n2words 1.23.1 → 2.0.0

package/lib/languages/ta.js

@@ -0,0 +1,226 @@
+import { AbstractLanguage } from '../classes/abstract-language.js'
+
+/**
+ * Tamil language converter.
+ *
+ * Supports:
+ * - Tamil numbering system
+ * - Tamil script
+ * - Complete word forms for 0-99
+ */
+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)
+
+    const hundreds = Math.trunc(number / 100)
+    const remainder = number % 100
+    let hundredPart = this.hundredsWords[hundreds]
+
+    if (remainder > 0) {
+      if (hundredPart.endsWith('ம்')) {
+        hundredPart = hundredPart.replace(/ம்$/, 'த்து')
+      } else if (hundredPart.endsWith('று')) {
+        hundredPart = hundredPart.slice(0, -2) + 'ற்று'
+      }
+    }
+
+    const parts = [hundredPart]
+    if (remainder > 0) {
+      parts.push(this.convertBelowHundred(remainder))
+    }
+
+    return parts.join(' ').trim()
+  }
+
+  splitIndian (number) {
+    const numStr = number.toString()
+    if (numStr.length <= 3) return [Number(numStr)]
+
+    const groups = []
+    const last3 = numStr.slice(-3)
+    groups.unshift(Number(last3))
+
+    let remaining = numStr.slice(0, -3)
+    while (remaining.length > 0) {
+      const group = remaining.slice(-2)
+      groups.unshift(Number(group))
+      remaining = remaining.slice(0, -2)
+    }
+
+    return groups
+  }
+
+  integerToWords (integerPart) {
+    if (integerPart === 0n) return this.zeroWord
+
+    const groups = this.splitIndian(integerPart)
+    const groupCount = groups.length
+    const words = []
+
+    for (let i = 0; i < groupCount; i++) {
+      const groupValue = groups[i]
+      if (groupValue === 0) continue
+
+      const scaleIndex = groupCount - i - 1
+      const groupWords = (groupValue === 1 && scaleIndex > 0) ? 'ஒரு' : this.convertBelowThousand(groupValue)
+      words.push(groupWords)
+      if (scaleIndex > 0 && this.scaleWords[scaleIndex]) {
+        words.push(this.scaleWords[scaleIndex])
+      }
+    }
+
+    return words.join(' ').trim()
+  }
+}

package/lib/languages/te.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Telugu language converter.
+ *
+ * Supports:
+ * - Telugu numbering system
+ * - Telugu script
+ * - Complete word forms for 0-99
+ */
+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';

package/lib/languages/te.js

@@ -0,0 +1,219 @@
+import { AbstractLanguage } from '../classes/abstract-language.js'
+
+/**
+ * Telugu language converter.
+ *
+ * Supports:
+ * - Telugu numbering system
+ * - Telugu script
+ * - Complete word forms for 0-99
+ */
+export class Telugu 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 Telugu words. */
+  convertBelowHundred (number) {
+    return this.belowHundredWords[number]
+  }
+
+  /** Convert numbers below 1000 to Telugu words. */
+  convertBelowThousand (number) {
+    if (number === 0) return ''
+    if (number < 100) return this.convertBelowHundred(number)
+
+    const hundreds = Math.trunc(number / 100)
+    const remainder = number % 100
+    const parts = [this.hundredsWords[hundreds]]
+
+    if (remainder > 0) {
+      parts.push(this.convertBelowHundred(remainder))
+    }
+
+    return parts.join(' ').trim()
+  }
+
+  /** Split a number using Indian-style grouping (3-2-2 digits from right). */
+  splitIndian (number) {
+    const numStr = number.toString()
+    if (numStr.length <= 3) return [Number(numStr)]
+
+    const groups = []
+    const last3 = numStr.slice(-3)
+    groups.unshift(Number(last3))
+
+    let remaining = numStr.slice(0, -3)
+    while (remaining.length > 0) {
+      const group = remaining.slice(-2)
+      groups.unshift(Number(group))
+      remaining = remaining.slice(0, -2)
+    }
+
+    return groups
+  }
+
+  integerToWords (integerPart) {
+    if (integerPart === 0n) return this.zeroWord
+
+    const groups = this.splitIndian(integerPart)
+    const groupCount = groups.length
+    const words = []
+
+    for (let i = 0; i < groupCount; i++) {
+      const groupValue = groups[i]
+      if (groupValue === 0) continue
+
+      const scaleIndex = groupCount - i - 1
+      const groupWords = (groupValue === 1 && scaleIndex > 0) ? 'ఒక' : this.convertBelowThousand(groupValue)
+      words.push(groupWords)
+      if (scaleIndex > 0 && this.scaleWords[scaleIndex]) {
+        words.push(this.scaleWords[scaleIndex])
+      }
+    }
+
+    return words.join(' ').trim()
+  }
+}

package/lib/languages/th.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Thai language converter.
+ *
+ * Supports:
+ * - Thai numerals (ศูนย์, หนึ่ง, สอง, สาม)
+ * - No word separators (continuous Thai script)
+ * - Digit-by-digit decimal reading
+ */
+export class Thai extends AbstractLanguage {
+    onesWords: string[];
+    /** Converts numbers below one million to Thai words. */
+    convertBelowMillion(number: any): string;
+    /** Split a number into million-sized groups for processing. */
+    splitMillionGroups(number: any): number[];
+    integerToWords(integerPart: any): string;
+}
+import { AbstractLanguage } from '../classes/abstract-language.js';

package/lib/languages/th.js

@@ -0,0 +1,117 @@
+import { AbstractLanguage } from '../classes/abstract-language.js'
+
+/**
+ * Thai language converter.
+ *
+ * Supports:
+ * - Thai numerals (ศูนย์, หนึ่ง, สอง, สาม)
+ * - No word separators (continuous Thai script)
+ * - Digit-by-digit decimal reading
+ */
+export class Thai extends AbstractLanguage {
+  negativeWord = 'ลบ'
+  decimalSeparatorWord = 'จุด'
+  zeroWord = 'ศูนย์'
+  wordSeparator = ''
+  usePerDigitDecimals = true // Enable digit-by-digit decimal conversion
+
+  // Ones words map 1–9
+  onesWords = ['หนึ่ง', 'สอง', 'สาม', 'สี่', 'ห้า', 'หก', 'เจ็ด', 'แปด', 'เก้า']
+
+  /** Converts numbers below one million to Thai words. */
+  convertBelowMillion (number) {
+    if (number === 0) return ''
+
+    let value = number
+    const parts = []
+
+    const hundredThousands = Math.trunc(value / 100000)
+    value %= 100000
+    const tenThousands = Math.trunc(value / 10000)
+    value %= 10000
+    const thousands = Math.trunc(value / 1000)
+    value %= 1000
+    const hundreds = Math.trunc(value / 100)
+    value %= 100
+    const tens = Math.trunc(value / 10)
+    const ones = value % 10
+
+    if (hundredThousands > 0) {
+      parts.push(this.onesWords[hundredThousands - 1] + 'แสน')
+    }
+
+    if (tenThousands > 0) {
+      if (tenThousands === 1) {
+        parts.push('หนึ่งหมื่น')
+      } else {
+        parts.push(this.onesWords[tenThousands - 1] + 'หมื่น')
+      }
+    }
+
+    if (thousands > 0) {
+      parts.push(this.onesWords[thousands - 1] + 'พัน')
+    }
+
+    if (hundreds > 0) {
+      parts.push(this.onesWords[hundreds - 1] + 'ร้อย')
+    }
+
+    if (tens > 0) {
+      if (tens === 1) {
+        parts.push('สิบ')
+      } else if (tens === 2) {
+        parts.push('ยี่สิบ')
+      } else {
+        parts.push(this.onesWords[tens - 1] + 'สิบ')
+      }
+    }
+
+    if (ones > 0) {
+      const hasHigher = hundredThousands > 0 || tenThousands > 0 || thousands > 0 || hundreds > 0 || tens > 0
+      if (ones === 1 && (tens > 0 || hasHigher)) {
+        parts.push('เอ็ด')
+      } else {
+        parts.push(this.onesWords[ones - 1])
+      }
+    }
+
+    return parts.join('')
+  }
+
+  /** Split a number into million-sized groups for processing. */
+  splitMillionGroups (number) {
+    const groups = []
+    let remaining = number
+
+    const million = 1_000_000n
+    while (remaining > 0n) {
+      const chunk = Number(remaining % million)
+      groups.unshift(chunk)
+      remaining = remaining / million
+    }
+
+    return groups
+  }
+
+  integerToWords (integerPart) {
+    if (integerPart === 0n) {
+      return this.zeroWord
+    }
+
+    const groups = this.splitMillionGroups(integerPart)
+    const parts = []
+
+    for (let i = 0; i < groups.length; i++) {
+      const groupValue = groups[i]
+      if (groupValue === 0) continue
+
+      parts.push(this.convertBelowMillion(groupValue))
+      const remaining = groups.length - i - 1
+      if (remaining > 0) {
+        parts.push('ล้าน'.repeat(remaining))
+      }
+    }
+
+    return parts.join('')
+  }
+}

package/lib/languages/tr.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Turkish language converter.
+ *
+ * Supports:
+ * - Omits 'bir' (one) before hundreds and thousands
+ * - Optional space removal via dropSpaces option
+ */
+export class Turkish extends TurkicLanguage {
+    constructor(options?: {});
+    scaleWords: (string | bigint)[][];
+}
+import { TurkicLanguage } from '../classes/turkic-language.js';

package/lib/languages/tr.js

@@ -0,0 +1,56 @@
+import { TurkicLanguage } from '../classes/turkic-language.js'
+
+/**
+ * Turkish language converter.
+ *
+ * Supports:
+ * - Omits 'bir' (one) before hundreds and thousands
+ * - Optional space removal via dropSpaces option
+ */
+export class Turkish extends TurkicLanguage {
+  negativeWord = 'eksi'
+  decimalSeparatorWord = 'virgül'
+  zeroWord = 'sıfır'
+  wordSeparator = ' '
+
+  scaleWords = [
+    [1_000_000_000_000_000_000n, 'kentilyon'],
+    [1_000_000_000_000_000n, 'katrilyon'],
+    [1_000_000_000_000n, 'trilyon'],
+    [1_000_000_000n, 'milyar'],
+    [1_000_000n, 'milyon'],
+    [1000n, 'bin'],
+    [100n, 'yüz'],
+    [90n, 'doksan'],
+    [80n, 'seksen'],
+    [70n, 'yetmiş'],
+    [60n, 'altmış'],
+    [50n, 'elli'],
+    [40n, 'kırk'],
+    [30n, 'otuz'],
+    [20n, 'yirmi'],
+    [10n, 'on'],
+    [9n, 'dokuz'],
+    [8n, 'sekiz'],
+    [7n, 'yedi'],
+    [6n, 'altı'],
+    [5n, 'beş'],
+    [4n, 'dört'],
+    [3n, 'üç'],
+    [2n, 'iki'],
+    [1n, 'bir'],
+    [0n, 'sıfır']
+  ]
+
+  constructor (options = {}) {
+    super()
+
+    this.setOptions({
+      dropSpaces: false
+    }, options)
+
+    if (this.options.dropSpaces) {
+      this.wordSeparator = ''
+    }
+  }
+}