From 0f38431ee611cb89c7e121fd02ab34f749a0c386 Mon Sep 17 00:00:00 2001
From: Song Hyo Jin <shj@xenosi.de>
Date: Sat, 29 Jun 2024 20:35:30 +0900
Subject: [PATCH 01/19] =?UTF-8?q?fix:=20=EC=BD=94=EB=93=9C=20=ED=9A=A8?=
 =?UTF-8?q?=EC=9C=A8=20=EA=B0=9C=EC=84=A0=20(#124)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: 모든 글자의 자소를 나누지 않고 마지막 글자만 계산합니다.

* fix: /\s/g to /\s+/g 일괄치환 효율 증가 bench: https://jsfiddle.net/crucify/g74b5d1h/

* fix: NFD 로 변환하여 자소계산 과정 생략하고 초성 ㄱ-ㅎ 만 남기게 수정

* fix: 자소계산을 생략하고 받침이 있는지만 검사합니다.

* fix: 유니코드 상수화 가독성 향상

* fix: 기존함수 받침문제 테스트 추가 (이 브랜치에서 해결됨)

* Create sixty-clouds-repeat.md

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 .changeset/sixty-clouds-repeat.md     |  5 ++++
 src/chosungIncludes.ts                |  4 +--
 src/constants.ts                      | 10 +++++++
 src/removeLastHangulCharacter.spec.ts |  1 +
 src/removeLastHangulCharacter.ts      | 20 +++----------
 src/utils.ts                          | 43 ++++++++++++++++++++-------
 6 files changed, 55 insertions(+), 28 deletions(-)
 create mode 100644 .changeset/sixty-clouds-repeat.md

diff --git a/.changeset/sixty-clouds-repeat.md b/.changeset/sixty-clouds-repeat.md
new file mode 100644
index 00000000..0210dfec
--- /dev/null
+++ b/.changeset/sixty-clouds-repeat.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": patch
+---
+
+fix: 코드 효율 개선
diff --git a/src/chosungIncludes.ts b/src/chosungIncludes.ts
index 254d1f30..3617a0c0 100644
--- a/src/chosungIncludes.ts
+++ b/src/chosungIncludes.ts
@@ -2,13 +2,13 @@ import { disassembleHangulToGroups } from './disassemble';
 import { canBeChosung, getChosung } from './utils';
 
 export function chosungIncludes(x: string, y: string) {
-  const trimmedY = y.replace(/\s/g, '');
+  const trimmedY = y.replace(/\s+/g, '');
 
   if (!isOnlyChosung(trimmedY)) {
     return false;
   }
 
-  const chosungX = getChosung(x).replace(/\s/g, '');
+  const chosungX = getChosung(x).replace(/\s+/g, '');
   const chosungY = trimmedY;
 
   return chosungX.includes(chosungY);
diff --git a/src/constants.ts b/src/constants.ts
index 217defe3..6579e3cc 100644
--- a/src/constants.ts
+++ b/src/constants.ts
@@ -3,6 +3,16 @@ export const COMPLETE_HANGUL_END_CHARCODE = '힣'.charCodeAt(0);
 export const NUMBER_OF_JONGSUNG = 28;
 export const NUMBER_OF_JUNGSUNG = 21;
 
+const _JASO_HANGUL_NFD = [...'각힣'.normalize('NFD')].map(char => char.charCodeAt(0)); // NFC 에 정의되지 않은 문자는 포함하지 않음
+export const JASO_HANGUL_NFD = {
+  START_CHOSEONG: _JASO_HANGUL_NFD[0], // ㄱ
+  START_JUNGSEONG: _JASO_HANGUL_NFD[1], // ㅏ
+  START_JONGSEONG: _JASO_HANGUL_NFD[2], // ㄱ
+  END_CHOSEONG: _JASO_HANGUL_NFD[3], // ㅎ
+  END_JUNGSEONG: _JASO_HANGUL_NFD[4], // ㅣ
+  END_JONGSEONG: _JASO_HANGUL_NFD[5], // ㅎ
+}
+
 /**
  * ㄱ -> 'ㄱ'
  * ㄳ -> 'ㄱㅅ' 으로 나눈다.
diff --git a/src/removeLastHangulCharacter.spec.ts b/src/removeLastHangulCharacter.spec.ts
index 17ce98f7..0445bc43 100644
--- a/src/removeLastHangulCharacter.spec.ts
+++ b/src/removeLastHangulCharacter.spec.ts
@@ -3,6 +3,7 @@ import { removeLastHangulCharacter } from './removeLastHangulCharacter';
 describe('removeLastHangulCharacter', () => {
   it('마지막 문자가 겹받침인 경우 홑받침으로 바꾼다.', () => {
     expect(removeLastHangulCharacter('안녕하세요 값')).toBe('안녕하세요 갑');
+    expect(removeLastHangulCharacter('안녕하세요 값이')).toBe('안녕하세요 값ㅇ');
   });
   it('마지막 문자가 초성과 중성의 조합으로 끝날 경우 초성만 남긴다.', () => {
     expect(removeLastHangulCharacter('프론트엔드')).toBe('프론트엔ㄷ');
diff --git a/src/removeLastHangulCharacter.ts b/src/removeLastHangulCharacter.ts
index 20c7ac15..59838522 100644
--- a/src/removeLastHangulCharacter.ts
+++ b/src/removeLastHangulCharacter.ts
@@ -20,25 +20,13 @@ import { excludeLastElement } from './_internal';
  * removeLastHangulCharacter('신세계') // 신세ㄱ
  */
 export function removeLastHangulCharacter(words: string) {
-  const disassembledGroups = disassembleHangulToGroups(words);
-  const lastCharacter = disassembledGroups[disassembledGroups.length - 1];
-
+  const lastCharacter = words[words.length - 1];
   if (lastCharacter == null) {
     return '';
   }
-
-  const withoutLastCharacter = disassembledGroups
-    .filter(v => v !== lastCharacter)
-    .map(([first, middle, last]) => {
-      if (middle != null) {
-        return combineHangulCharacter(first, middle, last);
-      }
-
-      return first;
-    });
-
-  const [[first, middle, last]] = excludeLastElement(lastCharacter);
+  const disassembleLastCharacter = disassembleHangulToGroups(lastCharacter);
+  const [[first, middle, last]] = excludeLastElement(disassembleLastCharacter[0]);
   const result = middle != null ? combineHangulCharacter(first, middle, last) : first;
 
-  return [...withoutLastCharacter, result].join('');
+  return [words.substring(0, words.length - 1), result].join('');
 }
diff --git a/src/utils.ts b/src/utils.ts
index 5213d9c8..eb336371 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -1,10 +1,22 @@
 import {
+  COMPLETE_HANGUL_START_CHARCODE,
+  COMPLETE_HANGUL_END_CHARCODE,
   HANGUL_CHARACTERS_BY_FIRST_INDEX,
   HANGUL_CHARACTERS_BY_LAST_INDEX,
   HANGUL_CHARACTERS_BY_MIDDLE_INDEX,
+  NUMBER_OF_JONGSUNG,
+  JASO_HANGUL_NFD,
 } from './constants';
-import { disassembleHangul, disassembleHangulToGroups } from './disassemble';
-import { disassembleCompleteHangulCharacter } from './disassembleCompleteHangulCharacter';
+import { disassembleHangulToGroups } from './disassemble';
+
+const EXTRACT_CHOSEONG_REGEX = new RegExp(
+  `[^\\u${JASO_HANGUL_NFD.START_CHOSEONG.toString(16)}-\\u${JASO_HANGUL_NFD.END_CHOSEONG.toString(16)}ㄱ-ㅎ\\s]+`,
+  'ug'
+);
+const CHOOSE_NFD_CHOSEONG_REGEX = new RegExp(
+  `[\\u${JASO_HANGUL_NFD.START_CHOSEONG.toString(16)}-\\u${JASO_HANGUL_NFD.END_CHOSEONG.toString(16)}]`,
+  'g'
+);
 
 /**
  * @name hasBatchim
@@ -26,9 +38,14 @@ export function hasBatchim(str: string) {
   if (lastChar == null) {
     return false;
   }
+  const charCode = lastChar.charCodeAt(0);
+  const isCompleteHangul = COMPLETE_HANGUL_START_CHARCODE <= charCode && charCode <= COMPLETE_HANGUL_END_CHARCODE;
 
-  const disassembled = disassembleCompleteHangulCharacter(lastChar);
-  return disassembled != null && disassembled.last !== '';
+  if (!isCompleteHangul) {
+    return false;
+  }
+
+  return (charCode - COMPLETE_HANGUL_START_CHARCODE) % NUMBER_OF_JONGSUNG > 0;
 }
 
 /**
@@ -49,12 +66,18 @@ export function hasBatchim(str: string) {
 export function hasSingleBatchim(str: string) {
   const lastChar = str[str.length - 1];
 
-  if (lastChar == null || hasBatchim(lastChar) === false) {
+  if (lastChar == null) {
     return false;
   }
+  const charCode = lastChar.charCodeAt(0);
+  const isCompleteHangul = COMPLETE_HANGUL_START_CHARCODE <= charCode && charCode <= COMPLETE_HANGUL_END_CHARCODE;
 
-  const disassembled = disassembleHangul(lastChar);
-  return disassembled.length === 3;
+  if (!isCompleteHangul) {
+    return false;
+  }
+
+  const batchimCode = (charCode - COMPLETE_HANGUL_START_CHARCODE) % NUMBER_OF_JONGSUNG;
+  return HANGUL_CHARACTERS_BY_LAST_INDEX[batchimCode].length === 1;
 }
 
 /**
@@ -73,9 +96,9 @@ export function hasSingleBatchim(str: string) {
  * getChosung('띄어 쓰기') // 'ㄸㅇ ㅆㄱ'
  */
 export function getChosung(word: string) {
-  return disassembleHangulToGroups(word).reduce((chosung, [consonant]) => {
-    return `${chosung}${consonant}`;
-  }, '');
+  return word.normalize('NFD')
+    .replace(EXTRACT_CHOSEONG_REGEX, '') // NFD ㄱ-ㅎ, NFC ㄱ-ㅎ 외 문자 삭제
+    .replace(CHOOSE_NFD_CHOSEONG_REGEX, $0 => HANGUL_CHARACTERS_BY_FIRST_INDEX[$0.charCodeAt(0) - 0x1100]); // NFD to NFC
 }
 
 /**

From b0b254198064778b1deed99ff9343178f333de6a Mon Sep 17 00:00:00 2001
From: Dongkyu Kim <po4tion0429@gmail.com>
Date: Sat, 29 Jun 2024 21:02:56 +0900
Subject: [PATCH 02/19] =?UTF-8?q?test:=20internal=20=ED=85=8C=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=20=EC=BD=94=EB=93=9C=EB=A5=BC=20=EC=9E=91=EC=84=B1?=
 =?UTF-8?q?=ED=95=A9=EB=8B=88=EB=8B=A4=20(#137)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* test: internal 테스트 코드를 작성합니다

* test: vitest에서 제공해주는 toThrowError로 변경

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 src/_internal/index.spec.ts | 61 +++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 src/_internal/index.spec.ts

diff --git a/src/_internal/index.spec.ts b/src/_internal/index.spec.ts
new file mode 100644
index 00000000..6c6bc393
--- /dev/null
+++ b/src/_internal/index.spec.ts
@@ -0,0 +1,61 @@
+import assert, { excludeLastElement, isBlank, joinString } from './index';
+
+describe('excludeLastElement', () => {
+  it('마지막 요소를 제외한 모든 요소와 마지막 요소를 반환한다', () => {
+    const result = excludeLastElement(['apple', 'banana', 'cherry']);
+
+    expect(result).toEqual([['apple', 'banana'], 'cherry']);
+  });
+
+  it('입력 배열이 비어 있으면 빈 배열과 빈 문자열을 반환한다', () => {
+    const result = excludeLastElement([]);
+
+    expect(result).toEqual([[], '']);
+  });
+
+  it('배열에 단 하나의 요소만 있는 경우, 빈배열과 그 요소를 반환한다', () => {
+    const result = excludeLastElement(['apple']);
+
+    expect(result).toEqual([[], 'apple']);
+  });
+});
+
+describe('joinString', () => {
+  it('여러 문자열을 하나의 문자열로 연결한다', () => {
+    const result = joinString('Hello', ' ', 'World');
+
+    expect(result).toBe('Hello World');
+  });
+
+  it('인자가 주어지지 않았을 때 빈 문자열을 반환한다', () => {
+    const result = joinString();
+
+    expect(result).toBe('');
+  });
+});
+
+describe('isBlank', () => {
+  it('문자가 공백이면 true를 반환한다', () => {
+    expect(isBlank(' ')).toBe(true);
+  });
+
+  it('문자가 공백이 아니면 false를 반환한다', () => {
+    expect(isBlank('a')).toBe(false);
+  });
+});
+
+describe('assert', () => {
+  it('조건이 참이면 에러를 던지지 않는다', () => {
+    expect(() => assert(true)).not.toThrowError();
+  });
+
+  it('조건이 거짓이면 에러를 던진다', () => {
+    expect(() => assert(false)).toThrowError('Invalid condition');
+  });
+
+  it('조건이 거짓이고 에러 메시지가 제공된 경우 사용자 정의 에러 메시지를 던져야 한다', () => {
+    const customMessage = 'Custom error message';
+
+    expect(() => assert(false, customMessage)).toThrowError(customMessage);
+  });
+});

From dadd51671fb93be213699dea6bee5467a7ea1bba Mon Sep 17 00:00:00 2001
From: Jaemin Kim <jmkim326@gmail.com>
Date: Sat, 29 Jun 2024 21:04:16 +0900
Subject: [PATCH 03/19] =?UTF-8?q?docs:=20josa=EC=97=90=20=EA=B4=80?=
 =?UTF-8?q?=EB=A0=A8=EB=90=9C=20=EB=AC=B8=EC=84=9C=EC=97=90=20=EC=9E=98?=
 =?UTF-8?q?=EB=AA=BB=EB=90=9C=20=EB=B6=80=EB=B6=84=EC=9D=84=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95=ED=95=A9=EB=8B=88=EB=8B=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- '이에/에' 삭제

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 docs/src/pages/docs/api/josa.ko.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/src/pages/docs/api/josa.ko.md b/docs/src/pages/docs/api/josa.ko.md
index 91adb784..bb094723 100644
--- a/docs/src/pages/docs/api/josa.ko.md
+++ b/docs/src/pages/docs/api/josa.ko.md
@@ -18,7 +18,6 @@ function josa(
     | '으로/로'
     | '와/과'
     | '이나/나'
-    | '이에/에'
     | '이란/란'
     | '아/야'
     | '이랑/랑'

From b0e97d549a61c65e878b16641193fafe1985988f Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 29 Jun 2024 21:04:39 +0900
Subject: [PATCH 04/19] chore: version packages (#143)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/sixty-clouds-repeat.md | 5 -----
 CHANGELOG.md                      | 6 ++++++
 docs/CHANGELOG.md                 | 7 +++++++
 docs/package.json                 | 2 +-
 package.json                      | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/sixty-clouds-repeat.md

diff --git a/.changeset/sixty-clouds-repeat.md b/.changeset/sixty-clouds-repeat.md
deleted file mode 100644
index 0210dfec..00000000
--- a/.changeset/sixty-clouds-repeat.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": patch
----
-
-fix: 코드 효율 개선
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0d921fbd..f72a9d96 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.3.7
+
+### Patch Changes
+
+- [#124](https://github.com/toss/es-hangul/pull/124) [`0f38431`](https://github.com/toss/es-hangul/commit/0f38431ee611cb89c7e121fd02ab34f749a0c386) Thanks [@crucifyer](https://github.com/crucifyer)! - fix: 코드 효율 개선
+
 ## 1.3.6
 
 ### Patch Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index e2fbde80..05099de5 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies [[`0f38431`](https://github.com/toss/es-hangul/commit/0f38431ee611cb89c7e121fd02ab34f749a0c386)]:
+  - es-hangul@1.3.7
+
 ## 0.1.2
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 2b0bc353..352979c6 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index 3888a6dd..74a38053 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "keywords": [
     "한글",
     "한국어",

From f0195b29f20bdbe5c4fbf0a5764046cba3d70d41 Mon Sep 17 00:00:00 2001
From: seunghee <sa02045@naver.com>
Date: Sat, 29 Jun 2024 22:18:12 +0900
Subject: [PATCH 05/19] =?UTF-8?q?feat:=20=ED=95=9C=EA=B8=80=20=EB=AC=B8?=
 =?UTF-8?q?=EC=9E=90=EC=97=B4=EC=97=90=20=EB=8C=80=ED=95=9C=20=EA=B2=80?=
 =?UTF-8?q?=EC=A6=9D,=20assert,=20parsing=20=ED=95=A8=EC=88=98=EB=A5=BC=20?=
 =?UTF-8?q?=EA=B5=AC=ED=98=84=ED=95=A9=EB=8B=88=EB=8B=A4.=20(#136)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: 한글 문자열인지 boolean 반환 함수

* feat: 한글 문자열인지 assert 함수

* feat: stringify

* test: isHangulString, assertHangulString 테스트 코드

* feat: parse 함수

* test: parse 함수 테스트

* refactor: naming 통일
---
 src/_internal/hangul.spec.ts | 72 +++++++++++++++++++++++++++++++++++-
 src/_internal/hangul.ts      | 34 +++++++++++++++++
 2 files changed, 105 insertions(+), 1 deletion(-)

diff --git a/src/_internal/hangul.spec.ts b/src/_internal/hangul.spec.ts
index 7cf63bbe..e5307cf0 100644
--- a/src/_internal/hangul.spec.ts
+++ b/src/_internal/hangul.spec.ts
@@ -1,4 +1,13 @@
-import { binaryAssembleHangulCharacters, binaryAssembleHangul, isHangulAlphabet, isHangulCharacter } from './hangul';
+import {
+  binaryAssembleHangulCharacters,
+  binaryAssembleHangul,
+  isHangulAlphabet,
+  isHangulCharacter,
+  isHangul,
+  assertHangul,
+  parseHangul,
+  safeParseHangul,
+} from './hangul';
 
 describe('isHangul*', () => {
   it('isHangulCharacter는 완성된 한글 문자를 받으면 true를 반환한다.', () => {
@@ -16,6 +25,51 @@ describe('isHangul*', () => {
     expect(isHangulAlphabet('ㅏ')).toBe(true);
     expect(isHangulAlphabet('a')).toBe(false);
   });
+
+  it('isHangul은 한글 문자열을 받으면 true를 반환한다.', () => {
+    expect(isHangul('값')).toBe(true);
+    expect(isHangul('ㄱ')).toBe(true);
+    expect(isHangul('ㅏ')).toBe(true);
+    expect(isHangul('저는 고양이를 좋아합니다')).toBe(true);
+    expect(isHangul('a')).toBe(false);
+    expect(isHangul(111)).toBe(false);
+    expect(isHangul([111, 111])).toBe(false);
+    expect(isHangul({ a: 111 })).toBe(false);
+  });
+});
+
+describe('parse', () => {
+  it('parseHangul은 한글 문자열을 받으면 그대로 반환한다.', () => {
+    expect(parseHangul('값')).toBe('값');
+    expect(parseHangul('ㄱ')).toBe('ㄱ');
+    expect(parseHangul('ㅏ')).toBe('ㅏ');
+    expect(parseHangul('저는 고양이를 좋아합니다')).toBe('저는 고양이를 좋아합니다');
+  });
+
+  it('parseHangul은 한글 문자열이 아닌 값을 받으면 에러를 발생시킨다.', () => {
+    expect(() => parseHangul(111)).toThrowError('111 is not a valid hangul string');
+    expect(() => parseHangul([111, 111])).toThrowError('[111,111] is not a valid hangul string');
+    expect(() => parseHangul({ a: 111 })).toThrowError('{"a":111} is not a valid hangul string');
+  });
+
+  it('safeParseHangul은 한글 문자열을 받으면 성공 객체를 반환한다.', () => {
+    expect(safeParseHangul('값')).toEqual({ success: true, data: '값' });
+    expect(safeParseHangul('ㄱ')).toEqual({ success: true, data: 'ㄱ' });
+    expect(safeParseHangul('ㅏ')).toEqual({ success: true, data: 'ㅏ' });
+    expect(safeParseHangul('저는 고양이를 좋아합니다')).toEqual({ success: true, data: '저는 고양이를 좋아합니다' });
+  });
+
+  it('safeParseHangul은 한글 문자열이 아닌 값을 받으면 실패 객체를 반환한다.', () => {
+    expect(safeParseHangul(111)).toEqual({ success: false, error: Error('111 is not a valid hangul string') });
+    expect(safeParseHangul([111, 111])).toEqual({
+      success: false,
+      error: Error('[111,111] is not a valid hangul string'),
+    });
+    expect(safeParseHangul({ a: 111 })).toEqual({
+      success: false,
+      error: Error('{"a":111} is not a valid hangul string'),
+    });
+  });
 });
 
 describe('binaryAssembleHangulCharacters', () => {
@@ -107,4 +161,20 @@ describe('binaryAssembleHangul', () => {
     expect(binaryAssembleHangul('저는 고양이를 좋아하', 'ㅏ')).toEqual('저는 고양이를 좋아하ㅏ');
     expect(binaryAssembleHangul('저는 고양이를 좋아합니다', 'ㅜ')).toEqual('저는 고양이를 좋아합니다ㅜ');
   });
+
+  describe('assertHangul', () => {
+    it('한글 문자열을 받으면 에러를 발생시키지 않는다.', () => {
+      expect(() => assertHangul('ㄱ')).not.toThrow();
+      expect(() => assertHangul('고양이')).not.toThrow();
+      expect(() => assertHangul('저는 고양이를 좋아합니다')).not.toThrow();
+      expect(() => assertHangul('저는 고양이를 좋아합니ㄷ')).not.toThrow();
+    });
+
+    it("한글 문자열이 아닌 값을 받으면 '___ is not a valid hangul string' 에러를 발생시킨다.", () => {
+      expect(() => assertHangul('aaaaaa')).toThrowError('"aaaaaa" is not a valid hangul string');
+      expect(() => assertHangul(111)).toThrowError('111 is not a valid hangul string');
+      expect(() => assertHangul([111, 111])).toThrowError('[111,111] is not a valid hangul string');
+      expect(() => assertHangul({ a: 111 })).toThrowError('{"a":111} is not a valid hangul string');
+    });
+  });
 });
diff --git a/src/_internal/hangul.ts b/src/_internal/hangul.ts
index 6a1479ca..1a746f5b 100644
--- a/src/_internal/hangul.ts
+++ b/src/_internal/hangul.ts
@@ -12,6 +12,40 @@ export function isHangulAlphabet(character: string) {
   return /^[ㄱ-ㅣ]$/.test(character);
 }
 
+export function isHangul(actual: unknown): actual is string {
+  return typeof actual === 'string' && /^[가-힣ㄱ-ㅣ\s]+$/.test(actual);
+}
+
+export function assertHangul(actual: unknown, message?: string): asserts actual is string {
+  assert(isHangul(actual), message || `${JSON.stringify(actual)} is not a valid hangul string`);
+}
+
+export function parseHangul(actual: unknown): string {
+  assertHangul(actual);
+  return actual;
+}
+
+type SafeParseSuccess = {
+  success: true;
+  data: string;
+  error?: never;
+};
+
+type SafeParseError = {
+  success: false;
+  error: unknown;
+  data?: never;
+};
+
+export function safeParseHangul(actual: unknown): SafeParseSuccess | SafeParseError {
+  try {
+    const parsedHangul = parseHangul(actual);
+    return { success: true, data: parsedHangul };
+  } catch (error) {
+    return { success: false, error };
+  }
+}
+
 /**
  * @name binaryAssembleHangulAlphabets
  * @description

From b0e1184204be0cb9f3c13937888c83c8a94e7ca6 Mon Sep 17 00:00:00 2001
From: taehyun <126179088+KNU-K@users.noreply.github.com>
Date: Sat, 29 Jun 2024 22:52:33 +0900
Subject: [PATCH 06/19] =?UTF-8?q?feat=20:=20=EB=AC=B8=EC=9E=A5=EC=9D=98=20?=
 =?UTF-8?q?=EA=B0=81=20=EB=8B=A8=EC=96=B4=20=EC=A4=91=20=EC=B2=AB=20?=
 =?UTF-8?q?=EB=AC=B8=EC=9E=90=EB=A7=8C=20=EB=BD=91=EB=8A=94=20=ED=95=A8?=
 =?UTF-8?q?=EC=88=98=EC=B6=94=EA=B0=80=20(=20#128=20=EC=9D=B4=EC=8A=88?=
 =?UTF-8?q?=EC=97=90=20=EB=8C=80=ED=95=9C=20)=20(#133)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat : 문장의 각 단어 중 첫 문자만 뽑는 함수추가

* test 및 함수 추가

* add : 한글 문장인지 여부 판별 함수 추가

* fix : 한글 문장인지 여부 판별 기저 및 오류 추가 / arg 이름 변경

test 추가

* fix: src/_internal/hangul.ts

Co-authored-by: 박찬혁 <pgg6713@gmail.com>

* fix : rename function

getFirstHangulLetters -> getHangulAcronym

* fix : rename function

export function isHangulOnly로 변경

* fix : lint error

* fix : index에 추가

* chore : doc 추가

* fix : 문서화 한글 영어 바뀐거 바로 변경

* fix : isHangul로 대체 #136 으로

* chore : doc수정

* Update docs/src/pages/docs/api/getHangulAcronym.en.mdx

Co-authored-by: 박찬혁 <pgg6713@gmail.com>

* fix : Update hangul.ts

안쓰는 메소드 삭제

* Update getHangulAcronym.ko.mdx

* Update getHangulAcronym.en.mdx

* Update src/getHangulAcronym.ts

Co-authored-by: 박찬혁 <pgg6713@gmail.com>

* Update src/getHangulAcronym.ts

Co-authored-by: 박찬혁 <pgg6713@gmail.com>

* Update getHangulAcronym.ts

* Update getHangulAcronym.spec.ts

* Create fair-brooms-drive.md

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 .changeset/fair-brooms-drive.md                |  5 +++++
 .../src/pages/docs/api/getHangulAcronym.en.mdx | 16 ++++++++++++++++
 .../src/pages/docs/api/getHangulAcronym.ko.mdx | 16 ++++++++++++++++
 src/getHangulAcronym.spec.ts                   | 18 ++++++++++++++++++
 src/getHangulAcronym.ts                        | 12 ++++++++++++
 src/index.ts                                   |  1 +
 6 files changed, 68 insertions(+)
 create mode 100644 .changeset/fair-brooms-drive.md
 create mode 100644 docs/src/pages/docs/api/getHangulAcronym.en.mdx
 create mode 100644 docs/src/pages/docs/api/getHangulAcronym.ko.mdx
 create mode 100644 src/getHangulAcronym.spec.ts
 create mode 100644 src/getHangulAcronym.ts

diff --git a/.changeset/fair-brooms-drive.md b/.changeset/fair-brooms-drive.md
new file mode 100644
index 00000000..9a73e4eb
--- /dev/null
+++ b/.changeset/fair-brooms-drive.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": patch
+---
+
+feat : 문장의 각 단어 중 첫 문자만 뽑는 extractHangul 함수를 추가합니다.
diff --git a/docs/src/pages/docs/api/getHangulAcronym.en.mdx b/docs/src/pages/docs/api/getHangulAcronym.en.mdx
new file mode 100644
index 00000000..730ea88c
--- /dev/null
+++ b/docs/src/pages/docs/api/getHangulAcronym.en.mdx
@@ -0,0 +1,16 @@
+# getHangulAcronym
+
+It receives the Korean sentence and returns the first letter of that Korean sentence.
+(We don't deal with non-Korean sentences; we don't deal with additional Korean + English sentences.)
+
+```typescript
+function getHangulAcronym(
+  // String consisting of plural nouns (e.g. '버스 충전', '치킨과 맥주')
+  text: string
+): boolean;
+```
+
+```typescript
+getHangulAcronym('치킨과 맥주').join(''); //치맥
+getHangulAcronym('버스 충전 카드').join(''); //버충카
+```
diff --git a/docs/src/pages/docs/api/getHangulAcronym.ko.mdx b/docs/src/pages/docs/api/getHangulAcronym.ko.mdx
new file mode 100644
index 00000000..8d655e54
--- /dev/null
+++ b/docs/src/pages/docs/api/getHangulAcronym.ko.mdx
@@ -0,0 +1,16 @@
+# getHangulAcronym
+
+한글 문장을 입력받아서, 해당 한글 문장의 첫글자를 리턴해줍니다.
+(한글 문장이 아닌, 문장은 취급하지않습니다. 추가로 한글 문장 + 영어 문장의 경우에도 취급하지않습니다.)
+
+```typescript
+function getHangulAcronym( 
+  // 복수 명사로 이루어진 문자열 (e.g. '버스 충전', '치킨과 맥주')
+  text: string
+): boolean;
+```
+
+```typescript
+getHangulAcronym('치킨과 맥주').join(''); //치맥
+getHangulAcronym('버스 충전 카드').join(''); //버충카
+```
diff --git a/src/getHangulAcronym.spec.ts b/src/getHangulAcronym.spec.ts
new file mode 100644
index 00000000..649d2432
--- /dev/null
+++ b/src/getHangulAcronym.spec.ts
@@ -0,0 +1,18 @@
+import { getHangulAcronym } from './getHangulAcronym';
+
+describe('getHangulAcronym', () => {
+  it('한글 문장 단어중 첫 문자만 뽑은 리스트를 반환', () => {
+    expect(getHangulAcronym('치킨과 맥주')).toHaveLength(2);
+    expect(getHangulAcronym('치킨과 맥주').join('')).toBe('치맥');
+
+    expect(getHangulAcronym('버스 충전 카드')).toHaveLength(3);
+    expect(getHangulAcronym('버스 충전 카드').join('')).toBe('버충카');
+  });
+  it('한글이 아닌 문장 넣었을 때', () => {
+    expect(() => getHangulAcronym('test test')).toThrowError('"test test" is not a valid hangul string');
+  });
+
+  it('한글과 영어가 섞인 문장을 넣었을 때', () => {
+    expect(() => getHangulAcronym('고기와 Cheese')).toThrowError('"고기와 Cheese" is not a valid hangul string');
+  });
+});
diff --git a/src/getHangulAcronym.ts b/src/getHangulAcronym.ts
new file mode 100644
index 00000000..5e5c5a37
--- /dev/null
+++ b/src/getHangulAcronym.ts
@@ -0,0 +1,12 @@
+import { parseHangul } from './_internal/hangul';
+
+/**
+ *
+ * @param getHangulAcronym
+ * @description
+ * 한글 문장을 입력받아서, 해당 한글 문장의 초성을을 리턴해줍니다.
+ * 한글 문장이 아닌, 문장은 취급하지않습니다. 추가로 한글 문장 + 영어 문장의 경우에도 취급하지않습니다.
+ */
+export function getHangulAcronym(hangul: string) {
+return parseHangul(hangul).split(' ').map(word => word.charAt(0));
+}
diff --git a/src/index.ts b/src/index.ts
index be7f02a3..84f29536 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -8,3 +8,4 @@ export * from './hangulIncludes';
 export * from './josa';
 export * from './removeLastHangulCharacter';
 export * from './utils';
+export * from './getHangulAcronym';

From b25fcc53fba7f0fe17a8544c4180ff82f4290fc0 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 29 Jun 2024 23:08:38 +0900
Subject: [PATCH 07/19] chore: version packages (#145)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/fair-brooms-drive.md | 5 -----
 CHANGELOG.md                    | 6 ++++++
 docs/CHANGELOG.md               | 7 +++++++
 docs/package.json               | 2 +-
 package.json                    | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/fair-brooms-drive.md

diff --git a/.changeset/fair-brooms-drive.md b/.changeset/fair-brooms-drive.md
deleted file mode 100644
index 9a73e4eb..00000000
--- a/.changeset/fair-brooms-drive.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": patch
----
-
-feat : 문장의 각 단어 중 첫 문자만 뽑는 extractHangul 함수를 추가합니다.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f72a9d96..aeeffb51 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.3.8
+
+### Patch Changes
+
+- [#133](https://github.com/toss/es-hangul/pull/133) [`b0e1184`](https://github.com/toss/es-hangul/commit/b0e1184204be0cb9f3c13937888c83c8a94e7ca6) Thanks [@KNU-K](https://github.com/KNU-K)! - feat : 문장의 각 단어 중 첫 문자만 뽑는 extractHangul 함수를 추가합니다.
+
 ## 1.3.7
 
 ### Patch Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 05099de5..d637752a 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies [[`b0e1184`](https://github.com/toss/es-hangul/commit/b0e1184204be0cb9f3c13937888c83c8a94e7ca6)]:
+  - es-hangul@1.3.8
+
 ## 0.1.3
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 352979c6..77a52e96 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index 74a38053..def9b1b4 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "keywords": [
     "한글",
     "한국어",

From acd6edb1d8aadced517f6b57a49c01152ff19d0a Mon Sep 17 00:00:00 2001
From: SeongMin Kim <86355699+Collection50@users.noreply.github.com>
Date: Sat, 29 Jun 2024 23:16:59 +0900
Subject: [PATCH 08/19] =?UTF-8?q?feat:=20=EB=AC=B8=EC=9E=90=EC=97=B4?=
 =?UTF-8?q?=EC=97=90=EC=84=9C=20=ED=95=9C=EA=B8=80=EB=A7=8C=20=EB=B0=98?=
 =?UTF-8?q?=ED=99=98=ED=95=98=EB=8A=94=20extractHangul=EC=9D=84=20?=
 =?UTF-8?q?=EA=B5=AC=ED=98=84=ED=95=A9=EB=8B=88=EB=8B=A4.=20(#130)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: parseHangul

* fix: parseHangul의 이름을 extractHangul로 수정 및 테스트 코드 보완

* test: 일관된 테스트 코드 작성이 될 수 있도록 describe 설명 수정

* test: 테스트 코드 수정

* docs: extractHangul의 문서 작성

* test: 테스트 문구 수정

* fix: index.ts에 export 추가

* Create fresh-students-sit.md

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 .changeset/fresh-students-sit.md            |  5 ++++
 docs/src/pages/docs/api/extractHangul.en.md | 23 ++++++++++++++++++
 docs/src/pages/docs/api/extractHangul.ko.md | 23 ++++++++++++++++++
 src/extractHangul.spec.ts                   | 27 +++++++++++++++++++++
 src/extractHangul.ts                        | 18 ++++++++++++++
 src/index.ts                                |  1 +
 6 files changed, 97 insertions(+)
 create mode 100644 .changeset/fresh-students-sit.md
 create mode 100644 docs/src/pages/docs/api/extractHangul.en.md
 create mode 100644 docs/src/pages/docs/api/extractHangul.ko.md
 create mode 100644 src/extractHangul.spec.ts
 create mode 100644 src/extractHangul.ts

diff --git a/.changeset/fresh-students-sit.md b/.changeset/fresh-students-sit.md
new file mode 100644
index 00000000..03c76557
--- /dev/null
+++ b/.changeset/fresh-students-sit.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": patch
+---
+
+feat: 문자열에서 한글만 반환하는 extractHangul을 구현합니다.
diff --git a/docs/src/pages/docs/api/extractHangul.en.md b/docs/src/pages/docs/api/extractHangul.en.md
new file mode 100644
index 00000000..c685c84a
--- /dev/null
+++ b/docs/src/pages/docs/api/extractHangul.en.md
@@ -0,0 +1,23 @@
+---
+title: extractHangul
+---
+
+# extractHangul
+
+Extracts and returns only Korean characters from the string.
+
+For detailed examples, see below.
+
+```typescript
+function extractHangul(str: string): string;
+```
+
+## Examples
+
+```tsx
+extractHangul('안녕하세요1234abc'); // '안녕하세요'
+extractHangul('abcde'); // ''
+extractHangul('안녕하세요ㄱㄴ'); // '안녕하세요ㄱㄴ'
+extractHangul('안녕하세요    만나서 반갑습니다'); // '안녕하세요    만나서 반갑습니다'
+extractHangul('가나다!-29~라마바.,,사'); // '가나다라마바사'
+```
diff --git a/docs/src/pages/docs/api/extractHangul.ko.md b/docs/src/pages/docs/api/extractHangul.ko.md
new file mode 100644
index 00000000..dc089bdb
--- /dev/null
+++ b/docs/src/pages/docs/api/extractHangul.ko.md
@@ -0,0 +1,23 @@
+---
+title: extractHangul
+---
+
+# extractHangul
+
+문자열에서 한글만 추출하여 반환합니다.
+
+자세한 예시는 아래 Example을 참고하세요.
+
+```typescript
+function extractHangul(str: string): string;
+```
+
+## Examples
+
+```tsx
+extractHangul('안녕하세요1234abc'); // '안녕하세요'
+extractHangul('abcde'); // ''
+extractHangul('안녕하세요ㄱㄴ'); // '안녕하세요ㄱㄴ'
+extractHangul('안녕하세요    만나서 반갑습니다'); // '안녕하세요    만나서 반갑습니다'
+extractHangul('가나다!-29~라마바.,,사'); // '가나다라마바사'
+```
diff --git a/src/extractHangul.spec.ts b/src/extractHangul.spec.ts
new file mode 100644
index 00000000..b3fd84dd
--- /dev/null
+++ b/src/extractHangul.spec.ts
@@ -0,0 +1,27 @@
+import { extractHangul } from './extractHangul';
+
+describe('extractHangul', () => {
+  it('숫자와 알파벳과 특수문자를 제외한 한글 반환', () => {
+    expect(extractHangul('안녕하세요1234abc!@#')).toBe('안녕하세요');
+  });
+
+  it('한글이 없는 문자열', () => {
+    expect(extractHangul('1234abc')).toBe('');
+  });
+
+  it('한글과 공백을 제외한 다른 문자는 제거', () => {
+    expect(extractHangul('한글과 영어가 섞인 문장입니다. Hello!')).toBe('한글과 영어가 섞인 문장입니다 ');
+  });
+
+  it('escape 문자열 유지', () => {
+    expect(extractHangul('한글과\n\t줄바꿈')).toBe('한글과\n\t줄바꿈');
+  });
+
+  it('모음은 제거하지 않음', () => {
+    expect(extractHangul('ㅠㅠ')).toBe('ㅠㅠ');
+  });
+
+  it('자음은 제거하지 않음', () => {
+    expect(extractHangul('ㄱㄴㄱㄴ')).toBe('ㄱㄴㄱㄴ');
+  });
+});
diff --git a/src/extractHangul.ts b/src/extractHangul.ts
new file mode 100644
index 00000000..d023a674
--- /dev/null
+++ b/src/extractHangul.ts
@@ -0,0 +1,18 @@
+/**
+ * @name extractHangul
+ * @description
+ * 문자열을 입력받고 한글만 추출해 반환합니다.
+ *
+ * @param {string} chars 모든 문자열
+ *
+ * @example
+ * extractHangul('안녕하세요1234abc') // '안녕하세요'
+ * extractHangul('abcde') // ''
+ * extractHangul('안녕하세요ㄱㄴ') // '안녕하세요ㄱㄴ'
+ * extractHangul('안녕하세요    만나서 반갑습니다') // '안녕하세요    만나서 반갑습니다'
+ * extractHangul('가나다!-29~라마바.,,사') // '가나다라마바사'
+ */
+
+export function extractHangul(str: string): string {
+  return str.replace(/[^ㄱ-ㅎㅏ-ㅣ가-힣\s]+/g, '');
+}
diff --git a/src/index.ts b/src/index.ts
index 84f29536..7bff5341 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -8,4 +8,5 @@ export * from './hangulIncludes';
 export * from './josa';
 export * from './removeLastHangulCharacter';
 export * from './utils';
+export * from './extractHangul';
 export * from './getHangulAcronym';

From d09822f74360e3567ead1eb8eadd7c8105c16338 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 29 Jun 2024 23:17:48 +0900
Subject: [PATCH 09/19] chore: version packages (#146)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/fresh-students-sit.md | 5 -----
 CHANGELOG.md                     | 6 ++++++
 docs/CHANGELOG.md                | 7 +++++++
 docs/package.json                | 2 +-
 package.json                     | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/fresh-students-sit.md

diff --git a/.changeset/fresh-students-sit.md b/.changeset/fresh-students-sit.md
deleted file mode 100644
index 03c76557..00000000
--- a/.changeset/fresh-students-sit.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": patch
----
-
-feat: 문자열에서 한글만 반환하는 extractHangul을 구현합니다.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aeeffb51..8a857c4c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.3.9
+
+### Patch Changes
+
+- [#130](https://github.com/toss/es-hangul/pull/130) [`acd6edb`](https://github.com/toss/es-hangul/commit/acd6edb1d8aadced517f6b57a49c01152ff19d0a) Thanks [@Collection50](https://github.com/Collection50)! - feat: 문자열에서 한글만 반환하는 extractHangul을 구현합니다.
+
 ## 1.3.8
 
 ### Patch Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index d637752a..67e69302 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [[`acd6edb`](https://github.com/toss/es-hangul/commit/acd6edb1d8aadced517f6b57a49c01152ff19d0a)]:
+  - es-hangul@1.3.9
+
 ## 0.1.4
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 77a52e96..ad4bed6d 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index def9b1b4..247bfdc3 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.3.8",
+  "version": "1.3.9",
   "keywords": [
     "한글",
     "한국어",

From f3c7fe9f73138b932af817b8ac925d54c3283151 Mon Sep 17 00:00:00 2001
From: taehyun <126179088+KNU-K@users.noreply.github.com>
Date: Sun, 30 Jun 2024 00:13:57 +0900
Subject: [PATCH 10/19] =?UTF-8?q?fix=20:=20getHangulacronym=ED=95=A8?=
 =?UTF-8?q?=EC=88=98=EB=A5=BC=20acronymizeHangul=20=EB=A9=94=EC=84=9C?=
 =?UTF-8?q?=EB=93=9C=EB=A1=9C=20=EB=8C=80=EC=B2=B4=ED=95=A9=EB=8B=88?=
 =?UTF-8?q?=EB=8B=A4.=20(#148)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update and rename getHangulAcronym.ts to acronymizeHangul.ts

* Update and rename getHangulAcronym.spec.ts to acronymizeHangul.spec.ts

* Update index.ts

* Update and rename getHangulAcronym.en.mdx to acronymizeHangul.en.mdx

* Update and rename getHangulAcronym.ko.mdx to acronymizeHangul.ko.mdx

* Create odd-squids-sin.md

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 .changeset/odd-squids-sin.md                   |  5 +++++
 ...lAcronym.en.mdx => acronymizeHangul.en.mdx} | 10 +++++-----
 ...lAcronym.ko.mdx => acronymizeHangul.ko.mdx} | 10 +++++-----
 src/acronymizeHangul.spec.ts                   | 18 ++++++++++++++++++
 ...getHangulAcronym.ts => acronymizeHangul.ts} |  2 +-
 src/getHangulAcronym.spec.ts                   | 18 ------------------
 src/index.ts                                   |  2 +-
 7 files changed, 35 insertions(+), 30 deletions(-)
 create mode 100644 .changeset/odd-squids-sin.md
 rename docs/src/pages/docs/api/{getHangulAcronym.en.mdx => acronymizeHangul.en.mdx} (63%)
 rename docs/src/pages/docs/api/{getHangulAcronym.ko.mdx => acronymizeHangul.ko.mdx} (67%)
 create mode 100644 src/acronymizeHangul.spec.ts
 rename src/{getHangulAcronym.ts => acronymizeHangul.ts} (89%)
 delete mode 100644 src/getHangulAcronym.spec.ts

diff --git a/.changeset/odd-squids-sin.md b/.changeset/odd-squids-sin.md
new file mode 100644
index 00000000..433b216b
--- /dev/null
+++ b/.changeset/odd-squids-sin.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": patch
+---
+
+fix : getHangulacronym함수를 acronymizeHangul 메서드로 대체합니다
diff --git a/docs/src/pages/docs/api/getHangulAcronym.en.mdx b/docs/src/pages/docs/api/acronymizeHangul.en.mdx
similarity index 63%
rename from docs/src/pages/docs/api/getHangulAcronym.en.mdx
rename to docs/src/pages/docs/api/acronymizeHangul.en.mdx
index 730ea88c..57d026c9 100644
--- a/docs/src/pages/docs/api/getHangulAcronym.en.mdx
+++ b/docs/src/pages/docs/api/acronymizeHangul.en.mdx
@@ -1,16 +1,16 @@
-# getHangulAcronym
+# acronymizeHangul
 
 It receives the Korean sentence and returns the first letter of that Korean sentence.
 (We don't deal with non-Korean sentences; we don't deal with additional Korean + English sentences.)
 
 ```typescript
-function getHangulAcronym(
+function acronymizeHangul(
   // String consisting of plural nouns (e.g. '버스 충전', '치킨과 맥주')
-  text: string
+  hangul: string
 ): boolean;
 ```
 
 ```typescript
-getHangulAcronym('치킨과 맥주').join(''); //치맥
-getHangulAcronym('버스 충전 카드').join(''); //버충카
+acronymizeHangul('치킨과 맥주').join(''); //치맥
+acronymizeHangul('버스 충전 카드').join(''); //버충카
 ```
diff --git a/docs/src/pages/docs/api/getHangulAcronym.ko.mdx b/docs/src/pages/docs/api/acronymizeHangul.ko.mdx
similarity index 67%
rename from docs/src/pages/docs/api/getHangulAcronym.ko.mdx
rename to docs/src/pages/docs/api/acronymizeHangul.ko.mdx
index 8d655e54..908e5251 100644
--- a/docs/src/pages/docs/api/getHangulAcronym.ko.mdx
+++ b/docs/src/pages/docs/api/acronymizeHangul.ko.mdx
@@ -1,16 +1,16 @@
-# getHangulAcronym
+# acronymizeHangul
 
 한글 문장을 입력받아서, 해당 한글 문장의 첫글자를 리턴해줍니다.
 (한글 문장이 아닌, 문장은 취급하지않습니다. 추가로 한글 문장 + 영어 문장의 경우에도 취급하지않습니다.)
 
 ```typescript
-function getHangulAcronym( 
+function acronymizeHangul( 
   // 복수 명사로 이루어진 문자열 (e.g. '버스 충전', '치킨과 맥주')
-  text: string
+  hangul: string
 ): boolean;
 ```
 
 ```typescript
-getHangulAcronym('치킨과 맥주').join(''); //치맥
-getHangulAcronym('버스 충전 카드').join(''); //버충카
+acronymizeHangul('치킨과 맥주').join(''); //치맥
+acronymizeHangul('버스 충전 카드').join(''); //버충카
 ```
diff --git a/src/acronymizeHangul.spec.ts b/src/acronymizeHangul.spec.ts
new file mode 100644
index 00000000..a4d8b91e
--- /dev/null
+++ b/src/acronymizeHangul.spec.ts
@@ -0,0 +1,18 @@
+import { acronymizeHangul } from './acronymizeHangul';
+
+describe('acronymizeHangul', () => {
+  it('한글 문장 단어중 첫 문자만 뽑은 리스트를 반환', () => {
+    expect(acronymizeHangul('치킨과 맥주')).toHaveLength(2);
+    expect(acronymizeHangul('치킨과 맥주').join('')).toBe('치맥');
+
+    expect(acronymizeHangul('버스 충전 카드')).toHaveLength(3);
+    expect(acronymizeHangul('버스 충전 카드').join('')).toBe('버충카');
+  });
+  it('한글이 아닌 문장 넣었을 때', () => {
+    expect(() => acronymizeHangul('test test')).toThrowError('"test test" is not a valid hangul string');
+  });
+
+  it('한글과 영어가 섞인 문장을 넣었을 때', () => {
+    expect(() => acronymizeHangul('고기와 Cheese')).toThrowError('"고기와 Cheese" is not a valid hangul string');
+  });
+});
diff --git a/src/getHangulAcronym.ts b/src/acronymizeHangul.ts
similarity index 89%
rename from src/getHangulAcronym.ts
rename to src/acronymizeHangul.ts
index 5e5c5a37..9103ec40 100644
--- a/src/getHangulAcronym.ts
+++ b/src/acronymizeHangul.ts
@@ -7,6 +7,6 @@ import { parseHangul } from './_internal/hangul';
  * 한글 문장을 입력받아서, 해당 한글 문장의 초성을을 리턴해줍니다.
  * 한글 문장이 아닌, 문장은 취급하지않습니다. 추가로 한글 문장 + 영어 문장의 경우에도 취급하지않습니다.
  */
-export function getHangulAcronym(hangul: string) {
+export function acronymizeHangul(hangul: string) {
 return parseHangul(hangul).split(' ').map(word => word.charAt(0));
 }
diff --git a/src/getHangulAcronym.spec.ts b/src/getHangulAcronym.spec.ts
deleted file mode 100644
index 649d2432..00000000
--- a/src/getHangulAcronym.spec.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-import { getHangulAcronym } from './getHangulAcronym';
-
-describe('getHangulAcronym', () => {
-  it('한글 문장 단어중 첫 문자만 뽑은 리스트를 반환', () => {
-    expect(getHangulAcronym('치킨과 맥주')).toHaveLength(2);
-    expect(getHangulAcronym('치킨과 맥주').join('')).toBe('치맥');
-
-    expect(getHangulAcronym('버스 충전 카드')).toHaveLength(3);
-    expect(getHangulAcronym('버스 충전 카드').join('')).toBe('버충카');
-  });
-  it('한글이 아닌 문장 넣었을 때', () => {
-    expect(() => getHangulAcronym('test test')).toThrowError('"test test" is not a valid hangul string');
-  });
-
-  it('한글과 영어가 섞인 문장을 넣었을 때', () => {
-    expect(() => getHangulAcronym('고기와 Cheese')).toThrowError('"고기와 Cheese" is not a valid hangul string');
-  });
-});
diff --git a/src/index.ts b/src/index.ts
index 7bff5341..ee3becfd 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -9,4 +9,4 @@ export * from './josa';
 export * from './removeLastHangulCharacter';
 export * from './utils';
 export * from './extractHangul';
-export * from './getHangulAcronym';
+export * from './acronymizeHangul';

From f782ec2cafac44f45cad6d72cf411a50d3a6fddc Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 30 Jun 2024 00:15:21 +0900
Subject: [PATCH 11/19] chore: version packages (#150)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/odd-squids-sin.md | 5 -----
 CHANGELOG.md                 | 6 ++++++
 docs/CHANGELOG.md            | 7 +++++++
 docs/package.json            | 2 +-
 package.json                 | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/odd-squids-sin.md

diff --git a/.changeset/odd-squids-sin.md b/.changeset/odd-squids-sin.md
deleted file mode 100644
index 433b216b..00000000
--- a/.changeset/odd-squids-sin.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": patch
----
-
-fix : getHangulacronym함수를 acronymizeHangul 메서드로 대체합니다
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8a857c4c..1e5583c4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.3.10
+
+### Patch Changes
+
+- [#148](https://github.com/toss/es-hangul/pull/148) [`f3c7fe9`](https://github.com/toss/es-hangul/commit/f3c7fe9f73138b932af817b8ac925d54c3283151) Thanks [@KNU-K](https://github.com/KNU-K)! - fix : getHangulacronym함수를 acronymizeHangul 메서드로 대체합니다
+
 ## 1.3.9
 
 ### Patch Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 67e69302..adc357a5 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [[`f3c7fe9`](https://github.com/toss/es-hangul/commit/f3c7fe9f73138b932af817b8ac925d54c3283151)]:
+  - es-hangul@1.3.10
+
 ## 0.1.5
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index ad4bed6d..2e1db525 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index 247bfdc3..cc3f0c6f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "keywords": [
     "한글",
     "한국어",

From b1148973e6c2b640ce528fc8ba4b8e2e034b90de Mon Sep 17 00:00:00 2001
From: SeongMin Kim <86355699+Collection50@users.noreply.github.com>
Date: Sun, 30 Jun 2024 10:57:36 +0900
Subject: [PATCH 12/19] =?UTF-8?q?fix:=20amountToHangul=EC=9D=B4=20?=
 =?UTF-8?q?=EC=86=8C=EC=88=98=EC=A0=90,=20=EC=88=AB=EC=9E=90=EB=8F=84=20?=
 =?UTF-8?q?=EB=8C=80=EC=9D=91=ED=95=A0=20=EC=88=98=20=EC=9E=88=EB=8F=84?=
 =?UTF-8?q?=EB=A1=9D=20=EC=88=98=EC=A0=95=20(#144)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: amountToHangul이 소수점, 숫자도 대응할 수 있도록 수정

* docs: amountToHangul의 영어 문서 작성

* Create famous-cheetahs-sneeze.md

* Update famous-cheetahs-sneeze.md

---------

Co-authored-by: 박찬혁 <pgg6713@gmail.com>
---
 .changeset/famous-cheetahs-sneeze.md         |  5 ++
 docs/src/pages/docs/api/amountToHangul.en.md | 12 ++--
 docs/src/pages/docs/api/amountToHangul.ko.md | 14 ++--
 src/amountToHangul.spec.ts                   | 19 ++++-
 src/amountToHangul.ts                        | 74 +++++++++++++++-----
 5 files changed, 87 insertions(+), 37 deletions(-)
 create mode 100644 .changeset/famous-cheetahs-sneeze.md

diff --git a/.changeset/famous-cheetahs-sneeze.md b/.changeset/famous-cheetahs-sneeze.md
new file mode 100644
index 00000000..f20b5a83
--- /dev/null
+++ b/.changeset/famous-cheetahs-sneeze.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": minor
+---
+
+fix: amountToHangul이 소수점, 숫자도 대응할 수 있도록 수정
diff --git a/docs/src/pages/docs/api/amountToHangul.en.md b/docs/src/pages/docs/api/amountToHangul.en.md
index c82c4dc4..19e3abcc 100644
--- a/docs/src/pages/docs/api/amountToHangul.en.md
+++ b/docs/src/pages/docs/api/amountToHangul.en.md
@@ -9,16 +9,14 @@ Converts numeric amounts to the Korean reading of the [National Institute of Kor
 For detailed examples, see below.
 
 ```typescript
-function amountToHangul(
-  // A string of numeric amounts
-  str: string
-): string;
+function amountToHangul(amount: string | number): string;
 ```
 
 ## Examples
 
 ```tsx
-amountToHangul('15,201,100'); // '일천오백이십만천백';
-amountToHangul('120,030원'); // '일십이만삼십' - Ignore non-numeric characters
-amountToHangul('392.24'); // '삼백구십이' - Ignore decimals
+amountToHangul('15,201,100'); // '일천오백이십만천백'
+amountToHangul('120,030원'); // '일십이만삼십'
+amountToHangul('12345.6789'); // '일만이천삼백사십오점육칠팔구'
+amountToHangul(15_201_100); // '일천오백이십만천백''
 ```
diff --git a/docs/src/pages/docs/api/amountToHangul.ko.md b/docs/src/pages/docs/api/amountToHangul.ko.md
index 9818d26d..dbafc07e 100644
--- a/docs/src/pages/docs/api/amountToHangul.ko.md
+++ b/docs/src/pages/docs/api/amountToHangul.ko.md
@@ -4,21 +4,19 @@ title: amountToHangul
 
 # amountToHangul
 
-숫자로 된 금액을 [국립국어원](https://ko.dict.naver.com/#/correct/korean/info?seq=602) 규칙의 한글 읽기로 변환합니다.
+숫자나 문자를 [국립국어원](https://ko.dict.naver.com/#/correct/korean/info?seq=602) 규칙의 한글 읽기 문자열로 변환합니다.
 
 자세한 예시는 아래 Example을 참고하세요.
 
 ```typescript
-function amountToHangul(
-  // 숫자로 된 금액 문자열
-  str: string
-): string;
+function amountToHangul(amount: string | number): string;
 ```
 
 ## Examples
 
 ```tsx
-amountToHangul('15,201,100'); // '일천오백이십만천백';
-amountToHangul('120,030원'); // '일십이만삼십' - 숫자 외 문자 무시
-amountToHangul('392.24'); // '삼백구십이' - 소수점 무시
+amountToHangul('15,201,100'); // '일천오백이십만천백'
+amountToHangul('120,030원'); // '일십이만삼십'
+amountToHangul('12345.6789'); // '일만이천삼백사십오점육칠팔구'
+amountToHangul(15_201_100); // '일천오백이십만천백''
 ```
diff --git a/src/amountToHangul.spec.ts b/src/amountToHangul.spec.ts
index 3d2de30b..7be66a5e 100644
--- a/src/amountToHangul.spec.ts
+++ b/src/amountToHangul.spec.ts
@@ -1,11 +1,24 @@
 import { amountToHangul } from './amountToHangul';
 
 describe('amountToHangul', () => {
-  it('숫자로 된 금액을 한글로 표기', () => {
+  it('금액 문자열을 한글로 표기', () => {
     expect(amountToHangul('15,201,100')).toEqual('일천오백이십만천백');
-    expect(amountToHangul('120,030원')).toEqual('일십이만삼십'); // 숫자 외 문자 무시
-    expect(amountToHangul('392.24')).toEqual('삼백구십이'); // 소수점 무시
     expect(amountToHangul('100000000')).toEqual('일억');
     expect(amountToHangul('100000100')).toEqual('일억백');
   });
+
+  it('숫자 외 문자를 무시하여 반환', () => {
+    expect(amountToHangul('120,030원')).toEqual('일십이만삼십');
+  });
+
+  it('소수점이 있는 경우도 표기', () => {
+    expect(amountToHangul('392.24')).toEqual('삼백구십이점이사');
+    expect(amountToHangul('12345.6789')).toEqual('일만이천삼백사십오점육칠팔구');
+  });
+
+  it('금액 숫자를 한글로 표기', () => {
+    expect(amountToHangul(15_201_100)).toEqual('일천오백이십만천백');
+    expect(amountToHangul(100000100)).toEqual('일억백');
+    expect(amountToHangul(392.24)).toEqual('삼백구십이점이사');
+  });
 });
diff --git a/src/amountToHangul.ts b/src/amountToHangul.ts
index 8708e817..c0afbd53 100644
--- a/src/amountToHangul.ts
+++ b/src/amountToHangul.ts
@@ -1,35 +1,71 @@
-export const HANGUL_DIGITS = ['', '만', '억', '조', '경', '해', '자', '양', '구', '간', '정', '재', '극', '항하사', '아승기', '나유타', '불가사의', '무량대수', '겁', '업'];
+export const HANGUL_DIGITS = [
+  '',
+  '만',
+  '억',
+  '조',
+  '경',
+  '해',
+  '자',
+  '양',
+  '구',
+  '간',
+  '정',
+  '재',
+  '극',
+  '항하사',
+  '아승기',
+  '나유타',
+  '불가사의',
+  '무량대수',
+  '겁',
+  '업',
+];
 export const HANGUL_DIGITS_MAX = HANGUL_DIGITS.length * 4;
 export const HANGUL_NUMBERS = ['', '일', '이', '삼', '사', '오', '육', '칠', '팔', '구'];
 export const HANGUL_CARDINAL = ['', '십', '백', '천'];
 
-// https://ko.dict.naver.com/#/correct/korean/info?seq=602
-// https://github.com/crucifyer/koreanCardinalOrdinal
-export function amountToHangul(str: string) {
-  str = str.replace(/\..*$/, '') // 소수점 지원 안함
-    .replace(/[^\d]+/g, ''); // , 표기 등 오류내지 않음
-  if(str.length > HANGUL_DIGITS_MAX) {
-    throw new Error('convert range exceeded : ' + str);
+export function amountToHangul(amount: string | number) {
+  const [integerPart, decimalPart] = String(amount)
+    .replace(/[^\d.]+/g, '')
+    .split('.');
+
+  if (integerPart.length > HANGUL_DIGITS_MAX) {
+    throw new Error(`convert range exceeded : ${amount}`);
   }
+
   const result = [];
   let pronunDigits = true;
-  for(let i = 0; i < str.length - 1; i ++) {
-    const d = str.length - i - 1;
-    if(str[i] > '1' || d % 4 === 0 || i === 0) {
-      const tnum = HANGUL_NUMBERS[parseInt(str[i])];
-      if(tnum) {
-        result.push(tnum);
+
+  for (let i = 0; i < integerPart.length - 1; i++) {
+    const digit = integerPart.length - i - 1;
+
+    if (integerPart[i] > '1' || digit % 4 === 0 || i === 0) {
+      const hangulNumber = HANGUL_NUMBERS[Number(integerPart[i])];
+
+      if (hangulNumber) {
+        result.push(hangulNumber);
         pronunDigits = true;
       }
     }
-    if(pronunDigits && d % 4 === 0) {
-      result.push(HANGUL_DIGITS[d / 4]);
+
+    if (pronunDigits && digit % 4 === 0) {
+      result.push(HANGUL_DIGITS[digit / 4]);
       pronunDigits = false;
     }
-    if(str[i] !== '0') {
-      result.push(HANGUL_CARDINAL[d % 4]);
+
+    if (integerPart[i] !== '0') {
+      result.push(HANGUL_CARDINAL[digit % 4]);
+    }
+  }
+  result.push(HANGUL_NUMBERS[Number(integerPart[integerPart.length - 1])]);
+
+  if (decimalPart) {
+    result.push('점');
+
+    for (let i = 0; i < decimalPart.length; i++) {
+      result.push(HANGUL_NUMBERS[Number(decimalPart[i])]);
     }
   }
-  result.push(HANGUL_NUMBERS[parseInt(str[str.length - 1])]);
+
   return result.join('');
 }

From 0624b5af13f3827200711ff3584bef1f02ac66bb Mon Sep 17 00:00:00 2001
From: Dongkyu Kim <po4tion0429@gmail.com>
Date: Sun, 30 Jun 2024 10:58:02 +0900
Subject: [PATCH 13/19] fix: packlint ESLint error (#149)

---
 tsconfig.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tsconfig.json b/tsconfig.json
index 08a6927f..2fbc5a46 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -8,5 +8,5 @@
     "strict": true,
     "skipLibCheck": true
   },
-  "include": ["src", ".eslintrc.js"]
+  "include": ["src", ".eslintrc.js", "packlint.config.mjs"]
 }

From ad05e4cb810f29e09706d482c9a2e114963790fe Mon Sep 17 00:00:00 2001
From: Dongkyu Kim <po4tion0429@gmail.com>
Date: Sun, 30 Jun 2024 10:58:34 +0900
Subject: [PATCH 14/19] =?UTF-8?q?test:=20utils=20=EA=B8=B0=EB=8A=A5?=
 =?UTF-8?q?=EB=93=A4=EC=9D=98=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20=EC=BC=80?=
 =?UTF-8?q?=EC=9D=B4=EC=8A=A4=EB=A5=BC=20=EA=B0=9C=EC=84=A0=ED=95=A9?=
 =?UTF-8?q?=EB=8B=88=EB=8B=A4=20(#151)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* test: hasBatchim 함수의 테스트 케이스를 추가합니다

* test: hasSingleBatchim의 테스트 케이스를 추가합니다
---
 src/utils.spec.ts | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/utils.spec.ts b/src/utils.spec.ts
index cacb0ce0..58dc04e4 100644
--- a/src/utils.spec.ts
+++ b/src/utils.spec.ts
@@ -34,6 +34,18 @@ describe('hasBatchim', () => {
       expect(hasBatchim('')).toBe(false);
     });
   });
+
+  describe('완성된 한글이 아닌 경우', () => {
+    it('한글이 자음 또는 모음으로만 구성된 경우 false를 반환한다.', () => {
+      expect(hasBatchim('ㄱ')).toBe(false);
+      expect(hasBatchim('ㅏ')).toBe(false);
+    });
+
+    it('한글 외의 문자를 입력하면 false를 반환한다', () => {
+      expect(hasBatchim('cat')).toBe(false);
+      expect(hasBatchim('!')).toBe(false);
+    });
+  });
 });
 
 describe('hasSingleBatchim', () => {
@@ -54,6 +66,12 @@ describe('hasSingleBatchim', () => {
       expect(hasSingleBatchim('토')).toBe(false);
       expect(hasSingleBatchim('서')).toBe(false);
     });
+
+    it('한글 외의 문자를 입력하면 false를 반환한다.', () => {
+      expect(hasSingleBatchim('cat')).toBe(false);
+      expect(hasSingleBatchim('')).toBe(false);
+      expect(hasSingleBatchim('?')).toBe(false);
+    });
   });
 });
 

From e6512364d89b25423a605825e3a2dbf4206107bd Mon Sep 17 00:00:00 2001
From: Dongkyu Kim <po4tion0429@gmail.com>
Date: Sun, 30 Jun 2024 10:59:13 +0900
Subject: [PATCH 15/19] =?UTF-8?q?fix:=20nextra=20theme=20asset=20=EA=B0=9C?=
 =?UTF-8?q?=EC=84=A0=20(#152)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/public/favicon-dark.png | Bin 0 -> 5451 bytes
 docs/public/favicon-dark.svg |   2 ++
 docs/public/favicon.ico      | Bin 25931 -> 0 bytes
 docs/public/favicon.svg      |   2 ++
 docs/public/next.svg         |   1 -
 docs/public/vercel.svg       |   1 -
 6 files changed, 4 insertions(+), 2 deletions(-)
 create mode 100644 docs/public/favicon-dark.png
 create mode 100644 docs/public/favicon-dark.svg
 delete mode 100644 docs/public/favicon.ico
 create mode 100644 docs/public/favicon.svg
 delete mode 100644 docs/public/next.svg
 delete mode 100644 docs/public/vercel.svg

diff --git a/docs/public/favicon-dark.png b/docs/public/favicon-dark.png
new file mode 100644
index 0000000000000000000000000000000000000000..07608185f0a3d1b2e7b818ce2732be7d35f58c86
GIT binary patch
literal 5451
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

literal 0
HcmV?d00001

diff --git a/docs/public/favicon-dark.svg b/docs/public/favicon-dark.svg
new file mode 100644
index 00000000..c5c553b4
--- /dev/null
+++ b/docs/public/favicon-dark.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="tiny" height="100px" version="1.2" width="110px" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><rect fill="black" height="100%" width="100%" x="0" y="0" /><text fill="white" font-family="Arial" font-size="30px" x="10" y="40">es-</text><text fill="white" font-family="Arial" font-size="30px" x="10" y="80">hangul</text></svg>
\ No newline at end of file
diff --git a/docs/public/favicon.ico b/docs/public/favicon.ico
deleted file mode 100644
index 718d6fea4835ec2d246af9800eddb7ffb276240c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 25931
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
LrJugUA?W`A8`#=m

diff --git a/docs/public/favicon.svg b/docs/public/favicon.svg
new file mode 100644
index 00000000..e6aa5e00
--- /dev/null
+++ b/docs/public/favicon.svg
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<svg baseProfile="tiny" height="100px" version="1.2" width="110px" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><rect fill="white" height="100%" width="100%" x="0" y="0" /><text fill="black" font-family="Arial" font-size="30px" x="10" y="40">es-</text><text fill="black" font-family="Arial" font-size="30px" x="10" y="80">hangul</text></svg>
\ No newline at end of file
diff --git a/docs/public/next.svg b/docs/public/next.svg
deleted file mode 100644
index 5174b28c..00000000
--- a/docs/public/next.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
\ No newline at end of file
diff --git a/docs/public/vercel.svg b/docs/public/vercel.svg
deleted file mode 100644
index d2f84222..00000000
--- a/docs/public/vercel.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 283 64"><path fill="black" d="M141 16c-11 0-19 7-19 18s9 18 20 18c7 0 13-3 16-7l-7-5c-2 3-6 4-9 4-5 0-9-3-10-7h28v-3c0-11-8-18-19-18zm-9 15c1-4 4-7 9-7s8 3 9 7h-18zm117-15c-11 0-19 7-19 18s9 18 20 18c6 0 12-3 16-7l-8-5c-2 3-5 4-8 4-5 0-9-3-11-7h28l1-3c0-11-8-18-19-18zm-10 15c2-4 5-7 10-7s8 3 9 7h-19zm-39 3c0 6 4 10 10 10 4 0 7-2 9-5l8 5c-3 5-9 8-17 8-11 0-19-7-19-18s8-18 19-18c8 0 14 3 17 8l-8 5c-2-3-5-5-9-5-6 0-10 4-10 10zm83-29v46h-9V5h9zM37 0l37 64H0L37 0zm92 5-27 48L74 5h10l18 30 17-30h10zm59 12v10l-3-1c-6 0-10 4-10 10v15h-9V17h9v9c0-5 6-9 13-9z"/></svg>
\ No newline at end of file

From 0bd21e7d8533e291ec1f838f13de5259f9a464f8 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 30 Jun 2024 23:54:06 +0900
Subject: [PATCH 16/19] chore: version packages (#153)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/famous-cheetahs-sneeze.md | 5 -----
 CHANGELOG.md                         | 6 ++++++
 docs/CHANGELOG.md                    | 7 +++++++
 docs/package.json                    | 2 +-
 package.json                         | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/famous-cheetahs-sneeze.md

diff --git a/.changeset/famous-cheetahs-sneeze.md b/.changeset/famous-cheetahs-sneeze.md
deleted file mode 100644
index f20b5a83..00000000
--- a/.changeset/famous-cheetahs-sneeze.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": minor
----
-
-fix: amountToHangul이 소수점, 숫자도 대응할 수 있도록 수정
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1e5583c4..aa48dffc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.4.0
+
+### Minor Changes
+
+- [#144](https://github.com/toss/es-hangul/pull/144) [`b114897`](https://github.com/toss/es-hangul/commit/b1148973e6c2b640ce528fc8ba4b8e2e034b90de) Thanks [@Collection50](https://github.com/Collection50)! - fix: amountToHangul이 소수점, 숫자도 대응할 수 있도록 수정
+
 ## 1.3.10
 
 ### Patch Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index adc357a5..43b723a4 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [[`b114897`](https://github.com/toss/es-hangul/commit/b1148973e6c2b640ce528fc8ba4b8e2e034b90de)]:
+  - es-hangul@1.4.0
+
 ## 0.1.6
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 2e1db525..cb05dd32 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index cc3f0c6f..b0e08ad8 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.3.10",
+  "version": "1.4.0",
   "keywords": [
     "한글",
     "한국어",

From f7e60aeca9f315ac1e34eba0a1f8a82f55d79956 Mon Sep 17 00:00:00 2001
From: Jonghyeon Ko <manudeli.ko@gmail.com>
Date: Mon, 1 Jul 2024 01:17:41 +0900
Subject: [PATCH 17/19] =?UTF-8?q?fix:=20=ED=8C=A8=ED=82=A4=EC=A7=80?=
 =?UTF-8?q?=EA=B0=80=20=EB=85=B8=EC=B6=9C=ED=95=98=EB=8A=94=20=EC=9D=B8?=
 =?UTF-8?q?=ED=84=B0=ED=8E=98=EC=9D=B4=EC=8A=A4=EB=A5=BC=20=EB=AA=85?=
 =?UTF-8?q?=ED=99=95=ED=9E=88=20=ED=95=98=EA=B8=B0=20=EC=9C=84=ED=95=B4=20?=
 =?UTF-8?q?index.ts=EB=A5=BC=20named=20export=EB=A1=9C=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95=ED=95=A9=EB=8B=88=EB=8B=A4=20(#157)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: exposing public apis strictly

* Create wild-cows-juggle.md
---
 .changeset/wild-cows-juggle.md |  5 +++++
 src/index.ts                   | 33 +++++++++++++++++++++------------
 2 files changed, 26 insertions(+), 12 deletions(-)
 create mode 100644 .changeset/wild-cows-juggle.md

diff --git a/.changeset/wild-cows-juggle.md b/.changeset/wild-cows-juggle.md
new file mode 100644
index 00000000..4dccf2ec
--- /dev/null
+++ b/.changeset/wild-cows-juggle.md
@@ -0,0 +1,5 @@
+---
+"es-hangul": patch
+---
+
+fix: 패키지가 노출하는 인터페이스를 명확히 하기 위해 index.ts를 named export로 수정합니다
diff --git a/src/index.ts b/src/index.ts
index ee3becfd..5e839a05 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,12 +1,21 @@
-export * from './assemble';
-export * from './chosungIncludes';
-export * from './combineHangulCharacter';
-export * from './convertQwertyToHangulAlphabet';
-export * from './disassemble';
-export * from './disassembleCompleteHangulCharacter';
-export * from './hangulIncludes';
-export * from './josa';
-export * from './removeLastHangulCharacter';
-export * from './utils';
-export * from './extractHangul';
-export * from './acronymizeHangul';
+export { assembleHangul } from './assemble';
+export { chosungIncludes } from './chosungIncludes';
+export { combineHangulCharacter, combineVowels, curriedCombineHangulCharacter } from './combineHangulCharacter';
+export { convertQwertyToHangul, convertQwertyToHangulAlphabet } from './convertQwertyToHangulAlphabet';
+export { disassembleHangul, disassembleHangulToGroups } from './disassemble';
+export { disassembleCompleteHangulCharacter } from './disassembleCompleteHangulCharacter';
+export { hangulIncludes } from './hangulIncludes';
+export { josa } from './josa';
+export { removeLastHangulCharacter } from './removeLastHangulCharacter';
+export {
+  canBeChosung,
+  canBeJongsung,
+  canBeJungsung,
+  getChosung,
+  hasBatchim,
+  hasProperty,
+  hasSingleBatchim,
+  hasValueInReadOnlyStringList,
+} from './utils';
+export { extractHangul } from './extractHangul';
+export { acronymizeHangul } from './acronymizeHangul';

From d58ba15678f6d50b00fcd6dbf1e6388e61b3143b Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 1 Jul 2024 01:19:25 +0900
Subject: [PATCH 18/19] chore: version packages (#160)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 .changeset/wild-cows-juggle.md | 5 -----
 CHANGELOG.md                   | 6 ++++++
 docs/CHANGELOG.md              | 7 +++++++
 docs/package.json              | 2 +-
 package.json                   | 2 +-
 5 files changed, 15 insertions(+), 7 deletions(-)
 delete mode 100644 .changeset/wild-cows-juggle.md

diff --git a/.changeset/wild-cows-juggle.md b/.changeset/wild-cows-juggle.md
deleted file mode 100644
index 4dccf2ec..00000000
--- a/.changeset/wild-cows-juggle.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"es-hangul": patch
----
-
-fix: 패키지가 노출하는 인터페이스를 명확히 하기 위해 index.ts를 named export로 수정합니다
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aa48dffc..2a30ae47 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # es-hangul
 
+## 1.4.1
+
+### Patch Changes
+
+- [#157](https://github.com/toss/es-hangul/pull/157) [`f7e60ae`](https://github.com/toss/es-hangul/commit/f7e60aeca9f315ac1e34eba0a1f8a82f55d79956) Thanks [@manudeli](https://github.com/manudeli)! - fix: 패키지가 노출하는 인터페이스를 명확히 하기 위해 index.ts를 named export로 수정합니다
+
 ## 1.4.0
 
 ### Minor Changes
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 43b723a4..8009477c 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,12 @@
 # docs
 
+## 0.1.8
+
+### Patch Changes
+
+- Updated dependencies [[`f7e60ae`](https://github.com/toss/es-hangul/commit/f7e60aeca9f315ac1e34eba0a1f8a82f55d79956)]:
+  - es-hangul@1.4.1
+
 ## 0.1.7
 
 ### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index cb05dd32..9269fa8e 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "docs",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "private": true,
   "packageManager": "yarn@4.1.1",
   "scripts": {
diff --git a/package.json b/package.json
index b0e08ad8..9f2f69e8 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "es-hangul",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "keywords": [
     "한글",
     "한국어",

From 11e0ba9b8762f25b321d208ba12ff7dc4510ae6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EB=B0=95=EC=B0=AC=ED=98=81?= <pgg6713@gmail.com>
Date: Wed, 3 Jul 2024 14:26:43 +0900
Subject: [PATCH 19/19] =?UTF-8?q?docs:=20CONTRIBUTING.md=20=ED=8C=8C?=
 =?UTF-8?q?=EC=9D=BC=EC=97=90=20=EB=A9=94=EC=84=9C=EB=93=9C=20=EC=BB=A8?=
 =?UTF-8?q?=EB=B2=A4=EC=85=98=EC=9D=84=20=EC=9E=91=EC=84=B1=ED=95=A9?=
 =?UTF-8?q?=EB=8B=88=EB=8B=A4.=20(#132)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update CONTRIBUTING.md

* fix

* write contribution.md

Co-authored-by: Jonghyeon Ko <61593290+manudeli@users.noreply.github.com>
Co-authored-by: Dongkyu Kim <55759551+po4tion@users.noreply.github.com>

* Update .github/CONTRIBUTING.md

Co-authored-by: Jonghyeon Ko <manudeli.ko@gmail.com>

* Update .github/CONTRIBUTING.md

Co-authored-by: Jonghyeon Ko <manudeli.ko@gmail.com>

* Update .github/CONTRIBUTING.md

Co-authored-by: Jonghyeon Ko <manudeli.ko@gmail.com>

---------

Co-authored-by: Jonghyeon Ko <61593290+manudeli@users.noreply.github.com>
Co-authored-by: Dongkyu Kim <55759551+po4tion@users.noreply.github.com>
Co-authored-by: Jonghyeon Ko <manudeli.ko@gmail.com>
---
 .github/CONTRIBUTING.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index 6d96350e..1bba496f 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -48,3 +48,30 @@
 ### 2.2 Description
 
 A clear and concise description of what the pr is about.
+
+## 3. Convention
+
+함수명에는 특별한 이유가 없다면 hangul을 포함하지 않습니다.
+
+```ts
+// Don't
+function getHangulSimilarity();
+// Do
+function getSimilarity();
+
+// Don't
+function disassembleHangul();
+// Do
+function disassemble();
+```
+
+함수명을 지을 때 아래와 같이 import될 것을 고려해야 합니다.
+
+```ts
+import { getSimilarity, disassemble, josa } from 'es-hangul' // 따로 나눠서도 제공
+import hangul from 'es-hangul' // hangul default export에 묶어서도 제공
+
+hangul.getSimilarity(...)
+hangul.disassemble(...)
+hangul.josa(...)
+