pds-dev-kit-web-test 2.6.29 → 2.7.0

package/dist/src/common/types/text.d.ts

@@ -1,2 +1,4 @@
 import type { TFunctionResult } from 'i18next';
 export type PDSTextType = number | TFunctionResult;
+export type TextLabelStyleThemeType = 'displayBold' | 'wizardPageTitleBold' | 'headingBold' | 'leadParaBold' | 'leadParaRegular' | 'subTitleBold' | 'subTitleRegular' | 'body1Bold' | 'body1Regular' | 'body2Bold' | 'body2Regular' | 'caption1Bold' | 'caption1Regular' | 'caption2Bold' | 'caption2Regular' | 'form1Regular' | 'form1Bold' | 'form2Regular' | 'form2Bold' | 'blog1Regular';
+export type TextLabelColorThemeType = 'sysTextPrimary' | 'sysTextSecondary' | 'sysTextTertiary' | 'sysTextWhite' | 'sysTextBlack' | 'sysTextError' | 'sysTextWarning' | 'sysTextBrandPrimary' | 'sysTextBrandSeconVariant' | 'usrTextBrandPrimary' | 'usrTextBrandSeconVariant' | 'usrTextBrandOnPrimary';

package/dist/src/common/utils/SystemUIPositionGenerator/hoverTypeSystemUICssGenerator.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 function hoverTypeSystemUICssGenerator(_a) {
     var baseSize = _a.baseSize, sizeOffset = _a.sizeOffset, positionOffset = _a.positionOffset, systemUIPosition = _a.systemUIPosition, _b = _a.distance, distance = _b === void 0 ? 8 : _b;
     if (!sizeOffset || !positionOffset) {
-        return 'visibility: hidden;';
+        return '';
     }
     var end = positionOffset.left, bottom = positionOffset.bottom, top = positionOffset.top;
     var width = sizeOffset.width, height = sizeOffset.height;

package/dist/src/common/utils/dateHelper.d.ts

@@ -10,4 +10,7 @@ export declare class DateHelper {
     static addMonths(date: Date, diff: number): Date;
     static addDays(date: Date, diff: number): Date;
     static getCalendarDates(monthDate: Date, startOfWeek: 'sunday' | 'monday'): Date[];
+    static endOfMonth(date: Date): Date;
+    static getCalendarDatesForCalendar(monthDate: Date, startOfWeek: 'sunday' | 'monday'): Date[];
+    static getDatesInRange(startDate: Date, endDate: Date): Date[];
 }

package/dist/src/common/utils/dateHelper.js

@@ -82,6 +82,43 @@ var DateHelper = /** @class */ (function () {
         var calendarStart = this.addDays(start, -offset);
         return Array.from({ length: 42 }, function (_, i) { return _this.addDays(calendarStart, i); });
     };
+    /*
+     * 월의 마지막 날짜 반환
+     */
+    DateHelper.endOfMonth = function (date) {
+        return new Date(date.getFullYear(), date.getMonth() + 1, 0);
+    };
+    /*
+     * 일반 캘린더처럼 현재 달의 날짜만 표시하고, 필요한 경우에만 이전/다음 달의 날짜를 포함
+     */
+    DateHelper.getCalendarDatesForCalendar = function (monthDate, startOfWeek) {
+        var start = this.startOfMonth(monthDate);
+        var end = this.endOfMonth(monthDate);
+        var startIndex = startOfWeek === 'monday' ? 1 : 0;
+        // 시작 날짜의 요일 조정
+        var startOffset = (start.getDay() - startIndex + 7) % 7;
+        var calendarStart = this.addDays(start, -startOffset);
+        // 마지막 날짜의 요일 조정
+        var endOffset = (6 - end.getDay() + startIndex) % 7;
+        var calendarEnd = this.addDays(end, endOffset);
+        // 전체 날짜 배열 생성
+        var dates = [];
+        var currentDate = new Date(calendarStart);
+        while (currentDate <= calendarEnd) {
+            dates.push(new Date(currentDate));
+            currentDate = this.addDays(currentDate, 1);
+        }
+        return dates;
+    };
+    DateHelper.getDatesInRange = function (startDate, endDate) {
+        var dates = [];
+        var currentDate = new Date(startDate);
+        while (currentDate <= endDate) {
+            dates.push(new Date(currentDate));
+            currentDate.setDate(currentDate.getDate() + 1);
+        }
+        return dates;
+    };
     return DateHelper;
 }());
 exports.DateHelper = DateHelper;

package/dist/src/core/pricing/formatter.d.ts

@@ -0,0 +1,4 @@
+import type { Price } from './types';
+export declare class PricingFormatter {
+    static price(price: Price): string;
+}

package/dist/src/core/pricing/formatter.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PricingFormatter = void 0;
+var types_1 = require("./types");
+var PricingFormatter = /** @class */ (function () {
+    function PricingFormatter() {
+    }
+    PricingFormatter.price = function (price) {
+        var amount = price.amount, currency = price.currency;
+        var decimalDigits = types_1.CURRENCY_MAP[currency].decimalDigits;
+        var str = Number(amount).toFixed(decimalDigits);
+        return decimalDigits > 0
+            ? str.replace(/(\d)(?=(\d{3})+\.)/g, '$1,') // 소수점 포함
+            : str.replace(/(\d)(?=(\d{3})+$)/g, '$1,'); // 정수 전용, 세 자리 콤마
+    };
+    return PricingFormatter;
+}());
+exports.PricingFormatter = PricingFormatter;

package/dist/src/core/pricing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './service';

package/dist/src/core/pricing/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./service"), exports);

package/dist/src/core/pricing/policy.d.ts

@@ -0,0 +1,26 @@
+import { CurrencyCode } from './types';
+import type { Currency, Price } from './types';
+/**
+ * publ이 지원하는 통화 목록
+ */
+export declare const SUPPORTED_CURRENCIES: readonly [CurrencyCode.KRW, CurrencyCode.USD, CurrencyCode.JPY];
+export type SupportedCurrency = typeof SUPPORTED_CURRENCIES[number];
+export declare const CURRENCY_BY_LOCALE_MAP: Record<string, CurrencyCode>;
+/**
+ * 통화 가격 정책
+ */
+export interface CurrencyPricePolicy {
+    currency: Currency;
+    minPayment: Price;
+    minPromotionPayment?: Price;
+    maxPayment: Price;
+    paymentUnit: number;
+}
+/**
+ * 통화별 기본 가격 정책
+ */
+export declare const DEFAULT_CURRENCY_PRICE_POLICIES: Record<CurrencyCode, CurrencyPricePolicy>;
+/**
+ * 별도의 통화별 가격 정책을 보유한 채널 목록
+ */
+export declare const CHANNEL_CURRENCY_PRICE_POLICIES: Record<string, CurrencyPricePolicy>;

package/dist/src/core/pricing/policy.js

@@ -0,0 +1,98 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHANNEL_CURRENCY_PRICE_POLICIES = exports.DEFAULT_CURRENCY_PRICE_POLICIES = exports.CURRENCY_BY_LOCALE_MAP = exports.SUPPORTED_CURRENCIES = void 0;
+var types_1 = require("./types");
+/**
+ * publ이 지원하는 통화 목록
+ */
+exports.SUPPORTED_CURRENCIES = [types_1.CurrencyCode.KRW, types_1.CurrencyCode.USD, types_1.CurrencyCode.JPY];
+exports.CURRENCY_BY_LOCALE_MAP = {
+    ko: types_1.CurrencyCode.KRW,
+    kr: types_1.CurrencyCode.KRW,
+    en: types_1.CurrencyCode.USD,
+    us: types_1.CurrencyCode.USD,
+    ja: types_1.CurrencyCode.JPY,
+    jp: types_1.CurrencyCode.JPY
+};
+/**
+ * 통화별 기본 가격 정책
+ */
+// customMaxAmount ?? (options.currency === CurrencyCode.KRW ? 10000000 : 10000.0);
+exports.DEFAULT_CURRENCY_PRICE_POLICIES = (_a = {},
+    _a[types_1.CurrencyCode.KRW] = {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.KRW],
+        minPayment: { amount: 300, currency: types_1.CurrencyCode.KRW },
+        maxPayment: { amount: 10000000, currency: types_1.CurrencyCode.KRW },
+        paymentUnit: 100
+    },
+    _a[types_1.CurrencyCode.USD] = {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.USD],
+        minPayment: { amount: 5, currency: types_1.CurrencyCode.USD },
+        maxPayment: { amount: 10000.0, currency: types_1.CurrencyCode.USD },
+        paymentUnit: 0.01
+    },
+    _a[types_1.CurrencyCode.JPY] = {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.JPY],
+        minPayment: { amount: 300, currency: types_1.CurrencyCode.JPY },
+        maxPayment: { amount: 10000000, currency: types_1.CurrencyCode.JPY },
+        paymentUnit: 100
+    },
+    _a);
+/**
+ * 별도의 통화별 가격 정책을 보유한 채널 목록
+ */
+exports.CHANNEL_CURRENCY_PRICE_POLICIES = {
+    // 루시드 드림 채널
+    L2NoYW5uZWxzLzMyMDA: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.KRW],
+        minPayment: { amount: 15000, currency: types_1.CurrencyCode.KRW },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].maxPayment,
+        paymentUnit: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].paymentUnit
+    },
+    // 이승기 채널
+    L2NoYW5uZWxzLzkz: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.KRW],
+        minPayment: { amount: 5000, currency: types_1.CurrencyCode.KRW },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].maxPayment,
+        paymentUnit: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].paymentUnit
+    },
+    // publDEV - 앱 채널
+    L2NoYW5uZWxzLzExNzQ: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.KRW],
+        minPayment: { amount: 5000, currency: types_1.CurrencyCode.KRW },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].maxPayment,
+        paymentUnit: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].paymentUnit
+    },
+    // KAVECON 채널
+    L2NoYW5uZWxzLzU4MTQ: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.KRW],
+        minPayment: { amount: 20000, currency: types_1.CurrencyCode.KRW },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].maxPayment,
+        paymentUnit: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.KRW].paymentUnit
+    },
+    // 투니모션 채널
+    L2NoYW5uZWxzLzE4NTcx: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.USD],
+        minPayment: { amount: 0.3, currency: types_1.CurrencyCode.USD },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.USD].maxPayment,
+        minPromotionPayment: { amount: 0.1, currency: types_1.CurrencyCode.USD },
+        paymentUnit: 0.1
+    },
+    // DEV 테스트 채널 - webCP 해외 1:100
+    L2NoYW5uZWxzLzIyMTM: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.USD],
+        minPayment: { amount: 0.3, currency: types_1.CurrencyCode.USD },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.USD].maxPayment,
+        minPromotionPayment: { amount: 0.1, currency: types_1.CurrencyCode.USD },
+        paymentUnit: 0.1
+    },
+    // PROD 테스트 채널
+    L2NoYW5uZWxzLzE4Nzg0: {
+        currency: types_1.CURRENCY_MAP[types_1.CurrencyCode.USD],
+        minPayment: { amount: 0.3, currency: types_1.CurrencyCode.USD },
+        minPromotionPayment: { amount: 0.1, currency: types_1.CurrencyCode.USD },
+        maxPayment: exports.DEFAULT_CURRENCY_PRICE_POLICIES[types_1.CurrencyCode.USD].maxPayment,
+        paymentUnit: 0.1
+    }
+};

package/dist/src/core/pricing/service.d.ts

@@ -0,0 +1,62 @@
+import { PricingFormatter } from './formatter';
+import { PricingTranslator } from './translator';
+import { CurrencyCode } from './types';
+import { PricingValidator } from './validator';
+import type { CurrencyPricePolicy, SupportedCurrency } from './policy';
+import type { Currency, ExchangeRateMap, Price } from './types';
+import type { PriceTextField } from '../../desktop/components';
+/**
+ * PricingService는 상품의 판매가, 할인, 통화 포맷 등 가격 관련 비즈니스 로직을 처리하는 도메인 서비스입니다
+ */
+export declare class PricingService {
+    private static instance;
+    static getInstance(): PricingService;
+    static format: typeof PricingFormatter;
+    static translate: typeof PricingTranslator;
+    static validate: typeof PricingValidator;
+    private browserLanguage;
+    static init(browserLanguage: string): void;
+    setBrowserLanguage(locale: string): void;
+    static getCurrency(currency: CurrencyCode): Currency;
+    /**
+     * publ이 지원하는 통화인지 반환합니다
+     */
+    static isSupportedCurrency(currency: string): currency is SupportedCurrency;
+    /**
+     * 채널의 통화 가격 정책을 반환합니다
+     */
+    static getCurrencyPricePolicy(channelCode: string, currency: CurrencyCode): CurrencyPricePolicy;
+    /**
+     * 유저의 선호 통화 기본값을 반환합니다
+     */
+    static getDefaultPreferredCurrency(userCountryCode?: string): CurrencyCode;
+    /**
+     * 환율 변환 유틸리티
+     *
+     * @param amount 금액 (from 통화 기준)
+     * @param from 원래 통화
+     * @param to 변환할 대상 통화
+     * @param exchangeRates 기준 통화 대비 환율 테이블 (예: { USD: 1, KRW: 1300, EUR: 0.9 })
+     * @returns 환산된 금액 (소수점 반올림 포함)
+     */
+    static exchangePrice(amount: number, from: CurrencyCode, to: CurrencyCode, exchangeRates: ExchangeRateMap): number;
+    /**
+     * 기준 통화 상품 가격을 선호 통화 가격으로 변환합니다
+     * @param price 기준 통화의 상품 가격
+     * @param preferredCurrency 선호 통화
+     * @param exchangeRates 기준 통화 대비 환율 테이블
+     */
+    static convertToPreferredPrice(price: Price, preferredCurrency: CurrencyCode, exchangeRates: ExchangeRateMap): Price;
+    /**
+     * 채널 가격 정책 기반의 PriceTextField Props를 반환합니다
+     */
+    static getPriceTextFieldProps(channelCode: string, options: {
+        currency: CurrencyCode;
+        isPromotionPrice?: boolean;
+        validation?: {
+            useRequiredValidation?: 'none' | 'use';
+            customMinAmount?: number;
+            customMaxAmount?: number;
+        };
+    }): Partial<Parameters<typeof PriceTextField>[0]>;
+}

package/dist/src/core/pricing/service.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PricingService = void 0;
+var i18next_1 = __importDefault(require("i18next"));
+var formatter_1 = require("./formatter");
+var policy_1 = require("./policy");
+var translator_1 = require("./translator");
+var types_1 = require("./types");
+var validator_1 = require("./validator");
+/**
+ * PricingService는 상품의 판매가, 할인, 통화 포맷 등 가격 관련 비즈니스 로직을 처리하는 도메인 서비스입니다
+ */
+var PricingService = /** @class */ (function () {
+    function PricingService() {
+        this.browserLanguage = null;
+    }
+    PricingService.getInstance = function () {
+        if (!PricingService.instance) {
+            PricingService.instance = new PricingService();
+        }
+        return PricingService.instance;
+    };
+    PricingService.init = function (browserLanguage) {
+        var instance = PricingService.getInstance();
+        instance.setBrowserLanguage(browserLanguage);
+    };
+    PricingService.prototype.setBrowserLanguage = function (locale) {
+        this.browserLanguage = locale;
+        translator_1.PricingTranslator.setBrowserLanguage(locale);
+    };
+    //-----------------------------------------------------------------------------
+    // 유틸리티
+    //-----------------------------------------------------------------------------
+    PricingService.getCurrency = function (currency) {
+        return types_1.CURRENCY_MAP[currency];
+    };
+    /**
+     * publ이 지원하는 통화인지 반환합니다
+     */
+    PricingService.isSupportedCurrency = function (currency) {
+        return policy_1.SUPPORTED_CURRENCIES.includes(currency);
+    };
+    /**
+     * 채널의 통화 가격 정책을 반환합니다
+     */
+    PricingService.getCurrencyPricePolicy = function (channelCode, currency) {
+        var _a;
+        return ((_a = policy_1.CHANNEL_CURRENCY_PRICE_POLICIES[channelCode]) !== null && _a !== void 0 ? _a : policy_1.DEFAULT_CURRENCY_PRICE_POLICIES[currency]);
+    };
+    /**
+     * 유저의 선호 통화 기본값을 반환합니다
+     */
+    PricingService.getDefaultPreferredCurrency = function (userCountryCode) {
+        // #1 사용자 국가 코드
+        if (userCountryCode) {
+            var currency = policy_1.CURRENCY_BY_LOCALE_MAP[userCountryCode];
+            if (currency) {
+                return currency;
+            }
+        }
+        // #2 채널 기준 통화
+        // const { channel } = PricingService.getInstance();
+        // if (!channel) {
+        //   throw new Error('PricingService::getDefaultPreferredCurrency error: INVALID_CHANNEL');
+        // }
+        //
+        // return channel.baseCurrency as CurrencyCode;
+        return types_1.CurrencyCode.USD;
+    };
+    /**
+     * 환율 변환 유틸리티
+     *
+     * @param amount 금액 (from 통화 기준)
+     * @param from 원래 통화
+     * @param to 변환할 대상 통화
+     * @param exchangeRates 기준 통화 대비 환율 테이블 (예: { USD: 1, KRW: 1300, EUR: 0.9 })
+     * @returns 환산된 금액 (소수점 반올림 포함)
+     */
+    PricingService.exchangePrice = function (amount, from, to, exchangeRates) {
+        var _a;
+        var fromRate = exchangeRates[from];
+        var toRate = exchangeRates[to];
+        if (!fromRate || !toRate) {
+            throw new Error("PricingService::exchangePrice error: Missing rate for currency: ".concat(!fromRate ? from : to));
+        }
+        var baseAmount = amount / fromRate; // 기준 통화로 환산
+        var targetAmount = baseAmount * toRate;
+        var decimalDigits = (_a = types_1.CURRENCY_MAP[to].decimalDigits) !== null && _a !== void 0 ? _a : 0;
+        return Number(targetAmount.toFixed(decimalDigits));
+    };
+    /**
+     * 기준 통화 상품 가격을 선호 통화 가격으로 변환합니다
+     * @param price 기준 통화의 상품 가격
+     * @param preferredCurrency 선호 통화
+     * @param exchangeRates 기준 통화 대비 환율 테이블
+     */
+    PricingService.convertToPreferredPrice = function (price, preferredCurrency, exchangeRates) {
+        return {
+            amount: PricingService.exchangePrice(Number(price.amount), price.currency, preferredCurrency, exchangeRates),
+            currency: preferredCurrency
+        };
+    };
+    /**
+     * 채널 가격 정책 기반의 PriceTextField Props를 반환합니다
+     */
+    PricingService.getPriceTextFieldProps = function (channelCode, options) {
+        var _a, _b, _c, _d;
+        var policy = PricingService.getCurrencyPricePolicy(channelCode, options.currency);
+        var useRequiredValidation = (_b = (_a = options.validation) === null || _a === void 0 ? void 0 : _a.useRequiredValidation) !== null && _b !== void 0 ? _b : 'use';
+        var customMinAmount = (_c = options.validation) === null || _c === void 0 ? void 0 : _c.customMinAmount;
+        var customMaxAmount = (_d = options.validation) === null || _d === void 0 ? void 0 : _d.customMaxAmount;
+        var validation = {};
+        // Required validation
+        if (useRequiredValidation === 'use') {
+            validation.required = i18next_1.default.t('str_please_enter_price');
+        }
+        else {
+            validation.required = false;
+        }
+        validation.validate = {
+            min: function (value) {
+                var _a, _b;
+                var minAmount = customMinAmount !== null && customMinAmount !== void 0 ? customMinAmount : (options.isPromotionPrice
+                    ? Math.min(Number(policy.minPayment.amount), Number((_b = (_a = policy.minPromotionPayment) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : policy.minPayment.amount))
+                    : Number(policy.minPayment.amount));
+                return PricingService.validate.min(value, {
+                    minAmount: minAmount,
+                    currency: options.currency
+                });
+            },
+            max: function (value) {
+                var maxAmount = customMaxAmount !== null && customMaxAmount !== void 0 ? customMaxAmount : Number(policy.maxPayment.amount);
+                return PricingService.validate.max(value, {
+                    maxAmount: maxAmount,
+                    currency: options.currency
+                });
+            },
+            format: function (value) {
+                return PricingService.validate.format(value, {
+                    paymentUnit: policy.paymentUnit,
+                    currency: options.currency
+                });
+            }
+        };
+        return {
+            validation: validation
+        };
+    };
+    PricingService.format = formatter_1.PricingFormatter;
+    PricingService.translate = translator_1.PricingTranslator;
+    PricingService.validate = validator_1.PricingValidator;
+    return PricingService;
+}());
+exports.PricingService = PricingService;

package/dist/src/core/pricing/translator.d.ts

@@ -0,0 +1,27 @@
+import type { CurrencyCodeType, Price, TranslationType } from './types';
+export interface PricingTranslateOptions {
+    friendly?: boolean;
+    translation?: TranslationType;
+}
+export declare class PricingTranslator {
+    private static browserLanguage;
+    static setBrowserLanguage(browserLanguage: string): void;
+    /**
+     * 통화 표시가 금액 앞에 오는지 브라우저 언어 기준으로 판단합니다.
+     *
+     * @example
+     * isCurrencyLeading('en-US') // true → "USD 10"
+     * isCurrencyLeading('ko-KR') // false → "10 KRW"
+     */
+    static isCurrencyLeading(browserLanguage: string | null): boolean;
+    /**
+     * 통화 문자열을 반환합니다
+     * @example "KRW" 또는 "원"
+     */
+    static currency(code: CurrencyCodeType, opts?: PricingTranslateOptions): string;
+    /**
+     * 포맷된 금액과 통화 문자열을 결합합니다
+     * @example "10,000 KRW" 또는 "10,000원"
+     */
+    static priceWithCurrency(price: Price, opts?: PricingTranslateOptions): string;
+}

package/dist/src/core/pricing/translator.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PricingTranslator = void 0;
+var formatter_1 = require("./formatter");
+var types_1 = require("./types");
+var PricingTranslator = /** @class */ (function () {
+    function PricingTranslator() {
+    }
+    PricingTranslator.setBrowserLanguage = function (browserLanguage) {
+        PricingTranslator.browserLanguage = browserLanguage;
+    };
+    /**
+     * 통화 표시가 금액 앞에 오는지 브라우저 언어 기준으로 판단합니다.
+     *
+     * @example
+     * isCurrencyLeading('en-US') // true → "USD 10"
+     * isCurrencyLeading('ko-KR') // false → "10 KRW"
+     */
+    PricingTranslator.isCurrencyLeading = function (browserLanguage) {
+        if (!browserLanguage) {
+            return true;
+        }
+        return !['ko', 'ko-kr'].includes(browserLanguage.toLowerCase());
+    };
+    /**
+     * 통화 문자열을 반환합니다
+     * @example "KRW" 또는 "원"
+     */
+    PricingTranslator.currency = function (code, opts) {
+        var currency = types_1.CURRENCY_MAP[code];
+        return (opts === null || opts === void 0 ? void 0 : opts.friendly) ? currency.friendlyName(opts.translation) : currency.name;
+    };
+    /**
+     * 포맷된 금액과 통화 문자열을 결합합니다
+     * @example "10,000 KRW" 또는 "10,000원"
+     */
+    PricingTranslator.priceWithCurrency = function (price, opts) {
+        var formattedAmount = formatter_1.PricingFormatter.price(price);
+        var currencyString = PricingTranslator.currency(price.currency, opts);
+        if (PricingTranslator.isCurrencyLeading(PricingTranslator.browserLanguage)) {
+            return "".concat(currencyString, " ").concat(formattedAmount);
+        }
+        // KRW만 friendly 대응
+        if (price.currency === types_1.CurrencyCode.KRW) {
+            return (opts === null || opts === void 0 ? void 0 : opts.friendly)
+                ? "".concat(formattedAmount).concat(currencyString)
+                : "".concat(formattedAmount, " ").concat(currencyString);
+        }
+        return "".concat(formattedAmount, " ").concat(currencyString);
+    };
+    PricingTranslator.browserLanguage = null;
+    return PricingTranslator;
+}());
+exports.PricingTranslator = PricingTranslator;

package/dist/src/core/pricing/types.d.ts

@@ -0,0 +1,19 @@
+export declare enum CurrencyCode {
+    KRW = "KRW",
+    USD = "USD",
+    JPY = "JPY"
+}
+export type CurrencyCodeType = CurrencyCode | string;
+export type TranslationType = (key: string) => string;
+export interface Currency {
+    code: CurrencyCode;
+    name: string;
+    friendlyName: (translate?: TranslationType) => string;
+    decimalDigits: number;
+}
+export declare const CURRENCY_MAP: Record<CurrencyCode, Currency>;
+export interface Price {
+    amount: number | string;
+    currency: CurrencyCodeType;
+}
+export type ExchangeRateMap = Partial<Record<CurrencyCode, number>>;

package/dist/src/core/pricing/types.js

@@ -0,0 +1,31 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENCY_MAP = exports.CurrencyCode = void 0;
+var CurrencyCode;
+(function (CurrencyCode) {
+    CurrencyCode["KRW"] = "KRW";
+    CurrencyCode["USD"] = "USD";
+    CurrencyCode["JPY"] = "JPY";
+})(CurrencyCode = exports.CurrencyCode || (exports.CurrencyCode = {}));
+var translateFriendlyName = function (key) { return function (t) { var _a; return (_a = t === null || t === void 0 ? void 0 : t(key)) !== null && _a !== void 0 ? _a : key; }; };
+exports.CURRENCY_MAP = (_a = {},
+    _a[CurrencyCode.KRW] = {
+        code: CurrencyCode.KRW,
+        name: CurrencyCode.KRW,
+        friendlyName: translateFriendlyName('str_friendly_currency_won'),
+        decimalDigits: 0
+    },
+    _a[CurrencyCode.USD] = {
+        code: CurrencyCode.USD,
+        name: CurrencyCode.USD,
+        friendlyName: function () { return CurrencyCode.USD; },
+        decimalDigits: 2
+    },
+    _a[CurrencyCode.JPY] = {
+        code: CurrencyCode.JPY,
+        name: CurrencyCode.JPY,
+        friendlyName: translateFriendlyName('str_friendly_currency_jpy'),
+        decimalDigits: 0
+    },
+    _a);

package/dist/src/core/pricing/validator.d.ts

@@ -0,0 +1,29 @@
+import type { PricingTranslateOptions } from './translator';
+import type { CurrencyCode } from './types';
+export declare class PricingValidator {
+    /**
+     * 최소 결제 금액 검증
+     * @returns i18n 오류 메시지 | undefined
+     */
+    static min(value: string, options: {
+        minAmount: number;
+        currency: CurrencyCode;
+    }): string | undefined;
+    /**
+     * 최대 결제 금액 검증
+     * @returns i18n 오류 메시지 | undefined
+     */
+    static max(value: string, options: {
+        maxAmount: number;
+        currency: CurrencyCode;
+    }): string | undefined;
+    /**
+     * 가격 형식 검증: 소수 자릿수 또는 결제 단위
+     * @returns i18n 오류 메시지 | undefined
+     */
+    static format(value: string, options: {
+        paymentUnit: number;
+        currency: CurrencyCode;
+        currencyTranslateOptions?: PricingTranslateOptions;
+    }): string | undefined;
+}