n2words 2.0.0 → 3.1.0

package/lib/languages/ru.js

@@ -1,96 +1,245 @@
-import { SlavicLanguage } from '../classes/slavic-language.js'
-
 /**
- * Russian language converter.
+ * Russian language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
  *
- * Supports:
- * - Gender agreement (masculine/feminine forms)
+ * Key features:
  * - Three-form pluralization (one/few/many)
- * - Large numbers up to nonillions
+ * - Gender: thousands are feminine, millions+ are masculine
+ * - Irregular hundreds (двести, триста, etc.)
+ * - Long scale naming
  */
-export class Russian extends SlavicLanguage {
-  negativeWord = 'минус'
-  decimalSeparatorWord = 'запятая'
-  zeroWord = 'ноль'
-
-  onesWords = {
-    1: 'один',
-    2: 'два',
-    3: 'три',
-    4: 'четыре',
-    5: 'пять',
-    6: 'шесть',
-    7: 'семь',
-    8: 'восемь',
-    9: 'девять'
-  }
-
-  onesFeminineWords = {
-    1: 'одна',
-    2: 'две',
-    3: 'три',
-    4: 'четыре',
-    5: 'пять',
-    6: 'шесть',
-    7: 'семь',
-    8: 'восемь',
-    9: 'девять'
-  }
-
-  teensWords = {
-    0: 'десять',
-    1: 'одиннадцать',
-    2: 'двенадцать',
-    3: 'тринадцать',
-    4: 'четырнадцать',
-    5: 'пятнадцать',
-    6: 'шестнадцать',
-    7: 'семнадцать',
-    8: 'восемнадцать',
-    9: 'девятнадцать'
-  }
-
-  twentiesWords = {
-    2: 'двадцать',
-    3: 'тридцать',
-    4: 'сорок',
-    5: 'пятьдесят',
-    6: 'шестьдесят',
-    7: 'семьдесят',
-    8: 'восемьдесят',
-    9: 'девяносто'
-  }
-
-  hundredsWords = {
-    1: 'сто',
-    2: 'двести',
-    3: 'триста',
-    4: 'четыреста',
-    5: 'пятьсот',
-    6: 'шестьсот',
-    7: 'семьсот',
-    8: 'восемьсот',
-    9: 'девятьсот'
-  }
-
-  pluralForms = {
-    1: ['тысяча', 'тысячи', 'тысяч'], // 10^ 3
-    2: ['миллион', 'миллиона', 'миллионов'], // 10^ 6
-    3: ['миллиард', 'миллиарда', 'миллиардов'], // 10^ 9
-    4: ['триллион', 'триллиона', 'триллионов'], // 10^ 12
-    5: ['квадриллион', 'квадриллиона', 'квадриллионов'], // 10^ 15
-    6: ['квинтиллион', 'квинтиллиона', 'квинтиллионов'], // 10^ 18
-    7: ['секстиллион', 'секстиллиона', 'секстиллионов'], // 10^ 21
-    8: ['септиллион', 'септиллиона', 'септиллионов'], // 10^ 24
-    9: ['октиллион', 'октиллиона', 'октиллионов'], // 10^ 27
-    10: ['нониллион', 'нониллиона', 'нониллионов'] // 10^ 30
-  }
-
-  /**
-   * Russian thousands (тысяча) are feminine, requiring одна/две forms.
-   * Other scales (million, billion, etc.) are masculine.
-   */
-  scaleGenders = {
-    1: true // thousands are feminine
+
+import { parseNumericValue } from '../utils/parse-numeric.js'
+import { validateOptions } from '../utils/validate-options.js'
+
+// ============================================================================
+// Vocabulary
+// ============================================================================
+
+const ONES_MASC = ['', 'один', 'два', 'три', 'четыре', 'пять', 'шесть', 'семь', 'восемь', 'девять']
+const ONES_FEM = ['', 'одна', 'две', 'три', 'четыре', 'пять', 'шесть', 'семь', 'восемь', 'девять']
+
+const TEENS = ['десять', 'одиннадцать', 'двенадцать', 'тринадцать', 'четырнадцать', 'пятнадцать', 'шестнадцать', 'семнадцать', 'восемнадцать', 'девятнадцать']
+const TENS = ['', '', 'двадцать', 'тридцать', 'сорок', 'пятьдесят', 'шестьдесят', 'семьдесят', 'восемьдесят', 'девяносто']
+
+// Irregular hundreds
+const HUNDREDS = ['', 'сто', 'двести', 'триста', 'четыреста', 'пятьсот', 'шестьсот', 'семьсот', 'восемьсот', 'девятьсот']
+
+const ZERO = 'ноль'
+const NEGATIVE = 'минус'
+const DECIMAL_SEP = 'запятая'
+
+// Scale words: [singular, few, many]
+// Thousands (index 0) are feminine, rest are masculine
+const SCALE_FORMS = [
+  ['тысяча', 'тысячи', 'тысяч'],
+  ['миллион', 'миллиона', 'миллионов'],
+  ['миллиард', 'миллиарда', 'миллиардов'],
+  ['триллион', 'триллиона', 'триллионов'],
+  ['квадриллион', 'квадриллиона', 'квадриллионов'],
+  ['квинтиллион', 'квинтиллиона', 'квинтиллионов'],
+  ['секстиллион', 'секстиллиона', 'секстиллионов'],
+  ['септиллион', 'септиллиона', 'септиллионов'],
+  ['октиллион', 'октиллиона', 'октиллионов'],
+  ['нониллион', 'нониллиона', 'нониллионов']
+]
+
+// ============================================================================
+// Segment Building
+// ============================================================================
+
+function pluralize (n, forms) {
+  const num = typeof n === 'bigint' ? Number(n) : n
+  const lastDigit = num % 10
+  const lastTwoDigits = num % 100
+
+  if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
+    return forms[2]
   }
+
+  if (lastDigit === 1) return forms[0]
+  if (lastDigit >= 2 && lastDigit <= 4) return forms[1]
+  return forms[2]
 }
+
+function buildSegmentMasc (n) {
+  if (n === 0) return ''
+
+  const onesDigit = n % 10
+  const tensDigit = Math.floor(n / 10) % 10
+  const hundredsDigit = Math.floor(n / 100)
+
+  const parts = []
+
+  if (hundredsDigit > 0) {
+    parts.push(HUNDREDS[hundredsDigit])
+  }
+
+  if (tensDigit > 1) {
+    parts.push(TENS[tensDigit])
+  }
+
+  if (tensDigit === 1) {
+    parts.push(TEENS[onesDigit])
+  } else if (onesDigit > 0) {
+    parts.push(ONES_MASC[onesDigit])
+  }
+
+  return parts.join(' ')
+}
+
+function buildSegmentFem (n) {
+  if (n === 0) return ''
+
+  const onesDigit = n % 10
+  const tensDigit = Math.floor(n / 10) % 10
+  const hundredsDigit = Math.floor(n / 100)
+
+  const parts = []
+
+  if (hundredsDigit > 0) {
+    parts.push(HUNDREDS[hundredsDigit])
+  }
+
+  if (tensDigit > 1) {
+    parts.push(TENS[tensDigit])
+  }
+
+  if (tensDigit === 1) {
+    parts.push(TEENS[onesDigit])
+  } else if (onesDigit > 0) {
+    parts.push(ONES_FEM[onesDigit])
+  }
+
+  return parts.join(' ')
+}
+
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+function integerToWords (n, options = {}) {
+  if (n === 0n) return ZERO
+
+  const feminine = options.gender === 'feminine'
+
+  if (n < 1000n) {
+    return feminine ? buildSegmentFem(Number(n)) : buildSegmentMasc(Number(n))
+  }
+
+  if (n < 1_000_000n) {
+    const thousands = Number(n / 1000n)
+    const remainder = Number(n % 1000n)
+
+    // Thousands are always feminine in Russian
+    const thousandsWord = buildSegmentFem(thousands)
+    const scaleWord = pluralize(thousands, SCALE_FORMS[0])
+
+    let result = thousandsWord + ' ' + scaleWord
+
+    if (remainder > 0) {
+      result += ' ' + (feminine ? buildSegmentFem(remainder) : buildSegmentMasc(remainder))
+    }
+
+    return result
+  }
+
+  return buildLargeNumberWords(n, options)
+}
+
+function buildLargeNumberWords (n, options) {
+  const feminine = options.gender === 'feminine'
+  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) {
+      if (scaleIndex === 0) {
+        parts.push(feminine ? buildSegmentFem(segment) : buildSegmentMasc(segment))
+      } else {
+        const scaleForms = SCALE_FORMS[scaleIndex - 1]
+        const scaleWord = pluralize(segment, scaleForms)
+        // Thousands (scaleIndex=1) are feminine, others masculine
+        const isFeminine = scaleIndex === 1
+        const segmentWord = isFeminine ? buildSegmentFem(segment) : buildSegmentMasc(segment)
+        parts.push(segmentWord + ' ' + scaleWord)
+      }
+    }
+
+    scaleIndex--
+  }
+
+  return parts.join(' ')
+}
+
+function decimalPartToWords (decimalPart, options) {
+  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), options)
+  }
+
+  return result
+}
+
+/**
+ * Converts a numeric value to Russian words.
+ *
+ * @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 Russian words
+ */
+function toWords (value, options) {
+  options = validateOptions(options)
+  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
+
+  let result = ''
+
+  if (isNegative) {
+    result = NEGATIVE + ' '
+  }
+
+  result += integerToWords(integerPart, options)
+
+  if (decimalPart) {
+    result += ' ' + DECIMAL_SEP + ' ' + decimalPartToWords(decimalPart, options)
+  }
+
+  return result
+}
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+export { toWords }

package/lib/languages/sr-Cyrl.d.ts

@@ -1,80 +1,11 @@
 /**
- * Serbian language converter (Cyrillic script).
+ * Converts a numeric value to Serbian (Cyrillic) words.
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Gender agreement (један/једна, два/две)
- * - Cyrillic script representation
+ * @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 Serbian Cyrillic words
  */
-export class SerbianCyrillic 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 Serbian 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;