jell-utils 0.1.0 → 0.2.0

package/coverage/lcov.info

@@ -63,8 +63,23 @@ FN:626,(anonymous_59)
 FN:628,(anonymous_60)
 FN:632,(anonymous_61)
 FN:646,(anonymous_62)
-FNF:63
-FNH:56
+FN:664,(anonymous_63)
+FN:699,(anonymous_64)
+FN:731,(anonymous_65)
+FN:739,(anonymous_66)
+FN:748,(anonymous_67)
+FN:757,(anonymous_68)
+FN:776,(anonymous_69)
+FN:792,(anonymous_70)
+FN:798,(anonymous_71)
+FN:846,(anonymous_72)
+FN:856,(anonymous_73)
+FN:865,(anonymous_74)
+FN:875,(anonymous_75)
+FN:889,(anonymous_76)
+FN:925,(anonymous_77)
+FNF:78
+FNH:71
 FNDA:1,(anonymous_0)
 FNDA:0,(anonymous_1)
 FNDA:3,(anonymous_2)
@@ -105,7 +120,7 @@ FNDA:0,(anonymous_36)
 FNDA:0,(anonymous_37)
 FNDA:3,(anonymous_38)
 FNDA:0,(anonymous_39)
-FNDA:6,(anonymous_40)
+FNDA:15,(anonymous_40)
 FNDA:2,(anonymous_41)
 FNDA:2,(anonymous_42)
 FNDA:1,(anonymous_43)
@@ -128,7 +143,22 @@ FNDA:2,(anonymous_59)
 FNDA:6,(anonymous_60)
 FNDA:4,(anonymous_61)
 FNDA:3,(anonymous_62)
-DA:2,7
+FNDA:6,(anonymous_63)
+FNDA:8,(anonymous_64)
+FNDA:4,(anonymous_65)
+FNDA:4,(anonymous_66)
+FNDA:10,(anonymous_67)
+FNDA:5,(anonymous_68)
+FNDA:5,(anonymous_69)
+FNDA:13,(anonymous_70)
+FNDA:13,(anonymous_71)
+FNDA:5,(anonymous_72)
+FNDA:9,(anonymous_73)
+FNDA:8,(anonymous_74)
+FNDA:8,(anonymous_75)
+FNDA:4,(anonymous_76)
+FNDA:3,(anonymous_77)
+DA:2,8
 DA:3,1
 DA:4,0
 DA:5,0
@@ -136,14 +166,14 @@ DA:6,0
 DA:7,0
 DA:9,0
 DA:11,1
-DA:13,7
+DA:13,8
 DA:14,9
 DA:15,3
 DA:16,5
 DA:17,4
 DA:18,11
 DA:19,3
-DA:22,7
+DA:22,8
 DA:23,19
 DA:24,9
 DA:25,27
@@ -165,14 +195,14 @@ DA:42,6
 DA:44,38
 DA:45,77
 DA:46,9
-DA:49,7
+DA:49,8
 DA:50,5
 DA:51,10
 DA:52,0
 DA:53,0
 DA:56,5
-DA:58,7
-DA:59,7
+DA:58,8
+DA:59,8
 DA:66,5
 DA:67,5
 DA:75,5
@@ -294,17 +324,17 @@ DA:354,6
 DA:355,1
 DA:357,1
 DA:364,0
-DA:372,6
-DA:373,6
-DA:374,3
-DA:375,3
-DA:376,3
-DA:377,3
-DA:378,3
-DA:379,27
-DA:381,3
-DA:382,3
-DA:383,3
+DA:372,15
+DA:373,15
+DA:374,5
+DA:375,10
+DA:376,10
+DA:377,10
+DA:378,10
+DA:379,90
+DA:381,10
+DA:382,10
+DA:383,10
 DA:393,2
 DA:394,2
 DA:395,2
@@ -418,19 +448,131 @@ DA:652,2
 DA:653,2
 DA:654,2
 DA:655,2
-DA:658,7
-LF:291
-LH:241
-BRDA:2,0,0,7
-BRDA:2,0,1,7
-BRDA:2,0,2,7
+DA:665,6
+DA:666,6
+DA:675,6
+DA:685,6
+DA:687,6
+DA:688,6
+DA:689,48
+DA:690,48
+DA:692,6
+DA:700,8
+DA:701,8
+DA:702,8
+DA:703,8
+DA:704,8
+DA:705,8
+DA:706,8
+DA:707,8
+DA:708,8
+DA:709,8
+DA:710,1
+DA:711,7
+DA:712,1
+DA:713,6
+DA:714,1
+DA:715,5
+DA:716,1
+DA:717,4
+DA:718,1
+DA:719,3
+DA:720,1
+DA:721,2
+DA:722,1
+DA:723,1
+DA:732,4
+DA:740,4
+DA:749,10
+DA:758,5
+DA:759,5
+DA:760,5
+DA:767,5
+DA:768,5
+DA:777,5
+DA:778,5
+DA:779,5
+DA:780,5
+DA:781,7
+DA:782,7
+DA:784,5
+DA:785,5
+DA:793,13
+DA:794,1
+DA:795,12
+DA:796,12
+DA:797,12
+DA:798,12
+DA:799,13
+DA:800,13
+DA:801,13
+DA:802,52
+DA:803,52
+DA:804,52
+DA:806,23
+DA:807,17
+DA:809,23
+DA:812,13
+DA:814,12
+DA:815,12
+DA:816,12
+DA:817,12
+DA:818,16
+DA:819,16
+DA:820,13
+DA:822,13
+DA:823,3
+DA:825,1
+DA:829,2
+DA:833,10
+DA:836,16
+DA:837,16
+DA:839,12
+DA:847,5
+DA:848,5
+DA:857,9
+DA:858,9
+DA:866,8
+DA:867,8
+DA:868,8
+DA:876,8
+DA:877,8
+DA:878,5
+DA:881,3
+DA:890,4
+DA:891,4
+DA:893,1
+DA:894,1
+DA:896,0
+DA:897,0
+DA:900,3
+DA:902,2
+DA:903,2
+DA:905,0
+DA:906,0
+DA:909,1
+DA:911,1
+DA:912,1
+DA:914,0
+DA:915,0
+DA:918,0
+DA:926,3
+DA:927,3
+DA:928,1
+DA:930,2
+DA:933,8
+LF:403
+LH:346
+BRDA:2,0,0,8
+BRDA:2,0,1,8
+BRDA:2,0,2,8
 BRDA:3,1,0,1
 BRDA:3,1,1,0
 BRDA:6,2,0,0
 BRDA:6,2,1,0
-BRDA:13,3,0,7
-BRDA:13,3,1,7
-BRDA:13,3,2,7
+BRDA:13,3,0,8
+BRDA:13,3,1,8
+BRDA:13,3,2,8
 BRDA:14,4,0,9
 BRDA:14,4,1,0
 BRDA:15,5,0,3
@@ -439,9 +581,9 @@ BRDA:18,6,0,2
 BRDA:18,6,1,9
 BRDA:19,7,0,3
 BRDA:19,7,1,0
-BRDA:22,8,0,7
-BRDA:22,8,1,7
-BRDA:22,8,2,7
+BRDA:22,8,0,8
+BRDA:22,8,1,8
+BRDA:22,8,2,8
 BRDA:23,9,0,4
 BRDA:23,9,1,15
 BRDA:23,10,0,9
@@ -502,9 +644,9 @@ BRDA:46,33,0,1
 BRDA:46,33,1,8
 BRDA:46,34,0,8
 BRDA:46,34,1,0
-BRDA:49,35,0,7
-BRDA:49,35,1,7
-BRDA:49,35,2,7
+BRDA:49,35,0,8
+BRDA:49,35,1,8
+BRDA:49,35,2,8
 BRDA:50,36,0,5
 BRDA:50,36,1,0
 BRDA:50,37,0,5
@@ -609,8 +751,8 @@ BRDA:351,85,0,1
 BRDA:351,85,1,2
 BRDA:354,86,0,1
 BRDA:354,86,1,5
-BRDA:373,87,0,3
-BRDA:373,87,1,3
+BRDA:373,87,0,5
+BRDA:373,87,1,10
 BRDA:397,88,0,1
 BRDA:397,88,1,5
 BRDA:397,89,0,6
@@ -684,6 +826,71 @@ BRDA:649,117,0,3
 BRDA:649,117,1,0
 BRDA:650,118,0,1
 BRDA:650,118,1,2
-BRF:263
-BRH:193
+BRDA:709,119,0,1
+BRDA:709,119,1,7
+BRDA:711,120,0,1
+BRDA:711,120,1,6
+BRDA:713,121,0,1
+BRDA:713,121,1,5
+BRDA:715,122,0,1
+BRDA:715,122,1,4
+BRDA:717,123,0,1
+BRDA:717,123,1,3
+BRDA:719,124,0,1
+BRDA:719,124,1,2
+BRDA:721,125,0,1
+BRDA:721,125,1,1
+BRDA:740,126,0,4
+BRDA:740,126,1,3
+BRDA:740,126,2,3
+BRDA:758,127,0,2
+BRDA:758,127,1,3
+BRDA:768,128,0,3
+BRDA:768,128,1,2
+BRDA:780,129,0,12
+BRDA:780,129,1,7
+BRDA:784,130,0,1
+BRDA:784,130,1,4
+BRDA:784,131,0,1
+BRDA:784,131,1,3
+BRDA:793,132,0,1
+BRDA:793,132,1,12
+BRDA:804,133,0,23
+BRDA:804,133,1,29
+BRDA:806,134,0,17
+BRDA:806,134,1,6
+BRDA:806,135,0,23
+BRDA:806,135,1,10
+BRDA:819,136,0,13
+BRDA:819,136,1,3
+BRDA:822,137,0,3
+BRDA:822,137,1,10
+BRDA:822,138,0,13
+BRDA:822,138,1,4
+BRDA:823,139,0,1
+BRDA:823,139,1,2
+BRDA:868,140,0,8
+BRDA:868,140,1,5
+BRDA:891,141,0,1
+BRDA:891,141,1,3
+BRDA:893,142,0,1
+BRDA:893,142,1,0
+BRDA:896,143,0,0
+BRDA:896,143,1,0
+BRDA:900,144,0,2
+BRDA:900,144,1,1
+BRDA:902,145,0,2
+BRDA:902,145,1,0
+BRDA:905,146,0,0
+BRDA:905,146,1,0
+BRDA:909,147,0,1
+BRDA:909,147,1,0
+BRDA:911,148,0,1
+BRDA:911,148,1,0
+BRDA:914,149,0,0
+BRDA:914,149,1,0
+BRDA:927,150,0,1
+BRDA:927,150,1,2
+BRF:328
+BRH:248
 end_of_record

package/internal-docs/CLAUDE.md

@@ -0,0 +1,139 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a TypeScript utility library (`jell-utils`) containing utility functions primarily focused on:
+- Korean text processing and detection
+- Date/time manipulation and formatting 
+- String transformations (camelCase, snake_case, title case)
+- HTML/text parsing and cleaning
+- Array comparison utilities
+- iOS device detection
+
+The library is designed for both browser and Node.js environments, with compiled output in CommonJS format.
+
+## Development Commands
+
+### Build & Compilation
+```bash
+# Build TypeScript to JavaScript (outputs to lib/ directory)
+yarn build
+# or
+npm run build
+```
+
+### Testing
+```bash
+# Run all tests using Jest
+yarn test
+# or
+npm test
+
+# Test files are in __tests__/ directory
+# Tests are written for TypeScript but run against compiled JS in lib/
+```
+
+### Code Quality
+```bash
+# Lint TypeScript files
+yarn lint
+# or
+npm run lint
+
+# Auto-fix linting issues
+yarn lint:fix
+# or
+npm run lint:fix
+
+# Format code with Prettier
+yarn format
+# or
+npm run format
+```
+
+### Publishing Workflow
+```bash
+# Pre-publish checks (runs test, lint, and lint:fix)
+yarn prepublishOnly
+
+# Version management (includes linting and formatting)
+yarn preversion  # lint check
+yarn version     # format and git add
+yarn postversion # git push with tags
+```
+
+## Architecture & Structure
+
+### Core Module Structure
+- **Source**: `src/index.ts` - Single file containing all utility functions as a default export object
+- **Compiled Output**: `lib/index.js` + `lib/index.d.ts` - ES5 CommonJS with TypeScript declarations
+- **Tests**: `__tests__/korean.test.ts` - Jest tests importing from compiled lib directory
+
+### Key Design Patterns
+- **Single Object Export**: All utilities are methods on a single `util` object
+- **Pure Functions**: All utility functions are stateless and side-effect free (except `clearTag` which uses DOM)
+- **Defensive Programming**: Functions include type checking and fallback values
+- **Browser Compatibility**: Uses DOM APIs for `clearTag` and `navigator` for `isiOS`
+
+### Function Categories
+
+1. **Korean Text Processing**:
+   - `isKorean()` - Detects Korean characters using Unicode ranges
+   
+2. **Date/Time Utilities**:
+   - `getNowDate()` - Current datetime in local timezone
+   - `getKoreanDate()` - Korean date format ("월일" format)
+   - `formatDate()` - yyyy-mm-dd formatting
+   - `calDDay()` - D-day calculator
+   - `parseTime()` - Parse time strings to milliseconds
+
+3. **String Transformations**:
+   - `toCamelCase()` - Convert to camelCase
+   - `toSnakeCase()` - Convert to snake_case  
+   - `toTitleCase()` - Convert to Title Case with space handling
+   - `replaceBetween()` - Replace substring at specific indices
+
+4. **HTML/Text Processing**:
+   - `parseTag()` - Decode HTML entities (&lt; to <)
+   - `toText()` - Convert <br> tags to newlines
+   - `toHtml()` - Convert newlines to <br> tags
+   - `clearTag()` - Remove HTML tags (browser only)
+
+5. **Data Utilities**:
+   - `clone()` - Shallow object cloning
+   - `equalArrays()` - Array comparison
+   - `parseNumber()` - Safe number parsing with defaults
+
+6. **Browser Detection**:
+   - `isiOS()` - Detect iOS devices via user agent
+
+## Development Notes
+
+### Build Process
+- TypeScript compiles to ES5 for broad compatibility
+- Outputs both JavaScript and TypeScript declaration files
+- Uses strict TypeScript configuration with proper module resolution
+
+### Testing Strategy  
+- Tests run against compiled JavaScript in `lib/` directory, not source TypeScript
+- Jest configuration supports both .ts and .js files
+- Tests focus on core functionality rather than edge cases
+
+### Type Safety Considerations
+- Uses `Record<string, unknown>` for generic object types
+- TODO comment indicates need to improve object typing
+- Functions include runtime type checking for safety
+
+### Browser Dependencies
+- `clearTag()` function requires DOM environment (uses `document.createElement`)
+- `isiOS()` function requires browser environment (uses `navigator.userAgent`)
+- Other functions are environment-agnostic
+
+When adding new utilities:
+1. Add to the main util object in `src/index.ts`
+2. Follow existing patterns for type safety and error handling
+3. Add comprehensive JSDoc documentation
+4. Write tests in `__tests__/` directory
+5. Test against compiled output, not source

package/internal-docs/NPM_DEPLOYMENT_GUIDE.md

@@ -0,0 +1,203 @@
+# 📦 NPM 배포 가이드
+
+## 사전 준비
+
+### 1. npm 계정 및 인증
+
+```bash
+# npm 로그인 상태 확인
+npm whoami
+
+# 로그인이 안되어 있다면
+npm login
+```
+
+### 2. .npmrc 파일 설정 (이미 완료됨)
+
+`.npmrc` 파일에 인증 토큰이 설정되어 있어야 합니다:
+
+```
+//registry.npmjs.org/:_authToken=npm_YOUR_TOKEN_HERE
+```
+
+⚠️ **중요**: `.npmrc` 파일은 `.gitignore`에 포함되어 있어 Git에 커밋되지 않습니다. 토큰을 안전하게 보관하세요!
+
+## 배포 프로세스
+
+### 방법 1: 수동 배포 (권장)
+
+```bash
+# 1. 모든 변경사항 커밋
+git add .
+git commit -m "feat: describe your changes"
+git push
+
+# 2. 버전 업데이트
+npm version patch   # 0.0.18 → 0.0.19 (버그 수정)
+npm version minor   # 0.0.18 → 0.1.0  (새 기능 추가)
+npm version major   # 0.0.18 → 1.0.0  (Breaking changes)
+
+# 3. 배포
+npm publish
+```
+
+### 방법 2: 한 번에 실행
+
+```bash
+# 테스트와 빌드를 수동으로 확인 후
+npm run build && npm test
+
+# 버전 업데이트와 배포
+npm version minor && npm publish
+```
+
+## 자동 체크리스트
+
+`npm publish` 실행 시 `prepublishOnly` 스크립트가 자동으로 다음을 실행합니다:
+
+1. ✅ **테스트 실행** (`npm test`)
+2. ✅ **Lint 검사** (`npm run lint`)
+3. ✅ **빌드** (`npm run build` - prepare 훅에서)
+
+어느 하나라도 실패하면 배포가 중단됩니다.
+
+## 버전 전략
+
+### Semantic Versioning (SemVer)
+
+- **MAJOR (1.0.0)**: Breaking changes - 기존 API가 변경되어 호환성이 깨짐
+- **MINOR (0.1.0)**: 새 기능 추가 - 하위 호환성 유지
+- **PATCH (0.0.1)**: 버그 수정 - 하위 호환성 유지
+
+### 예시
+
+```bash
+# 새 기능 추가 (오늘처럼)
+npm version minor
+# 0.0.18 → 0.1.0
+
+# 버그 수정
+npm version patch
+# 0.1.0 → 0.1.1
+
+# Breaking changes
+npm version major
+# 0.1.1 → 1.0.0
+```
+
+## Git Push 문제 해결
+
+만약 Git push 시 권한 오류가 발생한다면:
+
+```bash
+# 현재 Git 사용자 확인
+git config user.name
+git config user.email
+
+# Git credential 재설정
+git config --global credential.helper osxkeychain
+
+# 또는 SSH 키 사용
+git remote set-url origin git@github.com:jellive/jell-utils.js.git
+```
+
+## 배포 확인
+
+```bash
+# 패키지 페이지에서 확인
+# https://www.npmjs.com/package/jell-utils
+
+# 설치 테스트
+npm install jell-utils
+
+# 또는
+npm view jell-utils version
+```
+
+## Semantic Release (자동 배포)
+
+프로젝트에 semantic-release가 설정되어 있습니다. CI/CD에서 자동 배포하려면:
+
+```bash
+# Conventional Commits 형식으로 커밋
+git commit -m "feat: add new utility function"
+git commit -m "fix: resolve bug in parseTime"
+git commit -m "docs: update README"
+
+# Push하면 GitHub Actions가 자동으로 배포
+git push
+```
+
+### Conventional Commits 규칙
+
+- `feat:` - 새 기능 (MINOR 버전 증가)
+- `fix:` - 버그 수정 (PATCH 버전 증가)
+- `docs:` - 문서만 변경 (버전 증가 없음)
+- `BREAKING CHANGE:` - Breaking changes (MAJOR 버전 증가)
+
+## 문제 해결
+
+### 에러: "You do not have permission to publish"
+
+```bash
+# npm 로그인 다시 확인
+npm whoami
+npm logout
+npm login
+```
+
+### 에러: "Package version already exists"
+
+```bash
+# 버전을 올려야 합니다
+npm version patch
+npm publish
+```
+
+### 에러: "prepublishOnly script failed"
+
+테스트나 Lint 에러를 먼저 수정해야 합니다:
+
+```bash
+# 에러 확인
+npm test
+npm run lint
+
+# 수정 후 다시 시도
+npm publish
+```
+
+## 배포 체크리스트
+
+- [ ] 모든 테스트 통과 (`npm test`)
+- [ ] Lint 검사 통과 (`npm run lint`)
+- [ ] 빌드 성공 (`npm run build`)
+- [ ] README.md 업데이트
+- [ ] CHANGELOG.md 업데이트 (선택사항)
+- [ ] Git 커밋 및 Push
+- [ ] 버전 업데이트
+- [ ] npm publish
+- [ ] 배포 확인 (npmjs.com)
+
+## 현재 버전
+
+- **현재**: 0.1.0
+- **마지막 배포**: 2025-10-11
+- **포함된 기능**:
+  - Korean utilities (초성 검색, 사업자등록번호)
+  - Object/Array utilities (getByPath, setByPath, groupBy, sortBy, deepMerge)
+  - String utilities (extractNumbers, maskString, getFileExtension)
+  - Date utilities (dateDiff)
+  - Async utilities (retry with backoff)
+  - 50개 테스트 케이스 (79.67% 커버리지)
+
+## 다음 배포 시
+
+1. 변경사항을 커밋
+2. `npm version [patch|minor|major]` 선택
+3. `npm publish` 실행
+4. 완료! 🚀
+
+---
+
+**참고**: 배포 전 항상 로컬에서 `npm test && npm run build`를 실행하여 문제가 없는지 확인하세요.