n2words 3.0.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,164 +0,0 @@
-/**
- * Amharic Latin language converter - Functional Implementation
- *
- * Self-contained converter with precomputed lookup tables.
- * 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(' ')
-}
-
-const SEGMENTS = new Array(1000)
-for (let i = 0; i < 1000; i++) {
-  SEGMENTS[i] = buildSegment(i)
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return SEGMENTS[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(SEGMENTS[segment])
-      } else {
-        parts.push(SEGMENTS[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,164 +0,0 @@
-/**
- * Amharic language converter - Functional Implementation
- *
- * Self-contained converter with precomputed lookup tables.
- * 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(' ')
-}
-
-const SEGMENTS = new Array(1000)
-for (let i = 0; i < 1000; i++) {
-  SEGMENTS[i] = buildSegment(i)
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return SEGMENTS[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(SEGMENTS[segment])
-      } else {
-        parts.push(SEGMENTS[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,176 +0,0 @@
-/**
- * Azerbaijani language converter - Functional Implementation
- *
- * Self-contained converter with precomputed lookup tables.
- *
- * 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(' ')
-}
-
-const SEGMENTS = new Array(1000)
-for (let i = 0; i < 1000; i++) {
-  SEGMENTS[i] = buildSegment(i)
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return SEGMENTS[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(SEGMENTS[segment])
-      } else if (scaleIndex === 1 && segment === 1) {
-        // Omit "bir" before thousand
-        parts.push(scaleWord)
-      } else {
-        parts.push(SEGMENTS[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/bn.js

@@ -1,145 +0,0 @@
-/**
- * Bangla language converter - Functional Implementation
- *
- * Self-contained converter for South Asian numbering.
- *
- * Key features:
- * - Indian numbering system (হাজার, লাখ, কোটি)
- * - Bangla script (Bengali)
- * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
- * - Complete word forms for 0-99
- */
-
-import { parseNumericValue } from '../utils/parse-numeric.js'
-
-// ============================================================================
-// Vocabulary
-// ============================================================================
-
-const ZERO = 'শূন্য'
-const NEGATIVE = 'মাইনাস'
-const DECIMAL_SEP = 'দশমিক'
-const HUNDRED = 'শত'
-
-const BELOW_HUNDRED = [
-  'শূন্য', 'এক', 'দুই', 'তিন', 'চার', 'পাঁচ', 'ছয়', 'সাত', 'আট', 'নয়',
-  'দশ', 'এগারো', 'বারো', 'তেরো', 'চৌদ্দ', 'পনেরো', 'ষোল', 'সতেরো', 'আঠারো', 'উনিশ',
-  'বিশ', 'একুশ', 'বাইশ', 'তেইশ', 'চব্বিশ', 'পঁচিশ', 'ছাব্বিশ', 'সাতাশ', 'আঠাশ', 'উনত্রিশ',
-  'ত্রিশ', 'একত্রিশ', 'বত্রিশ', 'তেত্রিশ', 'চৌত্রিশ', 'পঁয়ত্রিশ', 'ছত্রিশ', 'সাঁইত্রিশ', 'আটত্রিশ', 'উনচল্লিশ',
-  'চল্লিশ', 'একচল্লিশ', 'বেয়াল্লিশ', 'তেতাল্লিশ', 'চুয়াল্লিশ', 'পঁয়তাল্লিশ', 'ছেচল্লিশ', 'সাতচল্লিশ', 'আটচল্লিশ', 'উনপঞ্চাশ',
-  'পঞ্চাশ', 'একান্ন', 'বাহান্ন', 'তিপ্পান্ন', 'চুয়ান্ন', 'পঞ্চান্ন', 'ছাপ্পান্ন', 'সাতান্ন', 'আটান্ন', 'উনষাট',
-  'ষাট', 'একষট্টি', 'বাষট্টি', 'তেষট্টি', 'চৌষট্টি', 'পঁয়ষট্টি', 'ছেষট্টি', 'সাতষট্টি', 'আটষট্টি', 'ঊনসত্তর',
-  'সত্তর', 'একাত্তর', 'বাহাত্তর', 'তেহাত্তর', 'চুয়াত্তর', 'পঁচাত্তর', 'ছিয়াত্তর', 'সাতাত্তর', 'আটাত্তর', 'উনআশি',
-  'আশি', 'একাশি', 'বিরাশি', 'তিরাশি', 'চুরাশি', 'পঁচাশি', 'ছিয়াশি', 'সাতাশি', 'আটাশি', 'উননব্বই',
-  'নব্বই', 'একানব্বই', 'বিরানব্বই', 'তিরানব্বই', 'চুরানব্বই', 'পঁচানব্বই', 'ছিয়ানব্বই', 'সাতানব্বই', 'আটানব্বই', 'নিরানব্বই'
-]
-
-// Scale words: index 0 = units (empty), 1 = thousand, 2 = lakh, 3 = crore, etc.
-const SCALE_WORDS = ['', 'হাজার', 'লাখ', 'কোটি', 'আরব', 'খরব', 'নীল', 'পদ্ম', 'শঙ্খ']
-
-// ============================================================================
-// Segment Splitting (inlined for performance)
-// ============================================================================
-
-function groupByThreeThenTwos (n) {
-  const numStr = n.toString()
-  if (numStr.length <= 3) return [Number(numStr)]
-
-  const segments = []
-  segments.unshift(Number(numStr.slice(-3)))
-
-  let remaining = numStr.slice(0, -3)
-  while (remaining.length > 0) {
-    segments.unshift(Number(remaining.slice(-2)))
-    remaining = remaining.slice(0, -2)
-  }
-
-  return segments
-}
-
-function segmentToWords (n) {
-  if (n === 0) return ''
-  if (n < 100) return BELOW_HUNDRED[n]
-
-  const hundreds = Math.trunc(n / 100)
-  const remainder = n % 100
-
-  if (remainder === 0) {
-    return BELOW_HUNDRED[hundreds] + ' ' + HUNDRED
-  }
-  return BELOW_HUNDRED[hundreds] + ' ' + HUNDRED + ' ' + BELOW_HUNDRED[remainder]
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  const segments = groupByThreeThenTwos(n)
-  const segmentCount = segments.length
-  const words = []
-
-  for (let i = 0; i < segmentCount; i++) {
-    const segmentValue = segments[i]
-    if (segmentValue === 0) continue
-
-    const scaleIndex = segmentCount - i - 1
-    words.push(segmentToWords(segmentValue))
-    if (scaleIndex > 0 && SCALE_WORDS[scaleIndex]) {
-      words.push(SCALE_WORDS[scaleIndex])
-    }
-  }
-
-  return words.join(' ').trim()
-}
-
-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 Bengali words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Bengali 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 }