/** * Korean (South Korea) language converter * * CLDR: ko-KR | Korean as used in South Korea * * Key features: * - Myriad-based (만) grouping - 4 digits * - Implicit '일' (one) omission before scale words * - Space separation after 만+ scales * - Hangul numerals */ export declare const cardinalMax: bigint; export declare const ordinalMax: bigint; export declare const currencyMax: bigint; /** * Converts a numeric value to Korean words. * @param {number | string | bigint} value - The numeric value to convert * @returns {string} The number in Korean words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format * @example * toCardinal(21) // '이십일' * toCardinal(10000) // '만' * toCardinal(1000000) // '백만' */ declare function toCardinal(value: number | string | bigint): string; /** * Converts a numeric value to Korean ordinal words. * @param {number | string | bigint} value - The numeric value to convert (positive integer) * @returns {string} The number as ordinal words * @throws {TypeError} If value is not a valid numeric type * @throws {RangeError} If value is negative, zero, or has a decimal part * @example * toOrdinal(1) // '제일' * toOrdinal(2) // '제이' * toOrdinal(10) // '제십' */ declare function toOrdinal(value: number | string | bigint): string; export type CurrencyOptions = { /** * - ISO 4217 currency code to name the amount in */ currency?: import('./utils/currency-vocab.js').KoCurrency; }; /** * @typedef {object} CurrencyOptions * @property {import('./utils/currency-vocab.js').KoCurrency} [currency] - ISO 4217 currency code to name the amount in */ /** @type {Required} */ export declare const currencyDefaults: Required; /** @type {{ currency: ReadonlyArray['currency']> }} */ export declare const currencyValues: { currency: ReadonlyArray['currency']>; }; /** * Converts a numeric value to Korean currency words (Won). * * Korean Won has no everyday subunit (jeon are historical) — a fractional * amount throws RangeError rather than being silently rounded away. * @param {number | string | bigint} value - The currency amount to convert * @param {CurrencyOptions} [options] - Optional configuration * @returns {string} The amount in Korean currency words * @throws {TypeError} If value is not a valid numeric type * @throws {RangeError} If value is not a valid number format, or has a fractional part * @example * toCurrency(42) // '사십이원' * toCurrency(1000) // '천원' * toCurrency(-5) // '마이너스 오원' */ declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string; export { toCardinal, toOrdinal, toCurrency };