jell-utils 0.1.0 → 0.2.0

package/internal-docs/OBSIDIAN_PROJECT_PROMPT.md

@@ -0,0 +1,302 @@
+# jell-utils.js - Obsidian 프로젝트 문서
+
+## 프로젝트 개요
+
+**프로젝트명**: jell-utils  
+**버전**: 0.1.0  
+**타입**: TypeScript 기반 NPM 패키지  
+**목적**: 개인용 JavaScript/TypeScript 유틸리티 함수 라이브러리  
+**저장소**: https://github.com/jellive/jell-utils.js  
+**NPM**: https://www.npmjs.com/package/jell-utils  
+**라이선스**: MIT  
+**작성자**: Jell <jellive7@gmail.com>
+
+## 프로젝트 상태
+
+- ✅ **배포 상태**: 활성 (npm에 배포됨)
+- ✅ **테스트**: 50개 테스트 케이스, 79.67% 커버리지
+- ✅ **빌드**: TypeScript → JavaScript 컴파일
+- ✅ **품질 관리**: ESLint, Prettier 적용
+- ✅ **CI/CD**: GitHub Actions (semantic-release)
+
+## 핵심 기능 카테고리
+
+### 1. 한국어 관련 기능
+
+- `isKorean(message: string)`: 한글 문자 포함 여부 검사
+- `isBusinessNumber(businessNumber: string)`: 사업자등록번호 유효성 검증 (체크섬 알고리즘)
+- `chosungSearch(str: string, search: string)`: 한글 초성 검색 (예: "ㄱㄴㄷ"로 "가나다" 검색)
+- `getKoreanDate(dateString, isYear)`: 한국식 날짜 포맷 (예: "3월 15일", "2024년 3월 15일")
+
+### 2. 문자열 처리
+
+- `parseTag(txt: string)`: HTML 엔티티 디코딩 (&lt; → <)
+- `toCamelCase(txt: string)`: snake_case → camelCase 변환
+- `toSnakeCase(txt: string)`: 일반 문자열 → snake_case 변환
+- `toTitleCase(txt: string)`: Title Case 변환 (첫 글자 대문자)
+- `toText(txt: string)`: HTML <br> → \n 변환
+- `toHtml(txt: string)`: \n → <br> 변환
+- `clearTag(txt: string, preserveErrorTags)`: XSS 방지하며 HTML 태그 제거
+- `replaceBetween(str, txt, startIndex, endIndex)`: 인덱스 기반 문자열 교체
+- `extractNumbers(str: string)`: 문자열에서 숫자만 추출
+- `maskString(str, visibleStart, visibleEnd, maskChar)`: 민감정보 마스킹 (예: 카드번호)
+- `getFileExtension(filename: string)`: 파일 확장자 추출
+
+### 3. 숫자 및 시간 파싱
+
+- `parseNumber(target: string, defaultValue: number, isFloat)`: 문자열을 숫자로 안전하게 파싱
+- `parseTime(target: string, defaultValue: number)`: 시간 문자열 파싱 (MM:SS, HH:MM:SS)
+
+### 4. 날짜 처리
+
+- `getNowDate()`: 현재 시간을 datetime 포맷으로 반환
+- `formatDate(date)`: yyyy-mm-dd 포맷으로 변환
+- `calDDay(date)`: D-day 계산
+- `dateDiff(date1, date2)`: 두 날짜 차이 계산 (일/시간/분/초 객체 반환)
+
+### 5. 객체 조작
+
+- `clone<T>(obj: T)`: 깊은 복사 (structuredClone 또는 JSON fallback)
+- `getByPath<T>(obj, path, defaultValue)`: 경로 문자열로 중첩 객체 값 가져오기 (예: 'user.profile.name')
+- `setByPath(obj, path, value)`: 경로 문자열로 중첩 객체 값 설정
+- `deepMerge<T>(target, source)`: 객체 깊은 병합
+- `objectToQueryString(obj)`: 객체를 URL 쿼리 스트링으로 변환
+
+### 6. 배열 조작
+
+- `equalArrays(a, b)`: 배열 비교 (얕은 비교)
+- `groupBy<T>(array, key)`: 배열을 특정 키로 그룹화
+- `sortBy<T>(array, key, order)`: 객체 배열 정렬 (asc/desc)
+
+### 7. 비동기 처리
+
+- `retry<T>(fn, maxRetries, delay)`: exponential backoff로 비동기 함수 재시도
+
+### 8. 브라우저 유틸리티
+
+- `isiOS()`: iOS 기기 감지 (User Agent 기반)
+
+## 기술 스택
+
+### 언어 및 런타임
+
+- TypeScript 5.2.2
+- Node.js (ES6+)
+
+### 개발 도구
+
+- **빌드**: TypeScript Compiler (tsc)
+- **테스트**: Jest 29.7.0 + ts-jest
+- **린트**: ESLint + @typescript-eslint
+- **포맷팅**: Prettier
+- **CI/CD**: semantic-release + GitHub Actions
+
+### 의존성 관리
+
+- npm (주)
+- yarn (부)
+
+## 프로젝트 구조
+
+```
+jell-utils.js/
+├── src/
+│   └── index.ts           # 메인 소스 파일 (모든 유틸 함수)
+├── lib/
+│   ├── index.js           # 컴파일된 JavaScript
+│   └── index.d.ts         # TypeScript 타입 정의
+├── __tests__/
+│   ├── korean.test.ts     # 한국어 관련 테스트
+│   ├── string.test.ts     # 문자열 처리 테스트
+│   ├── number.test.ts     # 숫자/시간 파싱 테스트
+│   ├── date.test.ts       # 날짜 처리 테스트
+│   ├── object.test.ts     # 객체 조작 테스트
+│   ├── array.test.ts      # 배열 조작 테스트
+│   └── async.test.ts      # 비동기 처리 테스트
+├── coverage/              # 테스트 커버리지 리포트
+├── .github/workflows/     # GitHub Actions CI/CD
+├── package.json
+├── tsconfig.json
+├── jestconfig.json
+└── .npmrc                 # npm 인증 토큰 (gitignore)
+```
+
+## 개발 워크플로우
+
+### 로컬 개발
+
+```bash
+# 의존성 설치
+npm install
+
+# 빌드
+npm run build
+
+# 테스트
+npm test
+npm run test:coverage
+
+# 린트
+npm run lint
+npm run lint:fix
+
+# 포맷팅
+npm run format
+```
+
+### 배포 프로세스
+
+```bash
+# 1. 변경사항 커밋
+git add .
+git commit -m "feat: new feature description"
+git push
+
+# 2. 버전 업데이트
+npm version patch   # 버그 수정
+npm version minor   # 새 기능
+npm version major   # Breaking changes
+
+# 3. 배포 (자동으로 test + lint + build 실행)
+npm publish
+```
+
+### Git Workflow
+
+- **브랜치**: master (메인 브랜치)
+- **커밋 컨벤션**: Conventional Commits
+  - `feat:` - 새 기능 (MINOR)
+  - `fix:` - 버그 수정 (PATCH)
+  - `docs:` - 문서 변경
+  - `chore:` - 빌드/설정 변경
+  - `BREAKING CHANGE:` - Breaking changes (MAJOR)
+
+## 품질 관리
+
+### 테스트 커버리지
+
+- **Statements**: 79.67%
+- **Branch**: 73.38%
+- **Functions**: 88.88%
+- **Lines**: 82.81%
+- **총 테스트**: 50개 (모두 통과)
+
+### 자동화된 검증
+
+- `prepublishOnly`: 배포 전 test + lint 자동 실행
+- `prepare`: 빌드 전 자동 실행
+- GitHub Actions: PR 및 push 시 CI 자동 실행
+
+## 사용 예시
+
+```typescript
+import util from 'jell-utils'
+
+// 한국어 검증
+util.isKorean('안녕하세요') // true
+util.isBusinessNumber('1018626554') // true
+util.chosungSearch('김철수', 'ㄱㅊㅅ') // true
+
+// 문자열 처리
+util.toCamelCase('hello_world') // 'helloWorld'
+util.maskString('1234567890', 3, 3) // '123****890'
+
+// 객체 조작
+const obj = { user: { profile: { name: 'John' } } }
+util.getByPath(obj, 'user.profile.name') // 'John'
+
+// 배열 처리
+const items = [{ age: 30 }, { age: 25 }, { age: 35 }]
+util.sortBy(items, 'age', 'asc') // age 기준 오름차순 정렬
+
+// 비동기 재시도
+await util.retry(
+  async () => {
+    return await fetchData()
+  },
+  3,
+  1000
+) // 3번 재시도, 1초 간격
+```
+
+## 주요 이정표
+
+### v0.0.x (초기 버전)
+
+- 기본 유틸리티 함수 구현
+- 한국어 관련 기능
+
+### v0.1.0 (2025-10-11) ✨ 현재 버전
+
+- 50개 포괄적인 테스트 케이스 추가
+- 한국어 특화 기능 강화 (사업자등록번호, 초성 검색)
+- 객체/배열 고급 조작 함수 추가
+- 비동기 retry 유틸리티 추가
+- 테스트 커버리지 79.67% 달성
+- ESLint strict 모드 적용 (any 타입 제거)
+- npm 배포 자동화 개선
+
+## 향후 계획
+
+### 단기 (v0.2.0)
+
+- [ ] 추가 한국어 유틸리티 (주민등록번호 검증, 한글 자모 분리 등)
+- [ ] 테스트 커버리지 90% 이상 달성
+- [ ] 브라우저 호환성 테스트 추가
+- [ ] 성능 벤치마크 추가
+
+### 중기 (v0.x.x)
+
+- [ ] Tree-shaking 지원 (개별 함수 import)
+- [ ] 웹 워커 지원
+- [ ] React hooks 버전 제공
+- [ ] 더 많은 날짜/시간 유틸리티
+
+### 장기 (v1.0.0)
+
+- [ ] 안정화 및 API freeze
+- [ ] 완전한 문서화 (JSDoc + 사이트)
+- [ ] 플러그인 시스템
+- [ ] 다국어 지원 확장
+
+## 알려진 이슈
+
+- TypeScript 5.9.2 사용 중 (ESLint는 5.4.0 미만 권장)
+- jest의 ts-jest 경고 (allowJs 설정 관련)
+- Git push 권한 문제 (credential 재설정 필요)
+
+## 참고 문서
+
+- [NPM 배포 가이드](./NPM_DEPLOYMENT_GUIDE.md) - 로컬 전용
+- [GitHub Repository](https://github.com/jellive/jell-utils.js)
+- [NPM Package](https://www.npmjs.com/package/jell-utils)
+- [블로그](https://blog.jell.kr)
+
+## 프로젝트 관리 메타데이터
+
+**프로젝트 타입**: 오픈소스 라이브러리  
+**유지보수 상태**: 활발히 개발 중  
+**기여 가능 여부**: Yes (MIT 라이선스)  
+**주 사용자**: 개인 프로젝트 (공개)  
+**업데이트 주기**: 기능 추가 시 비정기적  
+**최종 업데이트**: 2025-10-11 (v0.1.0 배포)
+
+---
+
+## Obsidian 태그
+
+#project #typescript #npm #utilities #korean #open-source #active #library
+
+## 연관 프로젝트
+
+- (여기에 이 라이브러리를 사용하는 다른 프로젝트 링크 추가)
+
+## 노트
+
+- 이 라이브러리는 개인 프로젝트에서 자주 사용하는 패턴들을 모아놓은 것
+- 한국어 특화 기능이 강점
+- TypeScript로 작성되어 타입 안정성 보장
+- 테스트 커버리지가 높아 안정적
+
+
+

package/lib/index.d.ts

@@ -211,5 +211,93 @@ declare const util: {
      * @returns masked string
      */
     maskString: (str: string, visibleStart?: number, visibleEnd?: number, maskChar?: string) => string;
+    /**
+     * @description Format date with custom format tokens
+     * @param date Date object or date string
+     * @param format Format string with tokens (YYYY, MM, DD, HH, mm, ss, ddd, dddd)
+     * @returns Formatted date string
+     */
+    formatDateAdvanced: (date: Date | string, format: string) => string;
+    /**
+     * @description Get relative time string in Korean
+     * @param date Date object or date string
+     * @returns Korean relative time string (e.g., '방금 전', '5분 전', '어제')
+     */
+    timeAgo: (date: Date | string) => string;
+    /**
+     * @description Get the number of days in a month
+     * @param year Year (e.g., 2025)
+     * @param month Month (1-12)
+     * @returns Number of days in the month
+     */
+    getDaysInMonth: (year: number, month: number) => number;
+    /**
+     * @description Check if a year is a leap year
+     * @param year Year to check
+     * @returns true if leap year, false otherwise
+     */
+    isLeapYear: (year: number) => boolean;
+    /**
+     * @description Format number with thousand separators
+     * @param num Number to format
+     * @returns Formatted string with commas
+     */
+    formatNumber: (num: number) => string;
+    /**
+     * @description Format number as currency
+     * @param amount Amount to format
+     * @param currency Currency code (KRW, USD, EUR, JPY, CNY)
+     * @returns Formatted currency string
+     */
+    formatCurrency: (amount: number, currency?: "KRW" | "USD" | "EUR" | "JPY" | "CNY") => string;
+    /**
+     * @description Format bytes to human-readable file size
+     * @param bytes Number of bytes
+     * @param precision Decimal precision (default: 0 for B/KB, 2 for larger)
+     * @returns Formatted file size string
+     */
+    formatFileSize: (bytes: number, precision?: number) => string;
+    /**
+     * @description Convert number to Korean words
+     * @param num Number to convert
+     * @returns Korean number string (e.g., '천이백삼십사')
+     */
+    numberToKorean: (num: number) => string;
+    /**
+     * @description Parse number from formatted string
+     * @param str String containing number (with commas, currency symbols, etc.)
+     * @returns Parsed number
+     */
+    parseNumberFromString: (str: string) => number;
+    /**
+     * @description Validate email address
+     * @param email Email address to validate
+     * @returns true if valid email, false otherwise
+     */
+    isEmail: (email: string) => boolean;
+    /**
+     * @description Validate Korean phone number
+     * @param phone Phone number to validate
+     * @returns true if valid Korean phone number, false otherwise
+     */
+    isPhoneNumber: (phone: string) => boolean;
+    /**
+     * @description Validate URL
+     * @param url URL to validate
+     * @returns true if valid URL, false otherwise
+     */
+    isUrl: (url: string) => boolean;
+    /**
+     * @description Format Korean phone number with hyphens
+     * @param phone Phone number to format
+     * @returns Formatted phone number
+     */
+    formatPhoneNumber: (phone: string) => string;
+    /**
+     * @description Format Korean business registration number
+     * @param brn Business registration number
+     * @returns Formatted business number (XXX-XX-XXXXX)
+     */
+    formatBusinessNumber: (brn: string) => string;
 };
 export default util;

package/lib/index.js

@@ -653,6 +653,281 @@ var util = {
         var end = str.substring(str.length - visibleEnd);
         var masked = maskChar.repeat(str.length - visibleStart - visibleEnd);
         return start + masked + end;
+    },
+    // ==================== Date Utilities (v0.2.0) ====================
+    /**
+     * @description Format date with custom format tokens
+     * @param date Date object or date string
+     * @param format Format string with tokens (YYYY, MM, DD, HH, mm, ss, ddd, dddd)
+     * @returns Formatted date string
+     */
+    formatDateAdvanced: function (date, format) {
+        var d = new Date(date);
+        var weekdays = [
+            '일요일',
+            '월요일',
+            '화요일',
+            '수요일',
+            '목요일',
+            '금요일',
+            '토요일'
+        ];
+        var replacements = {
+            YYYY: d.getFullYear().toString(),
+            MM: (d.getMonth() + 1).toString().padStart(2, '0'),
+            DD: d.getDate().toString().padStart(2, '0'),
+            HH: d.getHours().toString().padStart(2, '0'),
+            mm: d.getMinutes().toString().padStart(2, '0'),
+            ss: d.getSeconds().toString().padStart(2, '0'),
+            dddd: weekdays[d.getDay()],
+            ddd: weekdays[d.getDay()].charAt(0)
+        };
+        var result = format;
+        // Replace longer tokens first to avoid partial matches
+        var tokens = ['YYYY', 'dddd', 'ddd', 'MM', 'DD', 'HH', 'mm', 'ss'];
+        for (var _i = 0, tokens_1 = tokens; _i < tokens_1.length; _i++) {
+            var token = tokens_1[_i];
+            result = result.replace(new RegExp(token, 'g'), replacements[token]);
+        }
+        return result;
+    },
+    /**
+     * @description Get relative time string in Korean
+     * @param date Date object or date string
+     * @returns Korean relative time string (e.g., '방금 전', '5분 전', '어제')
+     */
+    timeAgo: function (date) {
+        var now = Date.now();
+        var past = new Date(date).getTime();
+        var diff = now - past;
+        var minute = 60 * 1000;
+        var hour = 60 * minute;
+        var day = 24 * hour;
+        var week = 7 * day;
+        var month = 30 * day;
+        var year = 365 * day;
+        if (diff < minute)
+            return '방금 전';
+        if (diff < hour)
+            return "".concat(Math.floor(diff / minute), "\uBD84 \uC804");
+        if (diff < day)
+            return "".concat(Math.floor(diff / hour), "\uC2DC\uAC04 \uC804");
+        if (diff < 2 * day)
+            return '어제';
+        if (diff < week)
+            return "".concat(Math.floor(diff / day), "\uC77C \uC804");
+        if (diff < month)
+            return "".concat(Math.floor(diff / week), "\uC8FC \uC804");
+        if (diff < year)
+            return "".concat(Math.floor(diff / month), "\uAC1C\uC6D4 \uC804");
+        return "".concat(Math.floor(diff / year), "\uB144 \uC804");
+    },
+    /**
+     * @description Get the number of days in a month
+     * @param year Year (e.g., 2025)
+     * @param month Month (1-12)
+     * @returns Number of days in the month
+     */
+    getDaysInMonth: function (year, month) {
+        return new Date(year, month, 0).getDate();
+    },
+    /**
+     * @description Check if a year is a leap year
+     * @param year Year to check
+     * @returns true if leap year, false otherwise
+     */
+    isLeapYear: function (year) {
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    },
+    // ==================== Number Utilities (v0.2.0) ====================
+    /**
+     * @description Format number with thousand separators
+     * @param num Number to format
+     * @returns Formatted string with commas
+     */
+    formatNumber: function (num) {
+        return num.toLocaleString('en-US');
+    },
+    /**
+     * @description Format number as currency
+     * @param amount Amount to format
+     * @param currency Currency code (KRW, USD, EUR, JPY, CNY)
+     * @returns Formatted currency string
+     */
+    formatCurrency: function (amount, currency) {
+        if (currency === void 0) { currency = 'KRW'; }
+        var formatted = util.formatNumber(amount);
+        var symbols = {
+            KRW: { symbol: '원', prefix: false },
+            USD: { symbol: '$', prefix: true },
+            EUR: { symbol: '€', prefix: true },
+            JPY: { symbol: '¥', prefix: true },
+            CNY: { symbol: '¥', prefix: true }
+        };
+        var _a = symbols[currency], symbol = _a.symbol, prefix = _a.prefix;
+        return prefix ? "".concat(symbol).concat(formatted) : "".concat(formatted).concat(symbol);
+    },
+    /**
+     * @description Format bytes to human-readable file size
+     * @param bytes Number of bytes
+     * @param precision Decimal precision (default: 0 for B/KB, 2 for larger)
+     * @returns Formatted file size string
+     */
+    formatFileSize: function (bytes, precision) {
+        var units = ['B', 'KB', 'MB', 'GB', 'TB'];
+        var size = bytes;
+        var unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        var decimals = precision !== undefined ? precision : unitIndex === 0 ? 0 : 0;
+        return "".concat(size.toFixed(decimals), " ").concat(units[unitIndex]);
+    },
+    /**
+     * @description Convert number to Korean words
+     * @param num Number to convert
+     * @returns Korean number string (e.g., '천이백삼십사')
+     */
+    numberToKorean: function (num) {
+        if (num === 0)
+            return '영';
+        var digits = ['', '일', '이', '삼', '사', '오', '육', '칠', '팔', '구'];
+        var units = ['', '십', '백', '천'];
+        var bigUnits = ['', '만', '억', '조'];
+        var processGroup = function (n) {
+            var result = '';
+            var temp = n;
+            for (var i = 3; i >= 0; i--) {
+                var digit = Math.floor(temp / Math.pow(10, i));
+                temp %= Math.pow(10, i);
+                if (digit > 0) {
+                    // Omit '일' before 십, 백, 천 (but not for units[0])
+                    if (digit > 1 || i === 0) {
+                        result += digits[digit];
+                    }
+                    result += units[i];
+                }
+            }
+            return result;
+        };
+        var result = '';
+        var groupIndex = 0;
+        var remaining = num;
+        while (remaining > 0) {
+            var group = remaining % 10000;
+            if (group > 0) {
+                var groupStr = processGroup(group);
+                // '만' 단위에서 1은 생략, '억' 이상에서는 '일' 포함
+                if (group === 1 && groupIndex >= 1) {
+                    if (groupIndex >= 2) {
+                        // 억 이상: '일억', '일조'
+                        result = '일' + bigUnits[groupIndex] + result;
+                    }
+                    else {
+                        // 만: '만' (일 생략)
+                        result = bigUnits[groupIndex] + result;
+                    }
+                }
+                else {
+                    result = groupStr + bigUnits[groupIndex] + result;
+                }
+            }
+            remaining = Math.floor(remaining / 10000);
+            groupIndex++;
+        }
+        return result;
+    },
+    /**
+     * @description Parse number from formatted string
+     * @param str String containing number (with commas, currency symbols, etc.)
+     * @returns Parsed number
+     */
+    parseNumberFromString: function (str) {
+        var cleaned = str.replace(/[^0-9.-]/g, '');
+        return parseFloat(cleaned);
+    },
+    // ==================== Validation Utilities (v0.2.0) ====================
+    /**
+     * @description Validate email address
+     * @param email Email address to validate
+     * @returns true if valid email, false otherwise
+     */
+    isEmail: function (email) {
+        var emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+        return emailRegex.test(email);
+    },
+    /**
+     * @description Validate Korean phone number
+     * @param phone Phone number to validate
+     * @returns true if valid Korean phone number, false otherwise
+     */
+    isPhoneNumber: function (phone) {
+        var mobileRegex = /^01[016789]-?\d{3,4}-?\d{4}$/;
+        var landlineRegex = /^0[2-6][1-5]?-?\d{3,4}-?\d{4}$/;
+        return mobileRegex.test(phone) || landlineRegex.test(phone);
+    },
+    /**
+     * @description Validate URL
+     * @param url URL to validate
+     * @returns true if valid URL, false otherwise
+     */
+    isUrl: function (url) {
+        try {
+            var parsed = new URL(url);
+            return ['http:', 'https:', 'ftp:'].includes(parsed.protocol);
+        }
+        catch (_a) {
+            return false;
+        }
+    },
+    /**
+     * @description Format Korean phone number with hyphens
+     * @param phone Phone number to format
+     * @returns Formatted phone number
+     */
+    formatPhoneNumber: function (phone) {
+        var digits = phone.replace(/[^0-9]/g, '');
+        if (digits.startsWith('02')) {
+            // Seoul: 02-XXXX-XXXX
+            if (digits.length === 10) {
+                return "".concat(digits.slice(0, 2), "-").concat(digits.slice(2, 6), "-").concat(digits.slice(6));
+            }
+            else if (digits.length === 9) {
+                return "".concat(digits.slice(0, 2), "-").concat(digits.slice(2, 5), "-").concat(digits.slice(5));
+            }
+        }
+        else if (digits.startsWith('01')) {
+            // Mobile: 01X-XXXX-XXXX or 01X-XXX-XXXX
+            if (digits.length === 11) {
+                return "".concat(digits.slice(0, 3), "-").concat(digits.slice(3, 7), "-").concat(digits.slice(7));
+            }
+            else if (digits.length === 10) {
+                return "".concat(digits.slice(0, 3), "-").concat(digits.slice(3, 6), "-").concat(digits.slice(6));
+            }
+        }
+        else if (/^0[3-6]/.test(digits)) {
+            // Area code: 0XX-XXXX-XXXX
+            if (digits.length === 11) {
+                return "".concat(digits.slice(0, 3), "-").concat(digits.slice(3, 7), "-").concat(digits.slice(7));
+            }
+            else if (digits.length === 10) {
+                return "".concat(digits.slice(0, 3), "-").concat(digits.slice(3, 6), "-").concat(digits.slice(6));
+            }
+        }
+        return phone;
+    },
+    /**
+     * @description Format Korean business registration number
+     * @param brn Business registration number
+     * @returns Formatted business number (XXX-XX-XXXXX)
+     */
+    formatBusinessNumber: function (brn) {
+        var digits = brn.replace(/[^0-9]/g, '');
+        if (digits.length !== 10) {
+            return brn;
+        }
+        return "".concat(digits.slice(0, 3), "-").concat(digits.slice(3, 5), "-").concat(digits.slice(5));
     }
 };
 exports.default = util;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jell-utils",
-  "version": "0.1.0",
-  "description": "This is personal used function collection.",
+  "version": "0.2.0",
+  "description": "Korean-specialized TypeScript utility library with date, number, string, and validation utilities.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "author": "Jell <jellive7@gmail.com> (https://blog.jell.kr)",
@@ -15,7 +15,15 @@
     "string-manipulation",
     "date-formatting",
     "korean-language",
-    "browser-utilities"
+    "browser-utilities",
+    "date-utils",
+    "number-formatting",
+    "validation",
+    "korean-utils",
+    "file-size",
+    "currency-formatting",
+    "phone-number",
+    "business-number"
   ],
   "repository": {
     "type": "git",