n2words 2.0.0 → 3.0.0

package/lib/languages/lt.js

@@ -1,136 +1,310 @@
-import { SlavicLanguage } from '../classes/slavic-language.js'
+/**
+ * Lithuanian language converter - Functional Implementation
+ *
+ * A performance-optimized number-to-words converter using precomputed lookup tables.
+ *
+ * Key features:
+ * - Three-form pluralization (singular/plural/genitive)
+ * - Gender agreement (masculine/feminine for numbers < 1000)
+ * - Two-form hundreds (šimtas/šimtai)
+ * - Long scale naming
+ */
+
+import { parseNumericValue } from '../utils/parse-numeric.js'
+import { validateOptions } from '../utils/validate-options.js'
+
+// ============================================================================
+// Vocabulary (module-level constants)
+// ============================================================================
+
+const ONES_MASC = ['', 'vienas', 'du', 'trys', 'keturi', 'penki', 'šeši', 'septyni', 'aštuoni', 'devyni']
+const ONES_FEM = ['', 'viena', 'dvi', 'trys', 'keturios', 'penkios', 'šešios', 'septynios', 'aštuonios', 'devynios']
+
+const TEENS = ['dešimt', 'vienuolika', 'dvylika', 'trylika', 'keturiolika', 'penkiolika', 'šešiolika', 'septyniolika', 'aštuoniolika', 'devyniolika']
+const TENS = ['', '', 'dvidešimt', 'trisdešimt', 'keturiasdešimt', 'penkiasdešimt', 'šešiasdešimt', 'septyniasdešimt', 'aštuoniasdešimt', 'devyniasdešimt']
+
+// Hundreds: šimtas (singular), šimtai (plural)
+const HUNDRED_SINGULAR = 'šimtas'
+const HUNDRED_PLURAL = 'šimtai'
+
+const ZERO = 'nulis'
+const NEGATIVE = 'minus'
+const DECIMAL_SEP = 'kablelis'
+
+// Scale words: [singular, plural, genitive]
+const SCALE_FORMS = [
+  ['tūkstantis', 'tūkstančiai', 'tūkstančių'],
+  ['milijonas', 'milijonai', 'milijonų'],
+  ['milijardas', 'milijardai', 'milijardų'],
+  ['trilijonas', 'trilijonai', 'trilijonų'],
+  ['kvadrilijonas', 'kvadrilijonai', 'kvadrilijonų'],
+  ['kvintilijonas', 'kvintilijonai', 'kvintilijonų'],
+  ['sikstilijonas', 'sikstilijonai', 'sikstilijonų'],
+  ['septilijonas', 'septilijonai', 'septilijonų'],
+  ['oktilijonas', 'oktilijonai', 'oktilijonų']
+]
+
+// ============================================================================
+// Precomputed Lookup Tables (built once at module load)
+// ============================================================================
+
+/**
+ * Builds segment word for 0-999 (masculine form).
+ */
+function buildSegment (n) {
+  if (n === 0) return ''
+
+  const ones = n % 10
+  const tens = Math.floor(n / 10) % 10
+  const hundreds = Math.floor(n / 100)
+
+  const parts = []
+
+  // Hundreds - Lithuanian always includes the numeral
+  if (hundreds > 0) {
+    parts.push(ONES_MASC[hundreds])
+    parts.push(hundreds === 1 ? HUNDRED_SINGULAR : HUNDRED_PLURAL)
+  }
+
+  // Tens
+  if (tens > 1) {
+    parts.push(TENS[tens])
+  }
+
+  // Teens or ones
+  if (tens === 1) {
+    parts.push(TEENS[ones])
+  } else if (ones > 0) {
+    parts.push(ONES_MASC[ones])
+  }
+
+  return parts.join(' ')
+}
 
 /**
- * Lithuanian language converter.
+ * Builds segment word for 0-999 (feminine form - only differs in ones).
+ */
+function buildSegmentFeminine (n) {
+  if (n === 0) return ''
+
+  const ones = n % 10
+  const tens = Math.floor(n / 10) % 10
+  const hundreds = Math.floor(n / 100)
+
+  const parts = []
+
+  // Hundreds - always masculine
+  if (hundreds > 0) {
+    parts.push(ONES_MASC[hundreds])
+    parts.push(hundreds === 1 ? HUNDRED_SINGULAR : HUNDRED_PLURAL)
+  }
+
+  // Tens
+  if (tens > 1) {
+    parts.push(TENS[tens])
+  }
+
+  // Teens or ones - feminine for ones only
+  if (tens === 1) {
+    parts.push(TEENS[ones])
+  } else if (ones > 0) {
+    parts.push(ONES_FEM[ones])
+  }
+
+  return parts.join(' ')
+}
+
+// Precompute all 1000 segment words (0-999)
+const SEGMENTS_MASC = new Array(1000)
+const SEGMENTS_FEM = new Array(1000)
+
+for (let i = 0; i < 1000; i++) {
+  SEGMENTS_MASC[i] = buildSegment(i)
+  SEGMENTS_FEM[i] = buildSegmentFeminine(i)
+}
+
+// ============================================================================
+// Pluralization
+// ============================================================================
+
+/**
+ * Lithuanian pluralization rules.
+ * - Singular: ends in 1 (except 11)
+ * - Plural: ends in 2-9 (except 12-19)
+ * - Genitive: 0, 10-19, or ends in 0
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Gender agreement (vienas/viena, du/dvi)
- * - Baltic declension patterns
+ * @param {number} n - The segment value
+ * @param {string[]} forms - [singular, plural, genitive]
+ * @returns {string} The appropriate form
  */
-export class Lithuanian extends SlavicLanguage {
-  negativeWord = 'minus'
-  decimalSeparatorWord = 'kablelis'
-  zeroWord = 'nulis'
-
-  onesWords = {
-    1: 'vienas',
-    2: 'du',
-    3: 'trys',
-    4: 'keturi',
-    5: 'penki',
-    6: 'šeši',
-    7: 'septyni',
-    8: 'aštuoni',
-    9: 'devyni'
-  }
-
-  onesFeminineWords = {
-    1: 'viena',
-    2: 'dvi',
-    3: 'trys',
-    4: 'keturios',
-    5: 'penkios',
-    6: 'šešios',
-    7: 'septynios',
-    8: 'aštuonios',
-    9: 'devynios'
-  }
-
-  teensWords = {
-    0: 'dešimt',
-    1: 'vienuolika',
-    2: 'dvylika',
-    3: 'trylika',
-    4: 'keturiolika',
-    5: 'penkiolika',
-    6: 'šešiolika',
-    7: 'septyniolika',
-    8: 'aštuoniolika',
-    9: 'devyniolika'
-  }
-
-  twentiesWords = {
-    2: 'dvidešimt',
-    3: 'trisdešimt',
-    4: 'keturiasdešimt',
-    5: 'penkiasdešimt',
-    6: 'šešiasdešimt',
-    7: 'septyniasdešimt',
-    8: 'aštuoniasdešimt',
-    9: 'devyniasdešimt'
-  }
-
-  hundredsWords = ['šimtas', 'šimtai']
-
-  pluralForms = {
-    1: ['tūkstantis', 'tūkstančiai', 'tūkstančių'],
-    2: ['milijonas', 'milijonai', 'milijonų'],
-    3: ['milijardas', 'milijardai', 'milijardų'],
-    4: ['trilijonas', 'trilijonai', 'trilijonų'],
-    5: ['kvadrilijonas', 'kvadrilijonai', 'kvadrilijonų'],
-    6: ['kvintilijonas', 'kvintilijonai', 'kvintilijonų'],
-    7: ['sikstilijonas', 'sikstilijonai', 'sikstilijonų'],
-    8: ['septilijonas', 'septilijonai', 'septilijonų'],
-    9: ['oktilijonas', 'oktilijonai', 'oktilijonų'],
-    10: ['naintilijonas', 'naintilijonai', 'naintilijonų']
-  }
-
-  pluralize (n, forms) {
-    if (n === 0n) {
-      return forms[2]
-    }
+function pluralize (n, forms) {
+  if (n === 0) return forms[2]
 
-    const [n1, n2] = this.extractDigits(n)
+  const lastDigit = n % 10
+  const lastTwoDigits = n % 100
 
-    if (n2 === 1n || n1 === 0n) {
-      return forms[2]
-    }
+  // 10-19 always use genitive
+  if (lastTwoDigits >= 10 && lastTwoDigits <= 19) {
+    return forms[2]
+  }
 
-    if (n1 === 1n) {
-      return forms[0]
-    }
+  // Ends in 0 → genitive
+  if (lastDigit === 0) {
+    return forms[2]
+  }
 
-    return forms[1]
+  // Ends in 1 → singular
+  if (lastDigit === 1) {
+    return forms[0]
   }
 
-  integerToWords (integerPart) {
-    if (integerPart === 0n) {
-      return this.zeroWord
-    }
-    const words = []
-    const segments = this.splitToSegments(integerPart.toString(), 3)
-    let index = segments.length
-    for (const x of segments) {
-      index = index - 1
-      if (x === 0n) {
-        continue
-      }
-      const [n1, n2, n3] = this.extractDigits(x)
-      if (n3 > 0n) {
-        words.push(this.onesWords[n3])
-        if (n3 > 1n) {
-          words.push(this.hundredsWords[1])
-        } else {
-          words.push(this.hundredsWords[0])
-        }
-      }
-      if (n2 > 1n) {
-        words.push(this.twentiesWords[n2])
-      }
-      if (n2 === 1n) {
-        words.push(this.teensWords[n1])
-      } else if (n1 > 0n) {
-        if ((index === 1 || (this.options.gender === 'feminine' && index === 0)) && integerPart < 1000n) {
-          words.push(this.onesFeminineWords[n1])
-        } else {
-          words.push(this.onesWords[n1])
-        }
-      }
-      if (index > 0) {
-        words.push(this.pluralize(x, this.pluralForms[index]))
+  // Ends in 2-9 → plural
+  return forms[1]
+}
+
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Lithuanian words.
+ *
+ * @param {bigint} n - Non-negative integer to convert
+ * @param {Object} options - Conversion options
+ * @returns {string} Lithuanian words
+ */
+function integerToWords (n, options = {}) {
+  if (n === 0n) return ZERO
+
+  // Fast path: numbers < 1000 (direct lookup)
+  if (n < 1000n) {
+    const segments = options.gender === 'feminine' ? SEGMENTS_FEM : SEGMENTS_MASC
+    return segments[Number(n)]
+  }
+
+  // For numbers >= 1000, feminine only applies to final segment if < 1000
+  // But the fixture shows feminine NOT applying for n >= 1000
+  // So we use masculine for all segments when n >= 1000
+  return buildLargeNumberWords(n, options)
+}
+
+/**
+ * Builds words for numbers >= 1000.
+ *
+ * @param {bigint} n - Number >= 1000
+ * @param {Object} options - Conversion options
+ * @returns {string} Lithuanian words
+ */
+function buildLargeNumberWords (n, options) {
+  const numStr = n.toString()
+  const len = numStr.length
+
+  // Build segments of 3 digits from right to left
+  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
+  }
+
+  // Convert segments to words
+  const parts = []
+  let scaleIndex = segments.length - 1
+
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i]
+
+    if (segment !== 0) {
+      const segmentWord = SEGMENTS_MASC[segment]
+
+      if (scaleIndex === 0) {
+        // Units segment - use masculine (feminine doesn't apply when n >= 1000)
+        parts.push(segmentWord)
+      } else {
+        // Segment with scale word
+        const scaleForms = SCALE_FORMS[scaleIndex - 1]
+        const scaleWord = pluralize(segment, scaleForms)
+        parts.push(segmentWord + ' ' + scaleWord)
       }
     }
-    return words.join(' ')
+
+    scaleIndex--
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Converts decimal digits to Lithuanian words.
+ *
+ * @param {string} decimalPart - Decimal digits (without the point)
+ * @param {Object} options - Conversion options
+ * @returns {string} Lithuanian words for decimal part
+ */
+function decimalPartToWords (decimalPart, options) {
+  let result = ''
+
+  // Handle leading zeros
+  let i = 0
+  while (i < decimalPart.length && decimalPart[i] === '0') {
+    if (result) result += ' '
+    result += ZERO
+    i++
   }
+
+  // Convert remainder as a single number
+  const remainder = decimalPart.slice(i)
+  if (remainder) {
+    if (result) result += ' '
+    result += integerToWords(BigInt(remainder), options)
+  }
+
+  return result
 }
+
+/**
+ * Converts a numeric value to Lithuanian words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @param {Object} [options] - Conversion options
+ * @param {string} [options.gender='masculine'] - Gender for numbers < 1000
+ * @returns {string} The number in Lithuanian words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toWords(42)                          // 'keturiasdešimt du'
+ * toWords(1, { gender: 'feminine' })   // 'viena'
+ * toWords(1000000)                     // 'vienas milijonas'
+ */
+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
+}
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+export { toWords }

package/lib/languages/lv.d.ts

@@ -1,70 +1,18 @@
 /**
- * Latvian language converter.
+ * Converts a numeric value to Latvian words.
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Latvian diacritical marks (ī, ā, ē, ū)
- * - Compound number formation (divdesmit, trīsdesmit)
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @param {Object} [options] - Conversion options
+ * @param {string} [options.gender='masculine'] - Gender for numbers < 1000
+ * @returns {string} The number in Latvian words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toWords(42)                          // 'četrdesmit divi'
+ * toWords(1, { gender: 'feminine' })   // 'viena'
+ * toWords(1000)                        // 'tūkstotis'
  */
-export class Latvian 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: string[];
-    pluralForms: {
-        1: string[];
-        2: string[];
-        3: string[];
-        4: string[];
-        5: string[];
-        6: string[];
-        7: string[];
-        8: string[];
-        9: string[];
-        10: string[];
-    };
-    pluralize(n: any, forms: any): any;
-    integerToWords(integerPart: any): string;
-}
-import { SlavicLanguage } from '../classes/slavic-language.js';
+export function toWords(value: number | string | bigint, options?: {
+    gender?: string | undefined;
+}): string;