/** * Converts a numeric value to Finnish words. * * @param {number | string | bigint} value - The numeric value to convert * @returns {string} The number in Finnish words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format * * @example * toCardinal(21) // 'kaksikymmentäyksi' * toCardinal(1000) // 'tuhat' * toCardinal('3.14') // 'kolme pilkku yksi neljä' */ export function toCardinal(value: number | string | bigint): string; /** * Converts a numeric value to Finnish ordinal words. * * @param {number | string | bigint} value - The numeric value to convert (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) // 'ensimmäinen' * toOrdinal(2) // 'toinen' * toOrdinal(3) // 'kolmas' * toOrdinal(10) // 'kymmenes' */ export function toOrdinal(value: number | string | bigint): string; /** * Converts a numeric value to Finnish currency words (Euro). * * Euro uses sentti as subunit (100 senttiä = 1 euro). * Finnish has singular/plural: 1 euro vs 2 euroa, 1 sentti vs 2 senttiä. * * @param {number | string | bigint} value - The currency amount to convert * @returns {string} The amount in Finnish currency words * @throws {TypeError} If value is not a valid numeric type * @throws {Error} If value is not a valid number format * * @example * toCurrency(1) // 'yksi euro' * toCurrency(42) // 'neljäkymmentäkaksi euroa' * toCurrency(1.50) // 'yksi euro viisikymmentä senttiä' */ export function toCurrency(value: number | string | bigint): string;