n2words 5.1.1 → 5.1.2

package/src/en-PK.d.ts

@@ -1,18 +1,17 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "and" between rupees and paise
+ * English (Pakistan) language converter
+ *
+ * CLDR: en-PK | English as used in Pakistan
+ *
+ * Key features:
+ * - Indian numbering system (thousand, lakh, crore, arab, kharab)
+ * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
+ * - British-style "and" after hundreds
+ * - Pakistani Rupee currency (PKR)
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
-export type CurrencyOptions = {
-    /**
-     * - Use "and" between rupees and paise
-     */
-    and?: boolean | undefined;
-};
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 /**
  * Converts a numeric value to English words using Indian numbering.
  * @param {number | string | bigint} value - The numeric value to convert
@@ -25,7 +24,7 @@ export type CurrencyOptions = {
  * toCardinal(10000000)     // 'one crore'
  * toCardinal(1234567)      // 'twelve lakh thirty-four thousand five hundred and sixty-seven'
  */
-export function toCardinal(value: number | string | bigint): string;
+declare function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to English ordinal words using Indian numbering.
  * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer)
@@ -37,7 +36,19 @@ export function toCardinal(value: number | string | bigint): string;
  * toOrdinal(100000)  // 'one lakhth'
  * toOrdinal(100001)  // 'one lakh first'
  */
-export function toOrdinal(value: number | string | bigint): string;
+declare function toOrdinal(value: number | string | bigint): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "and" between rupees and paise
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "and" between rupees and paise
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to Pakistani English currency words.
  * @param {number | string | bigint} value - The currency amount to convert
@@ -52,4 +63,5 @@ export function toOrdinal(value: number | string | bigint): string;
  * toCurrency(0.50)                     // 'fifty paise'
  * toCurrency(42.50, { and: false })    // 'forty-two rupees fifty paise'
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };

package/src/en-SG.d.ts

@@ -1,18 +1,24 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "and" between dollars and cents
+ * Singaporean English language converter
+ *
+ * CLDR: en-SG | English as used in Singapore
+ *
+ * Exports:
+ * - toCardinal(value)            - Cardinal numbers: 42 → "forty-two"
+ * - toOrdinal(value)             - Ordinal numbers: 42 → "forty-second"
+ * - toCurrency(value, options?)  - Currency: 42.50 → "forty-two dollars and fifty cents"
+ *
+ * Singaporean English conventions:
+ * - Follows British English style
+ * - "and" after hundreds: "one hundred and twenty-three"
+ * - "and" before final segment: "one million and one"
+ * - Hyphenated tens-ones: "twenty-one", "forty-two"
+ * - Western numbering system (short scale: billion = 10^9)
+ * - Currency: Singapore Dollar (SGD) - dollar/dollars, cent/cents
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
-export type CurrencyOptions = {
-    /**
-     * - Use "and" between dollars and cents
-     */
-    and?: boolean | undefined;
-};
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 /**
  * Converts a numeric value to Singaporean English words.
  * @param {number | string | bigint} value - The numeric value to convert
@@ -20,17 +26,30 @@ export type CurrencyOptions = {
  * @throws {TypeError} If value is not a valid numeric type
  * @throws {Error} If value is not a valid number format
  */
-export function toCardinal(value: number | string | bigint): string;
+declare function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Singaporean English ordinal words.
  * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer)
  * @returns {string} The number as ordinal words (e.g., "first", "forty-second")
  */
-export function toOrdinal(value: number | string | bigint): string;
+declare function toOrdinal(value: number | string | bigint): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "and" between dollars and cents
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "and" between dollars and cents
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to Singaporean English currency words.
  * @param {number | string | bigint} value - The currency amount to convert
  * @param {CurrencyOptions} [options] - Optional configuration
  * @returns {string} The amount in Singaporean English currency words
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };

package/src/en-US.d.ts

@@ -1,35 +1,41 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CardinalOptions
- * @property {boolean} [hundredPairing] - Use hundred-pairing for 1100-9999 (e.g., "fifteen hundred" instead of "one thousand five hundred")
- * @property {boolean} [and] - Use "and" after hundreds and before final small numbers (e.g., "one hundred and one" instead of "one hundred one")
- */
-/** @type {Required<CardinalOptions>} */
-export const cardinalDefaults: Required<CardinalOptions>;
-/**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "and" between dollars and cents (e.g., "one dollar and fifty cents")
+ * American English language converter
+ *
+ * CLDR: en-US | English as used in the United States
+ *
+ * Exports:
+ * - toCardinal(value, options?)  - Cardinal numbers: 42 → "forty-two"
+ * - toOrdinal(value)             - Ordinal numbers: 42 → "forty-second"
+ * - toCurrency(value, options?)  - Currency: 42.50 → "forty-two dollars and fifty cents"
+ *
+ * American English conventions:
+ * - No "and" after hundreds: "one hundred twenty-three" (default)
+ * - No "and" before final segment: "one million one" (default)
+ * - Hyphenated tens-ones: "twenty-one", "forty-two"
+ * - Western numbering system (short scale: billion = 10^9)
+ * - Optional hundred-pairing: 1500 → "fifteen hundred" (colloquial)
+ * - Optional "and" insertion: 101 → "one hundred and one" (informal)
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 export type CardinalOptions = {
     /**
      * - Use hundred-pairing for 1100-9999 (e.g., "fifteen hundred" instead of "one thousand five hundred")
      */
-    hundredPairing?: boolean | undefined;
+    hundredPairing?: boolean;
     /**
      * - Use "and" after hundreds and before final small numbers (e.g., "one hundred and one" instead of "one hundred one")
      */
-    and?: boolean | undefined;
-};
-export type CurrencyOptions = {
-    /**
-     * - Use "and" between dollars and cents (e.g., "one dollar and fifty cents")
-     */
-    and?: boolean | undefined;
+    and?: boolean;
 };
+/**
+ * @typedef {object} CardinalOptions
+ * @property {boolean} [hundredPairing] - Use hundred-pairing for 1100-9999 (e.g., "fifteen hundred" instead of "one thousand five hundred")
+ * @property {boolean} [and] - Use "and" after hundreds and before final small numbers (e.g., "one hundred and one" instead of "one hundred one")
+ */
+/** @type {Required<CardinalOptions>} */
+export declare const cardinalDefaults: Required<CardinalOptions>;
 /**
  * Converts a numeric value to American English words.
  *
@@ -47,7 +53,7 @@ export type CurrencyOptions = {
  * toCardinal(1500)                          // 'one thousand five hundred'
  * toCardinal(1500, { hundredPairing: true }) // 'fifteen hundred'
  */
-export function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
+declare function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
 /**
  * Converts a numeric value to American English ordinal words.
  * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer)
@@ -64,7 +70,19 @@ export function toCardinal(value: number | string | bigint, options?: CardinalOp
  * toOrdinal(101)  // 'one hundred first'
  * toOrdinal(1000) // 'one thousandth'
  */
-export function toOrdinal(value: number | string | bigint): string;
+declare function toOrdinal(value: number | string | bigint): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "and" between dollars and cents (e.g., "one dollar and fifty cents")
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "and" between dollars and cents (e.g., "one dollar and fifty cents")
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to American English currency words.
  * @param {number | string | bigint} value - The currency amount to convert
@@ -78,4 +96,5 @@ export function toOrdinal(value: number | string | bigint): string;
  * toCurrency(0.99)                     // 'ninety-nine cents'
  * toCurrency(42.50, { and: false })    // 'forty-two dollars fifty cents'
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };

package/src/en-ZA.d.ts

@@ -1,18 +1,26 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "and" between rand and cents (e.g., "one rand and fifty cents")
+ * South African English language converter
+ *
+ * CLDR: en-ZA | English as used in South Africa
+ *
+ * Exports:
+ * - toCardinal(value)            - Cardinal numbers: 42 → "forty-two"
+ * - toOrdinal(value)             - Ordinal numbers: 42 → "forty-second"
+ * - toCurrency(value, options?)  - Currency: 42.50 → "forty-two rand and fifty cents"
+ *
+ * South African English conventions:
+ * - Follows British English style
+ * - "and" after hundreds: "one hundred and twenty-three"
+ * - "and" before final segment: "one million and one"
+ * - Hyphenated tens-ones: "twenty-one", "forty-two"
+ * - Western numbering system (short scale: billion = 10^9)
+ * - Currency: South African Rand (ZAR) - rand (singular/plural), cent/cents
+ *
+ * Note: "Rand" is invariable (same for singular and plural).
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
-export type CurrencyOptions = {
-    /**
-     * - Use "and" between rand and cents (e.g., "one rand and fifty cents")
-     */
-    and?: boolean | undefined;
-};
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 /**
  * Converts a numeric value to South African English words.
  *
@@ -27,7 +35,7 @@ export type CurrencyOptions = {
  * toCardinal(-3.14)        // 'minus three point fourteen'
  * toCardinal('1000000')    // 'one million'
  */
-export function toCardinal(value: number | string | bigint): string;
+declare function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to South African English ordinal words.
  * @param {number | string | bigint} value - The numeric value to convert (must be a positive integer)
@@ -44,7 +52,19 @@ export function toCardinal(value: number | string | bigint): string;
  * toOrdinal(101)  // 'one hundred first'
  * toOrdinal(1000) // 'one thousandth'
  */
-export function toOrdinal(value: number | string | bigint): string;
+declare function toOrdinal(value: number | string | bigint): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "and" between rand and cents (e.g., "one rand and fifty cents")
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "and" between rand and cents (e.g., "one rand and fifty cents")
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to South African English currency words.
  * @param {number | string | bigint} value - The currency amount to convert
@@ -59,4 +79,5 @@ export function toOrdinal(value: number | string | bigint): string;
  * toCurrency(0.01)                     // 'one cent'
  * toCurrency(42.50, { and: false })    // 'forty-two rand fifty cents'
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };

package/src/es-ES.d.ts

@@ -1,49 +1,39 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CardinalOptions
- * @property {('masculine'|'feminine')} [gender] - Grammatical gender
- */
-/** @type {Required<CardinalOptions>} */
-export const cardinalDefaults: Required<CardinalOptions>;
-/** @type {{ gender: ReadonlyArray<Required<CardinalOptions>['gender']> }} */
-export const cardinalValues: {
-    gender: ReadonlyArray<Required<CardinalOptions>["gender"]>;
-};
-/**
- * @typedef {object} OrdinalOptions
- * @property {('masculine'|'feminine')} [gender] - Grammatical gender
- */
-/** @type {Required<OrdinalOptions>} */
-export const ordinalDefaults: Required<OrdinalOptions>;
-/** @type {{ gender: ReadonlyArray<Required<OrdinalOptions>['gender']> }} */
-export const ordinalValues: {
-    gender: ReadonlyArray<Required<OrdinalOptions>["gender"]>;
-};
-/**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "con" between euros and cents
+ * Spanish (Spain) language converter
+ *
+ * CLDR: es-ES | Spanish as used in Spain
+ *
+ * Uses the European long scale numbering system:
+ * - 10⁶ = millón
+ * - 10⁹ = mil millones (thousand millions)
+ * - 10¹² = billón
+ *
+ * Spanish-specific rules:
+ * - Gender agreement: uno/una, veintiuno/veintiuna, hundreds
+ * - Special twenties: veinte, veintiuno, veintidós, ... veintinueve
+ * - "y" conjunction: treinta y uno (only 30-99 with ones)
+ * - "cien" for exact 100, "ciento/cienta" otherwise
+ * - Irregular hundreds: quinientos, setecientos, novecientos
+ * - "un" before millón (not "uno"), omit before mil
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 export type CardinalOptions = {
     /**
      * - Grammatical gender
      */
-    gender?: "feminine" | "masculine" | undefined;
-};
-export type OrdinalOptions = {
-    /**
-     * - Grammatical gender
-     */
-    gender?: "feminine" | "masculine" | undefined;
+    gender?: ('masculine' | 'feminine');
 };
-export type CurrencyOptions = {
-    /**
-     * - Use "con" between euros and cents
-     */
-    and?: boolean | undefined;
+/**
+ * @typedef {object} CardinalOptions
+ * @property {('masculine'|'feminine')} [gender] - Grammatical gender
+ */
+/** @type {Required<CardinalOptions>} */
+export declare const cardinalDefaults: Required<CardinalOptions>;
+/** @type {{ gender: ReadonlyArray<Required<CardinalOptions>['gender']> }} */
+export declare const cardinalValues: {
+    gender: ReadonlyArray<Required<CardinalOptions>['gender']>;
 };
 /**
  * Converts a numeric value to Spanish words.
@@ -60,7 +50,23 @@ export type CurrencyOptions = {
  * toCardinal(21, {gender: 'feminine'})  // 'veintiuna'
  * toCardinal(1000000)                   // 'un millón'
  */
-export function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
+declare function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
+export type OrdinalOptions = {
+    /**
+     * - Grammatical gender
+     */
+    gender?: ('masculine' | 'feminine');
+};
+/**
+ * @typedef {object} OrdinalOptions
+ * @property {('masculine'|'feminine')} [gender] - Grammatical gender
+ */
+/** @type {Required<OrdinalOptions>} */
+export declare const ordinalDefaults: Required<OrdinalOptions>;
+/** @type {{ gender: ReadonlyArray<Required<OrdinalOptions>['gender']> }} */
+export declare const ordinalValues: {
+    gender: ReadonlyArray<Required<OrdinalOptions>['gender']>;
+};
 /**
  * Converts a numeric value to Spanish ordinal words.
  *
@@ -77,7 +83,19 @@ export function toCardinal(value: number | string | bigint, options?: CardinalOp
  * toOrdinal(21)                         // 'vigésimo primero'
  * toOrdinal(100)                        // 'centésimo'
  */
-export function toOrdinal(value: number | string | bigint, options?: OrdinalOptions): string;
+declare function toOrdinal(value: number | string | bigint, options?: OrdinalOptions): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "con" between euros and cents
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "con" between euros and cents
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to Spanish Euro currency words.
  *
@@ -94,4 +112,5 @@ export function toOrdinal(value: number | string | bigint, options?: OrdinalOpti
  * toCurrency(0.99)                   // 'noventa y nueve céntimos'
  * toCurrency(42.50, { and: false })  // 'cuarenta y dos euros cincuenta céntimos'
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };

package/src/es-MX.d.ts

@@ -1,49 +1,39 @@
-export const cardinalMax: bigint;
-export const ordinalMax: bigint;
-export const currencyMax: bigint;
 /**
- * @typedef {object} CardinalOptions
- * @property {('masculine'|'feminine')} [gender] - Grammatical gender
- */
-/** @type {Required<CardinalOptions>} */
-export const cardinalDefaults: Required<CardinalOptions>;
-/** @type {{ gender: ReadonlyArray<Required<CardinalOptions>['gender']> }} */
-export const cardinalValues: {
-    gender: ReadonlyArray<Required<CardinalOptions>["gender"]>;
-};
-/**
- * @typedef {object} OrdinalOptions
- * @property {('masculine'|'feminine')} [gender] - Grammatical gender
- */
-/** @type {Required<OrdinalOptions>} */
-export const ordinalDefaults: Required<OrdinalOptions>;
-/** @type {{ gender: ReadonlyArray<Required<OrdinalOptions>['gender']> }} */
-export const ordinalValues: {
-    gender: ReadonlyArray<Required<OrdinalOptions>["gender"]>;
-};
-/**
- * @typedef {object} CurrencyOptions
- * @property {boolean} [and] - Use "con" between pesos and centavos
+ * Spanish (Mexico) language converter
+ *
+ * CLDR: es-MX | Spanish as used in Mexico
+ *
+ * Uses the European long scale numbering system (per RAE and Academia Mexicana):
+ * - 10⁶ = millón
+ * - 10⁹ = mil millones (thousand millions)
+ * - 10¹² = billón
+ *
+ * Spanish-specific rules:
+ * - Gender agreement: uno/una, veintiuno/veintiuna, hundreds
+ * - Special twenties: veinte, veintiuno, veintidós, ... veintinueve
+ * - "y" conjunction: treinta y uno (only 30-99 with ones)
+ * - "cien" for exact 100, "ciento/cienta" otherwise
+ * - Irregular hundreds: quinientos, setecientos, novecientos
+ * - "un" before millón (not "uno"), omit before mil
  */
-/** @type {Required<CurrencyOptions>} */
-export const currencyDefaults: Required<CurrencyOptions>;
+export declare const cardinalMax: bigint;
+export declare const ordinalMax: bigint;
+export declare const currencyMax: bigint;
 export type CardinalOptions = {
     /**
      * - Grammatical gender
      */
-    gender?: "feminine" | "masculine" | undefined;
-};
-export type OrdinalOptions = {
-    /**
-     * - Grammatical gender
-     */
-    gender?: "feminine" | "masculine" | undefined;
+    gender?: ('masculine' | 'feminine');
 };
-export type CurrencyOptions = {
-    /**
-     * - Use "con" between pesos and centavos
-     */
-    and?: boolean | undefined;
+/**
+ * @typedef {object} CardinalOptions
+ * @property {('masculine'|'feminine')} [gender] - Grammatical gender
+ */
+/** @type {Required<CardinalOptions>} */
+export declare const cardinalDefaults: Required<CardinalOptions>;
+/** @type {{ gender: ReadonlyArray<Required<CardinalOptions>['gender']> }} */
+export declare const cardinalValues: {
+    gender: ReadonlyArray<Required<CardinalOptions>['gender']>;
 };
 /**
  * Converts a numeric value to Spanish words (long scale).
@@ -57,7 +47,23 @@ export type CurrencyOptions = {
  * toCardinal(21, {gender: 'feminine'})  // 'veintiuna'
  * toCardinal(1000000000)                // 'mil millones'
  */
-export function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
+declare function toCardinal(value: number | string | bigint, options?: CardinalOptions): string;
+export type OrdinalOptions = {
+    /**
+     * - Grammatical gender
+     */
+    gender?: ('masculine' | 'feminine');
+};
+/**
+ * @typedef {object} OrdinalOptions
+ * @property {('masculine'|'feminine')} [gender] - Grammatical gender
+ */
+/** @type {Required<OrdinalOptions>} */
+export declare const ordinalDefaults: Required<OrdinalOptions>;
+/** @type {{ gender: ReadonlyArray<Required<OrdinalOptions>['gender']> }} */
+export declare const ordinalValues: {
+    gender: ReadonlyArray<Required<OrdinalOptions>['gender']>;
+};
 /**
  * Converts a numeric value to Spanish ordinal words.
  * @param {number | string | bigint} value - The positive integer to convert
@@ -70,7 +76,19 @@ export function toCardinal(value: number | string | bigint, options?: CardinalOp
  * toOrdinal(1, { gender: 'feminine' })  // 'primera'
  * toOrdinal(21)                         // 'vigésimo primero'
  */
-export function toOrdinal(value: number | string | bigint, options?: OrdinalOptions): string;
+declare function toOrdinal(value: number | string | bigint, options?: OrdinalOptions): string;
+export type CurrencyOptions = {
+    /**
+     * - Use "con" between pesos and centavos
+     */
+    and?: boolean;
+};
+/**
+ * @typedef {object} CurrencyOptions
+ * @property {boolean} [and] - Use "con" between pesos and centavos
+ */
+/** @type {Required<CurrencyOptions>} */
+export declare const currencyDefaults: Required<CurrencyOptions>;
 /**
  * Converts a numeric value to Mexican Peso currency words.
  *
@@ -87,4 +105,5 @@ export function toOrdinal(value: number | string | bigint, options?: OrdinalOpti
  * toCurrency(0.99)                   // 'noventa y nueve centavos'
  * toCurrency(42.50, { and: false })  // 'cuarenta y dos pesos cincuenta centavos'
  */
-export function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+declare function toCurrency(value: number | string | bigint, options?: CurrencyOptions): string;
+export { toCardinal, toOrdinal, toCurrency };