pds-dev-kit-web-test 2.2.99 → 2.2.652

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

@@ -1,5 +1,10 @@
-import type fillIcons from '../assets/icons/fill';
-import type lineIcons from '../assets/icons/line';
+import fillIcons from '../assets/icons/fill';
+import { imageIconSrcSet } from '../assets/icons/image';
+import lineIcons from '../assets/icons/line';
 export type FillIconNameKeys = keyof typeof fillIcons;
 export type LineIconNameKeys = keyof typeof lineIcons;
-export type PDSIconType = FillIconNameKeys | LineIconNameKeys;
+export type ImageIconNameKeys = keyof typeof imageIconSrcSet;
+export type PDSIconType = FillIconNameKeys | LineIconNameKeys | ImageIconNameKeys;
+export declare const fillIconkeys: string[];
+export declare const lineIconkeys: string[];
+export declare const imageIconKeys: string[];

package/dist/src/common/types/icon.js

@@ -1,2 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.imageIconKeys = exports.lineIconkeys = exports.fillIconkeys = void 0;
+var fill_1 = __importDefault(require("../assets/icons/fill"));
+var image_1 = require("../assets/icons/image");
+var line_1 = __importDefault(require("../assets/icons/line"));
+exports.fillIconkeys = Object.keys(fill_1.default);
+exports.lineIconkeys = Object.keys(line_1.default);
+exports.imageIconKeys = Object.keys(image_1.imageIconSrcSet);

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

@@ -1,6 +1,6 @@
-export * from './form';
 export * from './icon';
 export * from './styled-components';
 export * from './text';
 export * from './uiColors';
 export * from './components';
+export * from './multilingual';

package/dist/src/common/types/index.js

@@ -14,9 +14,9 @@ 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("./form"), exports);
 __exportStar(require("./icon"), exports);
 __exportStar(require("./styled-components"), exports);
 __exportStar(require("./text"), exports);
 __exportStar(require("./uiColors"), exports);
 __exportStar(require("./components"), exports);
+__exportStar(require("./multilingual"), exports);

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

@@ -0,0 +1,16 @@
+type LanguageCode = 'en' | 'ko' | 'ja' | 'zh' | 'zh-Hant' | 'fr' | 'de' | 'es' | 'it' | 'pt' | 'ru' | 'vi' | 'th' | 'id' | 'ms' | 'ar' | 'tr' | 'pl' | 'nl' | 'sv' | 'fi' | 'no' | 'da' | 'he' | 'hi' | 'bn' | 'ta' | 'el' | 'cs' | 'ro';
+type MultilingualConfig = {
+    textFieldLineType?: 'single' | 'multi' | 'auto' | 'tinyeditor';
+    originalText?: string;
+    initialValues?: {
+        [key in LanguageCode]?: string;
+    };
+    visibleLanguages?: LanguageCode[];
+    readonlyLanguages?: LanguageCode[];
+    hiddenInputId: string;
+    onApply?: (values: {
+        [key in LanguageCode]?: string;
+    }) => void;
+    onTinyEditorAction?: () => void;
+};
+export type { LanguageCode, MultilingualConfig };

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/dateHelper.d.ts

@@ -0,0 +1,16 @@
+export declare class DateHelper {
+    static padZero(num: number): string;
+    static formatDate(date: Date): string;
+    static parseDate(dateStr: string): Date;
+    static getToday(): string;
+    static isSameDay(a: string | Date, b: string | Date): boolean;
+    static isBefore(a: Date, b: Date): boolean;
+    static isAfter(a: Date, b: Date): boolean;
+    static startOfMonth(date: Date): Date;
+    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

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateHelper = void 0;
+var DateHelper = /** @class */ (function () {
+    function DateHelper() {
+    }
+    /*
+     * 한 자리 숫자를 두 자리 문자열로 변환 (예: 5 → '05')
+     */
+    DateHelper.padZero = function (num) {
+        return num.toString().padStart(2, '0');
+    };
+    /*
+     * Date 객체를 'YYYY-MM-DD' 형식의 문자열로 포맷
+     */
+    DateHelper.formatDate = function (date) {
+        return "".concat(date.getFullYear(), "-").concat(this.padZero(date.getMonth() + 1), "-").concat(this.padZero(date.getDate()));
+    };
+    /*
+     * 문자열을 Date 객체로 파싱
+     */
+    DateHelper.parseDate = function (dateStr) {
+        var _a = dateStr.split('-').map(Number), y = _a[0], m = _a[1], d = _a[2];
+        return new Date(y, m - 1, d);
+    };
+    /*
+     * 오늘 날짜를 'YYYY-MM-DD' 형식으로 반환
+     */
+    DateHelper.getToday = function () {
+        return this.formatDate(new Date());
+    };
+    /*
+     * 두 날짜가 같은 날인지 비교 (string 또는 Date 입력 가능)
+     */
+    DateHelper.isSameDay = function (a, b) {
+        var dateA = typeof a === 'string' ? this.parseDate(a) : a;
+        var dateB = typeof b === 'string' ? this.parseDate(b) : b;
+        return (dateA.getFullYear() === dateB.getFullYear() &&
+            dateA.getMonth() === dateB.getMonth() &&
+            dateA.getDate() === dateB.getDate());
+    };
+    /*
+     * a가 b보다 이전 날짜인지 여부 반환
+     */
+    DateHelper.isBefore = function (a, b) {
+        return a.getTime() < b.getTime();
+    };
+    /*
+     * a가 b보다 이후 날짜인지 여부 반환
+     */
+    DateHelper.isAfter = function (a, b) {
+        return a.getTime() > b.getTime();
+    };
+    /*
+     * 해당 월의 시작 날짜 반환 (1일)
+     */
+    DateHelper.startOfMonth = function (date) {
+        return new Date(date.getFullYear(), date.getMonth(), 1);
+    };
+    /*
+     * 기준 날짜에서 n개월 후/전 날짜 반환 (해당 월의 1일)
+     */
+    DateHelper.addMonths = function (date, diff) {
+        return new Date(date.getFullYear(), date.getMonth() + diff, 1);
+    };
+    /*
+     * 기준 날짜에서 n일 후/전 날짜 반환
+     */
+    DateHelper.addDays = function (date, diff) {
+        var newDate = new Date(date);
+        newDate.setDate(newDate.getDate() + diff);
+        return newDate;
+    };
+    /*
+     * 월 달력에 표시할 날짜 배열 생성 (6주 기준, 총 42일)
+     */
+    DateHelper.getCalendarDates = function (monthDate, startOfWeek) {
+        var _this = this;
+        var start = this.startOfMonth(monthDate);
+        var startIndex = startOfWeek === 'monday' ? 1 : 0;
+        var offset = (start.getDay() - startIndex + 7) % 7;
+        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;
+}