n2words 2.0.0 → 3.1.0

package/lib/languages/kn.js

@@ -1,42 +1,150 @@
-import { SouthAsianLanguage } from '../classes/south-asian-language.js'
-
 /**
- * Kannada language converter.
+ * Kannada language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
  *
- * Supports:
+ * Key features:
  * - Indian numbering system (ಸಾವಿರ, ಲಕ್ಷ, ಕೋಟಿ)
  * - Kannada script
+ * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
  * - Complete word forms for 0-99
+ * - Per-digit decimal reading
+ */
+
+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.
  */
-export class Kannada extends SouthAsianLanguage {
-  negativeWord = 'ಋಣಾತ್ಮಕ'
-  decimalSeparatorWord = 'ದಶಮಾಂಶ'
-  zeroWord = 'ಸೊನ್ನೆ'
-  hundredWord = 'ನೂರು'
-  usePerDigitDecimals = true
-
-  belowHundredWords = [
-    'ಸೊನ್ನೆ', 'ಒಂದು', 'ಎರಡು', 'ಮೂರು', 'ನಾಲ್ಕು', 'ಐದು', 'ಆರು', 'ಏಳು', 'ಎಂಟು', 'ಒಂಬತ್ತು',
-    'ಹತ್ತು', 'ಹನ್ನೊಂದು', 'ಹನ್ನೆರಡು', 'ಹದಿಮೂರು', 'ಹದಿನಾಲ್ಕು', 'ಹದಿನೈದು', 'ಹದಿನಾರು', 'ಹದಿನೇಳು', 'ಹದಿನೆಂಟು', 'ಹತ್ತೊಂಬತ್ತು',
-    'ಇಪ್ಪತ್ತು', 'ಇಪ್ಪತ್ತೊಂದು', 'ಇಪ್ಪತ್ತೆರಡು', 'ಇಪ್ಪತ್ತಮೂರು', 'ಇಪ್ಪತ್ತನಾಲ್ಕು', 'ಇಪ್ಪತ್ತೈದು', 'ಇಪ್ಪತ್ತಾರು', 'ಇಪ್ಪತ್ತೇಳು', 'ಇಪ್ಪತ್ತೆಂಟು', 'ಇಪ್ಪತ್ತೊಂಬತ್ತು',
-    'ಮೂವತ್ತು', 'ಮೂವತ್ತೊಂದು', 'ಮೂವತ್ತೆರಡು', 'ಮೂವತ್ತಮೂರು', 'ಮೂವತ್ತನಾಲ್ಕು', 'ಮೂವತ್ತೈದು', 'ಮೂವತ್ತಾರು', 'ಮೂವತ್ತೇಳು', 'ಮೂವತ್ತೆಂಟು', 'ಮೂವತ್ತೊಂಬತ್ತು',
-    'ನಲವತ್ತು', 'ನಲವತ್ತೊಂದು', 'ನಲವತ್ತೆರಡು', 'ನಲವತ್ತಮೂರು', 'ನಲವತ್ತನಾಲ್ಕು', 'ನಲವತ್ತೈದು', 'ನಲವತ್ತಾರು', 'ನಲವತ್ತೇಳು', 'ನಲವತ್ತೆಂಟು', 'ನಲವತ್ತೊಂಬತ್ತು',
-    'ಐವತ್ತು', 'ಐವತ್ತೊಂದು', 'ಐವತ್ತೆರಡು', 'ಐವತ್ತಮೂರು', 'ಐವತ್ತನಾಲ್ಕು', 'ಐವತ್ತೈದು', 'ಐವತ್ತಾರು', 'ಐವತ್ತೇಳು', 'ಐವತ್ತೆಂಟು', 'ಐವತ್ತೊಂಬತ್ತು',
-    'ಅರವತ್ತು', 'ಅರವತ್ತೊಂದು', 'ಅರವತ್ತೆರಡು', 'ಅರವತ್ತಮೂರು', 'ಅರವತ್ತನಾಲ್ಕು', 'ಅರವತ್ತೈದು', 'ಅರವತ್ತಾರು', 'ಅರವತ್ತೇಳು', 'ಅರವತ್ತೆಂಟು', 'ಅರವತ್ತೊಂಬತ್ತು',
-    'ಎಪ್ಪತ್ತು', 'ಎಪ್ಪತ್ತೊಂದು', 'ಎಪ್ಪತ್ತೆರಡು', 'ಎಪ್ಪತ್ತಮೂರು', 'ಎಪ್ಪತ್ತನಾಲ್ಕು', 'ಎಪ್ಪತ್ತೈದು', 'ಎಪ್ಪತ್ತಾರು', 'ಎಪ್ಪತ್ತೇಳು', 'ಎಪ್ಪತ್ತೆಂಟು', 'ಎಪ್ಪತ್ತೊಂಬತ್ತು',
-    'ಎಂಬತ್ತು', 'ಎಂಬತ್ತೊಂದು', 'ಎಂಬತ್ತೆರಡು', 'ಎಂಬತ್ತಮೂರು', 'ಎಂಬತ್ತನಾಲ್ಕು', 'ಎಂಬತ್ತೈದು', 'ಎಂಬತ್ತಾರು', 'ಎಂಬತ್ತೇಳು', 'ಎಂಬತ್ತೆಂಟು', 'ಎಂಬತ್ತೊಂಬತ್ತು',
-    'ತೊಂಬತ್ತು', 'ತೊಂಬತ್ತೊಂದು', 'ತೊಂಬತ್ತೆರಡು', 'ತೊಂಬತ್ತಮೂರು', 'ತೊಂಬತ್ತನಾಲ್ಕು', 'ತೊಂಬತ್ತೈದು', 'ತೊಂಬತ್ತಾರು', 'ತೊಂಬತ್ತೇಳು', 'ತೊಂಬತ್ತೆಂಟು', 'ತೊಂಬತ್ತೊಂಬತ್ತು'
-  ]
-
-  scaleWords = [
-    '', // units
-    'ಸಾವಿರ', // thousand (1,000)
-    'ಲಕ್ಷ', // lakh (100,000)
-    'ಕೋಟಿ', // crore (10,000,000)
-    'ಅಬ್ಜ', // arab (1,000,000,000)
-    'ಖರ್ವ', // kharab (100,000,000,000)
-    'ನೀಲ', // neel (10,000,000,000,000)
-    'ಪದ್ಮ', // padma (1,000,000,000,000,000)
-    'ಶಂಖ' // shankh (100,000,000,000,000,000)
-  ]
+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 Kannada 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} Kannada words
+ */
+function integerToWords (n) {
+  if (n === 0n) return ZERO
+
+  // Fast path: numbers < 1000 (direct lookup)
+  if (n < 1000n) {
+    return buildSegment(Number(n))
+  }
+
+  // Extract segments using BigInt modulo
+  const segments = []
+  segments.push(Number(n % 1000n))
+  let temp = n / 1000n
+
+  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) {
+      words.push(buildSegment(segment))
+    } else {
+      words.push(BELOW_HUNDRED[segment])
+    }
+
+    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 : BELOW_HUNDRED[d])
+  }
+  return digits.join(' ')
+}
+
+/**
+ * Converts a numeric value to Kannada words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Kannada 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/ko.d.ts

@@ -1,14 +1,14 @@
 /**
- * Korean language converter.
+ * Converts a numeric value to Korean words.
  *
- * Supports:
- * - Hangul numerals (일, 이, 삼, etc.)
- * - Grouping by 만 (10,000) system
- * - Implicit '일' (one) omission before multipliers
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Korean words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toWords(21)         // '이십일'
+ * toWords(10000)      // '만'
+ * toWords(1000000)    // '백만'
  */
-export class Korean extends GreedyScaleLanguage {
-    scaleWords: (string | bigint)[][];
-    /** Combines two word-sets according to Korean grammar rules. */
-    combineWordSets(preceding: any, following: any): any;
-}
-import { GreedyScaleLanguage } from '../classes/greedy-scale-language.js';
+export function toWords(value: number | string | bigint): string;

package/lib/languages/ko.js

@@ -1,55 +1,256 @@
-import { GreedyScaleLanguage } from '../classes/greedy-scale-language.js'
+/**
+ * Korean language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
+ *
+ * Key features:
+ * - Myriad-based (만) grouping - 4 digits
+ * - Implicit '일' (one) omission before scale words
+ * - Space separation after 만+ scales
+ * - Hangul numerals
+ */
+
+import { parseNumericValue } from '../utils/parse-numeric.js'
+
+// ============================================================================
+// Vocabulary (module-level constants)
+// ============================================================================
+
+const ONES = ['', '일', '이', '삼', '사', '오', '육', '칠', '팔', '구']
+
+const TEN = '십'
+const HUNDRED = '백'
+const THOUSAND = '천'
+
+const ZERO = '영'
+const NEGATIVE = '마이너스'
+const DECIMAL_SEP = '점'
+
+// Myriad scale words (powers of 10,000)
+// 만 (10^4), 억 (10^8), 조 (10^12), 경 (10^16), etc.
+const SCALES = ['만', '억', '조', '경', '해', '자', '양']
+
+// ============================================================================
+// Segment Building
+// ============================================================================
 
 /**
- * Korean language converter.
+ * Builds segment word for 0-9999 (4-digit myriad segment).
+ * Korean omits "일" before 십, 백, 천.
+ */
+function buildSegment (n) {
+  if (n === 0) return ''
+
+  const ones = n % 10
+  const tens = Math.floor(n / 10) % 10
+  const hundreds = Math.floor(n / 100) % 10
+  const thousands = Math.floor(n / 1000)
+
+  let result = ''
+
+  // Thousands
+  if (thousands > 0) {
+    if (thousands === 1) {
+      result += THOUSAND
+    } else {
+      result += ONES[thousands] + THOUSAND
+    }
+  }
+
+  // Hundreds
+  if (hundreds > 0) {
+    if (hundreds === 1) {
+      result += HUNDRED
+    } else {
+      result += ONES[hundreds] + HUNDRED
+    }
+  }
+
+  // Tens
+  if (tens > 0) {
+    if (tens === 1) {
+      result += TEN
+    } else {
+      result += ONES[tens] + TEN
+    }
+  }
+
+  // Ones
+  if (ones > 0) {
+    result += ONES[ones]
+  }
+
+  return result
+}
+
+// ============================================================================
+// Conversion Functions
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Korean words.
  *
- * Supports:
- * - Hangul numerals (일, 이, 삼, etc.)
- * - Grouping by 만 (10,000) system
- * - Implicit '일' (one) omission before multipliers
+ * @param {bigint} n - Non-negative integer to convert
+ * @returns {string} Korean words
  */
-export class Korean extends GreedyScaleLanguage {
-  negativeWord = '마이너스'
-  decimalSeparatorWord = '점'
-  zeroWord = '영'
-
-  scaleWords = [
-    [10_000_000_000_000_000_000_000_000_000n, '양'],
-    [1_000_000_000_000_000_000_000_000n, '자'],
-    [100_000_000_000_000_000_000n, '해'],
-    [10_000_000_000_000_000n, '경'],
-    [1_000_000_000_000n, '조'],
-    [100_000_000n, '억'],
-    [10_000n, '만'],
-    [1000n, '천'],
-    [100n, '백'],
-    [10n, '십'],
-    [9n, '구'],
-    [8n, '팔'],
-    [7n, '칠'],
-    [6n, '육'],
-    [5n, '오'],
-    [4n, '사'],
-    [3n, '삼'],
-    [2n, '이'],
-    [1n, '일'],
-    [0n, '영']
-  ]
-
-  /** Combines two word-sets according to Korean grammar rules. */
-  combineWordSets (preceding, following) {
-    const precedingWord = Object.keys(preceding)[0]
-    const followingWord = Object.keys(following)[0]
-    const precedingValue = Object.values(preceding)[0] // BigInt
-    const followingValue = Object.values(following)[0] // BigInt
-
-    // Implicit "일": omit 1 before multipliers up to 만 (10,000)
-    if (precedingValue === 1n && followingValue <= 10_000n) return following
-    // Concatenate (no space) for small numbers less than 만
-    if (precedingValue < 10_000n && precedingValue > followingValue) return { [`${precedingWord}${followingWord}`]: precedingValue + followingValue }
-    // Space-separate for large numbers (>= 만) when adding
-    if (precedingValue >= 10_000n && precedingValue > followingValue) return { [`${precedingWord} ${followingWord}`]: precedingValue + followingValue }
-    // Multiply for all scale combinations
-    return { [`${precedingWord}${followingWord}`]: precedingValue * followingValue }
+function integerToWords (n) {
+  if (n === 0n) return ZERO
+
+  // Fast path: numbers < 10000
+  if (n < 10000n) {
+    return buildSegment(Number(n))
   }
+
+  // For numbers >= 10000, use myriad decomposition
+  return buildLargeNumberWords(n)
 }
+
+/**
+ * Builds words for numbers >= 10000.
+ * Uses myriad (만) grouping - 4 digits per segment.
+ *
+ * @param {bigint} n - Number >= 10000
+ * @returns {string} Korean words
+ */
+function buildLargeNumberWords (n) {
+  const numStr = n.toString()
+  const len = numStr.length
+
+  // Build segments of 4 digits from right to left
+  const segments = []
+  const segmentSize = 4
+
+  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) {
+      if (scaleIndex === 0) {
+        // Units segment (no scale word)
+        parts.push({ word: buildSegment(segment), isScale: false })
+      } else {
+        // Segment with scale word
+        const scaleWord = SCALES[scaleIndex - 1]
+
+        // Korean omits segment when it's 1 before scale words
+        if (segment === 1) {
+          parts.push({ word: scaleWord, isScale: true })
+        } else {
+          parts.push({ word: buildSegment(segment), isScale: false })
+          parts.push({ word: scaleWord, isScale: true })
+        }
+      }
+    }
+
+    scaleIndex--
+  }
+
+  // Join with Korean spacing rules
+  return joinKoreanParts(parts)
+}
+
+/**
+ * Joins parts with Korean spacing rules.
+ * - Concatenate without spaces within segments
+ * - Space after scale words before next number
+ *
+ * @param {Array} parts - Parts with isScale metadata
+ * @returns {string} Joined string
+ */
+function joinKoreanParts (parts) {
+  if (parts.length === 0) return ZERO
+  if (parts.length === 1) return parts[0].word
+
+  const result = []
+
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i]
+    const prevPart = i > 0 ? parts[i - 1] : null
+
+    // Add space after scale words before next number
+    if (prevPart && prevPart.isScale && !part.isScale) {
+      result.push(' ')
+    }
+
+    result.push(part.word)
+  }
+
+  return result.join('')
+}
+
+/**
+ * Converts decimal digits to Korean words.
+ *
+ * @param {string} decimalPart - Decimal digits (without the point)
+ * @returns {string} Korean words for decimal part (space-separated)
+ */
+function decimalPartToWords (decimalPart) {
+  const parts = []
+
+  // Handle leading zeros
+  let i = 0
+  while (i < decimalPart.length && decimalPart[i] === '0') {
+    parts.push(ZERO)
+    i++
+  }
+
+  // Convert remainder as a single number
+  const remainder = decimalPart.slice(i)
+  if (remainder) {
+    parts.push(integerToWords(BigInt(remainder)))
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Converts a numeric value to Korean words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Korean words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toWords(21)         // '이십일'
+ * toWords(10000)      // '만'
+ * toWords(1000000)    // '백만'
+ */
+function toWords (value) {
+  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
+
+  const parts = []
+
+  if (isNegative) {
+    parts.push(NEGATIVE)
+  }
+
+  parts.push(integerToWords(integerPart))
+
+  if (decimalPart) {
+    parts.push(DECIMAL_SEP)
+    parts.push(decimalPartToWords(decimalPart))
+  }
+
+  return parts.join(' ')
+}
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+export { toWords }

package/lib/languages/lt.d.ts

@@ -1,70 +1,18 @@
 /**
- * Lithuanian language converter.
+ * Converts a numeric value to Lithuanian words.
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Gender agreement (vienas/viena, du/dvi)
- * - Baltic declension patterns
+ * @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'
  */
-export class Lithuanian 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;