n2words 2.0.0 → 3.1.0

package/lib/languages/ta.d.ts

@@ -1,20 +1,7 @@
 /**
- * Tamil language converter.
+ * Converts a numeric value to Tamil words.
  *
- * Supports:
- * - Tamil numbering system
- * - Tamil script
- * - Complete word forms for 0-99
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Tamil words
  */
-export class Tamil extends AbstractLanguage {
-    belowHundredWords: string[];
-    hundredsWords: string[];
-    onesWords: string[];
-    scaleWords: string[];
-    /** Convert numbers below 100 to Tamil words. */
-    convertBelowHundred(number: any): string;
-    convertBelowThousand(number: any): string;
-    splitIndian(number: any): number[];
-    integerToWords(integerPart: any): string;
-}
-import { AbstractLanguage } from '../classes/abstract-language.js';
+export function toWords(value: number | string | bigint): string;

package/lib/languages/ta.js

@@ -1,226 +1,167 @@
-import { AbstractLanguage } from '../classes/abstract-language.js'
-
 /**
- * Tamil language converter.
+ * Tamil language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
  *
- * Supports:
- * - Tamil numbering system
+ * Key features:
+ * - Indian numbering system (ஆயிரம், லட்சம், கோடி)
  * - Tamil script
+ * - 3-2-2 grouping pattern
  * - Complete word forms for 0-99
+ * - Special hundred word transformations (connected vs standalone)
+ * - Per-digit decimal reading
+ * - BigInt modulo for efficient segment extraction
  */
-export class Tamil extends AbstractLanguage {
-  negativeWord = 'மைனஸ்'
-  decimalSeparatorWord = 'புள்ளி'
-  zeroWord = 'பூஜ்ஜியம்'
-  usePerDigitDecimals = true // Enable digit-by-digit decimal conversion
-
-  belowHundredWords = [
-    'பூஜ்ஜியம்',
-    'ஒன்று',
-    'இரண்டு',
-    'மூன்று',
-    'நான்கு',
-    'ஐந்து',
-    'ஆறு',
-    'ஏழு',
-    'எட்டு',
-    'ஒன்பது',
-    'பத்து',
-    'பதினொன்று',
-    'பன்னிரண்டு',
-    'பதிமூன்று',
-    'பதினான்கு',
-    'பதினைந்து',
-    'பதினாறு',
-    'பதினேழு',
-    'பதினெட்டு',
-    'பத்தொன்பது',
-    'இருபது',
-    'இருபத்தொன்று',
-    'இருபத்திரண்டு',
-    'இருபத்திமூன்று',
-    'இருபத்திநான்கு',
-    'இருபத்தைந்து',
-    'இருபத்தாறு',
-    'இருபத்தேழு',
-    'இருபத்தெட்டு',
-    'இருபத்தொன்பது',
-    'முப்பது',
-    'முப்பத்தொன்று',
-    'முப்பத்திரண்டு',
-    'முப்பத்திமூன்று',
-    'முப்பத்திநான்கு',
-    'முப்பத்தைந்து',
-    'முப்பத்தாறு',
-    'முப்பத்தேழு',
-    'முப்பத்தெட்டு',
-    'முப்பத்தொன்பது',
-    'நாற்பது',
-    'நாற்பத்தொன்று',
-    'நாற்பத்திரண்டு',
-    'நாற்பத்திமூன்று',
-    'நாற்பத்திநான்கு',
-    'நாற்பத்தைந்து',
-    'நாற்பத்தாறு',
-    'நாற்பத்தேழு',
-    'நாற்பத்தெட்டு',
-    'நாற்பத்தொன்பது',
-    'ஐம்பது',
-    'ஐம்பத்தொன்று',
-    'ஐம்பத்திரண்டு',
-    'ஐம்பத்திமூன்று',
-    'ஐம்பத்திநான்கு',
-    'ஐம்பத்தைந்து',
-    'ஐம்பத்தாறு',
-    'ஐம்பத்தேழு',
-    'ஐம்பத்தெட்டு',
-    'ஐம்பத்தொன்பது',
-    'அறுபது',
-    'அறுபத்தொன்று',
-    'அறுபத்திரண்டு',
-    'அறுபத்திமூன்று',
-    'அறுபத்திநான்கு',
-    'அறுபத்தைந்து',
-    'அறுபத்தாறு',
-    'அறுபத்தேழு',
-    'அறுபத்தெட்டு',
-    'அறுபத்தொன்பது',
-    'எழுபது',
-    'எழுபத்தொன்று',
-    'எழுபத்திரண்டு',
-    'எழுபத்திமூன்று',
-    'எழுபத்திநான்கு',
-    'எழுபத்தைந்து',
-    'எழுபத்தாறு',
-    'எழுபத்தேழு',
-    'எழுபத்தெட்டு',
-    'எழுபத்தொன்பது',
-    'எண்பது',
-    'எண்பத்தொன்று',
-    'எண்பத்திரண்டு',
-    'எண்பத்திமூன்று',
-    'எண்பத்திநான்கு',
-    'எண்பத்தைந்து',
-    'எண்பத்தாறு',
-    'எண்பத்தேழு',
-    'எண்பத்தெட்டு',
-    'எண்பத்தொன்பது',
-    'தொண்ணூறு',
-    'தொண்ணூற்று ஒன்று',
-    'தொண்ணூற்று இரண்டு',
-    'தொண்ணூற்று மூன்று',
-    'தொண்ணூற்று நான்கு',
-    'தொண்ணூற்று ஐந்து',
-    'தொண்ணூற்று ஆறு',
-    'தொண்ணூற்று ஏழு',
-    'தொண்ணூற்று எட்டு',
-    'தொண்ணூற்று ஒன்பது'
-  ]
-
-  hundredsWords = [
-    '',
-    'நூறு',
-    'இருநூறு',
-    'முன்னூறு',
-    'நானூறு',
-    'ஐநூறு',
-    'அறுநூறு',
-    'எழுநூறு',
-    'எண்நூறு',
-    'தொள்ளாயிரம்'
-  ]
-
-  // Ones words map 1–9 for decimal reading
-  onesWords = [
-    'ஒன்று',
-    'இரண்டு',
-    'மூன்று',
-    'நான்கு',
-    'ஐந்து',
-    'ஆறு',
-    'ஏழு',
-    'எட்டு',
-    'ஒன்பது'
-  ]
-
-  scaleWords = [
-    '',
-    'ஆயிரம்',
-    'லட்சம்',
-    'கோடி',
-    'அரபு',
-    'கராபு',
-    'நீல்',
-    'பத்ம',
-    'சங்கு'
-  ]
-
-  /** Convert numbers below 100 to Tamil words. */
-  convertBelowHundred (number) {
-    return this.belowHundredWords[number]
-  }
 
-  convertBelowThousand (number) {
-    if (number === 0) return ''
-    if (number < 100) return this.convertBelowHundred(number)
+import { parseNumericValue } from '../utils/parse-numeric.js'
 
-    const hundreds = Math.trunc(number / 100)
-    const remainder = number % 100
-    let hundredPart = this.hundredsWords[hundreds]
+// ============================================================================
+// Vocabulary
+// ============================================================================
 
-    if (remainder > 0) {
-      if (hundredPart.endsWith('ம்')) {
-        hundredPart = hundredPart.replace(/ம்$/, 'த்து')
-      } else if (hundredPart.endsWith('று')) {
-        hundredPart = hundredPart.slice(0, -2) + 'ற்று'
-      }
-    }
+const ZERO = 'பூஜ்ஜியம்'
+const NEGATIVE = 'மைனஸ்'
+const DECIMAL_SEP = 'புள்ளி'
 
-    const parts = [hundredPart]
-    if (remainder > 0) {
-      parts.push(this.convertBelowHundred(remainder))
-    }
+const BELOW_HUNDRED = [
+  'பூஜ்ஜியம்', 'ஒன்று', 'இரண்டு', 'மூன்று', 'நான்கு', 'ஐந்து', 'ஆறு', 'ஏழு', 'எட்டு', 'ஒன்பது',
+  'பத்து', 'பதினொன்று', 'பன்னிரண்டு', 'பதிமூன்று', 'பதினான்கு', 'பதினைந்து', 'பதினாறு', 'பதினேழு', 'பதினெட்டு', 'பத்தொன்பது',
+  'இருபது', 'இருபத்தொன்று', 'இருபத்திரண்டு', 'இருபத்திமூன்று', 'இருபத்திநான்கு', 'இருபத்தைந்து', 'இருபத்தாறு', 'இருபத்தேழு', 'இருபத்தெட்டு', 'இருபத்தொன்பது',
+  'முப்பது', 'முப்பத்தொன்று', 'முப்பத்திரண்டு', 'முப்பத்திமூன்று', 'முப்பத்திநான்கு', 'முப்பத்தைந்து', 'முப்பத்தாறு', 'முப்பத்தேழு', 'முப்பத்தெட்டு', 'முப்பத்தொன்பது',
+  'நாற்பது', 'நாற்பத்தொன்று', 'நாற்பத்திரண்டு', 'நாற்பத்திமூன்று', 'நாற்பத்திநான்கு', 'நாற்பத்தைந்து', 'நாற்பத்தாறு', 'நாற்பத்தேழு', 'நாற்பத்தெட்டு', 'நாற்பத்தொன்பது',
+  'ஐம்பது', 'ஐம்பத்தொன்று', 'ஐம்பத்திரண்டு', 'ஐம்பத்திமூன்று', 'ஐம்பத்திநான்கு', 'ஐம்பத்தைந்து', 'ஐம்பத்தாறு', 'ஐம்பத்தேழு', 'ஐம்பத்தெட்டு', 'ஐம்பத்தொன்பது',
+  'அறுபது', 'அறுபத்தொன்று', 'அறுபத்திரண்டு', 'அறுபத்திமூன்று', 'அறுபத்திநான்கு', 'அறுபத்தைந்து', 'அறுபத்தாறு', 'அறுபத்தேழு', 'அறுபத்தெட்டு', 'அறுபத்தொன்பது',
+  'எழுபது', 'எழுபத்தொன்று', 'எழுபத்திரண்டு', 'எழுபத்திமூன்று', 'எழுபத்திநான்கு', 'எழுபத்தைந்து', 'எழுபத்தாறு', 'எழுபத்தேழு', 'எழுபத்தெட்டு', 'எழுபத்தொன்பது',
+  'எண்பது', 'எண்பத்தொன்று', 'எண்பத்திரண்டு', 'எண்பத்திமூன்று', 'எண்பத்திநான்கு', 'எண்பத்தைந்து', 'எண்பத்தாறு', 'எண்பத்தேழு', 'எண்பத்தெட்டு', 'எண்பத்தொன்பது',
+  'தொண்ணூறு', 'தொண்ணூற்று ஒன்று', 'தொண்ணூற்று இரண்டு', 'தொண்ணூற்று மூன்று', 'தொண்ணூற்று நான்கு', 'தொண்ணூற்று ஐந்து', 'தொண்ணூற்று ஆறு', 'தொண்ணூற்று ஏழு', 'தொண்ணூற்று எட்டு', 'தொண்ணூற்று ஒன்பது'
+]
 
-    return parts.join(' ').trim()
-  }
+// Standalone hundreds (when not followed by remainder)
+const HUNDREDS = ['', 'நூறு', 'இருநூறு', 'முன்னூறு', 'நானூறு', 'ஐநூறு', 'அறுநூறு', 'எழுநூறு', 'எண்நூறு', 'தொள்ளாயிரம்']
 
-  splitIndian (number) {
-    const numStr = number.toString()
-    if (numStr.length <= 3) return [Number(numStr)]
+// Connected form of hundreds (when followed by remainder) - precomputed
+const HUNDREDS_CONNECTED = ['', 'நூற்று', 'இருநூற்று', 'முன்னூற்று', 'நானூற்று', 'ஐநூற்று', 'அறுநூற்று', 'எழுநூற்று', 'எண்நூற்று', 'தொள்ளாயிரத்து']
 
-    const groups = []
-    const last3 = numStr.slice(-3)
-    groups.unshift(Number(last3))
+// Ones for decimal reading
+const ONES = ['ஒன்று', 'இரண்டு', 'மூன்று', 'நான்கு', 'ஐந்து', 'ஆறு', 'ஏழு', 'எட்டு', 'ஒன்பது']
 
-    let remaining = numStr.slice(0, -3)
-    while (remaining.length > 0) {
-      const group = remaining.slice(-2)
-      groups.unshift(Number(group))
-      remaining = remaining.slice(0, -2)
-    }
+// Scale words: index 0 = units, 1 = thousand, 2 = lakh, etc.
+const SCALE_WORDS = ['', 'ஆயிரம்', 'லட்சம்', 'கோடி', 'அரபு', 'கராபு', 'நீல்', 'பத்ம', 'சங்கு']
+
+// ============================================================================
+// Segment Building
+// ============================================================================
 
-    return groups
+/**
+ * Builds words for a 0-999 segment.
+ *
+ * @param {number} n - Number 0-999
+ * @returns {string} Tamil words for the segment
+ */
+function buildSegment (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 HUNDREDS[hundreds]
   }
 
-  integerToWords (integerPart) {
-    if (integerPart === 0n) return this.zeroWord
+  // Use connected form when followed by remainder
+  return HUNDREDS_CONNECTED[hundreds] + ' ' + BELOW_HUNDRED[remainder]
+}
+
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Tamil words.
+ *
+ * Uses BigInt modulo for segment extraction (faster than string slicing).
+ * South Asian 3-2-2 grouping: first 3 digits, then groups of 2.
+ *
+ * @param {bigint} n - Non-negative integer to convert
+ * @returns {string} Tamil words
+ */
+function integerToWords (n) {
+  if (n === 0n) return ZERO
+
+  // Fast path: numbers < 1000
+  if (n < 1000n) {
+    return buildSegment(Number(n))
+  }
 
-    const groups = this.splitIndian(integerPart)
-    const groupCount = groups.length
-    const words = []
+  // Extract segments using BigInt modulo
+  const segments = []
+  segments.push(Number(n % 1000n))
+  let temp = n / 1000n
 
-    for (let i = 0; i < groupCount; i++) {
-      const groupValue = groups[i]
-      if (groupValue === 0) continue
+  while (temp > 0n) {
+    segments.push(Number(temp % 100n))
+    temp = temp / 100n
+  }
 
-      const scaleIndex = groupCount - i - 1
-      const groupWords = (groupValue === 1 && scaleIndex > 0) ? 'ஒரு' : this.convertBelowThousand(groupValue)
+  // Build result string (process from most-significant to least)
+  const words = []
+  for (let i = segments.length - 1; i >= 0; i--) {
+    const segment = segments[i]
+    if (segment === 0) continue
+
+    if (i === 0) {
+      words.push(buildSegment(segment))
+    } else {
+      // Use 'ஒரு' for 1 at scale positions
+      const groupWords = (segment === 1) ? 'ஒரு' : BELOW_HUNDRED[segment]
       words.push(groupWords)
-      if (scaleIndex > 0 && this.scaleWords[scaleIndex]) {
-        words.push(this.scaleWords[scaleIndex])
-      }
     }
 
-    return words.join(' ').trim()
+    if (i > 0 && SCALE_WORDS[i]) {
+      words.push(SCALE_WORDS[i])
+    }
   }
+
+  return words.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 - 1])
+  }
+  return digits.join(' ')
+}
+
+/**
+ * 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)
+
+  let result = ''
+
+  if (isNegative) {
+    result = NEGATIVE + ' '
+  }
+
+  result += integerToWords(integerPart)
+
+  if (decimalPart) {
+    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart)
+  }
+
+  return result
+}
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+export { toWords }

package/lib/languages/te.d.ts

@@ -1,22 +1,7 @@
 /**
- * Telugu language converter.
+ * Converts a numeric value to Telugu words.
  *
- * Supports:
- * - Telugu numbering system
- * - Telugu script
- * - Complete word forms for 0-99
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Telugu words
  */
-export class Telugu extends AbstractLanguage {
-    belowHundredWords: string[];
-    hundredsWords: string[];
-    onesWords: string[];
-    scaleWords: string[];
-    /** Convert numbers below 100 to Telugu words. */
-    convertBelowHundred(number: any): string;
-    /** Convert numbers below 1000 to Telugu words. */
-    convertBelowThousand(number: any): string;
-    /** Split a number using Indian-style grouping (3-2-2 digits from right). */
-    splitIndian(number: any): number[];
-    integerToWords(integerPart: any): string;
-}
-import { AbstractLanguage } from '../classes/abstract-language.js';
+export function toWords(value: number | string | bigint): string;