/** * Converts a numeric value to Simplified Chinese words. * * @param {number | string | bigint} value - The numeric value to convert * @param {Object} [options] - Optional configuration * @param {boolean} [options.formal=true] - Use formal/financial numerals * @returns {string} The number in Simplified Chinese words */ export function toCardinal(value: number | string | bigint, options?: { formal?: boolean | undefined; }): string; /** * Converts a numeric value to Simplified Chinese ordinal words. * * @param {number | string | bigint} value - The numeric value to convert (positive integer) * @param {Object} [options] - Optional configuration * @param {boolean} [options.formal=true] - Use formal/financial numerals * @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) // '第壹' * toOrdinal(1, { formal: false }) // '第一' * toOrdinal(10) // '第壹拾' */ export function toOrdinal(value: number | string | bigint, options?: { formal?: boolean | undefined; }): string; /** * Converts a numeric value to Simplified Chinese currency words (Yuan/Renminbi). * * @param {number | string | bigint} value - The currency amount to convert * @param {Object} [options] - Optional configuration * @param {boolean} [options.formal=true] - Use formal/financial numerals * @returns {string} The amount in Simplified Chinese 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) // '肆拾贰圆伍角整' * toCurrency(1) // '壹圆整' * toCurrency(0.05) // '伍分' * toCurrency(42.50, { formal: false }) // '四十二元五角整' */ export function toCurrency(value: number | string | bigint, options?: { formal?: boolean | undefined; }): string;