goodchuck-utils 1.7.1 → 1.9.0

package/dist/number/format.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Number Formatting Utilities
+ *
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
+ */
+/**
+ * 숫자를 천 단위 구분자로 포맷팅
+ * @param value - 포맷팅할 숫자
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @returns 포맷팅된 문자열
+ *
+ * @example
+ * formatNumber(1234567) // "1,234,567"
+ * formatNumber(1234.56, 2) // "1,234.56"
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
+ */
+export declare function formatNumber(value: number | string, decimals?: number, separator?: string): string;
+/**
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
+ * @param value - 포맷팅할 가격
+ * @param currency - 통화 기호 (기본값: '₩')
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @param position - 통화 기호 위치 (기본값: 'before')
+ * @returns 포맷팅된 가격 문자열
+ *
+ * @example
+ * formatPrice(1234567) // "₩1,234,567"
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
+ */
+export declare function formatPrice(value: number | string, currency?: string, decimals?: number, separator?: string, position?: 'before' | 'after'): string;
+/**
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
+ * @param value - 포맷팅할 금액
+ * @param locale - 로케일 (기본값: 'ko-KR')
+ * @param currency - 통화 코드 (기본값: 'KRW')
+ * @param style - 표시 스타일 (기본값: 'currency')
+ * @returns 포맷팅된 통화 문자열
+ *
+ * @example
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
+ */
+export declare function formatCurrencyIntl(value: number | string, locale?: string, currency?: string, style?: 'currency' | 'decimal'): string;
+/**
+ * 가격 문자열을 숫자로 변환
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
+ * @returns 변환된 숫자
+ *
+ * @example
+ * parsePrice("₩1,234,567") // 1234567
+ * parsePrice("1,234.56") // 1234.56
+ * parsePrice("$1,234.56") // 1234.56
+ */
+export declare function parsePrice(priceString: string): number;
+/**
+ * 할인율 계산
+ * @param originalPrice - 원래 가격
+ * @param discountedPrice - 할인된 가격
+ * @returns 할인율 (퍼센트)
+ *
+ * @example
+ * calculateDiscount(10000, 8000) // 20
+ * calculateDiscount(100, 75) // 25
+ */
+export declare function calculateDiscount(originalPrice: number, discountedPrice: number): number;
+/**
+ * 할인 가격 계산
+ * @param originalPrice - 원래 가격
+ * @param discountPercent - 할인율 (퍼센트)
+ * @returns 할인된 가격
+ *
+ * @example
+ * calculateDiscountedPrice(10000, 20) // 8000
+ * calculateDiscountedPrice(100, 25) // 75
+ */
+export declare function calculateDiscountedPrice(originalPrice: number, discountPercent: number): number;
+/**
+ * 세금 포함 가격 계산
+ * @param price - 세전 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세금 포함 가격
+ *
+ * @example
+ * calculatePriceWithTax(10000, 10) // 11000
+ * calculatePriceWithTax(100, 20) // 120
+ */
+export declare function calculatePriceWithTax(price: number, taxRate?: number): number;
+/**
+ * 세금 제외 가격 계산
+ * @param priceWithTax - 세금 포함 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세전 가격
+ *
+ * @example
+ * calculatePriceWithoutTax(11000, 10) // 10000
+ * calculatePriceWithoutTax(120, 20) // 100
+ */
+export declare function calculatePriceWithoutTax(priceWithTax: number, taxRate?: number): number;
+/**
+ * 백분율 포맷팅
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
+ * @param decimals - 소수점 자릿수 (기본값: 1)
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
+ * @returns 포맷팅된 퍼센트 문자열
+ *
+ * @example
+ * formatPercent(0.1234, 1, true) // "12.3%"
+ * formatPercent(12.34, 1, false) // "12.3%"
+ * formatPercent(50) // "50.0%"
+ */
+export declare function formatPercent(value: number, decimals?: number, isDecimal?: boolean): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/number/format.d.ts.map

@@ -0,0 +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"}

package/dist/number/format.js

@@ -0,0 +1,165 @@
+/**
+ * Number Formatting Utilities
+ *
+ * 숫자 및 가격 포맷팅 관련 유틸리티 함수들
+ */
+/**
+ * 숫자를 천 단위 구분자로 포맷팅
+ * @param value - 포맷팅할 숫자
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @returns 포맷팅된 문자열
+ *
+ * @example
+ * formatNumber(1234567) // "1,234,567"
+ * formatNumber(1234.56, 2) // "1,234.56"
+ * formatNumber(1234.56, 2, '.') // "1.234.56"
+ */
+export function formatNumber(value, decimals = 0, separator = ',') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num)) {
+        return '0';
+    }
+    const fixed = num.toFixed(decimals);
+    const parts = fixed.split('.');
+    const integerPart = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    const decimalPart = parts[1] ? `.${parts[1]}` : '';
+    return integerPart + decimalPart;
+}
+/**
+ * 가격을 포맷팅 (천 단위 구분자 + 통화 기호)
+ * @param value - 포맷팅할 가격
+ * @param currency - 통화 기호 (기본값: '₩')
+ * @param decimals - 소수점 자릿수 (기본값: 0)
+ * @param separator - 천 단위 구분자 (기본값: ',')
+ * @param position - 통화 기호 위치 (기본값: 'before')
+ * @returns 포맷팅된 가격 문자열
+ *
+ * @example
+ * formatPrice(1234567) // "₩1,234,567"
+ * formatPrice(1234.56, '₩', 2) // "₩1,234.56"
+ * formatPrice(1234, '$', 0, ',', 'after') // "1,234$"
+ */
+export function formatPrice(value, currency = '₩', decimals = 0, separator = ',', position = 'before') {
+    const formatted = formatNumber(value, decimals, separator);
+    return position === 'before' ? `${currency}${formatted}` : `${formatted}${currency}`;
+}
+/**
+ * 국제화 통화 포맷팅 (Intl.NumberFormat 사용)
+ * @param value - 포맷팅할 금액
+ * @param locale - 로케일 (기본값: 'ko-KR')
+ * @param currency - 통화 코드 (기본값: 'KRW')
+ * @param style - 표시 스타일 (기본값: 'currency')
+ * @returns 포맷팅된 통화 문자열
+ *
+ * @example
+ * formatCurrencyIntl(1234567) // "₩1,234,567"
+ * formatCurrencyIntl(1234.56, 'en-US', 'USD') // "$1,234.56"
+ * formatCurrencyIntl(1234.56, 'ja-JP', 'JPY') // "¥1,235"
+ */
+export function formatCurrencyIntl(value, locale = 'ko-KR', currency = 'KRW', style = 'currency') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num)) {
+        return '0';
+    }
+    return new Intl.NumberFormat(locale, {
+        style,
+        currency,
+        minimumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
+        maximumFractionDigits: currency === 'KRW' || currency === 'JPY' ? 0 : 2,
+    }).format(num);
+}
+/**
+ * 가격 문자열을 숫자로 변환
+ * @param priceString - 가격 문자열 (예: "₩1,234,567" 또는 "1,234.56")
+ * @returns 변환된 숫자
+ *
+ * @example
+ * parsePrice("₩1,234,567") // 1234567
+ * parsePrice("1,234.56") // 1234.56
+ * parsePrice("$1,234.56") // 1234.56
+ */
+export function parsePrice(priceString) {
+    if (!priceString || typeof priceString !== 'string') {
+        return 0;
+    }
+    // 통화 기호, 공백, 쉼표 제거
+    const cleaned = priceString.replace(/[₩$€£¥,\s]/g, '');
+    const parsed = parseFloat(cleaned);
+    return isNaN(parsed) ? 0 : parsed;
+}
+/**
+ * 할인율 계산
+ * @param originalPrice - 원래 가격
+ * @param discountedPrice - 할인된 가격
+ * @returns 할인율 (퍼센트)
+ *
+ * @example
+ * calculateDiscount(10000, 8000) // 20
+ * calculateDiscount(100, 75) // 25
+ */
+export function calculateDiscount(originalPrice, discountedPrice) {
+    if (originalPrice <= 0) {
+        return 0;
+    }
+    const discount = ((originalPrice - discountedPrice) / originalPrice) * 100;
+    return Math.round(discount * 100) / 100; // 소수점 2자리까지
+}
+/**
+ * 할인 가격 계산
+ * @param originalPrice - 원래 가격
+ * @param discountPercent - 할인율 (퍼센트)
+ * @returns 할인된 가격
+ *
+ * @example
+ * calculateDiscountedPrice(10000, 20) // 8000
+ * calculateDiscountedPrice(100, 25) // 75
+ */
+export function calculateDiscountedPrice(originalPrice, discountPercent) {
+    const discount = (originalPrice * discountPercent) / 100;
+    return Math.round((originalPrice - discount) * 100) / 100;
+}
+/**
+ * 세금 포함 가격 계산
+ * @param price - 세전 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세금 포함 가격
+ *
+ * @example
+ * calculatePriceWithTax(10000, 10) // 11000
+ * calculatePriceWithTax(100, 20) // 120
+ */
+export function calculatePriceWithTax(price, taxRate = 10) {
+    const tax = (price * taxRate) / 100;
+    return Math.round((price + tax) * 100) / 100;
+}
+/**
+ * 세금 제외 가격 계산
+ * @param priceWithTax - 세금 포함 가격
+ * @param taxRate - 세율 (퍼센트, 기본값: 10)
+ * @returns 세전 가격
+ *
+ * @example
+ * calculatePriceWithoutTax(11000, 10) // 10000
+ * calculatePriceWithoutTax(120, 20) // 100
+ */
+export function calculatePriceWithoutTax(priceWithTax, taxRate = 10) {
+    const price = priceWithTax / (1 + taxRate / 100);
+    return Math.round(price * 100) / 100;
+}
+/**
+ * 백분율 포맷팅
+ * @param value - 포맷팅할 값 (0-1 또는 0-100)
+ * @param decimals - 소수점 자릿수 (기본값: 1)
+ * @param isDecimal - 값이 0-1 범위인지 여부 (기본값: false, 0-100 범위)
+ * @returns 포맷팅된 퍼센트 문자열
+ *
+ * @example
+ * formatPercent(0.1234, 1, true) // "12.3%"
+ * formatPercent(12.34, 1, false) // "12.3%"
+ * formatPercent(50) // "50.0%"
+ */
+export function formatPercent(value, decimals = 1, isDecimal = false) {
+    const percent = isDecimal ? value * 100 : value;
+    return `${percent.toFixed(decimals)}%`;
+}

package/dist/number/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Number Utilities
+ *
+ * 숫자 및 가격 관련 유틸리티 함수들
+ */
+export * from './format';
+//# sourceMappingURL=index.d.ts.map

package/dist/number/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC"}

package/dist/number/index.js

@@ -0,0 +1,7 @@
+/**
+ * Number Utilities
+ *
+ * 숫자 및 가격 관련 유틸리티 함수들
+ */
+// Formatting utilities
+export * from './format';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goodchuck-utils",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",