/**
 * Converts a numeric value to Persian words.
 *
 * @param {number | string | bigint} value - The numeric value to convert
 * @returns {string} The number in Persian words
 */
export function toCardinal(value: number | string | bigint): string;
/**
 * Converts a numeric value to Persian 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)    // 'اول'
 * toOrdinal(2)    // 'دوم'
 * toOrdinal(10)   // 'دهم'
 */
export function toOrdinal(value: number | string | bigint): string;
/**
 * Converts a numeric value to Persian currency words (Rial).
 *
 * Iranian Rial has no subunit in modern usage.
 * (Historically dinar was 1/100 rial, but not used today)
 *
 * @param {number | string | bigint} value - The currency amount to convert
 * @returns {string} The amount in Persian 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)     // 'چهل و دو ریال'
 * toCurrency(1000)   // 'هزار ریال'
 * toCurrency(-5)     // 'منفى پنج ریال'
 */
export function toCurrency(value: number | string | bigint): string;