n2words 3.0.0 → 4.0.0

package/lib/languages/ur.js

@@ -1,163 +0,0 @@
-/**
- * Urdu language converter - Functional Implementation
- *
- * Self-contained converter for South Asian numbering.
- *
- * Key features:
- * - Indian numbering system (ہزار, لاکھ, کروڑ)
- * - Urdu script (right-to-left)
- * - 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 Urdu 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 Urdu words.
- * Uses recursive approach for Indian 3-2-2 grouping pattern.
- *
- * @param {bigint} n - Non-negative integer to convert
- * @returns {string} Urdu 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} Urdu 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 Urdu words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Urdu 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/vi.d.ts

@@ -1,17 +0,0 @@
-/**
- * Converts a numeric value to Vietnamese 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
- * @returns {string} The number in Vietnamese words
- * @throws {TypeError} If value is not a valid numeric type
- * @throws {Error} If value is not a valid number format
- *
- * @example
- * toWords(42)           // 'bốn mươi hai'
- * toWords(101)          // 'một trăm lẻ một'
- * toWords(1000000)      // 'một triệu'
- */
-export function toWords(value: number | string | bigint): string;

package/lib/languages/zh-Hans.d.ts

@@ -1,11 +0,0 @@
-/**
- * Converts a numeric value to Simplified Chinese words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @param {Object} [options] - Optional configuration
- * @param {boolean} [options.formal=true] - Use formal/financial numerals
- * @returns {string} The number in Simplified Chinese words
- */
-export function toWords(value: number | string | bigint, options?: {
-    formal?: boolean | undefined;
-}): string;

package/lib/languages/zh-Hant.d.ts

@@ -1,11 +0,0 @@
-/**
- * Converts a numeric value to Traditional Chinese words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @param {Object} [options] - Optional configuration
- * @param {boolean} [options.formal=true] - Use formal/financial numerals
- * @returns {string} The number in Traditional Chinese words
- */
-export function toWords(value: number | string | bigint, options?: {
-    formal?: boolean | undefined;
-}): string;

package/lib/n2words.d.ts

@@ -1,53 +0,0 @@
-import { toWords as am } from './languages/am.js';
-import { toWords as amLatn } from './languages/am-Latn.js';
-import { toWords as ar } from './languages/ar.js';
-import { toWords as az } from './languages/az.js';
-import { toWords as bn } from './languages/bn.js';
-import { toWords as cs } from './languages/cs.js';
-import { toWords as da } from './languages/da.js';
-import { toWords as de } from './languages/de.js';
-import { toWords as el } from './languages/el.js';
-import { toWords as en } from './languages/en.js';
-import { toWords as es } from './languages/es.js';
-import { toWords as fa } from './languages/fa.js';
-import { toWords as fi } from './languages/fi.js';
-import { toWords as fil } from './languages/fil.js';
-import { toWords as fr } from './languages/fr.js';
-import { toWords as frBE } from './languages/fr-BE.js';
-import { toWords as gu } from './languages/gu.js';
-import { toWords as ha } from './languages/ha.js';
-import { toWords as hbo } from './languages/hbo.js';
-import { toWords as he } from './languages/he.js';
-import { toWords as hi } from './languages/hi.js';
-import { toWords as hr } from './languages/hr.js';
-import { toWords as hu } from './languages/hu.js';
-import { toWords as id } from './languages/id.js';
-import { toWords as it } from './languages/it.js';
-import { toWords as ja } from './languages/ja.js';
-import { toWords as kn } from './languages/kn.js';
-import { toWords as ko } from './languages/ko.js';
-import { toWords as lt } from './languages/lt.js';
-import { toWords as lv } from './languages/lv.js';
-import { toWords as mr } from './languages/mr.js';
-import { toWords as ms } from './languages/ms.js';
-import { toWords as nb } from './languages/nb.js';
-import { toWords as nl } from './languages/nl.js';
-import { toWords as pa } from './languages/pa.js';
-import { toWords as pl } from './languages/pl.js';
-import { toWords as pt } from './languages/pt.js';
-import { toWords as ro } from './languages/ro.js';
-import { toWords as ru } from './languages/ru.js';
-import { toWords as srCyrl } from './languages/sr-Cyrl.js';
-import { toWords as srLatn } from './languages/sr-Latn.js';
-import { toWords as sv } from './languages/sv.js';
-import { toWords as sw } from './languages/sw.js';
-import { toWords as ta } from './languages/ta.js';
-import { toWords as te } from './languages/te.js';
-import { toWords as th } from './languages/th.js';
-import { toWords as tr } from './languages/tr.js';
-import { toWords as uk } from './languages/uk.js';
-import { toWords as ur } from './languages/ur.js';
-import { toWords as vi } from './languages/vi.js';
-import { toWords as zhHans } from './languages/zh-Hans.js';
-import { toWords as zhHant } from './languages/zh-Hant.js';
-export { am, amLatn, ar, az, bn, cs, da, de, el, en, es, fa, fi, fil, fr, frBE, gu, ha, hbo, he, hi, hr, hu, id, it, ja, kn, ko, lt, lv, mr, ms, nb, nl, pa, pl, pt, ro, ru, srCyrl, srLatn, sv, sw, ta, te, th, tr, uk, ur, vi, zhHans, zhHant };

package/lib/n2words.js

@@ -1,122 +0,0 @@
-/**
- * n2words - Number to words converter
- *
- * This module re-exports all language converters as named exports.
- * Each export is a `toWords(value, options?)` function.
- *
- * Export names use normalized BCP 47 codes (hyphens → camelCase):
- * - `en`, `fr`, `de` (simple codes unchanged)
- * - `zhHans` (zh-Hans), `frBE` (fr-BE), `srCyrl` (sr-Cyrl)
- *
- * Imports and exports are alphabetically sorted by normalized name.
- *
- * @module n2words
- */
-
-import { toWords as am } from './languages/am.js'
-import { toWords as amLatn } from './languages/am-Latn.js'
-import { toWords as ar } from './languages/ar.js'
-import { toWords as az } from './languages/az.js'
-import { toWords as bn } from './languages/bn.js'
-import { toWords as cs } from './languages/cs.js'
-import { toWords as da } from './languages/da.js'
-import { toWords as de } from './languages/de.js'
-import { toWords as el } from './languages/el.js'
-import { toWords as en } from './languages/en.js'
-import { toWords as es } from './languages/es.js'
-import { toWords as fa } from './languages/fa.js'
-import { toWords as fi } from './languages/fi.js'
-import { toWords as fil } from './languages/fil.js'
-import { toWords as fr } from './languages/fr.js'
-import { toWords as frBE } from './languages/fr-BE.js'
-import { toWords as gu } from './languages/gu.js'
-import { toWords as ha } from './languages/ha.js'
-import { toWords as hbo } from './languages/hbo.js'
-import { toWords as he } from './languages/he.js'
-import { toWords as hi } from './languages/hi.js'
-import { toWords as hr } from './languages/hr.js'
-import { toWords as hu } from './languages/hu.js'
-import { toWords as id } from './languages/id.js'
-import { toWords as it } from './languages/it.js'
-import { toWords as ja } from './languages/ja.js'
-import { toWords as kn } from './languages/kn.js'
-import { toWords as ko } from './languages/ko.js'
-import { toWords as lt } from './languages/lt.js'
-import { toWords as lv } from './languages/lv.js'
-import { toWords as mr } from './languages/mr.js'
-import { toWords as ms } from './languages/ms.js'
-import { toWords as nb } from './languages/nb.js'
-import { toWords as nl } from './languages/nl.js'
-import { toWords as pa } from './languages/pa.js'
-import { toWords as pl } from './languages/pl.js'
-import { toWords as pt } from './languages/pt.js'
-import { toWords as ro } from './languages/ro.js'
-import { toWords as ru } from './languages/ru.js'
-import { toWords as srCyrl } from './languages/sr-Cyrl.js'
-import { toWords as srLatn } from './languages/sr-Latn.js'
-import { toWords as sv } from './languages/sv.js'
-import { toWords as sw } from './languages/sw.js'
-import { toWords as ta } from './languages/ta.js'
-import { toWords as te } from './languages/te.js'
-import { toWords as th } from './languages/th.js'
-import { toWords as tr } from './languages/tr.js'
-import { toWords as uk } from './languages/uk.js'
-import { toWords as ur } from './languages/ur.js'
-import { toWords as vi } from './languages/vi.js'
-import { toWords as zhHans } from './languages/zh-Hans.js'
-import { toWords as zhHant } from './languages/zh-Hant.js'
-
-export {
-  am,
-  amLatn,
-  ar,
-  az,
-  bn,
-  cs,
-  da,
-  de,
-  el,
-  en,
-  es,
-  fa,
-  fi,
-  fil,
-  fr,
-  frBE,
-  gu,
-  ha,
-  hbo,
-  he,
-  hi,
-  hr,
-  hu,
-  id,
-  it,
-  ja,
-  kn,
-  ko,
-  lt,
-  lv,
-  mr,
-  ms,
-  nb,
-  nl,
-  pa,
-  pl,
-  pt,
-  ro,
-  ru,
-  srCyrl,
-  srLatn,
-  sv,
-  sw,
-  ta,
-  te,
-  th,
-  tr,
-  uk,
-  ur,
-  vi,
-  zhHans,
-  zhHant
-}

package/lib/utils/parse-numeric.d.ts

@@ -1,17 +0,0 @@
-/**
- * Numeric value parsing utility.
- * Transforms user input (number, string, or bigint) into normalized components.
- * @module parse-numeric
- */
-/**
- * Parses a numeric value into its components.
- * @param {number|string|bigint} value
- * @returns {{isNegative: boolean, integerPart: bigint, decimalPart?: string}}
- * @throws {TypeError} If value is not number, string, or bigint
- * @throws {Error} If value is not a valid number format
- */
-export function parseNumericValue(value: number | string | bigint): {
-    isNegative: boolean;
-    integerPart: bigint;
-    decimalPart?: string;
-};