n2words 3.1.0 → 4.0.0

package/lib/languages/am-Latn.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Amharic (Latin script) words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Amharic Latin words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/am-Latn.js

@@ -1,159 +0,0 @@
-/**
- * Amharic Latin language converter - Functional Implementation
- *
- * Self-contained module with its own input validation, ready for subpath exports.
- * Latin/ASCII romanization of Amharic numerals.
- *
- * Key features:
- * - Romanized numerals (and, hulet, sost)
- * - Teens formed with "asra" prefix
- * - Keeps "one" before hundred: "and meto" (100)
- * - Short scale naming
- * - Per-digit decimal reading
- */
-
-import { parseNumericValue } from '../utils/parse-numeric.js'
-
-// ============================================================================
-// Vocabulary
-// ============================================================================
-
-const ONES = ['', 'and', 'hulet', 'sost', 'arat', 'amist', 'siddist', 'sebat', 'siment', 'zeteny']
-const TEENS = ['asir', 'asra and', 'asra hulet', 'asra sost', 'asra arat', 'asra amist', 'asra siddist', 'asra sebat', 'asra siment', 'asra zeteny']
-const TENS = ['', '', 'haya', 'selasa', 'arba', 'hamsa', 'silsa', 'seba', 'semanya', 'zetena']
-
-const HUNDRED = 'meto'
-const THOUSAND = 'shi'
-
-const ZERO = 'zero'
-const NEGATIVE = 'asitegna'
-const DECIMAL_SEP = 'netib'
-
-// Short scale
-const SCALE_WORDS = ['', THOUSAND, 'miliyon', 'billiyon']
-
-// ============================================================================
-// Precomputed Lookup Table
-// ============================================================================
-
-function buildSegment (n) {
-  if (n === 0) return ''
-
-  const ones = n % 10
-  const tensDigit = Math.floor(n / 10) % 10
-  const hundredsDigit = Math.floor(n / 100)
-
-  const parts = []
-
-  // Amharic keeps "one" before hundred: "and meto" (100)
-  if (hundredsDigit > 0) {
-    parts.push(ONES[hundredsDigit] + ' ' + HUNDRED)
-  }
-
-  if (tensDigit === 1) {
-    parts.push(TEENS[ones])
-  } else {
-    if (tensDigit > 1) {
-      parts.push(TENS[tensDigit])
-    }
-    if (ones > 0) {
-      parts.push(ONES[ones])
-    }
-  }
-
-  return parts.join(' ')
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return buildSegment(Number(n))
-  }
-
-  return buildLargeNumberWords(n)
-}
-
-function buildLargeNumberWords (n) {
-  const numStr = n.toString()
-  const len = numStr.length
-
-  const segments = []
-  const segmentSize = 3
-
-  const remainderLen = len % segmentSize
-  let pos = 0
-  if (remainderLen > 0) {
-    segments.push(Number(numStr.slice(0, remainderLen)))
-    pos = remainderLen
-  }
-  while (pos < len) {
-    segments.push(Number(numStr.slice(pos, pos + segmentSize)))
-    pos += segmentSize
-  }
-
-  const parts = []
-  let scaleIndex = segments.length - 1
-
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i]
-
-    if (segment !== 0) {
-      const scaleWord = SCALE_WORDS[scaleIndex] || ''
-
-      if (scaleIndex === 0) {
-        parts.push(buildSegment(segment))
-      } else {
-        parts.push(buildSegment(segment) + ' ' + scaleWord)
-      }
-    }
-
-    scaleIndex--
-  }
-
-  return parts.join(' ')
-}
-
-function decimalPartToWords (decimalPart) {
-  // Per-digit decimal reading
-  const digits = []
-  for (const char of decimalPart) {
-    const d = parseInt(char, 10)
-    digits.push(d === 0 ? ZERO : ONES[d])
-  }
-  return digits.join(' ')
-}
-
-/**
- * Converts a numeric value to Amharic (Latin script) words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Amharic Latin words
- */
-function toWords (value) {
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
-
-  let result = ''
-
-  if (isNegative) {
-    result = NEGATIVE + ' '
-  }
-
-  result += integerToWords(integerPart)
-
-  if (decimalPart) {
-    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)
-  }
-
-  return result
-}
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export { toWords }

package/lib/languages/am.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Amharic words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Amharic words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/am.js

@@ -1,159 +0,0 @@
-/**
- * Amharic language converter - Functional Implementation
- *
- * Self-contained module with its own input validation, ready for subpath exports.
- * Native Ge'ez script (ግዕዝ) output.
- *
- * Key features:
- * - Ge'ez/Ethiopic script numerals
- * - Teens formed with "አስራ" prefix
- * - Keeps "one" before hundred: "አንድ መቶ" (100)
- * - Short scale naming
- * - Per-digit decimal reading
- */
-
-import { parseNumericValue } from '../utils/parse-numeric.js'
-
-// ============================================================================
-// Vocabulary
-// ============================================================================
-
-const ONES = ['', 'አንድ', 'ሁለት', 'ሶስት', 'አራት', 'አምስት', 'ስድስት', 'ሰባት', 'ስምንት', 'ዘጠኝ']
-const TEENS = ['አስር', 'አስራ አንድ', 'አስራ ሁለት', 'አስራ ሶስት', 'አስራ አራት', 'አስራ አምስት', 'አስራ ስድስት', 'አስራ ሰባት', 'አስራ ስምንት', 'አስራ ዘጠኝ']
-const TENS = ['', '', 'ሃያ', 'ሰላሳ', 'አርባ', 'ሃምሳ', 'ስልሳ', 'ሰባ', 'ሰማንያ', 'ዘጠና']
-
-const HUNDRED = 'መቶ'
-const THOUSAND = 'ሺ'
-
-const ZERO = 'ዜሮ'
-const NEGATIVE = 'አሉታዊ'
-const DECIMAL_SEP = 'ነጥብ'
-
-// Short scale
-const SCALE_WORDS = ['', THOUSAND, 'ሚሊዮን', 'ቢሊዮን']
-
-// ============================================================================
-// Precomputed Lookup Table
-// ============================================================================
-
-function buildSegment (n) {
-  if (n === 0) return ''
-
-  const ones = n % 10
-  const tensDigit = Math.floor(n / 10) % 10
-  const hundredsDigit = Math.floor(n / 100)
-
-  const parts = []
-
-  // Amharic keeps "one" before hundred: "አንድ መቶ" (100)
-  if (hundredsDigit > 0) {
-    parts.push(ONES[hundredsDigit] + ' ' + HUNDRED)
-  }
-
-  if (tensDigit === 1) {
-    parts.push(TEENS[ones])
-  } else {
-    if (tensDigit > 1) {
-      parts.push(TENS[tensDigit])
-    }
-    if (ones > 0) {
-      parts.push(ONES[ones])
-    }
-  }
-
-  return parts.join(' ')
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return buildSegment(Number(n))
-  }
-
-  return buildLargeNumberWords(n)
-}
-
-function buildLargeNumberWords (n) {
-  const numStr = n.toString()
-  const len = numStr.length
-
-  const segments = []
-  const segmentSize = 3
-
-  const remainderLen = len % segmentSize
-  let pos = 0
-  if (remainderLen > 0) {
-    segments.push(Number(numStr.slice(0, remainderLen)))
-    pos = remainderLen
-  }
-  while (pos < len) {
-    segments.push(Number(numStr.slice(pos, pos + segmentSize)))
-    pos += segmentSize
-  }
-
-  const parts = []
-  let scaleIndex = segments.length - 1
-
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i]
-
-    if (segment !== 0) {
-      const scaleWord = SCALE_WORDS[scaleIndex] || ''
-
-      if (scaleIndex === 0) {
-        parts.push(buildSegment(segment))
-      } else {
-        parts.push(buildSegment(segment) + ' ' + scaleWord)
-      }
-    }
-
-    scaleIndex--
-  }
-
-  return parts.join(' ')
-}
-
-function decimalPartToWords (decimalPart) {
-  // Per-digit decimal reading
-  const digits = []
-  for (const char of decimalPart) {
-    const d = parseInt(char, 10)
-    digits.push(d === 0 ? ZERO : ONES[d])
-  }
-  return digits.join(' ')
-}
-
-/**
- * Converts a numeric value to Amharic words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Amharic words
- */
-function toWords (value) {
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
-
-  let result = ''
-
-  if (isNegative) {
-    result = NEGATIVE + ' '
-  }
-
-  result += integerToWords(integerPart)
-
-  if (decimalPart) {
-    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)
-  }
-
-  return result
-}
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export { toWords }

package/lib/languages/ar.d.ts

@@ -1,17 +0,0 @@
-/**
- * Converts a numeric value to Arabic words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @param {Object} [options] - Optional configuration
- * @param {('masculine'|'feminine')} [options.gender='masculine'] - Grammatical gender
- * @param {string} [options.negativeWord] - Custom word for negative numbers
- * @returns {string} The number in Arabic words
- *
- * @example
- * toWords(1)                        // 'واحد'
- * toWords(1, {gender: 'feminine'})  // 'واحدة'
- */
-export function toWords(value: number | string | bigint, options?: {
-    gender?: "masculine" | "feminine" | undefined;
-    negativeWord?: string | undefined;
-}): string;

package/lib/languages/az.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Azerbaijani words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Azerbaijani words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/az.js

@@ -1,171 +0,0 @@
-/**
- * Azerbaijani language converter - Functional Implementation
- *
- * Self-contained module with its own input validation, ready for subpath exports.
- *
- * Key features:
- * - Turkic language patterns
- * - Implicit "bir" (one) omission before hundreds and thousands
- * - Short scale naming
- */
-
-import { parseNumericValue } from '../utils/parse-numeric.js'
-
-// ============================================================================
-// Vocabulary
-// ============================================================================
-
-const ONES = ['', 'bir', 'iki', 'üç', 'dörd', 'beş', 'altı', 'yeddi', 'səkkiz', 'doqquz']
-const TEENS = ['on', 'on bir', 'on iki', 'on üç', 'on dörd', 'on beş', 'on altı', 'on yeddi', 'on səkkiz', 'on doqquz']
-const TENS = ['', '', 'iyirmi', 'otuz', 'qırx', 'əlli', 'altmış', 'yetmiş', 'səksən', 'doxsan']
-
-const HUNDRED = 'yüz'
-const THOUSAND = 'min'
-
-const ZERO = 'sıfır'
-const NEGATIVE = 'mənfi'
-const DECIMAL_SEP = 'nöqtə'
-
-// Short scale
-const SCALE_WORDS = ['', THOUSAND, 'milyon', 'milyar', 'trilyon', 'katrilyon', 'kentilyon']
-
-// ============================================================================
-// Precomputed Lookup Table
-// ============================================================================
-
-function buildSegment (n) {
-  if (n === 0) return ''
-
-  const ones = n % 10
-  const tensDigit = Math.floor(n / 10) % 10
-  const hundredsDigit = Math.floor(n / 100)
-
-  const parts = []
-
-  if (hundredsDigit > 0) {
-    if (hundredsDigit === 1) {
-      parts.push(HUNDRED)
-    } else {
-      parts.push(ONES[hundredsDigit] + ' ' + HUNDRED)
-    }
-  }
-
-  if (tensDigit === 1) {
-    parts.push(TEENS[ones])
-  } else {
-    if (tensDigit > 1) {
-      parts.push(TENS[tensDigit])
-    }
-    if (ones > 0) {
-      parts.push(ONES[ones])
-    }
-  }
-
-  return parts.join(' ')
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return buildSegment(Number(n))
-  }
-
-  return buildLargeNumberWords(n)
-}
-
-function buildLargeNumberWords (n) {
-  const numStr = n.toString()
-  const len = numStr.length
-
-  const segments = []
-  const segmentSize = 3
-
-  const remainderLen = len % segmentSize
-  let pos = 0
-  if (remainderLen > 0) {
-    segments.push(Number(numStr.slice(0, remainderLen)))
-    pos = remainderLen
-  }
-  while (pos < len) {
-    segments.push(Number(numStr.slice(pos, pos + segmentSize)))
-    pos += segmentSize
-  }
-
-  const parts = []
-  let scaleIndex = segments.length - 1
-
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i]
-
-    if (segment !== 0) {
-      const scaleWord = SCALE_WORDS[scaleIndex] || ''
-
-      if (scaleIndex === 0) {
-        parts.push(buildSegment(segment))
-      } else if (scaleIndex === 1 && segment === 1) {
-        // Omit "bir" before thousand
-        parts.push(scaleWord)
-      } else {
-        parts.push(buildSegment(segment) + ' ' + scaleWord)
-      }
-    }
-
-    scaleIndex--
-  }
-
-  return parts.join(' ')
-}
-
-function decimalPartToWords (decimalPart) {
-  let result = ''
-  let i = 0
-
-  while (i < decimalPart.length && decimalPart[i] === '0') {
-    if (result) result += ' '
-    result += ZERO
-    i++
-  }
-
-  const remainder = decimalPart.slice(i)
-  if (remainder) {
-    if (result) result += ' '
-    result += integerToWords(BigInt(remainder))
-  }
-
-  return result
-}
-
-/**
- * Converts a numeric value to Azerbaijani words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Azerbaijani words
- */
-function toWords (value) {
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
-
-  let result = ''
-
-  if (isNegative) {
-    result = NEGATIVE + ' '
-  }
-
-  result += integerToWords(integerPart)
-
-  if (decimalPart) {
-    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)
-  }
-
-  return result
-}
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export { toWords }

package/lib/languages/bn.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Bengali words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Bengali words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/cs.d.ts

@@ -1,18 +0,0 @@
-/**
- * Converts a numeric value to Czech 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
- * @returns {string} The number in Czech words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(21)           // 'dvacet jedna'
- * toWords(1000)         // 'tisíc'
- * toWords(2000)         // 'dva tisíce'
- * toWords(5000)         // 'pět tisíc'
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/da.d.ts

@@ -1,14 +0,0 @@
-/**
- * Converts a numeric value to Danish words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Danish words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(21)       // 'enogtyve'
- * toWords(1000)     // 'ettusind'
- * toWords(1000000)  // 'en millioner'
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/de.d.ts

@@ -1,17 +0,0 @@
-/**
- * Converts a numeric value to German 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
- * @returns {string} The number in German words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(21)           // 'einundzwanzig'
- * toWords(1000)         // 'eintausend'
- * toWords(1000000)      // 'eine Million'
- */
-export function toWords(value: number | string | bigint): string;