/**
 * Converts a numeric value to Polish words.
 *
 * This is the main public API. It accepts any valid numeric input
 * (number, string, or bigint) and handles parsing internally.
 *
 * @param {number | string | bigint} value - The numeric value to convert
 * @param {Object} [options] - Conversion options
 * @param {string} [options.gender='masculine'] - Gender for numbers < 1000
 * @returns {string} The number in Polish words
 * @throws {TypeError} If value is not a valid numeric type
 * @throws {Error} If value is not a valid number format
 *
 * @example
 * toCardinal(1)                          // 'jeden'
 * toCardinal(1, { gender: 'feminine' })  // 'jedna'
 * toCardinal(1000)                       // 'tysiąc'
 * toCardinal(2000)                       // 'dwa tysiące'
 */
export function toCardinal(value: number | string | bigint, options?: {
    gender?: string | undefined;
}): string;
/**
 * Converts a numeric value to Polish ordinal words (masculine nominative).
 *
 * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer)
 * @returns {string} The number as ordinal words (e.g., "pierwszy", "czterdziesty drugi")
 * @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)    // 'pierwszy'
 * toOrdinal(2)    // 'drugi'
 * toOrdinal(3)    // 'trzeci'
 * toOrdinal(21)   // 'dwudziesty pierwszy'
 * toOrdinal(42)   // 'czterdziesty drugi'
 * toOrdinal(100)  // 'setny'
 * toOrdinal(1000) // 'tysięczny'
 */
export function toOrdinal(value: number | string | bigint): string;
/**
 * Converts a numeric value to Polish currency words (Polish Złoty).
 *
 * @param {number | string | bigint} value - The currency amount to convert
 * @returns {string} The amount in Polish 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)     // 'czterdzieści dwa złote'
 * toCurrency(1)      // 'jeden złoty'
 * toCurrency(1.50)   // 'jeden złoty pięćdziesiąt groszy'
 * toCurrency(-5)     // 'minus pięć złotych'
 */
export function toCurrency(value: number | string | bigint): string;