/** * Singaporean English language converter * * CLDR: en-SG | English as used in Singapore * * Exports: * - toCardinal(value) - Cardinal numbers: 42 → "forty-two" * - toOrdinal(value) - Ordinal numbers: 42 → "forty-second" * - toCurrency(value, options?) - Currency: 42.50 → "forty-two dollars and fifty cents" * * Singaporean English conventions: * - Follows British English style * - "and" after hundreds: "one hundred and twenty-three" * - "and" before final segment: "one million and one" * - Hyphenated tens-ones: "twenty-one", "forty-two" * - Western numbering system (short scale: billion = 10^9) * - Currency: Singapore Dollar (SGD) - dollar/dollars, cent/cents */ export declare const cardinalMax: bigint; export declare const ordinalMax: bigint; export declare const currencyMax: bigint; /** * Converts a numeric value to Singaporean English words. * @param {number | string | bigint} value - The numeric value to convert * @returns {string} The number in English words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format */ declare function toCardinal(value: number | string | bigint): string; /** * Converts a numeric value to Singaporean English ordinal words. * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer) * @returns {string} The number as ordinal words (e.g., "first", "forty-second") */ declare function toOrdinal(value: number | string | bigint): string; export type CurrencyOptions = { /** * - Use "and" between dollars and cents */ and?: boolean; }; /** * @typedef {object} CurrencyOptions * @property {boolean} [and] - Use "and" between dollars and cents */ /** @type {Required} */ export declare const currencyDefaults: Required; /** * Converts a numeric value to Singaporean English currency words. * @param {number | string | bigint} value - The currency amount to convert * @param {CurrencyOptions} [options] - Optional configuration * @returns {string} The amount in Singaporean English currency words */ declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string; export { toCardinal, toOrdinal, toCurrency };