/** * English (bare-tag alias) * * `en` has no single "correct" region — English is official in dozens of * countries with genuinely different cardinal grammar (US vs. British * "and") and different default currencies. This file exists so * `n2words/en` resolves without forcing a region subtag, defaulting to * en-US (the most widely used variant, and the one en-CA/en-AU already * proved to be a near-duplicate of). It does NOT speak for en-GB, en-CA, * en-IN, or any other regional variant — see LANGUAGES.md's "Bare-tag * aliases" section for the full rationale. * * `toCurrency` is the one form this file doesn't forward untouched: a bare * tag names a language, and a default currency belongs to a country, so * `currency` is required here rather than inherited. See * docs/bare-tag-aliases.md's "Bare tags carry no default currency". */ export * from './en-US.js'; export declare const aliasOf = "en-US"; export type CurrencyOptions = Omit & Required>; /** * Every en-US currency default except the currency itself. * @type {Omit, 'currency'>} */ export declare const currencyDefaults: Omit, 'currency'>; /** * Converts a numeric value to English currency words. * * Unlike en-US's, this needs an explicit `currency`: `en` is a language * and has no country to take a default from. * @param {number | string | bigint} value - The currency amount to convert * @param {CurrencyOptions} options - Configuration; `currency` is required * @returns {string} The amount in English currency words * @throws {TypeError} If `currency` is omitted, or options are malformed * @example * toCurrency(42.50, { currency: 'USD' }) // 'forty-two dollars and fifty cents' */ declare function toCurrency(value: number | string | bigint, options: CurrencyOptions): string; export { toCurrency };