n2words 3.0.0 → 4.0.0

package/lib/languages/mr.js

@@ -1,137 +0,0 @@
-/**
- * Marathi language converter - Functional Implementation
- *
- * Self-contained converter for South Asian numbering.
- *
- * 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
- * - 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 Splitting (inlined for performance)
-// ============================================================================
-
-function groupByThreeThenTwos (n) {
-  const numStr = n.toString()
-  if (numStr.length <= 3) return [Number(numStr)]
-
-  const segments = []
-  segments.unshift(Number(numStr.slice(-3)))
-
-  let remaining = numStr.slice(0, -3)
-  while (remaining.length > 0) {
-    segments.unshift(Number(remaining.slice(-2)))
-    remaining = remaining.slice(0, -2)
-  }
-
-  return segments
-}
-
-function segmentToWords (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
-// ============================================================================
-
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  const segments = groupByThreeThenTwos(n)
-  const segmentCount = segments.length
-  const words = []
-
-  for (let i = 0; i < segmentCount; i++) {
-    const segmentValue = segments[i]
-    if (segmentValue === 0) continue
-
-    const scaleIndex = segmentCount - i - 1
-    words.push(segmentToWords(segmentValue))
-    if (scaleIndex > 0 && SCALE_WORDS[scaleIndex]) {
-      words.push(SCALE_WORDS[scaleIndex])
-    }
-  }
-
-  return words.join(' ').trim()
-}
-
-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 Marathi words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Marathi 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/ms.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Malay words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Malay words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/nb.d.ts

@@ -1,14 +0,0 @@
-/**
- * Converts a numeric value to Norwegian Bokmål words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Norwegian words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(21)       // 'tjue-en'
- * toWords(101)      // 'en hundre og en'
- * toWords(1000000)  // 'en million'
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/nl.d.ts

@@ -1,26 +0,0 @@
-/**
- * Converts a numeric value to Dutch words.
- *
- * This is the main public API. It accepts any valid numeric input
- * (number, string, or bigint) and handles parsing internally.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @param {Object} [options] - Optional configuration
- * @param {boolean} [options.accentOne=true] - Use "één" instead of "een"
- * @param {boolean} [options.includeOptionalAnd=false] - Include "en" before small numbers
- * @param {boolean} [options.noHundredPairing=false] - Disable hundred pairing (1104→duizend honderdvier)
- * @returns {string} The number in Dutch words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(21)                        // 'eenentwintig'
- * toWords(1)                         // 'één'
- * toWords(1, {accentOne: false})     // 'een'
- * toWords(1104)                      // 'elfhonderd vier'
- */
-export function toWords(value: number | string | bigint, options?: {
-    accentOne?: boolean | undefined;
-    includeOptionalAnd?: boolean | undefined;
-    noHundredPairing?: boolean | undefined;
-}): string;

package/lib/languages/pa.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Punjabi words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Punjabi words
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/pa.js

@@ -1,163 +0,0 @@
-/**
- * Punjabi language converter - Functional Implementation
- *
- * Self-contained converter for South Asian numbering.
- *
- * Key features:
- * - Indian numbering system (ਹਜ਼ਾਰ, ਲੱਖ, ਕਰੋੜ)
- * - Gurmukhi script
- * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
- * - Complete word forms for 0-99
- */
-
-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 = ['', 'ਹਜ਼ਾਰ', 'ਲੱਖ', 'ਕਰੋੜ', 'ਅਰਬ', 'ਖਰਬ', 'ਨੀਲ', 'ਪਦਮ', 'ਸ਼ੰਖ']
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-/**
- * Converts 0-999 to Punjabi words.
- */
-function segmentToWords (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]
-}
-
-/**
- * Converts a non-negative integer to Punjabi words.
- * Uses recursive approach for Indian 3-2-2 grouping pattern.
- *
- * @param {bigint} n - Non-negative integer to convert
- * @returns {string} Punjabi words
- */
-function integerToWords (n) {
-  if (n === 0n) return ZERO
-
-  // Fast path: numbers < 1000 (direct lookup)
-  if (n < 1000n) {
-    return segmentToWords(Number(n))
-  }
-
-  return buildLargeNumberWords(n, 0)
-}
-
-/**
- * Recursively builds words for numbers >= 1000.
- * Indian grouping: first 3 digits, then 2-digit groups.
- *
- * @param {bigint} n - Number to convert
- * @param {number} scale - Current scale index (0=units, 1=thousands, etc.)
- * @returns {string} Punjabi words
- */
-function buildLargeNumberWords (n, scale) {
-  if (n === 0n) return ''
-
-  // Determine divisor: 1000 for first split, 100 for rest
-  const divisor = scale === 0 ? 1000n : 100n
-  const segment = Number(n % divisor)
-  const rest = n / divisor
-
-  // Build higher segments first (recursive)
-  let result = ''
-  if (rest > 0n) {
-    result = buildLargeNumberWords(rest, scale + 1)
-  }
-
-  // Add current segment
-  if (segment > 0) {
-    if (result) result += ' '
-
-    if (scale === 0) {
-      // Units segment (0-999)
-      result += segmentToWords(segment)
-    } else {
-      // Scale segments (0-99)
-      result += BELOW_HUNDRED[segment] + ' ' + SCALE_WORDS[scale]
-    }
-  }
-
-  return result
-}
-
-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 Punjabi words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Punjabi 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/pl.d.ts

@@ -1,22 +0,0 @@
-/**
- * Converts a numeric value to Polish words.
- *
- * This is the main public API. It accepts any valid numeric input
- * (number, string, or bigint) and handles parsing internally.
- *
- * @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 Polish words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(1)                          // 'jeden'
- * toWords(1, { gender: 'feminine' })  // 'jedna'
- * toWords(1000)                       // 'tysiąc'
- * toWords(2000)                       // 'dwa tysiące'
- */
-export function toWords(value: number | string | bigint, options?: {
-    gender?: string | undefined;
-}): string;