/** * Japanese (Japan) language converter * * CLDR: ja-JP | Japanese as used in Japan * * Japanese-specific rules: * - Myriad (万-based) grouping: 4 digits per segment instead of 3 * - 一 omission: Omit "一" before 十, 百, 千 but NOT before 万 and higher scales * - Kanji numerals: 零一二三四五六七八九 * - No spaces between characters */ export declare const cardinalMax: bigint; export declare const ordinalMax: bigint; export declare const currencyMax: bigint; /** * Converts a numeric value to Japanese words. * * This is the main public API. It accepts any valid numeric input * (number, string, or bigint) and handles parsing internally. * @param {number | string | bigint} value - The numeric value to convert * @returns {string} The number in Japanese kanji words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format * @example * toCardinal(42) // '四十二' * toCardinal(10000) // '一万' * toCardinal(100000000) // '一億' */ declare function toCardinal(value: number | string | bigint): string; /** * Converts a numeric value to Japanese 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(10) // '第十' * toOrdinal(100) // '第百' */ declare function toOrdinal(value: number | string | bigint): string; export type CurrencyOptions = { /** * - ISO 4217 code: native JPY, else DisplayNames/home-minor fallback (see currency-fallback.js) */ currency?: string; }; /** * @typedef {object} CurrencyOptions * @property {string} [currency] - ISO 4217 code: native JPY, else DisplayNames/home-minor fallback (see currency-fallback.js) */ /** @type {Required} */ export declare const currencyDefaults: Required; /** * Open set on purpose: no `currency` key, so `resolveOptions` accepts any * ISO 4217 code and the lookup below falls back past the native matrix. * Kept as an (empty) export so re-exporters (`ja.js`), the CLI help and the * docs generators keep a stable binding to read. */ export declare const currencyValues: {}; /** * Converts a numeric value to Japanese currency words (Yen). * * Yen has no everyday minor unit — a fractional amount throws RangeError * rather than spelling a historical, no-longer-circulating 銭 (sen), which * was demonetised in 1953. * @param {number | string | bigint} value - The currency amount to convert * @param {CurrencyOptions} [options] - Optional configuration * @returns {string} The amount in Japanese 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(1) // '一円' * toCurrency(0) // '零円' */ declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string; export { toCardinal, toOrdinal, toCurrency };