/** * Converts a numeric value to Australian 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 * * @example * toCardinal(42) // 'forty-two' * toCardinal(101) // 'one hundred and one' * toCardinal(1000000) // 'one million' */ export function toCardinal(value: number | string | bigint): string; /** * Converts a numeric value to Australian 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 * @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) // 'first' * toOrdinal(42) // 'forty-second' * toOrdinal(100) // 'one hundredth' */ export function toOrdinal(value: number | string | bigint): string; /** * Converts a numeric value to Australian English currency words. * * @param {number | string | bigint} value - The currency amount to convert * @param {Object} [options] - Optional configuration * @param {boolean} [options.and=true] - Use "and" between dollars and cents * @returns {string} The amount in Australian English currency words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format * * @example * toCurrency(42.50) // 'forty-two dollars and fifty cents' * toCurrency(1) // 'one dollar' * toCurrency(0.99) // 'ninety-nine cents' * toCurrency(42.50, { and: false }) // 'forty-two dollars fifty cents' */ export function toCurrency(value: number | string | bigint, options?: { and?: boolean | undefined; }): string;