n2words 1.24.0 → 3.0.0

package/lib/languages/ta.js

@@ -1,226 +1,154 @@
-import AbstractLanguage from '../classes/abstract-language.js'
-
-class Tamil extends AbstractLanguage {
-  negativeWord = 'மைனஸ்'
-  decimalSeparatorWord = 'புள்ளி'
-  zeroWord = 'பூஜ்ஜியம்'
-  convertDecimalsPerDigit = true // Enable digit-by-digit decimal conversion
-  belowHundred = [
-    'பூஜ்ஜியம்',
-    'ஒன்று',
-    'இரண்டு',
-    'மூன்று',
-    'நான்கு',
-    'ஐந்து',
-    'ஆறு',
-    'ஏழு',
-    'எட்டு',
-    'ஒன்பது',
-    'பத்து',
-    'பதினொன்று',
-    'பன்னிரண்டு',
-    'பதிமூன்று',
-    'பதினான்கு',
-    'பதினைந்து',
-    'பதினாறு',
-    'பதினேழு',
-    'பதினெட்டு',
-    'பத்தொன்பது',
-    'இருபது',
-    'இருபத்தொன்று',
-    'இருபத்திரண்டு',
-    'இருபத்திமூன்று',
-    'இருபத்திநான்கு',
-    'இருபத்தைந்து',
-    'இருபத்தாறு',
-    'இருபத்தேழு',
-    'இருபத்தெட்டு',
-    'இருபத்தொன்பது',
-    'முப்பது',
-    'முப்பத்தொன்று',
-    'முப்பத்திரண்டு',
-    'முப்பத்திமூன்று',
-    'முப்பத்திநான்கு',
-    'முப்பத்தைந்து',
-    'முப்பத்தாறு',
-    'முப்பத்தேழு',
-    'முப்பத்தெட்டு',
-    'முப்பத்தொன்பது',
-    'நாற்பது',
-    'நாற்பத்தொன்று',
-    'நாற்பத்திரண்டு',
-    'நாற்பத்திமூன்று',
-    'நாற்பத்திநான்கு',
-    'நாற்பத்தைந்து',
-    'நாற்பத்தாறு',
-    'நாற்பத்தேழு',
-    'நாற்பத்தெட்டு',
-    'நாற்பத்தொன்பது',
-    'ஐம்பது',
-    'ஐம்பத்தொன்று',
-    'ஐம்பத்திரண்டு',
-    'ஐம்பத்திமூன்று',
-    'ஐம்பத்திநான்கு',
-    'ஐம்பத்தைந்து',
-    'ஐம்பத்தாறு',
-    'ஐம்பத்தேழு',
-    'ஐம்பத்தெட்டு',
-    'ஐம்பத்தொன்பது',
-    'அறுபது',
-    'அறுபத்தொன்று',
-    'அறுபத்திரண்டு',
-    'அறுபத்திமூன்று',
-    'அறுபத்திநான்கு',
-    'அறுபத்தைந்து',
-    'அறுபத்தாறு',
-    'அறுபத்தேழு',
-    'அறுபத்தெட்டு',
-    'அறுபத்தொன்பது',
-    'எழுபது',
-    'எழுபத்தொன்று',
-    'எழுபத்திரண்டு',
-    'எழுபத்திமூன்று',
-    'எழுபத்திநான்கு',
-    'எழுபத்தைந்து',
-    'எழுபத்தாறு',
-    'எழுபத்தேழு',
-    'எழுபத்தெட்டு',
-    'எழுபத்தொன்பது',
-    'எண்பது',
-    'எண்பத்தொன்று',
-    'எண்பத்திரண்டு',
-    'எண்பத்திமூன்று',
-    'எண்பத்திநான்கு',
-    'எண்பத்தைந்து',
-    'எண்பத்தாறு',
-    'எண்பத்தேழு',
-    'எண்பத்தெட்டு',
-    'எண்பத்தொன்பது',
-    'தொண்ணூறு',
-    'தொண்ணூற்று ஒன்று',
-    'தொண்ணூற்று இரண்டு',
-    'தொண்ணூற்று மூன்று',
-    'தொண்ணூற்று நான்கு',
-    'தொண்ணூற்று ஐந்து',
-    'தொண்ணூற்று ஆறு',
-    'தொண்ணூற்று ஏழு',
-    'தொண்ணூற்று எட்டு',
-    'தொண்ணூற்று ஒன்பது'
-  ]
-
-  hundreds = [
-    '',
-    'நூறு',
-    'இருநூறு',
-    'முன்னூறு',
-    'நானூறு',
-    'ஐநூறு',
-    'அறுநூறு',
-    'எழுநூறு',
-    'எண்நூறு',
-    'தொள்ளாயிரம்'
-  ]
-
-  // Digits map 1–9 for decimal reading
-  digits = [
-    'ஒன்று',
-    'இரண்டு',
-    'மூன்று',
-    'நான்கு',
-    'ஐந்து',
-    'ஆறு',
-    'ஏழு',
-    'எட்டு',
-    'ஒன்பது'
-  ]
-
-  scales = [
-    '',
-    'ஆயிரம்',
-    'லட்சம்',
-    'கோடி',
-    'அரபு',
-    'கராபு',
-    'நீல்',
-    'பத்ம',
-    'சங்கு'
-  ]
-
-  /**
-   * Convert numbers below 100 to Tamil words.
-   *
-   * @param {number} number The number to convert (0-99).
-   * @returns {string} The Tamil representation.
-   */
-  convertBelowHundred (number) {
-    return this.belowHundred[number]
+/**
+ * Tamil language converter - Functional Implementation
+ *
+ * Self-contained converter for South Asian numbering.
+ *
+ * Key features:
+ * - Indian numbering system (ஆயிரம், லட்சம், கோடி)
+ * - Tamil script
+ * - 3-2-2 grouping pattern
+ * - Complete word forms for 0-99
+ * - Special hundred word transformations
+ * - Per-digit decimal reading
+ */
+
+import { parseNumericValue } from '../utils/parse-numeric.js'
+
+// ============================================================================
+// Vocabulary
+// ============================================================================
+
+const ZERO = 'பூஜ்ஜியம்'
+const NEGATIVE = 'மைனஸ்'
+const DECIMAL_SEP = 'புள்ளி'
+
+const BELOW_HUNDRED = [
+  'பூஜ்ஜியம்', 'ஒன்று', 'இரண்டு', 'மூன்று', 'நான்கு', 'ஐந்து', 'ஆறு', 'ஏழு', 'எட்டு', 'ஒன்பது',
+  'பத்து', 'பதினொன்று', 'பன்னிரண்டு', 'பதிமூன்று', 'பதினான்கு', 'பதினைந்து', 'பதினாறு', 'பதினேழு', 'பதினெட்டு', 'பத்தொன்பது',
+  'இருபது', 'இருபத்தொன்று', 'இருபத்திரண்டு', 'இருபத்திமூன்று', 'இருபத்திநான்கு', 'இருபத்தைந்து', 'இருபத்தாறு', 'இருபத்தேழு', 'இருபத்தெட்டு', 'இருபத்தொன்பது',
+  'முப்பது', 'முப்பத்தொன்று', 'முப்பத்திரண்டு', 'முப்பத்திமூன்று', 'முப்பத்திநான்கு', 'முப்பத்தைந்து', 'முப்பத்தாறு', 'முப்பத்தேழு', 'முப்பத்தெட்டு', 'முப்பத்தொன்பது',
+  'நாற்பது', 'நாற்பத்தொன்று', 'நாற்பத்திரண்டு', 'நாற்பத்திமூன்று', 'நாற்பத்திநான்கு', 'நாற்பத்தைந்து', 'நாற்பத்தாறு', 'நாற்பத்தேழு', 'நாற்பத்தெட்டு', 'நாற்பத்தொன்பது',
+  'ஐம்பது', 'ஐம்பத்தொன்று', 'ஐம்பத்திரண்டு', 'ஐம்பத்திமூன்று', 'ஐம்பத்திநான்கு', 'ஐம்பத்தைந்து', 'ஐம்பத்தாறு', 'ஐம்பத்தேழு', 'ஐம்பத்தெட்டு', 'ஐம்பத்தொன்பது',
+  'அறுபது', 'அறுபத்தொன்று', 'அறுபத்திரண்டு', 'அறுபத்திமூன்று', 'அறுபத்திநான்கு', 'அறுபத்தைந்து', 'அறுபத்தாறு', 'அறுபத்தேழு', 'அறுபத்தெட்டு', 'அறுபத்தொன்பது',
+  'எழுபது', 'எழுபத்தொன்று', 'எழுபத்திரண்டு', 'எழுபத்திமூன்று', 'எழுபத்திநான்கு', 'எழுபத்தைந்து', 'எழுபத்தாறு', 'எழுபத்தேழு', 'எழுபத்தெட்டு', 'எழுபத்தொன்பது',
+  'எண்பது', 'எண்பத்தொன்று', 'எண்பத்திரண்டு', 'எண்பத்திமூன்று', 'எண்பத்திநான்கு', 'எண்பத்தைந்து', 'எண்பத்தாறு', 'எண்பத்தேழு', 'எண்பத்தெட்டு', 'எண்பத்தொன்பது',
+  'தொண்ணூறு', 'தொண்ணூற்று ஒன்று', 'தொண்ணூற்று இரண்டு', 'தொண்ணூற்று மூன்று', 'தொண்ணூற்று நான்கு', 'தொண்ணூற்று ஐந்து', 'தொண்ணூற்று ஆறு', 'தொண்ணூற்று ஏழு', 'தொண்ணூற்று எட்டு', 'தொண்ணூற்று ஒன்பது'
+]
+
+// Standalone hundreds (when not followed by remainder)
+const HUNDREDS = ['', 'நூறு', 'இருநூறு', 'முன்னூறு', 'நானூறு', 'ஐநூறு', 'அறுநூறு', 'எழுநூறு', 'எண்நூறு', 'தொள்ளாயிரம்']
+
+// Connected form of hundreds (when followed by remainder) - precomputed
+const HUNDREDS_CONNECTED = ['', 'நூற்று', 'இருநூற்று', 'முன்னூற்று', 'நானூற்று', 'ஐநூற்று', 'அறுநூற்று', 'எழுநூற்று', 'எண்நூற்று', 'தொள்ளாயிரத்து']
+
+// Ones for decimal reading
+const ONES = ['ஒன்று', 'இரண்டு', 'மூன்று', 'நான்கு', 'ஐந்து', 'ஆறு', 'ஏழு', 'எட்டு', 'ஒன்பது']
+
+// Scale words: index 0 = units, 1 = thousand, 2 = lakh, etc.
+const SCALE_WORDS = ['', 'ஆயிரம்', 'லட்சம்', 'கோடி', 'அரபு', 'கராபு', 'நீல்', 'பத்ம', 'சங்கு']
+
+// ============================================================================
+// Segment Splitting (inlined for performance)
+// ============================================================================
+
+function groupByThreeThenTwos (n) {
+  const numStr = n.toString()
+
+  if (numStr.length <= 3) {
+    return [Number(numStr)]
   }
 
-  convertBelowThousand (number) {
-    if (number === 0) return ''
-    if (number < 100) return this.convertBelowHundred(number)
+  const segments = []
+  const last3 = numStr.slice(-3)
+  segments.unshift(Number(last3))
 
-    const hundreds = Math.trunc(number / 100)
-    const remainder = number % 100
-    let hundredPart = this.hundreds[hundreds]
+  let remaining = numStr.slice(0, -3)
+  while (remaining.length > 0) {
+    const segment = remaining.slice(-2)
+    segments.unshift(Number(segment))
+    remaining = remaining.slice(0, -2)
+  }
 
-    if (remainder > 0) {
-      if (hundredPart.endsWith('ம்')) {
-        hundredPart = hundredPart.replace(/ம்$/, 'த்து')
-      } else if (hundredPart.endsWith('று')) {
-        hundredPart = hundredPart.slice(0, -2) + 'ற்று'
-      }
-    }
+  return segments
+}
 
-    const parts = [hundredPart]
-    if (remainder > 0) {
-      parts.push(this.convertBelowHundred(remainder))
-    }
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+function convertBelowThousand (n) {
+  if (n === 0) return ''
+  if (n < 100) return BELOW_HUNDRED[n]
 
-    return parts.join(' ').trim()
+  const hundreds = Math.trunc(n / 100)
+  const remainder = n % 100
+
+  if (remainder === 0) {
+    return HUNDREDS[hundreds]
   }
 
-  splitIndian (number) {
-    const numStr = number.toString()
-    if (numStr.length <= 3) return [Number(numStr)]
+  // Use precomputed connected form
+  return HUNDREDS_CONNECTED[hundreds] + ' ' + BELOW_HUNDRED[remainder]
+}
+
+function integerToWords (n) {
+  if (n === 0n) return ZERO
+
+  const groups = groupByThreeThenTwos(n)
+  const groupCount = groups.length
+  const words = []
 
-    const groups = []
-    const last3 = numStr.slice(-3)
-    groups.unshift(Number(last3))
+  for (let i = 0; i < groupCount; i++) {
+    const groupValue = groups[i]
+    if (groupValue === 0) continue
 
-    let remaining = numStr.slice(0, -3)
-    while (remaining.length > 0) {
-      const group = remaining.slice(-2)
-      groups.unshift(Number(group))
-      remaining = remaining.slice(0, -2)
+    const scaleIndex = groupCount - i - 1
+    const groupWords = (groupValue === 1 && scaleIndex > 0) ? 'ஒரு' : convertBelowThousand(groupValue)
+    words.push(groupWords)
+    if (scaleIndex > 0 && SCALE_WORDS[scaleIndex]) {
+      words.push(SCALE_WORDS[scaleIndex])
     }
+  }
+
+  return words.join(' ').trim()
+}
 
-    return groups
+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 - 1])
   }
+  return digits.join(' ')
+}
 
-  convertWholePart (number) {
-    if (number === 0n) return this.zeroWord
+/**
+ * Converts a numeric value to Tamil words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Tamil words
+ */
+function toWords (value) {
+  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
 
-    const groups = this.splitIndian(number)
-    const groupCount = groups.length
-    const words = []
+  let result = ''
 
-    for (let i = 0; i < groupCount; i++) {
-      const groupValue = groups[i]
-      if (groupValue === 0) continue
+  if (isNegative) {
+    result = NEGATIVE + ' '
+  }
 
-      const scaleIndex = groupCount - i - 1
-      const groupWords = (groupValue === 1 && scaleIndex > 0) ? 'ஒரு' : this.convertBelowThousand(groupValue)
-      words.push(groupWords)
-      if (scaleIndex > 0 && this.scales[scaleIndex]) {
-        words.push(this.scales[scaleIndex])
-      }
-    }
+  result += integerToWords(integerPart)
 
-    return words.join(' ').trim()
+  if (decimalPart) {
+    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)
   }
-}
 
-export default function convertToWords (value, options = {}) {
-  return new Tamil(options).convertToWords(value)
+  return result
 }
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+export { toWords }

package/lib/languages/te.d.ts

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