n2words 1.23.1 → 1.24.0

package/lib/languages/kn.js

@@ -0,0 +1,71 @@
+/**
+ * Converts numbers to their word representation in Kannada (ಕನ್ನಡ).
+ * @module languages/kn
+ */
+
+import SouthAsianLanguage from '../classes/south-asian-language.js'
+
+/**
+ * Kannada language implementation using Indian-style number grouping.
+ * @extends SouthAsianLanguage
+ */
+class KannadaLanguage extends SouthAsianLanguage {
+  negativeWord = 'ಋಣಾತ್ಮಕ'
+  decimalSeparatorWord = 'ದಶಮಾಂಶ'
+  zeroWord = 'ಸೊನ್ನೆ'
+  hundredWord = 'ನೂರು'
+  convertDecimalsPerDigit = true
+
+  /**
+   * Array of number words from 0 to 99.
+   * Index matches the number value.
+   * @type {string[]}
+   */
+  belowHundred = [
+    'ಸೊನ್ನೆ', 'ಒಂದು', 'ಎರಡು', 'ಮೂರು', 'ನಾಲ್ಕು', 'ಐದು', 'ಆರು', 'ಏಳು', 'ಎಂಟು', 'ಒಂಬತ್ತು',
+    'ಹತ್ತು', 'ಹನ್ನೊಂದು', 'ಹನ್ನೆರಡು', 'ಹದಿಮೂರು', 'ಹದಿನಾಲ್ಕು', 'ಹದಿನೈದು', 'ಹದಿನಾರು', 'ಹದಿನೇಳು', 'ಹದಿನೆಂಟು', 'ಹತ್ತೊಂಬತ್ತು',
+    'ಇಪ್ಪತ್ತು', 'ಇಪ್ಪತ್ತೊಂದು', 'ಇಪ್ಪತ್ತೆರಡು', 'ಇಪ್ಪತ್ತಮೂರು', 'ಇಪ್ಪತ್ತನಾಲ್ಕು', 'ಇಪ್ಪತ್ತೈದು', 'ಇಪ್ಪತ್ತಾರು', 'ಇಪ್ಪತ್ತೇಳು', 'ಇಪ್ಪತ್ತೆಂಟು', 'ಇಪ್ಪತ್ತೊಂಬತ್ತು',
+    'ಮೂವತ್ತು', 'ಮೂವತ್ತೊಂದು', 'ಮೂವತ್ತೆರಡು', 'ಮೂವತ್ತಮೂರು', 'ಮೂವತ್ತನಾಲ್ಕು', 'ಮೂವತ್ತೈದು', 'ಮೂವತ್ತಾರು', 'ಮೂವತ್ತೇಳು', 'ಮೂವತ್ತೆಂಟು', 'ಮೂವತ್ತೊಂಬತ್ತು',
+    'ನಲವತ್ತು', 'ನಲವತ್ತೊಂದು', 'ನಲವತ್ತೆರಡು', 'ನಲವತ್ತಮೂರು', 'ನಲವತ್ತನಾಲ್ಕು', 'ನಲವತ್ತೈದು', 'ನಲವತ್ತಾರು', 'ನಲವತ್ತೇಳು', 'ನಲವತ್ತೆಂಟು', 'ನಲವತ್ತೊಂಬತ್ತು',
+    'ಐವತ್ತು', 'ಐವತ್ತೊಂದು', 'ಐವತ್ತೆರಡು', 'ಐವತ್ತಮೂರು', 'ಐವತ್ತನಾಲ್ಕು', 'ಐವತ್ತೈದು', 'ಐವತ್ತಾರು', 'ಐವತ್ತೇಳು', 'ಐವತ್ತೆಂಟು', 'ಐವತ್ತೊಂಬತ್ತು',
+    'ಅರವತ್ತು', 'ಅರವತ್ತೊಂದು', 'ಅರವತ್ತೆರಡು', 'ಅರವತ್ತಮೂರು', 'ಅರವತ್ತನಾಲ್ಕು', 'ಅರವತ್ತೈದು', 'ಅರವತ್ತಾರು', 'ಅರವತ್ತೇಳು', 'ಅರವತ್ತೆಂಟು', 'ಅರವತ್ತೊಂಬತ್ತು',
+    'ಎಪ್ಪತ್ತು', 'ಎಪ್ಪತ್ತೊಂದು', 'ಎಪ್ಪತ್ತೆರಡು', 'ಎಪ್ಪತ್ತಮೂರು', 'ಎಪ್ಪತ್ತನಾಲ್ಕು', 'ಎಪ್ಪತ್ತೈದು', 'ಎಪ್ಪತ್ತಾರು', 'ಎಪ್ಪತ್ತೇಳು', 'ಎಪ್ಪತ್ತೆಂಟು', 'ಎಪ್ಪತ್ತೊಂಬತ್ತು',
+    'ಎಂಬತ್ತು', 'ಎಂಬತ್ತೊಂದು', 'ಎಂಬತ್ತೆರಡು', 'ಎಂಬತ್ತಮೂರು', 'ಎಂಬತ್ತನಾಲ್ಕು', 'ಎಂಬತ್ತೈದು', 'ಎಂಬತ್ತಾರು', 'ಎಂಬತ್ತೇಳು', 'ಎಂಬತ್ತೆಂಟು', 'ಎಂಬತ್ತೊಂಬತ್ತು',
+    'ತೊಂಬತ್ತು', 'ತೊಂಬತ್ತೊಂದು', 'ತೊಂಬತ್ತೆರಡು', 'ತೊಂಬತ್ತಮೂರು', 'ತೊಂಬತ್ತನಾಲ್ಕು', 'ತೊಂಬತ್ತೈದು', 'ತೊಂಬತ್ತಾರು', 'ತೊಂಬತ್ತೇಳು', 'ತೊಂಬತ್ತೆಂಟು', 'ತೊಂಬತ್ತೊಂಬತ್ತು'
+  ]
+
+  /**
+   * Scale words for powers of ten in Indian numbering system.
+   * Index 0 = units, 1 = thousand, 2 = lakh, 3 = crore, etc.
+   * @type {string[]}
+   */
+  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)
+  ]
+
+  /**
+   * Converts numbers using the belowHundred array directly.
+   */
+}
+
+/**
+ * Converts a number to its word representation in Kannada.
+ * @param {number|string|bigint} value - The number to convert
+ * @param {Object} [options={}] - Conversion options
+ * @returns {string} The word representation of the number
+ * @example
+ * convertToWords(42) // 'ನಲವತ್ತೆರಡು'
+ * convertToWords(1000) // 'ಒಂದು ಸಾವಿರ'
+ * convertToWords(100000) // 'ಒಂದು ಲಕ್ಷ'
+ */
+export default function convertToWords (value, options = {}) {
+  return new KannadaLanguage(options).convertToWords(value)
+}

package/lib/languages/ko.js

@@ -0,0 +1,83 @@
+import GreedyScaleLanguage from '../classes/greedy-scale-language.js'
+
+/**
+ * Korean language converter.
+ *
+ * Features:
+ * - Space-separated for large numbers (>= 만/10,000)
+ * - Concatenated for smaller numbers
+ * - Omits '일' (1) before multipliers
+ */
+export class Korean extends GreedyScaleLanguage {
+  negativeWord = '마이너스'
+  decimalSeparatorWord = '점'
+  zeroWord = '영'
+  scaleWordPairs = [
+    [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, '영']
+  ]
+
+  /**
+   * Merges two adjacent word-number pairs according to Korean grammar rules.
+   *
+   * Korean-specific rules:
+   * - Omits '일' (1) before multipliers <= 만 (10,000)
+   * - Concatenates without space for small numbers (< 만)
+   * - Separates with space for large numbers (>= 만)
+   * - Multiplies when right > left, adds when left > right
+   *
+   * @param {Object} leftPair The left operand as `{ word: number }`.
+   * @param {Object} rightPair The right operand as `{ word: number }`.
+   * @returns {Object} Merged pair with combined word and resulting number.
+   */
+  mergeScales (leftPair, rightPair) {
+    const leftWord = Object.keys(leftPair)[0]
+    const rightWord = Object.keys(rightPair)[0]
+    const leftNumber = Object.values(leftPair)[0] // BigInt
+    const rightNumber = Object.values(rightPair)[0] // BigInt
+
+    // Implicit "일": omit 1 before multipliers up to 만 (10,000)
+    if (leftNumber === 1n && rightNumber <= 10_000n) return rightPair
+    // Concatenate (no space) for small numbers less than 만
+    if (leftNumber < 10_000n && leftNumber > rightNumber) return { [`${leftWord}${rightWord}`]: leftNumber + rightNumber }
+    // Space-separate for large numbers (>= 만) when adding
+    if (leftNumber >= 10_000n && leftNumber > rightNumber) return { [`${leftWord} ${rightWord}`]: leftNumber + rightNumber }
+    // Multiply for all scale combinations
+    return { [`${leftWord}${rightWord}`]: leftNumber * rightNumber }
+  }
+}
+
+/**
+ * Converts a number to Korean cardinal (written) form.
+ *
+ * @param {number|string|bigint} value The number to convert.
+ * @param {Object} [options] Conversion options (see Korean class options).
+ * @returns {string} The number expressed in Korean words.
+ * @throws {TypeError} If value is NaN or invalid type.
+ * @throws {Error} If value is an invalid number string.
+ *
+ * @example
+ * convertToWords(42); // '사십이'
+ * convertToWords(10001); // '만 일'
+ */
+export default function convertToWords (value, options = {}) {
+  return new Korean(options).convertToWords(value)
+}

package/lib/languages/lt.js

@@ -0,0 +1,171 @@
+import SlavicLanguage from '../classes/slavic-language.js'
+
+/**
+ * @typedef {Object} SlavicOptions
+ * @property {boolean} [feminine=false] Use feminine forms for numbers.
+ */
+
+/**
+ * Lithuanian language converter.
+ *
+ * Implements Lithuanian number words using the Slavic language pattern:
+ * - Lithuanian number words (vienas/viena, du/dvi, trys, keturi...)
+ * - Gender-aware forms (masculine/feminine)
+ * - Baltic three-form pluralization (tūkstantis/tūkstančiai/tūkstančių)
+ * - Lithuanian-specific declension patterns
+ *
+ * Key Features:
+ * - Three-form pluralization system shared across Slavic/Baltic languages
+ *   * Form 1 (singular): 1 (e.g., "tūkstantis")
+ *   * Form 2 (few): 2-4, 22-24, 32-34... excluding teens (e.g., "tūkstančiai")
+ *   * Form 3 (many): all other numbers (e.g., "tūkstančių")
+ * - Chunk-based decomposition (splits into groups of 3 digits: ones, thousands, millions, etc.)
+ * - Large number handling via thousands[] array with indexed [singular, few, many] forms
+ * - Gender-specific number forms for 1 and 2 (masculine/feminine dual forms)
+ *
+ * Features:
+ * - Dual gender forms (vienas/viena, du/dvi, keturi/keturios)
+ * - Complex declension patterns for large numbers
+ * - Baltic language characteristics
+ *
+ * Inherits from SlavicLanguage as Lithuanian uses similar pluralization.
+ */
+export class Lithuanian extends SlavicLanguage {
+  negativeWord = 'minus'
+  decimalSeparatorWord = 'kablelis'
+  zeroWord = 'nulis'
+  ones = {
+    1: 'vienas',
+    2: 'du',
+    3: 'trys',
+    4: 'keturi',
+    5: 'penki',
+    6: 'šeši',
+    7: 'septyni',
+    8: 'aštuoni',
+    9: 'devyni'
+  }
+
+  onesFeminine = {
+    1: 'viena',
+    2: 'dvi',
+    3: 'trys',
+    4: 'keturios',
+    5: 'penkios',
+    6: 'šešios',
+    7: 'septynios',
+    8: 'aštuonios',
+    9: 'devynios'
+  }
+
+  tens = {
+    0: 'dešimt',
+    1: 'vienuolika',
+    2: 'dvylika',
+    3: 'trylika',
+    4: 'keturiolika',
+    5: 'penkiolika',
+    6: 'šešiolika',
+    7: 'septyniolika',
+    8: 'aštuoniolika',
+    9: 'devyniolika'
+  }
+
+  twenties = {
+    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'
+  }
+
+  hundreds = ['šimtas', 'šimtai']
+
+  thousands = {
+    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]
+    }
+
+    const [n1, n2] = this.getDigits(n)
+
+    if (n2 === 1n || n1 === 0n) {
+      return forms[2]
+    }
+
+    if (n1 === 1n) {
+      return forms[0]
+    }
+
+    return forms[1]
+  }
+
+  convertWholePart (number) {
+    if (number === 0n) {
+      return this.zeroWord
+    }
+    const words = []
+    const chunks = this.splitByX(number.toString(), 3)
+    let index = chunks.length
+    for (const x of chunks) {
+      index = index - 1
+      if (x === 0n) {
+        continue
+      }
+      const [n1, n2, n3] = this.getDigits(x)
+      if (n3 > 0n) {
+        words.push(this.ones[n3])
+        if (n3 > 1n) {
+          words.push(this.hundreds[1])
+        } else {
+          words.push(this.hundreds[0])
+        }
+      }
+      if (n2 > 1n) {
+        words.push(this.twenties[n2])
+      }
+      if (n2 === 1n) {
+        words.push(this.tens[n1])
+      } else if (n1 > 0n) {
+        if ((index === 1 || (this.feminine && index === 0)) && number < 1000n) {
+          words.push(this.onesFeminine[n1])
+        } else {
+          words.push(this.ones[n1])
+        }
+      }
+      if (index > 0) {
+        words.push(this.pluralize(x, this.thousands[index]))
+      }
+    }
+    return words.join(' ')
+  }
+}
+
+/**
+ * Converts a number to Lithuanian cardinal (written) form.
+ *
+ * @param {number|string|bigint} value The number to convert.
+ * @param {Object} [options={}] Configuration options.
+ * @param {boolean} [options.feminine=false] Use feminine forms for numbers.
+ * @returns {string} The number expressed in Lithuanian words.
+ * @throws {TypeError} If value is NaN or invalid type.
+ * @throws {Error} If value is an invalid number string.
+ */
+export default function convertToWords (value, options = {}) {
+  return new Lithuanian(options).convertToWords(value)
+}

package/lib/languages/lv.js

@@ -0,0 +1,153 @@
+import SlavicLanguage from '../classes/slavic-language.js'
+
+/**
+ * @typedef {Object} SlavicOptions
+ * @property {boolean} [feminine=false] Use feminine forms for numbers.
+ */
+
+/**
+ * Latvian language converter.
+ *
+ * Implements Latvian number words using the Slavic language pattern:
+ * - Latvian number words (viens, divi, trīs, četri, pieci...)
+ * - Latvian-specific pluralization patterns
+ * - Baltic grammatical structure
+ * - Simplified gender handling compared to Lithuanian
+ *
+ * Key Features:
+ * - Three-form pluralization system shared across Slavic/Baltic languages
+ *   * Form 1 (singular): 1 (e.g., "tūkstotis")
+ *   * Form 2 (few): 2-4, 22-24, 32-34... excluding teens (e.g., "tūkstoši")
+ *   * Form 3 (many): all other numbers (e.g., "tūkstošu")
+ * - Chunk-based decomposition (splits into groups of 3 digits: ones, thousands, millions, etc.)
+ * - Large number handling via thousands[] array with indexed [singular, few, many] forms
+ *
+ * Features:
+ * - Latvian diacritical marks (ī, ā, ē, ū, etc.)
+ * - Three-form pluralization (adapted for Latvian)
+ * - Baltic number naming conventions
+ * - Compound number formation (divdesmit, trīsdesmit)
+ *
+ * Inherits from SlavicLanguage for pluralization algorithms.
+ */
+export class Latvian extends SlavicLanguage {
+  negativeWord = 'mīnus'
+  decimalSeparatorWord = 'komats'
+  zeroWord = 'nulle'
+  ones = {
+    1: 'viens',
+    2: 'divi',
+    3: 'trīs',
+    4: 'četri',
+    5: 'pieci',
+    6: 'seši',
+    7: 'septiņi',
+    8: 'astoņi',
+    9: 'deviņi'
+  }
+
+  tens = {
+    0: 'desmit',
+    1: 'vienpadsmit',
+    2: 'divpadsmit',
+    3: 'trīspadsmit',
+    4: 'četrpadsmit',
+    5: 'piecpadsmit',
+    6: 'sešpadsmit',
+    7: 'septiņpadsmit',
+    8: 'astoņpadsmit',
+    9: 'deviņpadsmit'
+  }
+
+  twenties = {
+    2: 'divdesmit',
+    3: 'trīsdesmit',
+    4: 'četrdesmit',
+    5: 'piecdesmit',
+    6: 'sešdesmit',
+    7: 'septiņdesmit',
+    8: 'astoņdesmit',
+    9: 'deviņdesmit'
+  }
+
+  hundreds = ['simts', 'simti', 'simtu']
+
+  thousands = {
+    1: ['tūkstotis', 'tūkstoši', 'tūkstošu'],
+    2: ['miljons', 'miljoni', 'miljonu'],
+    3: ['miljards', 'miljardi', 'miljardu'],
+    4: ['triljons', 'triljoni', 'triljonu'],
+    5: ['kvadriljons', 'kvadriljoni', 'kvadriljonu'],
+    6: ['kvintiljons', 'kvintiljoni', 'kvintiljonu'],
+    7: ['sikstiljons', 'sikstiljoni', 'sikstiljonu'],
+    8: ['septiljons', 'septiljoni', 'septiljonu'],
+    9: ['oktiljons', 'oktiljoni', 'oktiljonu'],
+    10: ['nontiljons', 'nontiljoni', 'nontiljonu']
+  }
+
+  pluralize (n, forms) {
+    if (n === 0n) {
+      return forms[2]
+    }
+
+    const lastDigit = n % 10n
+    const lastTwoDigits = n % 100n
+
+    if (lastDigit === 1n && lastTwoDigits !== 11n) {
+      return forms[0]
+    }
+
+    return forms[1]
+  }
+
+  convertWholePart (number) {
+    if (number === 0n) {
+      return this.zeroWord
+    }
+    const words = []
+    const chunks = this.splitByX(number.toString(), 3)
+    let index = chunks.length
+    for (const x of chunks) {
+      index = index - 1
+      if (x === 0n) {
+        continue
+      }
+      const [n1, n2, n3] = this.getDigits(x)
+      if (n3 > 0n) {
+        if (n3 === 1n && n2 === 0n && n1 > 0n) {
+          words.push(this.hundreds[2])
+        } else if (n3 > 1n) {
+          words.push(this.ones[n3], this.hundreds[1])
+        } else {
+          words.push(this.hundreds[0])
+        }
+      }
+      if (n2 > 1n) {
+        words.push(this.twenties[n2])
+      }
+      if (n2 === 1n) {
+        words.push(this.tens[n1])
+      } else if (n1 > 0n && !(index > 0 && x === 1n)) {
+        words.push(this.ones[n1])
+      }
+      if (index > 0) {
+        words.push(this.pluralize(x, this.thousands[index]))
+      }
+    }
+    return words.join(' ')
+  }
+}
+
+/**
+ * Converts a number to Latvian cardinal (written) form.
+ *
+ * @param {number|string|bigint} value The number to convert.
+ * @param {Object} [options={}] Configuration options.
+ * @param {boolean} [options.feminine=false] Use feminine forms for numbers.
+ * @returns {string} The number expressed in Latvian words.
+ * @throws {TypeError} If value is NaN or invalid type.
+ * @throws {Error} If value is an invalid number string.
+ */
+export default function convertToWords (value, options = {}) {
+  return new Latvian(options).convertToWords(value)
+}

package/lib/languages/mr.js

@@ -0,0 +1,156 @@
+/**
+ * Marathi language implementation for n2words
+ *
+ * Marathi uses Indian-style number grouping (3 digits, then 2-2 from right).
+ * Numbers: शून्य (0), एक (1), दोन (2), तीन (3), चार (4), पाच (5)...
+ *
+ * @module lib/languages/mr
+ * @example
+ * import mr from './lib/languages/mr.js'
+ * mr(42) // 'बेचाळीस'
+ * mr(1000) // 'एक हजार'
+ */
+
+import SouthAsianLanguage from '../classes/south-asian-language.js'
+
+/**
+ * Marathi language implementation
+ * Extends SouthAsianLanguage for Indian-style grouping
+ */
+class MarathiLanguage extends SouthAsianLanguage {
+  negativeWord = 'उणे'
+  decimalSeparatorWord = 'दशांश'
+  zeroWord = 'शून्य'
+  hundredWord = 'शंभर'
+  convertDecimalsPerDigit = true
+
+  belowHundred = [
+    'शून्य',
+    'एक',
+    'दोन',
+    'तीन',
+    'चार',
+    'पाच',
+    'सहा',
+    'सात',
+    'आठ',
+    'नऊ',
+    'दहा',
+    'अकरा',
+    'बारा',
+    'तेरा',
+    'चौदा',
+    'पंधरा',
+    'सोळा',
+    'सतरा',
+    'अठरा',
+    'एकोणीस',
+    'वीस',
+    'एकवीस',
+    'बावीस',
+    'तेवीस',
+    'चोवीस',
+    'पंचवीस',
+    'सव्वीस',
+    'सत्तावीस',
+    'अठ्ठावीस',
+    'एकोणतीस',
+    'तीस',
+    'एकतीस',
+    'बत्तीस',
+    'तेहेतीस',
+    'चौतीस',
+    'पस्तीस',
+    'छत्तीस',
+    'सदतीस',
+    'अडतीस',
+    'एकोणचाळीस',
+    'चाळीस',
+    'एकेचाळीस',
+    'बेचाळीस',
+    'त्रेचाळीस',
+    'चव्वेचाळीस',
+    'पंचेचाळीस',
+    'सेहेचाळीस',
+    'सत्तेचाळीस',
+    'अठ्ठेचाळीस',
+    'एकोणपन्नास',
+    'पन्नास',
+    'एक्काव्वन',
+    'बावन्न',
+    'त्रेपन्न',
+    'चोपन्न',
+    'पंचाव्वन',
+    'छप्पन्न',
+    'सत्तावन्न',
+    'अठ्ठावन्न',
+    'एकोणसाठ',
+    'साठ',
+    'एकसष्ठ',
+    'बासष्ठ',
+    'त्रेसष्ठ',
+    'चौसष्ठ',
+    'पासष्ठ',
+    'सहासष्ठ',
+    'सदुसष्ठ',
+    'अडुसष्ठ',
+    'एकोणसत्तर',
+    'सत्तर',
+    'एकाहत्तर',
+    'बाहत्तर',
+    'त्र्याहत्तर',
+    'चौऱ्याहत्तर',
+    'पंच्याहत्तर',
+    'शहात्तर',
+    'सत्याहत्तर',
+    'अठ्ठ्याहत्तर',
+    'एकोणऐंशी',
+    'ऐंशी',
+    'एक्याऐंशी',
+    'ब्याऐंशी',
+    'त्र्याऐंशी',
+    'चौऱ्याऐंशी',
+    'पंच्याऐंशी',
+    'शहाऐंशी',
+    'सत्याऐंशी',
+    'अठ्ठ्याऐंशी',
+    'एकोणनव्वद',
+    'नव्वद',
+    'एक्याण्णव',
+    'ब्याण्णव',
+    'त्र्याण्णव',
+    'चौऱ्याण्णव',
+    'पंच्याण्णव',
+    'शहाण्णव',
+    'सत्याण्णव',
+    'अठ्ठ्याण्णव',
+    'नव्याण्णव'
+  ]
+
+  scaleWords = [
+    '',
+    'हजार',
+    'लाख',
+    'कोटी',
+    'अब्ज',
+    'खर्व',
+    'निखर्व',
+    'महापद्म',
+    'शंकू'
+  ]
+}
+
+/**
+ * Convert a number to Marathi words
+ *
+ * @param {number|string|bigint} value - The number to convert
+ * @param {Object} [options={}] - Conversion options
+ * @returns {string} The Marathi word representation
+ * @example
+ * convertToWords(42) // 'बेचाळीस'
+ * convertToWords(1000) // 'एक हजार'
+ * convertToWords(100000) // 'एक लाख'
+ */
+export default function convertToWords (value, options = {}) {
+  return new MarathiLanguage(options).convertToWords(value)
+}