/** * Portuguese (Brazil) language converter * * CLDR: pt-BR | Brazilian Portuguese as used in Brazil * * Portuguese-specific rules: * - "e" conjunction between units, tens and hundreds: vinte e um, cento e um * - "cem" for exact 100, "cento" for 100+ remainder * - Irregular hundreds: duzentos, trezentos, quatrocentos, etc. * - Short scale: milhão (10^6), bilhão (10^9), trilhão (10^12) * - Omit "um" before "mil" */ export declare const cardinalMax: bigint; export declare const ordinalMax: bigint; export declare const currencyMax: bigint; /** * Converts a numeric value to Portuguese words. * @param {number | string | bigint} value - The numeric value to convert * @returns {string} The number in Portuguese words */ declare function toCardinal(value: number | string | bigint): string; /** * Converts a number to Portuguese ordinal words. * @param {number | string | bigint} value - The number to convert * @returns {string} Portuguese ordinal words */ declare function toOrdinal(value: number | string | bigint): string; export type CurrencyOptions = { /** * - Include "e" between major and minor units */ and?: boolean; /** * - ISO 4217 code: native BRL, else DisplayNames/home-minor fallback (see currency-fallback.js) */ currency?: string; }; /** * @typedef {object} CurrencyOptions * @property {boolean} [and] - Include "e" between major and minor units * @property {string} [currency] - ISO 4217 code: native BRL, 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 the CLI help and the docs generators keep a * stable binding to read. */ export declare const currencyValues: {}; /** * Converts a number to Brazilian Portuguese currency words. * @param {number | string | bigint} value - The amount to convert * @param {CurrencyOptions} [options] Currency formatting options * @returns {string} Brazilian Portuguese currency words * @example * toCurrency(42.50) // 'quarenta e dois reais e cinquenta centavos' * toCurrency(42.50, {currency: 'USD'}) // 'quarenta e dois dólares e cinquenta centavos' */ declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string; export { toCardinal, toOrdinal, toCurrency };