@blastlabs/utils 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/README.md +267 -0
  2. package/dist/components/dev/ApiLogger.d.ts +136 -0
  3. package/dist/components/dev/ApiLogger.d.ts.map +1 -0
  4. package/dist/components/dev/ApiLogger.js +408 -0
  5. package/dist/components/dev/DevPanel.d.ts +32 -0
  6. package/dist/components/dev/DevPanel.d.ts.map +1 -0
  7. package/dist/components/dev/DevPanel.js +196 -0
  8. package/dist/components/dev/FormDevTools/FormDevTools.d.ts +136 -0
  9. package/dist/components/dev/FormDevTools/FormDevTools.d.ts.map +1 -0
  10. package/dist/components/dev/FormDevTools/FormDevTools.js +442 -0
  11. package/dist/components/dev/FormDevTools/index.d.ts +3 -0
  12. package/dist/components/dev/FormDevTools/index.d.ts.map +1 -0
  13. package/dist/components/dev/FormDevTools/index.js +1 -0
  14. package/dist/components/dev/FormDevTools/styles.d.ts +45 -0
  15. package/dist/components/dev/FormDevTools/styles.d.ts.map +1 -0
  16. package/dist/components/dev/FormDevTools/styles.js +197 -0
  17. package/dist/components/dev/IdSelector.d.ts +50 -0
  18. package/dist/components/dev/IdSelector.d.ts.map +1 -0
  19. package/dist/components/dev/IdSelector.js +129 -0
  20. package/dist/components/dev/WindowSizeDisplay.d.ts +44 -0
  21. package/dist/components/dev/WindowSizeDisplay.d.ts.map +1 -0
  22. package/dist/components/dev/WindowSizeDisplay.js +74 -0
  23. package/dist/components/dev/ZIndexDebugger.d.ts +32 -0
  24. package/dist/components/dev/ZIndexDebugger.d.ts.map +1 -0
  25. package/dist/components/dev/ZIndexDebugger.js +184 -0
  26. package/dist/components/dev/index.d.ts +15 -0
  27. package/dist/components/dev/index.d.ts.map +1 -0
  28. package/dist/components/dev/index.js +12 -0
  29. package/dist/components/index.d.ts +8 -0
  30. package/dist/components/index.d.ts.map +1 -0
  31. package/dist/components/index.js +7 -0
  32. package/dist/date/index.d.ts +64 -0
  33. package/dist/date/index.d.ts.map +1 -0
  34. package/dist/date/index.js +92 -0
  35. package/dist/date/index.test.d.ts +2 -0
  36. package/dist/date/index.test.d.ts.map +1 -0
  37. package/dist/date/index.test.js +166 -0
  38. package/dist/form/__tests__/formatter.test.d.ts +2 -0
  39. package/dist/form/__tests__/formatter.test.d.ts.map +1 -0
  40. package/dist/form/__tests__/formatter.test.js +74 -0
  41. package/dist/form/__tests__/helpers.test.d.ts +2 -0
  42. package/dist/form/__tests__/helpers.test.d.ts.map +1 -0
  43. package/dist/form/__tests__/helpers.test.js +42 -0
  44. package/dist/form/__tests__/validation.test.d.ts +2 -0
  45. package/dist/form/__tests__/validation.test.d.ts.map +1 -0
  46. package/dist/form/__tests__/validation.test.js +67 -0
  47. package/dist/form/formatter.d.ts +34 -0
  48. package/dist/form/formatter.d.ts.map +1 -0
  49. package/dist/form/formatter.js +76 -0
  50. package/dist/form/helpers.d.ts +16 -0
  51. package/dist/form/helpers.d.ts.map +1 -0
  52. package/dist/form/helpers.js +34 -0
  53. package/dist/form/index.d.ts +9 -0
  54. package/dist/form/index.d.ts.map +1 -0
  55. package/dist/form/index.js +11 -0
  56. package/dist/form/validation.d.ts +33 -0
  57. package/dist/form/validation.d.ts.map +1 -0
  58. package/dist/form/validation.js +56 -0
  59. package/dist/hooks/index.d.ts +19 -0
  60. package/dist/hooks/index.d.ts.map +1 -0
  61. package/dist/hooks/index.js +23 -0
  62. package/dist/hooks/useClickOutside.d.ts +49 -0
  63. package/dist/hooks/useClickOutside.d.ts.map +1 -0
  64. package/dist/hooks/useClickOutside.js +94 -0
  65. package/dist/hooks/useCopyToClipboard.d.ts +67 -0
  66. package/dist/hooks/useCopyToClipboard.d.ts.map +1 -0
  67. package/dist/hooks/useCopyToClipboard.js +79 -0
  68. package/dist/hooks/useDebounce.d.ts +47 -0
  69. package/dist/hooks/useDebounce.d.ts.map +1 -0
  70. package/dist/hooks/useDebounce.js +60 -0
  71. package/dist/hooks/useEventListener.d.ts +79 -0
  72. package/dist/hooks/useEventListener.d.ts.map +1 -0
  73. package/dist/hooks/useEventListener.js +33 -0
  74. package/dist/hooks/useIntersectionObserver.d.ts +109 -0
  75. package/dist/hooks/useIntersectionObserver.d.ts.map +1 -0
  76. package/dist/hooks/useIntersectionObserver.js +128 -0
  77. package/dist/hooks/useLocalStorage.d.ts +19 -0
  78. package/dist/hooks/useLocalStorage.d.ts.map +1 -0
  79. package/dist/hooks/useLocalStorage.js +91 -0
  80. package/dist/hooks/useMediaQuery.d.ts +56 -0
  81. package/dist/hooks/useMediaQuery.d.ts.map +1 -0
  82. package/dist/hooks/useMediaQuery.js +104 -0
  83. package/dist/hooks/usePrevious.d.ts +58 -0
  84. package/dist/hooks/usePrevious.d.ts.map +1 -0
  85. package/dist/hooks/usePrevious.js +67 -0
  86. package/dist/hooks/useSessionStorage.d.ts +19 -0
  87. package/dist/hooks/useSessionStorage.d.ts.map +1 -0
  88. package/dist/hooks/useSessionStorage.js +85 -0
  89. package/dist/hooks/useThrottle.d.ts +57 -0
  90. package/dist/hooks/useThrottle.d.ts.map +1 -0
  91. package/dist/hooks/useThrottle.js +80 -0
  92. package/dist/hooks/useToggle.d.ts +49 -0
  93. package/dist/hooks/useToggle.d.ts.map +1 -0
  94. package/dist/hooks/useToggle.js +56 -0
  95. package/dist/hooks/useWindowSize.d.ts +58 -0
  96. package/dist/hooks/useWindowSize.d.ts.map +1 -0
  97. package/dist/hooks/useWindowSize.js +79 -0
  98. package/dist/index.d.ts +6 -0
  99. package/dist/index.d.ts.map +1 -0
  100. package/dist/index.js +17 -0
  101. package/dist/mock/form.d.ts +41 -0
  102. package/dist/mock/form.d.ts.map +1 -0
  103. package/dist/mock/form.js +195 -0
  104. package/dist/mock/generators.d.ts +112 -0
  105. package/dist/mock/generators.d.ts.map +1 -0
  106. package/dist/mock/generators.js +195 -0
  107. package/dist/mock/index.d.ts +8 -0
  108. package/dist/mock/index.d.ts.map +1 -0
  109. package/dist/mock/index.js +9 -0
  110. package/dist/number/format.d.ts +116 -0
  111. package/dist/number/format.d.ts.map +1 -0
  112. package/dist/number/format.js +165 -0
  113. package/dist/number/index.d.ts +7 -0
  114. package/dist/number/index.d.ts.map +1 -0
  115. package/dist/number/index.js +7 -0
  116. package/dist/string/__tests__/case.test.d.ts +2 -0
  117. package/dist/string/__tests__/case.test.d.ts.map +1 -0
  118. package/dist/string/__tests__/case.test.js +61 -0
  119. package/dist/string/__tests__/manipulation.test.d.ts +2 -0
  120. package/dist/string/__tests__/manipulation.test.d.ts.map +1 -0
  121. package/dist/string/__tests__/manipulation.test.js +109 -0
  122. package/dist/string/__tests__/validation.test.d.ts +2 -0
  123. package/dist/string/__tests__/validation.test.d.ts.map +1 -0
  124. package/dist/string/__tests__/validation.test.js +101 -0
  125. package/dist/string/case.d.ts +42 -0
  126. package/dist/string/case.d.ts.map +1 -0
  127. package/dist/string/case.js +71 -0
  128. package/dist/string/index.d.ts +9 -0
  129. package/dist/string/index.d.ts.map +1 -0
  130. package/dist/string/index.js +11 -0
  131. package/dist/string/manipulation.d.ts +61 -0
  132. package/dist/string/manipulation.d.ts.map +1 -0
  133. package/dist/string/manipulation.js +106 -0
  134. package/dist/string/validation.d.ts +79 -0
  135. package/dist/string/validation.d.ts.map +1 -0
  136. package/dist/string/validation.js +115 -0
  137. package/package.json +86 -0
@@ -0,0 +1,195 @@
1
+ /**
2
+ * Mock Data Generators
3
+ *
4
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
5
+ */
6
+ /**
7
+ * 한국어 이름 생성
8
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
9
+ * @returns 한국어 이름
10
+ *
11
+ * @example
12
+ * generateKoreanName() // "김민수"
13
+ * generateKoreanName('female') // "이지은"
14
+ */
15
+ export function generateKoreanName(gender = 'random') {
16
+ const surnames = ['김', '이', '박', '최', '정', '강', '조', '윤', '장', '임', '한', '오', '서', '신', '권', '황', '안', '송', '전', '홍'];
17
+ const maleNames = ['민수', '준호', '성호', '지훈', '현우', '동현', '민준', '건우', '준영', '상우', '영수', '성민', '준혁', '태현', '승현'];
18
+ const femaleNames = ['지은', '수진', '미영', '혜진', '은지', '서연', '민지', '예은', '지원', '유진', '소영', '지현', '수빈', '하은', '서윤'];
19
+ const surname = surnames[Math.floor(Math.random() * surnames.length)];
20
+ const selectedGender = gender === 'random' ? (Math.random() > 0.5 ? 'male' : 'female') : gender;
21
+ const name = selectedGender === 'male'
22
+ ? maleNames[Math.floor(Math.random() * maleNames.length)]
23
+ : femaleNames[Math.floor(Math.random() * femaleNames.length)];
24
+ return `${surname}${name}`;
25
+ }
26
+ /**
27
+ * 영어 이름 생성
28
+ * @param gender - 성별 ('male' | 'female' | 'random', 기본값: 'random')
29
+ * @returns 영어 이름
30
+ *
31
+ * @example
32
+ * generateEnglishName() // "John Smith"
33
+ * generateEnglishName('female') // "Emily Johnson"
34
+ */
35
+ export function generateEnglishName(gender = 'random') {
36
+ const maleFirstNames = ['James', 'John', 'Robert', 'Michael', 'William', 'David', 'Richard', 'Joseph', 'Thomas', 'Christopher'];
37
+ const femaleFirstNames = ['Mary', 'Patricia', 'Jennifer', 'Linda', 'Elizabeth', 'Barbara', 'Susan', 'Jessica', 'Sarah', 'Karen'];
38
+ const lastNames = ['Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller', 'Davis', 'Rodriguez', 'Martinez'];
39
+ const selectedGender = gender === 'random' ? (Math.random() > 0.5 ? 'male' : 'female') : gender;
40
+ const firstName = selectedGender === 'male'
41
+ ? maleFirstNames[Math.floor(Math.random() * maleFirstNames.length)]
42
+ : femaleFirstNames[Math.floor(Math.random() * femaleFirstNames.length)];
43
+ const lastName = lastNames[Math.floor(Math.random() * lastNames.length)];
44
+ return `${firstName} ${lastName}`;
45
+ }
46
+ /**
47
+ * 이메일 생성
48
+ * @param name - 이름 (선택, 없으면 랜덤 생성)
49
+ * @param domain - 도메인 (기본값: 'example.com')
50
+ * @returns 이메일 주소
51
+ *
52
+ * @example
53
+ * generateEmail() // "user123@example.com"
54
+ * generateEmail('홍길동') // "honggildong@example.com"
55
+ */
56
+ export function generateEmail(name, domain = 'example.com') {
57
+ if (name) {
58
+ // 한글 이름을 영문으로 변환 (간단한 변환)
59
+ const nameMap = {
60
+ '김': 'kim', '이': 'lee', '박': 'park', '최': 'choi', '정': 'jung',
61
+ '강': 'kang', '조': 'cho', '윤': 'yoon', '장': 'jang', '임': 'lim'
62
+ };
63
+ let emailName = name.toLowerCase()
64
+ .replace(/[가-힣]/g, (char) => {
65
+ // 간단한 로마자 변환 (실제로는 더 복잡한 변환이 필요)
66
+ return nameMap[char] || 'user';
67
+ })
68
+ .replace(/[^a-z0-9]/g, '')
69
+ .substring(0, 20) || 'user';
70
+ if (emailName.length < 3)
71
+ emailName = 'user';
72
+ return `${emailName}${Math.floor(Math.random() * 1000)}@${domain}`;
73
+ }
74
+ const randomString = Math.random().toString(36).substring(2, 10);
75
+ return `${randomString}@${domain}`;
76
+ }
77
+ /**
78
+ * 전화번호 생성 (한국 형식)
79
+ * @returns 전화번호 (010-1234-5678 형식)
80
+ *
81
+ * @example
82
+ * generatePhoneNumber() // "010-1234-5678"
83
+ */
84
+ export function generatePhoneNumber() {
85
+ const prefixes = ['010', '011', '016', '017', '018', '019'];
86
+ const prefix = prefixes[Math.floor(Math.random() * prefixes.length)];
87
+ const middle = Math.floor(Math.random() * 9000) + 1000;
88
+ const last = Math.floor(Math.random() * 9000) + 1000;
89
+ return `${prefix}-${middle}-${last}`;
90
+ }
91
+ /**
92
+ * 주소 생성 (한국 형식)
93
+ * @returns 한국 주소
94
+ *
95
+ * @example
96
+ * generateAddress() // "서울특별시 강남구 테헤란로 123"
97
+ */
98
+ export function generateAddress() {
99
+ const cities = ['서울특별시', '부산광역시', '대구광역시', '인천광역시', '광주광역시', '대전광역시', '울산광역시'];
100
+ const districts = ['강남구', '강동구', '강북구', '강서구', '관악구', '광진구', '구로구', '금천구', '노원구', '도봉구'];
101
+ const streets = ['테헤란로', '강남대로', '서초대로', '올림픽대로', '반포대로', '한강대로', '을지로', '종로', '명동길', '이태원로'];
102
+ const city = cities[Math.floor(Math.random() * cities.length)];
103
+ const district = districts[Math.floor(Math.random() * districts.length)];
104
+ const street = streets[Math.floor(Math.random() * streets.length)];
105
+ const number = Math.floor(Math.random() * 999) + 1;
106
+ return `${city} ${district} ${street} ${number}`;
107
+ }
108
+ /**
109
+ * 날짜 생성 (범위 내)
110
+ * @param startDate - 시작 날짜 (기본값: 1년 전)
111
+ * @param endDate - 종료 날짜 (기본값: 오늘)
112
+ * @returns 날짜 문자열 (YYYY-MM-DD)
113
+ *
114
+ * @example
115
+ * generateDate() // "2023-06-15"
116
+ * generateDate('2024-01-01', '2024-12-31') // "2024-08-20"
117
+ */
118
+ export function generateDate(startDate, endDate) {
119
+ const start = startDate ? new Date(startDate).getTime() : Date.now() - 365 * 24 * 60 * 60 * 1000;
120
+ const end = endDate ? new Date(endDate).getTime() : Date.now();
121
+ const randomTime = start + Math.random() * (end - start);
122
+ const date = new Date(randomTime);
123
+ const year = date.getFullYear();
124
+ const month = String(date.getMonth() + 1).padStart(2, '0');
125
+ const day = String(date.getDate()).padStart(2, '0');
126
+ return `${year}-${month}-${day}`;
127
+ }
128
+ /**
129
+ * 숫자 생성 (범위 내)
130
+ * @param min - 최소값 (기본값: 0)
131
+ * @param max - 최대값 (기본값: 100)
132
+ * @returns 랜덤 숫자
133
+ *
134
+ * @example
135
+ * generateNumber() // 42
136
+ * generateNumber(1, 10) // 7
137
+ */
138
+ export function generateNumber(min = 0, max = 100) {
139
+ return Math.floor(Math.random() * (max - min + 1)) + min;
140
+ }
141
+ /**
142
+ * 텍스트 생성 (한글)
143
+ * @param length - 길이 (기본값: 10)
144
+ * @returns 랜덤 한글 텍스트
145
+ *
146
+ * @example
147
+ * generateKoreanText() // "안녕하세요반갑습니다"
148
+ * generateKoreanText(5) // "테스트데이터"
149
+ */
150
+ export function generateKoreanText(length = 10) {
151
+ const chars = '가나다라마바사아자차카타파하거너더러머버서어저처커터퍼허고노도로모보소오조초코토포호구누두루무부수우주추쿠투푸후그느드르므브스으즈츠크트프흐기니디리미비시이지치키티피히';
152
+ let result = '';
153
+ for (let i = 0; i < length; i++) {
154
+ result += chars[Math.floor(Math.random() * chars.length)];
155
+ }
156
+ return result;
157
+ }
158
+ /**
159
+ * 텍스트 생성 (영문)
160
+ * @param length - 길이 (기본값: 10)
161
+ * @returns 랜덤 영문 텍스트
162
+ *
163
+ * @example
164
+ * generateEnglishText() // "loremipsum"
165
+ * generateEnglishText(5) // "testd"
166
+ */
167
+ export function generateEnglishText(length = 10) {
168
+ const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
169
+ let result = '';
170
+ for (let i = 0; i < length; i++) {
171
+ result += chars[Math.floor(Math.random() * chars.length)];
172
+ }
173
+ return result;
174
+ }
175
+ /**
176
+ * 불린 값 생성
177
+ * @returns 랜덤 boolean
178
+ *
179
+ * @example
180
+ * generateBoolean() // true
181
+ */
182
+ export function generateBoolean() {
183
+ return Math.random() > 0.5;
184
+ }
185
+ /**
186
+ * 배열에서 랜덤 선택
187
+ * @param array - 선택할 배열
188
+ * @returns 랜덤으로 선택된 요소
189
+ *
190
+ * @example
191
+ * generateFromArray(['red', 'blue', 'green']) // "blue"
192
+ */
193
+ export function generateFromArray(array) {
194
+ return array[Math.floor(Math.random() * array.length)];
195
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Mock Data Utilities
3
+ *
4
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
5
+ */
6
+ export * from './generators';
7
+ export * from './form';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mock/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Mock Data Utilities
3
+ *
4
+ * 폼 필드 타입에 맞는 mock 데이터 생성 유틸리티
5
+ */
6
+ // Generators
7
+ export * from './generators';
8
+ // Form mock data generators
9
+ export * from './form';
@@ -0,0 +1,116 @@
1
+ /**
2
+ * Number Formatting Utilities
3
+ *
4
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
5
+ */
6
+ /**
7
+ * 숫자를 천 단위 구분자로 포맷팅
8
+ * @param value - 포맷팅할 숫자
9
+ * @param decimals - 소수점 자릿수 (기본값: 0)
10
+ * @param separator - 천 단위 구분자 (기본값: ',')
11
+ * @returns 포맷팅된 문자열
12
+ *
13
+ * @example
14
+ * formatNumber(1234567) // "1,234,567"
15
+ * formatNumber(1234.56, 2) // "1,234.56"
16
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
17
+ */
18
+ export declare function formatNumber(value: number | string, decimals?: number, separator?: string): string;
19
+ /**
20
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
21
+ * @param value - 포맷팅할 가격
22
+ * @param currency - 통화 기호 (기본값: '₩')
23
+ * @param decimals - 소수점 자릿수 (기본값: 0)
24
+ * @param separator - 천 단위 구분자 (기본값: ',')
25
+ * @param position - 통화 기호 위치 (기본값: 'before')
26
+ * @returns 포맷팅된 가격 문자열
27
+ *
28
+ * @example
29
+ * formatPrice(1234567) // "₩1,234,567"
30
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
31
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
32
+ */
33
+ export declare function formatPrice(value: number | string, currency?: string, decimals?: number, separator?: string, position?: 'before' | 'after'): string;
34
+ /**
35
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
36
+ * @param value - 포맷팅할 금액
37
+ * @param locale - 로케일 (기본값: 'ko-KR')
38
+ * @param currency - 통화 코드 (기본값: 'KRW')
39
+ * @param style - 표시 스타일 (기본값: 'currency')
40
+ * @returns 포맷팅된 통화 문자열
41
+ *
42
+ * @example
43
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
44
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
45
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
46
+ */
47
+ export declare function formatCurrencyIntl(value: number | string, locale?: string, currency?: string, style?: 'currency' | 'decimal'): string;
48
+ /**
49
+ * 가격 문자열을 숫자로 변환
50
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
51
+ * @returns 변환된 숫자
52
+ *
53
+ * @example
54
+ * parsePrice("₩1,234,567") // 1234567
55
+ * parsePrice("1,234.56") // 1234.56
56
+ * parsePrice("$1,234.56") // 1234.56
57
+ */
58
+ export declare function parsePrice(priceString: string): number;
59
+ /**
60
+ * 할인율 계산
61
+ * @param originalPrice - 원래 가격
62
+ * @param discountedPrice - 할인된 가격
63
+ * @returns 할인율 (퍼센트)
64
+ *
65
+ * @example
66
+ * calculateDiscount(10000, 8000) // 20
67
+ * calculateDiscount(100, 75) // 25
68
+ */
69
+ export declare function calculateDiscount(originalPrice: number, discountedPrice: number): number;
70
+ /**
71
+ * 할인 가격 계산
72
+ * @param originalPrice - 원래 가격
73
+ * @param discountPercent - 할인율 (퍼센트)
74
+ * @returns 할인된 가격
75
+ *
76
+ * @example
77
+ * calculateDiscountedPrice(10000, 20) // 8000
78
+ * calculateDiscountedPrice(100, 25) // 75
79
+ */
80
+ export declare function calculateDiscountedPrice(originalPrice: number, discountPercent: number): number;
81
+ /**
82
+ * 세금 포함 가격 계산
83
+ * @param price - 세전 가격
84
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
85
+ * @returns 세금 포함 가격
86
+ *
87
+ * @example
88
+ * calculatePriceWithTax(10000, 10) // 11000
89
+ * calculatePriceWithTax(100, 20) // 120
90
+ */
91
+ export declare function calculatePriceWithTax(price: number, taxRate?: number): number;
92
+ /**
93
+ * 세금 제외 가격 계산
94
+ * @param priceWithTax - 세금 포함 가격
95
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
96
+ * @returns 세전 가격
97
+ *
98
+ * @example
99
+ * calculatePriceWithoutTax(11000, 10) // 10000
100
+ * calculatePriceWithoutTax(120, 20) // 100
101
+ */
102
+ export declare function calculatePriceWithoutTax(priceWithTax: number, taxRate?: number): number;
103
+ /**
104
+ * 백분율 포맷팅
105
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
106
+ * @param decimals - 소수점 자릿수 (기본값: 1)
107
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
108
+ * @returns 포맷팅된 퍼센트 문자열
109
+ *
110
+ * @example
111
+ * formatPercent(0.1234, 1, true) // "12.3%"
112
+ * formatPercent(12.34, 1, false) // "12.3%"
113
+ * formatPercent(50) // "50.0%"
114
+ */
115
+ export declare function formatPercent(value: number, decimals?: number, isDecimal?: boolean): string;
116
+ //# sourceMappingURL=format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/number/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAY,GACtB,MAAM,CAaR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAY,EACvB,QAAQ,GAAE,QAAQ,GAAG,OAAkB,GACtC,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,GAAE,MAAgB,EACxB,QAAQ,GAAE,MAAc,EACxB,KAAK,GAAE,UAAU,GAAG,SAAsB,GACzC,MAAM,CAaR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAG/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAGjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAG3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,OAAe,GACzB,MAAM,CAGR"}
@@ -0,0 +1,165 @@
1
+ /**
2
+ * Number Formatting Utilities
3
+ *
4
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
5
+ */
6
+ /**
7
+ * 숫자를 천 단위 구분자로 포맷팅
8
+ * @param value - 포맷팅할 숫자
9
+ * @param decimals - 소수점 자릿수 (기본값: 0)
10
+ * @param separator - 천 단위 구분자 (기본값: ',')
11
+ * @returns 포맷팅된 문자열
12
+ *
13
+ * @example
14
+ * formatNumber(1234567) // "1,234,567"
15
+ * formatNumber(1234.56, 2) // "1,234.56"
16
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
17
+ */
18
+ export function formatNumber(value, decimals = 0, separator = ',') {
19
+ const num = typeof value === 'string' ? parseFloat(value) : value;
20
+ if (isNaN(num)) {
21
+ return '0';
22
+ }
23
+ const fixed = num.toFixed(decimals);
24
+ const parts = fixed.split('.');
25
+ const integerPart = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, separator);
26
+ const decimalPart = parts[1] ? `.${parts[1]}` : '';
27
+ return integerPart + decimalPart;
28
+ }
29
+ /**
30
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
31
+ * @param value - 포맷팅할 가격
32
+ * @param currency - 통화 기호 (기본값: '₩')
33
+ * @param decimals - 소수점 자릿수 (기본값: 0)
34
+ * @param separator - 천 단위 구분자 (기본값: ',')
35
+ * @param position - 통화 기호 위치 (기본값: 'before')
36
+ * @returns 포맷팅된 가격 문자열
37
+ *
38
+ * @example
39
+ * formatPrice(1234567) // "₩1,234,567"
40
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
41
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
42
+ */
43
+ export function formatPrice(value, currency = '₩', decimals = 0, separator = ',', position = 'before') {
44
+ const formatted = formatNumber(value, decimals, separator);
45
+ return position === 'before' ? `${currency}${formatted}` : `${formatted}${currency}`;
46
+ }
47
+ /**
48
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
49
+ * @param value - 포맷팅할 금액
50
+ * @param locale - 로케일 (기본값: 'ko-KR')
51
+ * @param currency - 통화 코드 (기본값: 'KRW')
52
+ * @param style - 표시 스타일 (기본값: 'currency')
53
+ * @returns 포맷팅된 통화 문자열
54
+ *
55
+ * @example
56
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
57
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
58
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
59
+ */
60
+ export function formatCurrencyIntl(value, locale = 'ko-KR', currency = 'KRW', style = 'currency') {
61
+ const num = typeof value === 'string' ? parseFloat(value) : value;
62
+ if (isNaN(num)) {
63
+ return '0';
64
+ }
65
+ return new Intl.NumberFormat(locale, {
66
+ style,
67
+ currency,
68
+ minimumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
69
+ maximumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
70
+ }).format(num);
71
+ }
72
+ /**
73
+ * 가격 문자열을 숫자로 변환
74
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
75
+ * @returns 변환된 숫자
76
+ *
77
+ * @example
78
+ * parsePrice("₩1,234,567") // 1234567
79
+ * parsePrice("1,234.56") // 1234.56
80
+ * parsePrice("$1,234.56") // 1234.56
81
+ */
82
+ export function parsePrice(priceString) {
83
+ if (!priceString || typeof priceString !== 'string') {
84
+ return 0;
85
+ }
86
+ // 통화 기호, 공백, 쉼표 제거
87
+ const cleaned = priceString.replace(/[₩$€£¥,\s]/g, '');
88
+ const parsed = parseFloat(cleaned);
89
+ return isNaN(parsed) ? 0 : parsed;
90
+ }
91
+ /**
92
+ * 할인율 계산
93
+ * @param originalPrice - 원래 가격
94
+ * @param discountedPrice - 할인된 가격
95
+ * @returns 할인율 (퍼센트)
96
+ *
97
+ * @example
98
+ * calculateDiscount(10000, 8000) // 20
99
+ * calculateDiscount(100, 75) // 25
100
+ */
101
+ export function calculateDiscount(originalPrice, discountedPrice) {
102
+ if (originalPrice <= 0) {
103
+ return 0;
104
+ }
105
+ const discount = ((originalPrice - discountedPrice) / originalPrice) * 100;
106
+ return Math.round(discount * 100) / 100; // 소수점 2자리까지
107
+ }
108
+ /**
109
+ * 할인 가격 계산
110
+ * @param originalPrice - 원래 가격
111
+ * @param discountPercent - 할인율 (퍼센트)
112
+ * @returns 할인된 가격
113
+ *
114
+ * @example
115
+ * calculateDiscountedPrice(10000, 20) // 8000
116
+ * calculateDiscountedPrice(100, 25) // 75
117
+ */
118
+ export function calculateDiscountedPrice(originalPrice, discountPercent) {
119
+ const discount = (originalPrice * discountPercent) / 100;
120
+ return Math.round((originalPrice - discount) * 100) / 100;
121
+ }
122
+ /**
123
+ * 세금 포함 가격 계산
124
+ * @param price - 세전 가격
125
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
126
+ * @returns 세금 포함 가격
127
+ *
128
+ * @example
129
+ * calculatePriceWithTax(10000, 10) // 11000
130
+ * calculatePriceWithTax(100, 20) // 120
131
+ */
132
+ export function calculatePriceWithTax(price, taxRate = 10) {
133
+ const tax = (price * taxRate) / 100;
134
+ return Math.round((price + tax) * 100) / 100;
135
+ }
136
+ /**
137
+ * 세금 제외 가격 계산
138
+ * @param priceWithTax - 세금 포함 가격
139
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
140
+ * @returns 세전 가격
141
+ *
142
+ * @example
143
+ * calculatePriceWithoutTax(11000, 10) // 10000
144
+ * calculatePriceWithoutTax(120, 20) // 100
145
+ */
146
+ export function calculatePriceWithoutTax(priceWithTax, taxRate = 10) {
147
+ const price = priceWithTax / (1 + taxRate / 100);
148
+ return Math.round(price * 100) / 100;
149
+ }
150
+ /**
151
+ * 백분율 포맷팅
152
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
153
+ * @param decimals - 소수점 자릿수 (기본값: 1)
154
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
155
+ * @returns 포맷팅된 퍼센트 문자열
156
+ *
157
+ * @example
158
+ * formatPercent(0.1234, 1, true) // "12.3%"
159
+ * formatPercent(12.34, 1, false) // "12.3%"
160
+ * formatPercent(50) // "50.0%"
161
+ */
162
+ export function formatPercent(value, decimals = 1, isDecimal = false) {
163
+ const percent = isDecimal ? value * 100 : value;
164
+ return `${percent.toFixed(decimals)}%`;
165
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Number Utilities
3
+ *
4
+ * 숫자 및 가격 관련 유틸리티 함수들
5
+ */
6
+ export * from './format';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Number Utilities
3
+ *
4
+ * 숫자 및 가격 관련 유틸리티 함수들
5
+ */
6
+ // Formatting utilities
7
+ export * from './format';
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=case.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"case.test.d.ts","sourceRoot":"","sources":["../../../src/string/__tests__/case.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,61 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { capitalize, capitalizeWords, camelCase, pascalCase, snakeCase, kebabCase, constantCase, } from '../case';
3
+ describe('String Case Conversion', () => {
4
+ describe('capitalize', () => {
5
+ it('should capitalize first letter', () => {
6
+ expect(capitalize('hello')).toBe('Hello');
7
+ expect(capitalize('hello world')).toBe('Hello world');
8
+ expect(capitalize('HELLO')).toBe('HELLO');
9
+ });
10
+ it('should handle empty string', () => {
11
+ expect(capitalize('')).toBe('');
12
+ });
13
+ });
14
+ describe('capitalizeWords', () => {
15
+ it('should capitalize each word', () => {
16
+ expect(capitalizeWords('hello world')).toBe('Hello World');
17
+ expect(capitalizeWords('the quick brown fox')).toBe('The Quick Brown Fox');
18
+ });
19
+ });
20
+ describe('camelCase', () => {
21
+ it('should convert to camelCase', () => {
22
+ expect(camelCase('hello world')).toBe('helloWorld');
23
+ expect(camelCase('hello-world')).toBe('helloWorld');
24
+ expect(camelCase('hello_world')).toBe('helloWorld');
25
+ expect(camelCase('Hello World')).toBe('helloWorld');
26
+ });
27
+ it('should handle already camelCase strings', () => {
28
+ expect(camelCase('helloWorld')).toBe('helloworld');
29
+ });
30
+ });
31
+ describe('pascalCase', () => {
32
+ it('should convert to PascalCase', () => {
33
+ expect(pascalCase('hello world')).toBe('HelloWorld');
34
+ expect(pascalCase('hello-world')).toBe('HelloWorld');
35
+ expect(pascalCase('hello_world')).toBe('HelloWorld');
36
+ });
37
+ });
38
+ describe('snakeCase', () => {
39
+ it('should convert to snake_case', () => {
40
+ expect(snakeCase('helloWorld')).toBe('hello_world');
41
+ expect(snakeCase('Hello World')).toBe('hello_world');
42
+ expect(snakeCase('hello-world')).toBe('hello_world');
43
+ expect(snakeCase('HelloWorld')).toBe('hello_world');
44
+ });
45
+ });
46
+ describe('kebabCase', () => {
47
+ it('should convert to kebab-case', () => {
48
+ expect(kebabCase('helloWorld')).toBe('hello-world');
49
+ expect(kebabCase('Hello World')).toBe('hello-world');
50
+ expect(kebabCase('hello_world')).toBe('hello-world');
51
+ expect(kebabCase('HelloWorld')).toBe('hello-world');
52
+ });
53
+ });
54
+ describe('constantCase', () => {
55
+ it('should convert to CONSTANT_CASE', () => {
56
+ expect(constantCase('helloWorld')).toBe('HELLO_WORLD');
57
+ expect(constantCase('Hello World')).toBe('HELLO_WORLD');
58
+ expect(constantCase('hello-world')).toBe('HELLO_WORLD');
59
+ });
60
+ });
61
+ });
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=manipulation.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manipulation.test.d.ts","sourceRoot":"","sources":["../../../src/string/__tests__/manipulation.test.ts"],"names":[],"mappings":""}