n2words 2.0.0 → 3.1.0

package/lib/languages/hi.js

@@ -1,131 +1,170 @@
-import { SouthAsianLanguage } from '../classes/south-asian-language.js'
-
 /**
- * Hindi language converter.
+ * Hindi language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
  *
- * Supports:
+ * Key features:
  * - Indian numbering system (हज़ार, लाख, करोड़)
  * - Devanagari script
+ * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
  * - Complete word forms for 0-99
+ * - BigInt modulo for efficient segment extraction
+ */
+
+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 Building
+// ============================================================================
+
+/**
+ * Builds words for a 0-999 segment.
+ *
+ * @param {number} n - Number 0-999
+ * @returns {string} Hindi 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 BELOW_HUNDRED[hundreds] + ' ' + HUNDRED
+  }
+  return BELOW_HUNDRED[hundreds] + ' ' + HUNDRED + ' ' + BELOW_HUNDRED[remainder]
+}
+
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Hindi 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} Hindi words
+ */
+function integerToWords (n) {
+  if (n === 0n) return ZERO
+
+  // Fast path: numbers < 1000
+  if (n < 1000n) {
+    return buildSegment(Number(n))
+  }
+
+  // Extract segments using BigInt modulo
+  // First segment is 3 digits (thousands), rest are 2 digits (lakhs, crores, etc.)
+  // Segments stored least-significant first
+  const segments = []
+
+  // First segment: last 3 digits
+  segments.push(Number(n % 1000n))
+  let temp = n / 1000n
+
+  // Remaining segments: 2 digits each (lakh = 100k, crore = 10M, etc.)
+  while (temp > 0n) {
+    segments.push(Number(temp % 100n))
+    temp = temp / 100n
+  }
+
+  // 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) {
+      // First segment (units place) can be 0-999
+      words.push(buildSegment(segment))
+    } else {
+      // Other segments are 0-99
+      words.push(BELOW_HUNDRED[segment])
+    }
+
+    // Add scale word if not the units segment
+    if (i > 0 && SCALE_WORDS[i]) {
+      words.push(SCALE_WORDS[i])
+    }
+  }
+
+  return words.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 Hindi words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Hindi words
  */
-export class Hindi extends SouthAsianLanguage {
-  negativeWord = 'माइनस'
-  decimalSeparatorWord = 'दशमलव'
-  zeroWord = 'शून्य'
-  hundredWord = 'सौ'
-
-  belowHundredWords = [
-    'शून्य',
-    'एक',
-    'दो',
-    'तीन',
-    'चार',
-    'पाँच',
-    'छह',
-    'सात',
-    'आठ',
-    'नौ',
-    'दस',
-    'ग्यारह',
-    'बारह',
-    'तेरह',
-    'चौदह',
-    'पंद्रह',
-    'सोलह',
-    'सत्रह',
-    'अठारह',
-    'उन्नीस',
-    'बीस',
-    'इक्कीस',
-    'बाईस',
-    'तेईस',
-    'चौबीस',
-    'पच्चीस',
-    'छब्बीस',
-    'सत्ताईस',
-    'अट्ठाईस',
-    'उनतीस',
-    'तीस',
-    'इकतीस',
-    'बत्तीस',
-    'तैंतीस',
-    'चौंतीस',
-    'पैंतीस',
-    'छत्तीस',
-    'सैंतीस',
-    'अड़तीस',
-    'उनतालीस',
-    'चालीस',
-    'इकतालीस',
-    'बयालीस',
-    'तेतालीस',
-    'चवालीस',
-    'पैंतालीस',
-    'छियालीस',
-    'सैंतालीस',
-    'अड़तालीस',
-    'उनचास',
-    'पचास',
-    'इक्यावन',
-    'बावन',
-    'तिरपन',
-    'चौवन',
-    'पचपन',
-    'छप्पन',
-    'सत्तावन',
-    'अट्ठावन',
-    'उनसठ',
-    'साठ',
-    'इकसठ',
-    'बासठ',
-    'तिरसठ',
-    'चौंसठ',
-    'पैंसठ',
-    'छियासठ',
-    'सड़सठ',
-    'अड़सठ',
-    'उनहत्तर',
-    'सत्तर',
-    'इकहत्तर',
-    'बहत्तर',
-    'तिहत्तर',
-    'चौहत्तर',
-    'पचहत्तर',
-    'छिहत्तर',
-    'सतहत्तर',
-    'अठहत्तर',
-    'उन्यासी',
-    'अस्सी',
-    'इक्यासी',
-    'बयासी',
-    'तिरासी',
-    'चौरासी',
-    'पचासी',
-    'छियासी',
-    'सत्तासी',
-    'अट्ठासी',
-    'नवासी',
-    'नब्बे',
-    'इक्यानवे',
-    'बानवे',
-    'तिरानवे',
-    'चौरानवे',
-    'पचानवे',
-    'छियानवे',
-    'सत्तानवे',
-    'अट्ठानवे',
-    'निन्यानवे'
-  ]
-
-  scaleWords = [
-    '',
-    'हज़ार',
-    'लाख',
-    'करोड़',
-    'अरब',
-    'खरब',
-    'नील',
-    'पद्म',
-    'शंख'
-  ]
+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/hr.d.ts

@@ -1,80 +1,11 @@
 /**
- * Croatian language converter.
+ * Converts a numeric value to Croatian words.
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Gender agreement (jedan/jedna, dva/dvije)
- * - Croatian-specific declension endings
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {('masculine'|'feminine')} [options.gender='masculine'] - Grammatical gender
+ * @returns {string} The number in Croatian words
  */
-export class Croatian extends SlavicLanguage {
-    onesWords: {
-        1: string;
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    onesFeminineWords: {
-        1: string;
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    teensWords: {
-        0: string;
-        1: string;
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    twentiesWords: {
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    hundredsWords: {
-        1: string;
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    pluralForms: {
-        1: string[];
-        2: string[];
-        3: string[];
-        4: string[];
-        5: string[];
-        6: string[];
-        7: string[];
-        8: string[];
-        9: string[];
-        10: string[];
-    };
-    /** Selects Croatian plural form: 1 = singular, 2-4 = few, else = many. */
-    pluralize(n: any, forms: any): any;
-}
-import { SlavicLanguage } from '../classes/slavic-language.js';
+export function toWords(value: number | string | bigint, options?: {
+    gender?: "masculine" | "feminine" | undefined;
+}): string;