/**
 * Converts a numeric value to Spanish words (US short scale).
 *
 * @param {number | string | bigint} value - The numeric value to convert
 * @param {Object} [options] - Optional configuration
 * @param {('masculine'|'feminine')} [options.gender='masculine'] - Grammatical gender
 * @returns {string} The number in Spanish words
 * @throws {TypeError} If value is not a valid numeric type
 * @throws {Error} If value is not a valid number format
 *
 * @example
 * toCardinal(21)                        // 'veintiuno'
 * toCardinal(21, {gender: 'feminine'})  // 'veintiuna'
 * toCardinal(1000000000)                // 'un billón'
 */
export function toCardinal(value: number | string | bigint, options?: {
    gender?: "masculine" | "feminine" | undefined;
}): string;
/**
 * Converts a numeric value to Spanish ordinal words.
 *
 * @param {number | string | bigint} value - The positive integer to convert
 * @param {Object} [options] - Optional configuration
 * @param {('masculine'|'feminine')} [options.gender='masculine'] - Grammatical gender
 * @returns {string} The number in Spanish ordinal words
 * @throws {TypeError} If value is not a valid numeric type
 * @throws {Error} If value is not a positive integer
 *
 * @example
 * toOrdinal(1)                          // 'primero'
 * toOrdinal(1, { gender: 'feminine' })  // 'primera'
 * toOrdinal(21)                         // 'vigésimo primero'
 */
export function toOrdinal(value: number | string | bigint, options?: {
    gender?: "masculine" | "feminine" | undefined;
}): string;
/**
 * Converts a numeric value to US Dollar currency words in Spanish.
 *
 * US Dollar uses masculine gender for dólares (el dólar)
 * and masculine for centavos (el centavo).
 *
 * @param {number | string | bigint} value - The currency amount to convert
 * @param {Object} [options] - Optional configuration
 * @param {boolean} [options.and=true] - Use "con" between dollars and cents
 * @returns {string} The amount in Spanish US Dollar 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)                  // 'cuarenta y dos dólares con cincuenta centavos'
 * toCurrency(1)                      // 'un dólar'
 * toCurrency(0.99)                   // 'noventa y nueve centavos'
 * toCurrency(42.50, { and: false })  // 'cuarenta y dos dólares cincuenta centavos'
 */
export function toCurrency(value: number | string | bigint, options?: {
    and?: boolean | undefined;
}): string;