/**
 * Converts a numeric value to French 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] - Optional configuration
 * @param {boolean} [options.withHyphenSeparator=false] - Use hyphens between all words
 * @returns {string} The number in French words
 * @throws {TypeError} If value is not a valid numeric type
 * @throws {Error} If value is not a valid number format
 *
 * @example
 * toCardinal(21)           // 'vingt et un'
 * toCardinal(80)           // 'quatre-vingts'
 * toCardinal(1000000)      // 'un million'
 */
export function toCardinal(value: number | string | bigint, options?: {
    withHyphenSeparator?: boolean | undefined;
}): string;
/**
 * Converts a numeric value to French ordinal words.
 *
 * French ordinals: premier (1st), then cardinal + ième.
 * Special rules: quatre→quatrième, cinq→cinquième, neuf→neuvième.
 *
 * @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)    // 'premier'
 * toOrdinal(2)    // 'deuxième'
 * toOrdinal(4)    // 'quatrième'
 * toOrdinal(5)    // 'cinquième'
 * toOrdinal(9)    // 'neuvième'
 * toOrdinal(21)   // 'vingt et unième'
 * toOrdinal(100)  // 'centième'
 * toOrdinal(1000) // 'millième'
 */
export function toOrdinal(value: number | string | bigint): string;
/**
 * Converts a numeric value to French currency words (Euro).
 *
 * @param {number | string | bigint} value - The currency amount to convert
 * @param {Object} [options] - Optional configuration
 * @param {boolean} [options.and=true] - Use "et" between euros and centimes
 * @returns {string} The amount in French 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)                 // 'quarante-deux euros et cinquante centimes'
 * toCurrency(1)                     // 'un euro'
 * toCurrency(0.99)                  // 'quatre-vingt-dix-neuf centimes'
 * toCurrency(0.01)                  // 'un centime'
 * toCurrency(42.50, { and: false }) // 'quarante-deux euros cinquante centimes'
 */
export function toCurrency(value: number | string | bigint, options?: {
    and?: boolean | undefined;
}): string;