/** * Ukrainian (Ukraine) language converter * * CLDR: uk-UA | Ukrainian as used in Ukraine * * Key features: * - Three-form pluralization (one/few/many) * - Gender: thousands are feminine, millions+ are masculine * - Irregular hundreds * - Long scale naming */ export declare const cardinalMax: bigint; export declare const ordinalMax: bigint; export declare const currencyMax: bigint; export type CardinalOptions = { /** * - Grammatical gender */ gender?: ('masculine' | 'feminine'); }; /** * @typedef {object} CardinalOptions * @property {('masculine'|'feminine')} [gender] - Grammatical gender */ /** @type {Required} */ export declare const cardinalDefaults: Required; /** @type {{ gender: ReadonlyArray['gender']> }} */ export declare const cardinalValues: { gender: ReadonlyArray['gender']>; }; /** * Converts a numeric value to Ukrainian words. * @param {number | string | bigint} value - The numeric value to convert * @param {CardinalOptions} [options] - Optional configuration * @returns {string} The number in Ukrainian words */ declare function toCardinal(value: number | string | bigint, options?: CardinalOptions): string; /** * Converts a numeric value to Ukrainian 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 * @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(21) // 'двадцять перший' * toOrdinal(100) // 'сотий' * toOrdinal(1000) // 'тисячний' */ declare function toOrdinal(value: number | string | bigint): string; /** * Converts a numeric value to Ukrainian currency words (Hryvnia). * @param {number | string | bigint} value - The currency amount to convert * @returns {string} The amount in Ukrainian 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) // 'сорок двi гривнi' * toCurrency(1) // 'одна гривня' * toCurrency(1.50) // 'одна гривня п\'ятдесят копiйок' * toCurrency(-5) // 'мiнус п\'ять гривень' */ declare function toCurrency(value: number | string | bigint): string; export { toCardinal, toOrdinal, toCurrency };