n2words 3.1.0 → 5.0.0

package/{lib/languages/yo.js → src/yo-NG.js}

@@ -1,8 +1,7 @@
 /**
- * Yoruba language converter - Functional Implementation
+ * Yoruba (Nigeria) language converter
  *
- * A number-to-words converter for Yoruba (yo), a Niger-Congo language
- * spoken by ~45 million people in Nigeria, Benin, and Togo.
+ * CLDR: yo-NG | Yoruba as used in Nigeria
  *
  * Yoruba uses a complex vigesimal (base-20) system with:
  * - Additive patterns: 1-4 added to decade (lé = "plus")
@@ -17,7 +16,9 @@
  * - 45 = àrùndínláàádọ́ta (50 - 5)
  */
 
-import { parseNumericValue } from '../utils/parse-numeric.js'
+import { parseCardinalValue } from './utils/parse-cardinal.js'
+import { parseCurrencyValue } from './utils/parse-currency.js'
+import { parseOrdinalValue } from './utils/parse-ordinal.js'
 
 // ============================================================================
 // Vocabulary (module-level constants)
@@ -111,6 +112,23 @@ const NEGATIVE = 'àìní'
 const DECIMAL_SEP = 'àmì'
 const AND = 'ó lé' // "and" / "plus" connector
 
+// ============================================================================
+// Ordinal Vocabulary
+// ============================================================================
+
+// Yoruba ordinals use "ìkẹ-" prefix: ìkẹta (3rd), ìkẹrin (4th)
+// First and second have special forms
+const ORDINAL_FIRST = 'àkọ́kọ́' // first
+const ORDINAL_SECOND = 'ìkejì' // second
+const ORDINAL_PREFIX = 'ìkẹ'
+
+// ============================================================================
+// Currency Vocabulary (Nigerian Naira)
+// ============================================================================
+
+const NAIRA = 'náírà'
+const KOBO = 'kọ́bọ̀'
+
 // ============================================================================
 // Segment Building
 // ============================================================================
@@ -131,7 +149,7 @@ function buildUnder100 (n) {
   // Exact decades
   if (n % 10 === 0) return DECADES[n]
 
-  const decade = Math.floor(n / 10) * 10
+  const decade = Math.trunc(n / 10) * 10
   const unit = n % 10
 
   // 1-4 are added to current decade (21 = 1 + 20, not 1 + 30)
@@ -155,7 +173,7 @@ function buildUnder100 (n) {
 function convertHundreds (n) {
   if (n < 100) return buildUnder100(n)
 
-  const hundreds = Math.floor(n / 100)
+  const hundreds = Math.trunc(n / 100)
   const remainder = n % 100
 
   let result
@@ -282,8 +300,8 @@ function decimalPartToWords (decimalPart) {
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Yoruba words
  */
-function toWords (value) {
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
+function toCardinal (value) {
+  const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
 
   let result = ''
 
@@ -300,4 +318,86 @@ function toWords (value) {
   return result
 }
 
-export { toWords }
+// ============================================================================
+// ORDINAL: toOrdinal(value)
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Yoruba ordinal words.
+ *
+ * Yoruba ordinals: àkọ́kọ́ (1st), ìkejì (2nd), ìkẹta (3rd), ìkẹrin (4th), etc.
+ *
+ * @param {bigint} n - Positive integer to convert
+ * @returns {string} Yoruba ordinal words
+ */
+function integerToOrdinal (n) {
+  // Special forms
+  if (n === 1n) return ORDINAL_FIRST
+  if (n === 2n) return ORDINAL_SECOND
+
+  // For 3+, use ìkẹ- prefix + cardinal
+  return ORDINAL_PREFIX + integerToWords(n)
+}
+
+/**
+ * Converts a numeric value to Yoruba ordinal words.
+ *
+ * @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)    // 'àkọ́kọ́'
+ * toOrdinal(2)    // 'ìkejì'
+ * toOrdinal(3)    // 'ìkẹẹ̀ta'
+ */
+function toOrdinal (value) {
+  const integerPart = parseOrdinalValue(value)
+  return integerToOrdinal(integerPart)
+}
+
+// ============================================================================
+// CURRENCY: toCurrency(value)
+// ============================================================================
+
+/**
+ * Converts a numeric value to Yoruba currency words (Nigerian Naira).
+ *
+ * Uses náírà (naira) and kọ́bọ̀ (kobo).
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @returns {string} The amount in Yoruba 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)     // 'èjì lé lógójì náírà'
+ * toCurrency(1.50)   // 'ọ̀kan náírà àti àádọ́ta kọ́bọ̀'
+ * toCurrency(-5)     // 'àìní àrùn náírà'
+ */
+function toCurrency (value) {
+  const { isNegative, dollars: naira, cents: kobo } = parseCurrencyValue(value)
+
+  let result = ''
+  if (isNegative) {
+    result = NEGATIVE + ' '
+  }
+
+  // Naira part
+  if (naira > 0n || kobo === 0n) {
+    result += integerToWords(naira) + ' ' + NAIRA
+  }
+
+  // Kobo part
+  if (kobo > 0n) {
+    if (naira > 0n) {
+      result += ' àti '
+    }
+    result += integerToWords(kobo) + ' ' + KOBO
+  }
+
+  return result
+}
+
+export { toCardinal, toOrdinal, toCurrency }

package/src/zh-Hans-CN.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Converts a numeric value to Simplified Chinese words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The number in Simplified Chinese words
+ */
+export function toCardinal(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;
+/**
+ * Converts a numeric value to Simplified Chinese ordinal words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @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(1, { formal: false }) // '第一'
+ * toOrdinal(10)                   // '第壹拾'
+ */
+export function toOrdinal(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;
+/**
+ * Converts a numeric value to Simplified Chinese currency words (Yuan/Renminbi).
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The amount in Simplified Chinese 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)                    // '肆拾贰圆伍角整'
+ * toCurrency(1)                        // '壹圆整'
+ * toCurrency(0.05)                     // '伍分'
+ * toCurrency(42.50, { formal: false }) // '四十二元五角整'
+ */
+export function toCurrency(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;

package/{lib/languages/zh-Hans.js → src/zh-Hans-CN.js}

@@ -1,7 +1,7 @@
 /**
- * Simplified Chinese language converter - Functional Implementation
+ * Simplified Chinese (China) language converter
  *
- * Self-contained converter for Simplified Chinese.
+ * CLDR: zh-Hans-CN | Simplified Chinese as used in China
  *
  * Key features:
  * - Myriad-based (万, 亿) grouping - 4 digits
@@ -10,8 +10,10 @@
  * - No word separators (concatenated format)
  */
 
-import { parseNumericValue } from '../utils/parse-numeric.js'
-import { validateOptions } from '../utils/validate-options.js'
+import { parseCardinalValue } from './utils/parse-cardinal.js'
+import { parseCurrencyValue } from './utils/parse-currency.js'
+import { parseOrdinalValue } from './utils/parse-ordinal.js'
+import { validateOptions } from './utils/validate-options.js'
 
 // ============================================================================
 // Vocabulary
@@ -37,6 +39,30 @@ const ZERO = '零'
 const NEGATIVE = '负'
 const DECIMAL_SEP = '点'
 
+// ============================================================================
+// Ordinal Vocabulary
+// ============================================================================
+
+// Ordinal prefix
+const ORDINAL_PREFIX = '第'
+
+// ============================================================================
+// Currency Vocabulary (Chinese Yuan / Renminbi)
+// ============================================================================
+
+// Yuan (main unit) - formal uses 圆, common uses 元
+const YUAN_FORMAL = '圆'
+const YUAN_COMMON = '元'
+
+// Jiao (1/10 yuan) - both use 角
+const JIAO = '角'
+
+// Fen (1/100 yuan) - both use 分
+const FEN = '分'
+
+// "Whole" when no jiao/fen
+const ZHENG = '整'
+
 // ============================================================================
 // Conversion Functions
 // ============================================================================
@@ -158,10 +184,12 @@ function decimalDigitsToWords (decimalString, ones) {
  * @param {boolean} [options.formal=true] - Use formal/financial numerals
  * @returns {string} The number in Simplified Chinese words
  */
-function toWords (value, options) {
+function toCardinal (value, options) {
   options = validateOptions(options)
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
-  const formal = options.formal !== false // Default to true
+  const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
+
+  // Apply option defaults
+  const { formal = true } = options
 
   let result = isNegative ? NEGATIVE : ''
 
@@ -175,8 +203,112 @@ function toWords (value, options) {
   return result
 }
 
+// ============================================================================
+// ORDINAL: toOrdinal(value)
+// ============================================================================
+
+/**
+ * Converts a positive integer to Simplified Chinese ordinal words.
+ *
+ * Chinese ordinals: 第 prefix + cardinal number.
+ *
+ * @param {bigint} n - Positive integer to convert
+ * @param {boolean} formal - Use formal numerals
+ * @returns {string} Simplified Chinese ordinal words
+ */
+function integerToOrdinal (n, formal) {
+  return ORDINAL_PREFIX + integerToWords(n, formal)
+}
+
+/**
+ * Converts a numeric value to Simplified Chinese ordinal words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @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(1, { formal: false }) // '第一'
+ * toOrdinal(10)                   // '第壹拾'
+ */
+function toOrdinal (value, options) {
+  options = validateOptions(options)
+  const integerPart = parseOrdinalValue(value)
+  const { formal = true } = options
+  return integerToOrdinal(integerPart, formal)
+}
+
+// ============================================================================
+// CURRENCY: toCurrency(value, options?)
+// ============================================================================
+
+/**
+ * Converts a numeric value to Simplified Chinese currency words (Yuan/Renminbi).
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The amount in Simplified Chinese 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)                    // '肆拾贰圆伍角整'
+ * toCurrency(1)                        // '壹圆整'
+ * toCurrency(0.05)                     // '伍分'
+ * toCurrency(42.50, { formal: false }) // '四十二元五角整'
+ */
+function toCurrency (value, options) {
+  options = validateOptions(options)
+  const { isNegative, dollars: yuan, cents } = parseCurrencyValue(value)
+  const { formal = true } = options
+
+  const ones = formal ? ONES_FORMAL : ONES_COMMON
+  const yuanWord = formal ? YUAN_FORMAL : YUAN_COMMON
+
+  // Split cents into jiao (tens) and fen (ones)
+  const jiao = cents / 10n
+  const fen = cents % 10n
+
+  // Build result
+  let result = ''
+  if (isNegative) result = NEGATIVE
+
+  // Yuan part
+  if (yuan > 0n) {
+    result += integerToWords(yuan, formal) + yuanWord
+  }
+
+  // Jiao part (1/10)
+  if (jiao > 0n) {
+    result += ones[Number(jiao)] + JIAO
+  } else if (yuan > 0n && fen > 0n) {
+    // Need zero placeholder between yuan and fen
+    result += ZERO
+  }
+
+  // Fen part (1/100)
+  if (fen > 0n) {
+    result += ones[Number(fen)] + FEN
+  } else if (yuan > 0n || jiao > 0n) {
+    // Add 整 (zheng) to indicate whole amount
+    result += ZHENG
+  }
+
+  // Handle zero case
+  if (yuan === 0n && jiao === 0n && fen === 0n) {
+    result += ZERO + yuanWord + ZHENG
+  }
+
+  return result
+}
+
 // ============================================================================
 // Exports
 // ============================================================================
 
-export { toWords }
+export { toCardinal, toOrdinal, toCurrency }

package/src/zh-Hant-TW.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Converts a numeric value to Traditional Chinese words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The number in Traditional Chinese words
+ */
+export function toCardinal(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;
+/**
+ * Converts a numeric value to Traditional Chinese ordinal words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @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(1, { formal: false }) // '第一'
+ */
+export function toOrdinal(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;
+/**
+ * Converts a numeric value to Traditional Chinese currency words (New Taiwan Dollar).
+ *
+ * Uses 圓 (yuan), 角 (jiao, 1/10), 分 (fen, 1/100).
+ * Formal writing adds 整 (zheng) for whole amounts.
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The amount in Traditional Chinese 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)                    // '肆拾貳圓整'
+ * toCurrency(1.50)                  // '壹圓伍角整'
+ * toCurrency(42, { formal: false }) // '四十二元整'
+ */
+export function toCurrency(value: number | string | bigint, options?: {
+    formal?: boolean | undefined;
+}): string;

package/{lib/languages/zh-Hant.js → src/zh-Hant-TW.js}

@@ -1,7 +1,7 @@
 /**
- * Traditional Chinese language converter - Functional Implementation
+ * Traditional Chinese (Taiwan) language converter
  *
- * Self-contained converter for Traditional Chinese.
+ * CLDR: zh-Hant-TW | Traditional Chinese as used in Taiwan
  *
  * Key features:
  * - Myriad-based (萬, 億) grouping - 4 digits
@@ -14,8 +14,10 @@
  * - Some formal numerals differ (參/叁, 貳/贰, 陸/陆)
  */
 
-import { parseNumericValue } from '../utils/parse-numeric.js'
-import { validateOptions } from '../utils/validate-options.js'
+import { parseCardinalValue } from './utils/parse-cardinal.js'
+import { parseCurrencyValue } from './utils/parse-currency.js'
+import { parseOrdinalValue } from './utils/parse-ordinal.js'
+import { validateOptions } from './utils/validate-options.js'
 
 // ============================================================================
 // Vocabulary
@@ -41,6 +43,25 @@ const ZERO = '零'
 const NEGATIVE = '負'
 const DECIMAL_SEP = '點'
 
+// ============================================================================
+// Ordinal Vocabulary
+// ============================================================================
+
+const ORDINAL_PREFIX = '第'
+
+// ============================================================================
+// Currency Vocabulary (New Taiwan Dollar)
+// ============================================================================
+
+// Formal currency (default)
+const YUAN_FORMAL = '圓'
+const JIAO_FORMAL = '角'
+const FEN_FORMAL = '分'
+const ZHENG_FORMAL = '整' // "exactly" suffix when whole amount
+
+// Common currency
+const YUAN_COMMON = '元'
+
 // ============================================================================
 // Conversion Functions
 // ============================================================================
@@ -175,10 +196,12 @@ function decimalDigitsToWords (decimalString, formal = true) {
  * @param {boolean} [options.formal=true] - Use formal/financial numerals
  * @returns {string} The number in Traditional Chinese words
  */
-function toWords (value, options) {
+function toCardinal (value, options) {
   options = validateOptions(options)
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
-  const formal = options.formal !== false // Default to true
+  const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
+
+  // Apply option defaults
+  const { formal = true } = options
 
   let result = ''
 
@@ -195,8 +218,116 @@ function toWords (value, options) {
   return result
 }
 
+// ============================================================================
+// ORDINAL: toOrdinal(value, options?)
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Traditional Chinese ordinal words.
+ *
+ * Traditional Chinese ordinals use "第" prefix + cardinal number.
+ *
+ * @param {bigint} n - Positive integer to convert
+ * @param {boolean} formal - Use formal/financial numerals
+ * @returns {string} Traditional Chinese ordinal words
+ */
+function integerToOrdinal (n, formal = true) {
+  return ORDINAL_PREFIX + integerToWords(n, formal)
+}
+
+/**
+ * Converts a numeric value to Traditional Chinese ordinal words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @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(1, { formal: false }) // '第一'
+ */
+function toOrdinal (value, options) {
+  options = validateOptions(options)
+  const integerPart = parseOrdinalValue(value)
+  const { formal = true } = options
+  return integerToOrdinal(integerPart, formal)
+}
+
+// ============================================================================
+// CURRENCY: toCurrency(value, options?)
+// ============================================================================
+
+/**
+ * Converts a numeric value to Traditional Chinese currency words (New Taiwan Dollar).
+ *
+ * Uses 圓 (yuan), 角 (jiao, 1/10), 分 (fen, 1/100).
+ * Formal writing adds 整 (zheng) for whole amounts.
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.formal=true] - Use formal/financial numerals
+ * @returns {string} The amount in Traditional Chinese 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)                    // '肆拾貳圓整'
+ * toCurrency(1.50)                  // '壹圓伍角整'
+ * toCurrency(42, { formal: false }) // '四十二元整'
+ */
+function toCurrency (value, options) {
+  options = validateOptions(options)
+  const { isNegative, dollars: yuan, cents } = parseCurrencyValue(value)
+  const { formal = true } = options
+
+  const yuanWord = formal ? YUAN_FORMAL : YUAN_COMMON
+
+  // Split cents into jiao (tens) and fen (ones)
+  const jiao = cents / 10n
+  const fen = cents % 10n
+
+  let result = ''
+  if (isNegative) {
+    result = NEGATIVE
+  }
+
+  // Yuan part (always show for zero with no cents)
+  if (yuan > 0n || cents === 0n) {
+    result += integerToWords(yuan, formal)
+    result += yuanWord
+  }
+
+  // Jiao part (tens of cents)
+  if (jiao > 0n) {
+    const ones = formal ? ONES_FORMAL : ONES_COMMON
+    result += ones[Number(jiao)] + JIAO_FORMAL
+  }
+
+  // Fen part (ones of cents)
+  if (fen > 0n) {
+    const ones = formal ? ONES_FORMAL : ONES_COMMON
+    // Need zero if we have yuan but no jiao
+    if (yuan > 0n && jiao === 0n) {
+      result += ZERO
+    }
+    result += ones[Number(fen)] + FEN_FORMAL
+  } else if (jiao > 0n) {
+    // Has jiao but no fen - add 整
+    result += ZHENG_FORMAL
+  } else {
+    // Whole yuan only - add 整
+    result += ZHENG_FORMAL
+  }
+
+  return result
+}
+
 // ============================================================================
 // Exports
 // ============================================================================
 
-export { toWords }
+export { toCardinal, toOrdinal, toCurrency }

package/dist/languages/am-Latn.js

@@ -1,3 +0,0 @@
-/*! n2words/am-Latn v3.1.0 | MIT License | github.com/forzagreen/n2words */
-var e,t;e=this,t=function(e){"use strict";function t(e){const t="-"===e[0];t&&(e=e.slice(1));const n=e.indexOf(".");if(-1===n)return{isNegative:t,integerPart:BigInt(e)};const i=e.slice(0,n)||"0",r=e.slice(n+1);return{isNegative:t,integerPart:BigInt(i),decimalPart:r}}function n(e){const[t,n]=e.toLowerCase().split("e"),i=parseInt(n,10),r=t.indexOf("."),s=-1===r?t:t.slice(0,r)+t.slice(r+1),a=(-1===r?t.length:r)+i;return a>=s.length?s+"0".repeat(a-s.length):a<=0?"0."+"0".repeat(-a)+s:s.slice(0,a)+"."+s.slice(a)}const i=["","and","hulet","sost","arat","amist","siddist","sebat","siment","zeteny"],r=["asir","asra and","asra hulet","asra sost","asra arat","asra amist","asra siddist","asra sebat","asra siment","asra zeteny"],s=["","","haya","selasa","arba","hamsa","silsa","seba","semanya","zetena"],a="zero",o=["","shi","miliyon","billiyon"];function u(e){if(0===e)return"";const t=e%10,n=Math.floor(e/10)%10,a=Math.floor(e/100),o=[];return a>0&&o.push(i[a]+" meto"),1===n?o.push(r[t]):(n>1&&o.push(s[n]),t>0&&o.push(i[t])),o.join(" ")}e.amLatn=function(e){const{isNegative:r,integerPart:s,decimalPart:c}=function(e){const i=typeof e;if("bigint"===i)return e<0n?{isNegative:!0,integerPart:-e}:{isNegative:!1,integerPart:e};if("number"===i){if(!Number.isFinite(e))throw new Error("Number must be finite (NaN and Infinity are not supported)");return Number.isSafeInteger(e)?e<0?{isNegative:!0,integerPart:BigInt(-e)}:{isNegative:!1,integerPart:BigInt(e)}:t(function(e){const t=e.toString();return t.includes("e")||t.includes("E")?n(t):t}(e))}if("string"===i)return t(function(e){const t=e.trim();if(0===t.length||Number.isNaN(Number(t)))throw new Error(`Invalid number format: "${e}"`);return t.includes("e")||t.includes("E")?n(t):t}(e));throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${i}`)}(e);let l="";return r&&(l="asitegna "),l+=0n===(f=s)?a:f<1000n?u(Number(f)):function(e){const t=e.toString(),n=t.length,i=[],r=n%3;let s=0;for(r>0&&(i.push(Number(t.slice(0,r))),s=r);s<n;)i.push(Number(t.slice(s,s+3))),s+=3;const a=[];let c=i.length-1;for(let e=0;e<i.length;e++){const t=i[e];if(0!==t){const e=o[c]||"";a.push(0===c?u(t):u(t)+" "+e)}c--}return a.join(" ")}(f),c&&(l+=" netib "+function(e){const t=[];for(const n of e){const e=parseInt(n,10);t.push(0===e?a:i[e])}return t.join(" ")}(c)),l;var f}},"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).n2words=e.n2words||{});
-//# sourceMappingURL=am-Latn.js.map

package/dist/languages/am-Latn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"am-Latn.js","sources":["../../lib/utils/parse-numeric.js","../../lib/languages/am-Latn.js"],"sourcesContent":["/**\n * Numeric value parsing utility.\n * Transforms user input (number, string, or bigint) into normalized components.\n * @module parse-numeric\n */\n\n/**\n * Parses a numeric value into its components.\n * @param {number|string|bigint} value\n * @returns {{isNegative: boolean, integerPart: bigint, decimalPart?: string}}\n * @throws {TypeError} If value is not number, string, or bigint\n * @throws {Error} If value is not a valid number format\n */\nexport function parseNumericValue (value) {\n  const type = typeof value\n\n  // BigInt: simplest case\n  if (type === 'bigint') {\n    return value < 0n\n      ? { isNegative: true, integerPart: -value }\n      : { isNegative: false, integerPart: value }\n  }\n\n  // Number: fast path for safe integers\n  if (type === 'number') {\n    if (!Number.isFinite(value)) {\n      throw new Error('Number must be finite (NaN and Infinity are not supported)')\n    }\n    if (Number.isSafeInteger(value)) {\n      return value < 0\n        ? { isNegative: true, integerPart: BigInt(-value) }\n        : { isNegative: false, integerPart: BigInt(value) }\n    }\n    return parseNumericString(numberToString(value))\n  }\n\n  // String input\n  if (type === 'string') {\n    return parseNumericString(normalizeString(value))\n  }\n\n  throw new TypeError(\n    `Invalid value type: expected number, string, or bigint, received ${type}`\n  )\n}\n\n/**\n * Converts a number to decimal string, expanding scientific notation if needed.\n */\nfunction numberToString (value) {\n  const str = value.toString()\n  return (str.includes('e') || str.includes('E'))\n    ? expandScientificNotation(str)\n    : str\n}\n\n/**\n * Validates and normalizes a string numeric input.\n */\nfunction normalizeString (value) {\n  const trimmed = value.trim()\n  if (trimmed.length === 0 || Number.isNaN(Number(trimmed))) {\n    throw new Error(`Invalid number format: \"${value}\"`)\n  }\n  return (trimmed.includes('e') || trimmed.includes('E'))\n    ? expandScientificNotation(trimmed)\n    : trimmed\n}\n\n/**\n * Parses a normalized numeric string into components.\n */\nfunction parseNumericString (str) {\n  const isNegative = str[0] === '-'\n  if (isNegative) str = str.slice(1)\n\n  const dotIndex = str.indexOf('.')\n  if (dotIndex === -1) {\n    return { isNegative, integerPart: BigInt(str) }\n  }\n\n  const integerStr = str.slice(0, dotIndex) || '0'\n  const decimalPart = str.slice(dotIndex + 1)\n  return { isNegative, integerPart: BigInt(integerStr), decimalPart }\n}\n\n/**\n * Expands scientific notation to decimal form (e.g., \"1e21\" → \"1000...\").\n */\nfunction expandScientificNotation (str) {\n  const [mantissa, expStr] = str.toLowerCase().split('e')\n  const exp = parseInt(expStr, 10)\n\n  const dotIndex = mantissa.indexOf('.')\n  const digits = dotIndex === -1\n    ? mantissa\n    : mantissa.slice(0, dotIndex) + mantissa.slice(dotIndex + 1)\n  const integerLength = dotIndex === -1 ? mantissa.length : dotIndex\n  const newDotPosition = integerLength + exp\n\n  if (newDotPosition >= digits.length) {\n    return digits + '0'.repeat(newDotPosition - digits.length)\n  }\n  if (newDotPosition <= 0) {\n    return '0.' + '0'.repeat(-newDotPosition) + digits\n  }\n  return digits.slice(0, newDotPosition) + '.' + digits.slice(newDotPosition)\n}\n","/**\n * Amharic Latin language converter - Functional Implementation\n *\n * Self-contained module with its own input validation, ready for subpath exports.\n * Latin/ASCII romanization of Amharic numerals.\n *\n * Key features:\n * - Romanized numerals (and, hulet, sost)\n * - Teens formed with \"asra\" prefix\n * - Keeps \"one\" before hundred: \"and meto\" (100)\n * - Short scale naming\n * - Per-digit decimal reading\n */\n\nimport { parseNumericValue } from '../utils/parse-numeric.js'\n\n// ============================================================================\n// Vocabulary\n// ============================================================================\n\nconst ONES = ['', 'and', 'hulet', 'sost', 'arat', 'amist', 'siddist', 'sebat', 'siment', 'zeteny']\nconst TEENS = ['asir', 'asra and', 'asra hulet', 'asra sost', 'asra arat', 'asra amist', 'asra siddist', 'asra sebat', 'asra siment', 'asra zeteny']\nconst TENS = ['', '', 'haya', 'selasa', 'arba', 'hamsa', 'silsa', 'seba', 'semanya', 'zetena']\n\nconst HUNDRED = 'meto'\nconst THOUSAND = 'shi'\n\nconst ZERO = 'zero'\nconst NEGATIVE = 'asitegna'\nconst DECIMAL_SEP = 'netib'\n\n// Short scale\nconst SCALE_WORDS = ['', THOUSAND, 'miliyon', 'billiyon']\n\n// ============================================================================\n// Precomputed Lookup Table\n// ============================================================================\n\nfunction buildSegment (n) {\n  if (n === 0) return ''\n\n  const ones = n % 10\n  const tensDigit = Math.floor(n / 10) % 10\n  const hundredsDigit = Math.floor(n / 100)\n\n  const parts = []\n\n  // Amharic keeps \"one\" before hundred: \"and meto\" (100)\n  if (hundredsDigit > 0) {\n    parts.push(ONES[hundredsDigit] + ' ' + HUNDRED)\n  }\n\n  if (tensDigit === 1) {\n    parts.push(TEENS[ones])\n  } else {\n    if (tensDigit > 1) {\n      parts.push(TENS[tensDigit])\n    }\n    if (ones > 0) {\n      parts.push(ONES[ones])\n    }\n  }\n\n  return parts.join(' ')\n}\n\n// ============================================================================\n// Conversion Functions\n// ============================================================================\n\nfunction integerToWords (n) {\n  if (n === 0n) return ZERO\n\n  if (n < 1000n) {\n    return buildSegment(Number(n))\n  }\n\n  return buildLargeNumberWords(n)\n}\n\nfunction buildLargeNumberWords (n) {\n  const numStr = n.toString()\n  const len = numStr.length\n\n  const segments = []\n  const segmentSize = 3\n\n  const remainderLen = len % segmentSize\n  let pos = 0\n  if (remainderLen > 0) {\n    segments.push(Number(numStr.slice(0, remainderLen)))\n    pos = remainderLen\n  }\n  while (pos < len) {\n    segments.push(Number(numStr.slice(pos, pos + segmentSize)))\n    pos += segmentSize\n  }\n\n  const parts = []\n  let scaleIndex = segments.length - 1\n\n  for (let i = 0; i < segments.length; i++) {\n    const segment = segments[i]\n\n    if (segment !== 0) {\n      const scaleWord = SCALE_WORDS[scaleIndex] || ''\n\n      if (scaleIndex === 0) {\n        parts.push(buildSegment(segment))\n      } else {\n        parts.push(buildSegment(segment) + ' ' + scaleWord)\n      }\n    }\n\n    scaleIndex--\n  }\n\n  return parts.join(' ')\n}\n\nfunction decimalPartToWords (decimalPart) {\n  // Per-digit decimal reading\n  const digits = []\n  for (const char of decimalPart) {\n    const d = parseInt(char, 10)\n    digits.push(d === 0 ? ZERO : ONES[d])\n  }\n  return digits.join(' ')\n}\n\n/**\n * Converts a numeric value to Amharic (Latin script) words.\n *\n * @param {number | string | bigint} value - The numeric value to convert\n * @returns {string} The number in Amharic Latin words\n */\nfunction toWords (value) {\n  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)\n\n  let result = ''\n\n  if (isNegative) {\n    result = NEGATIVE + ' '\n  }\n\n  result += integerToWords(integerPart)\n\n  if (decimalPart) {\n    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)\n  }\n\n  return result\n}\n\n// ============================================================================\n// Exports\n// ============================================================================\n\nexport { toWords }\n"],"names":["parseNumericString","str","isNegative","slice","dotIndex","indexOf","integerPart","BigInt","integerStr","decimalPart","expandScientificNotation","mantissa","expStr","toLowerCase","split","exp","parseInt","digits","newDotPosition","length","repeat","ONES","TEENS","TENS","ZERO","SCALE_WORDS","buildSegment","n","ones","tensDigit","Math","floor","hundredsDigit","parts","push","join","value","type","Number","isFinite","Error","isSafeInteger","toString","includes","numberToString","trimmed","trim","isNaN","normalizeString","TypeError","parseNumericValue","result","NEGATIVE","numStr","len","segments","remainderLen","pos","scaleIndex","i","segment","scaleWord","buildLargeNumberWords","char","d","decimalPartToWords"],"mappings":"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"}

package/dist/languages/am.js

@@ -1,3 +0,0 @@
-/*! n2words/am v3.1.0 | MIT License | github.com/forzagreen/n2words */
-var e,t;e=this,t=function(e){"use strict";function t(e){const t="-"===e[0];t&&(e=e.slice(1));const n=e.indexOf(".");if(-1===n)return{isNegative:t,integerPart:BigInt(e)};const i=e.slice(0,n)||"0",r=e.slice(n+1);return{isNegative:t,integerPart:BigInt(i),decimalPart:r}}function n(e){const[t,n]=e.toLowerCase().split("e"),i=parseInt(n,10),r=t.indexOf("."),o=-1===r?t:t.slice(0,r)+t.slice(r+1),s=(-1===r?t.length:r)+i;return s>=o.length?o+"0".repeat(s-o.length):s<=0?"0."+"0".repeat(-s)+o:o.slice(0,s)+"."+o.slice(s)}const i=["","አንድ","ሁለት","ሶስት","አራት","አምስት","ስድስት","ሰባት","ስምንት","ዘጠኝ"],r=["አስር","አስራ አንድ","አስራ ሁለት","አስራ ሶስት","አስራ አራት","አስራ አምስት","አስራ ስድስት","አስራ ሰባት","አስራ ስምንት","አስራ ዘጠኝ"],o=["","","ሃያ","ሰላሳ","አርባ","ሃምሳ","ስልሳ","ሰባ","ሰማንያ","ዘጠና"],s=["","ሺ","ሚሊዮን","ቢሊዮን"];function u(e){if(0===e)return"";const t=e%10,n=Math.floor(e/10)%10,s=Math.floor(e/100),u=[];return s>0&&u.push(i[s]+" መቶ"),1===n?u.push(r[t]):(n>1&&u.push(o[n]),t>0&&u.push(i[t])),u.join(" ")}e.am=function(e){const{isNegative:r,integerPart:o,decimalPart:c}=function(e){const i=typeof e;if("bigint"===i)return e<0n?{isNegative:!0,integerPart:-e}:{isNegative:!1,integerPart:e};if("number"===i){if(!Number.isFinite(e))throw new Error("Number must be finite (NaN and Infinity are not supported)");return Number.isSafeInteger(e)?e<0?{isNegative:!0,integerPart:BigInt(-e)}:{isNegative:!1,integerPart:BigInt(e)}:t(function(e){const t=e.toString();return t.includes("e")||t.includes("E")?n(t):t}(e))}if("string"===i)return t(function(e){const t=e.trim();if(0===t.length||Number.isNaN(Number(t)))throw new Error(`Invalid number format: "${e}"`);return t.includes("e")||t.includes("E")?n(t):t}(e));throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${i}`)}(e);let f="";return r&&(f="አሉታዊ "),f+=0n===(a=o)?"ዜሮ":a<1000n?u(Number(a)):function(e){const t=e.toString(),n=t.length,i=[],r=n%3;let o=0;for(r>0&&(i.push(Number(t.slice(0,r))),o=r);o<n;)i.push(Number(t.slice(o,o+3))),o+=3;const c=[];let f=i.length-1;for(let e=0;e<i.length;e++){const t=i[e];if(0!==t){const e=s[f]||"";c.push(0===f?u(t):u(t)+" "+e)}f--}return c.join(" ")}(a),c&&(f+=" ነጥብ "+function(e){const t=[];for(const n of e){const e=parseInt(n,10);t.push(0===e?"ዜሮ":i[e])}return t.join(" ")}(c)),f;var a}},"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).n2words=e.n2words||{});
-//# sourceMappingURL=am.js.map