feat : 문장의 각 단어 중 첫 문자만 뽑는 함수추가 ( #128 이슈에 대한 )

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(''); //버충카
+```

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(''); //버충카
+```

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');
+  });
+});

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));
+}

src/index.ts

@@ -8,3 +8,4 @@ export * from './hangulIncludes';
 export * from './josa';
 export * from './removeLastHangulCharacter';
 export * from './utils';
+export * from './getHangulAcronym';