/** * 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 currency code to name the amount in */ currency?: import('./utils/currency-vocab.js').PtBRCurrency; }; /** * @typedef {object} CurrencyOptions * @property {boolean} [and] - Include "e" between major and minor units * @property {import('./utils/currency-vocab.js').PtBRCurrency} [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 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 };