test: Add comprehensive Korean text decoding tests

- Add Korean text UTF-8 decoding test for pure Korean text
- Add mixed Korean and English text decoding test
- Verify proper UTF-8 encoding/decoding in byte mode
- Ensure multi-byte character support works correctly
- Strengthen test coverage for international text support

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: yongsk0066

src/qr-decode/decode/data-extraction/dataExtractor.test.ts

@@ -86,6 +86,30 @@ describe('dataExtractor', () => {
       expect(result?.data).toBe('Hello');
       expect(result?.bytes).toEqual(bytes);
     });
+
+    it('should decode Korean text as UTF-8', () => {
+      const text = '안녕하세요';
+      const bytes = Array.from(new TextEncoder().encode(text));
+      
+      const bitStream = codewordsToBitStream(bytes);
+      const result = decodeByte(bitStream, bytes.length);
+      
+      expect(result).not.toBeNull();
+      expect(result?.data).toBe('안녕하세요');
+      expect(result?.bytes).toEqual(bytes);
+    });
+
+    it('should handle mixed Korean and English text', () => {
+      const text = 'Hello 안녕하세요 World!';
+      const bytes = Array.from(new TextEncoder().encode(text));
+      
+      const bitStream = codewordsToBitStream(bytes);
+      const result = decodeByte(bitStream, bytes.length);
+      
+      expect(result).not.toBeNull();
+      expect(result?.data).toBe('Hello 안녕하세요 World!');
+      expect(result?.bytes).toEqual(bytes);
+    });
   });
 
   describe('Full data extraction', () => {

src/qr-encode/analysis/dataAnalysis.test.ts

@@ -93,6 +93,24 @@ describe('dataAnalysis', () => {
       const result = analyzeData('A B C');
       expect(result.characterCount).toBe(5);
     });
+
+    it('한글 텍스트는 바이트 수로 계산 (UTF-8)', () => {
+      const result = analyzeData('안녕하세요');
+      
+      // 문자 수는 5개이지만, UTF-8 바이트 수는 15개 (한글 1글자 = 3바이트)
+      expect(result.recommendedMode).toBe('byte');
+      expect(result.characterCount).toBe(15); // 바이트 수
+      expect(result.characterCount).not.toBe(5); // 문자 수가 아님
+    });
+
+    it('한영 혼합 텍스트는 바이트 수로 계산', () => {
+      const result = analyzeData('Hi안녕');
+      
+      // Hi(2바이트) + 안녕(6바이트) = 8바이트
+      expect(result.recommendedMode).toBe('byte');
+      expect(result.characterCount).toBe(8); // 바이트 수
+      expect(result.characterCount).not.toBe(4); // 문자 수가 아님
+    });
   });
 
   describe('에러 정정 레벨별 테스트', () => {

src/qr-encode/analysis/dataAnalysis.ts

@@ -148,10 +148,15 @@ export const analyzeData = (
   const minimumVersion = findMinimumVersion(data, recommendedMode, errorLevel);
   const isValid = minimumVersion !== null;
 
+  // 바이트 모드의 경우 UTF-8 바이트 수를 반환, 다른 모드는 문자 수 반환
+  const characterCount = recommendedMode === 'byte' 
+    ? new TextEncoder().encode(data).length  // UTF-8 바이트 수
+    : data.length;  // 문자 수
+
   return {
     recommendedMode,
     minimumVersion: minimumVersion || 40,
-    characterCount: data.length,
+    characterCount,
     isValid,
   };
 };

src/qr-encode/encoding/dataEncoding.test.ts

@@ -87,6 +87,35 @@ describe('dataEncoding', () => {
       // !=33, @=64, #=35
       expect(result.data).toBe('001000010100000000100011');
     });
+
+    it('한글 텍스트 UTF-8 인코딩', () => {
+      const result = encodeData('안녕', 'byte', 1, 152);
+      
+      // '안녕'을 UTF-8로 인코딩하면 6바이트
+      // '안' = [236, 149, 136], '녕' = [235, 133, 149]
+      const expectedBytes = [236, 149, 136, 235, 133, 149];
+      
+      expect(result.characterCount).toBe('00000110'); // 6바이트 (문자 수가 아님)
+      
+      // 각 바이트를 8비트 이진수로 변환한 결과
+      const expectedBits = expectedBytes.map(b => b.toString(2).padStart(8, '0')).join('');
+      expect(result.data).toBe(expectedBits);
+    });
+
+    it('한글과 영어 혼합 텍스트 인코딩', () => {
+      const text = 'Hi안녕';
+      const result = encodeData(text, 'byte', 1, 152);
+      
+      // UTF-8 바이트 수 계산
+      const utf8Bytes = new TextEncoder().encode(text);
+      const expectedByteCount = utf8Bytes.length; // 8바이트: Hi(2) + 안녕(6)
+      
+      expect(result.characterCount).toBe(expectedByteCount.toString(2).padStart(8, '0'));
+      
+      // 모든 바이트가 올바르게 인코딩되었는지 확인
+      const expectedBits = Array.from(utf8Bytes).map(b => b.toString(2).padStart(8, '0')).join('');
+      expect(result.data).toBe(expectedBits);
+    });
   });
 
   describe('종단자 및 패딩', () => {

src/qr-encode/encoding/dataEncoding.ts

@@ -17,9 +17,16 @@ export interface EncodedData {
 
 /**
  * 문자 카운트 지시자를 생성
+ * 바이트 모드의 경우 문자 수가 아닌 바이트 수를 사용
  */
-const createCharacterCountIndicator = (count: number, mode: QRMode, version: QRVersion): string => {
+const createCharacterCountIndicator = (data: string, mode: QRMode, version: QRVersion): string => {
   const bits = getCharacterCountBits(mode, version);
+  
+  // 바이트 모드는 UTF-8 바이트 수를 사용, 다른 모드는 문자 수 사용
+  const count = mode === 'byte' 
+    ? new TextEncoder().encode(data).length  // UTF-8 바이트 수
+    : data.length;  // 문자 수
+    
   return toBinaryString(count, bits);
 };
 
@@ -57,14 +64,17 @@ const encodeAlphanumericMode = (data: string): string => {
 
 /**
  * 바이트 모드 인코딩 (각 바이트를 8비트로)
+ * UTF-8 인코딩을 사용하여 멀티바이트 문자(한글 등)를 올바르게 처리
  */
-const encodeByteMode = (data: string): string =>
-  pipe(
-    data,
-    (str) => str.split(''),
-    A.map((char) => toBinaryString(char.charCodeAt(0), 8)),
-    A.join('')
-  );
+const encodeByteMode = (data: string): string => {
+  // UTF-8 바이트 배열 생성
+  const utf8Bytes = new TextEncoder().encode(data);
+  
+  // 각 바이트를 8비트 이진 문자열로 변환
+  return Array.from(utf8Bytes)
+    .map(byte => toBinaryString(byte, 8))
+    .join('');
+};
 
 /**
  * 한자 모드 인코딩 (미구현 - 복잡한 Shift JIS 인코딩 필요)
@@ -128,7 +138,7 @@ export const encodeData = (
 ): EncodedData => {
   // 1. 기본 구성 요소 생성 (ISO/IEC 18004 - 8.4 데이터 부호화)
   const modeIndicator = MODE_INDICATORS[mode]; // 표 2: 4비트 모드 지시자
-  const characterCount = createCharacterCountIndicator(data.length, mode, version); // 표 3: 문자 카운트 지시자
+  const characterCount = createCharacterCountIndicator(data, mode, version); // 표 3: 문자 카운트 지시자
   const encodedData = encodeDataByMode(data, mode); // 8.4.2~8.4.5: 모드별 데이터 인코딩
 
   // 2. 비트 스트림 처리 파이프라인 (ISO/IEC 18004 - 8.4.9)