n2words 3.1.0 → 4.0.0

package/lib/languages/uk.js

@@ -1,224 +0,0 @@
-/**
- * Ukrainian language converter - Functional Implementation
- *
- * Self-contained module with its own input validation, ready for subpath exports.
- *
- * Key features:
- * - Three-form pluralization (one/few/many)
- * - Gender: thousands are feminine, millions+ are masculine
- * - Irregular hundreds
- * - Long scale naming
- */
-
-import { parseNumericValue } from '../utils/parse-numeric.js'
-import { validateOptions } from '../utils/validate-options.js'
-
-// ============================================================================
-// Vocabulary
-// ============================================================================
-
-const ONES_MASC = ['', 'один', 'два', 'три', 'чотири', 'п\'ять', 'шiсть', 'сiм', 'вiсiм', 'дев\'ять']
-const ONES_FEM = ['', 'одна', 'двi', 'три', 'чотири', 'п\'ять', 'шiсть', 'сiм', 'вiсiм', 'дев\'ять']
-
-const TEENS = ['десять', 'одинадцять', 'дванадцять', 'тринадцять', 'чотирнадцять', 'п\'ятнадцять', 'шiстнадцять', 'сiмнадцять', 'вiсiмнадцять', 'дев\'ятнадцять']
-const TENS = ['', '', 'двадцять', 'тридцять', 'сорок', 'п\'ятдесят', 'шiстдесят', 'сiмдесят', 'вiсiмдесят', 'дев\'яносто']
-
-// Irregular hundreds
-const HUNDREDS = ['', 'сто', 'двiстi', 'триста', 'чотириста', 'п\'ятсот', 'шiстсот', 'сiмсот', 'вiсiмсот', 'дев\'ятсот']
-
-const ZERO = 'нуль'
-const NEGATIVE = 'мiнус'
-const DECIMAL_SEP = 'кома'
-
-// Scale words: [singular, few, many]
-// Thousands (index 0) are feminine, rest are masculine
-const SCALE_FORMS = [
-  ['тисяча', 'тисячi', 'тисяч'],
-  ['мiльйон', 'мiльйони', 'мiльйонiв'],
-  ['мiльярд', 'мiльярди', 'мiльярдiв'],
-  ['трильйон', 'трильйони', 'трильйонiв'],
-  ['квадрильйон', 'квадрильйони', 'квадрильйонiв'],
-  ['квiнтильйон', 'квiнтильйони', 'квiнтильйонiв'],
-  ['секстильйон', 'секстильйони', 'секстильйонiв'],
-  ['септильйон', 'септильйони', 'септильйонiв'],
-  ['октильйон', 'октильйони', 'октильйонiв']
-]
-
-// ============================================================================
-// Segment Building
-// ============================================================================
-
-function pluralize (n, forms) {
-  const num = typeof n === 'bigint' ? Number(n) : n
-  const lastDigit = num % 10
-  const lastTwoDigits = num % 100
-
-  if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
-    return forms[2]
-  }
-
-  if (lastDigit === 1) return forms[0]
-  if (lastDigit >= 2 && lastDigit <= 4) return forms[1]
-  return forms[2]
-}
-
-function buildSegmentMasc (n) {
-  if (n === 0) return ''
-
-  const onesDigit = n % 10
-  const tensDigit = Math.floor(n / 10) % 10
-  const hundredsDigit = Math.floor(n / 100)
-
-  const parts = []
-
-  if (hundredsDigit > 0) {
-    parts.push(HUNDREDS[hundredsDigit])
-  }
-
-  if (tensDigit > 1) {
-    parts.push(TENS[tensDigit])
-  }
-
-  if (tensDigit === 1) {
-    parts.push(TEENS[onesDigit])
-  } else if (onesDigit > 0) {
-    parts.push(ONES_MASC[onesDigit])
-  }
-
-  return parts.join(' ')
-}
-
-function buildSegmentFem (n) {
-  if (n === 0) return ''
-
-  const onesDigit = n % 10
-  const tensDigit = Math.floor(n / 10) % 10
-  const hundredsDigit = Math.floor(n / 100)
-
-  const parts = []
-
-  if (hundredsDigit > 0) {
-    parts.push(HUNDREDS[hundredsDigit])
-  }
-
-  if (tensDigit > 1) {
-    parts.push(TENS[tensDigit])
-  }
-
-  if (tensDigit === 1) {
-    parts.push(TEENS[onesDigit])
-  } else if (onesDigit > 0) {
-    parts.push(ONES_FEM[onesDigit])
-  }
-
-  return parts.join(' ')
-}
-
-// ============================================================================
-// Conversion Functions
-// ============================================================================
-
-function integerToWords (n, options = {}) {
-  if (n === 0n) return ZERO
-
-  if (n < 1000n) {
-    return options.gender === 'feminine' ? buildSegmentFem(Number(n)) : buildSegmentMasc(Number(n))
-  }
-
-  return buildLargeNumberWords(n, options)
-}
-
-function buildLargeNumberWords (n, options) {
-  const numStr = n.toString()
-  const len = numStr.length
-
-  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
-  }
-
-  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) {
-        parts.push(options.gender === 'feminine' ? buildSegmentFem(segment) : buildSegmentMasc(segment))
-      } else {
-        const scaleForms = SCALE_FORMS[scaleIndex - 1]
-        const scaleWord = pluralize(segment, scaleForms)
-        // Thousands (scaleIndex=1) are feminine, others masculine
-        const isFeminine = scaleIndex === 1
-        const segmentWord = isFeminine ? buildSegmentFem(segment) : buildSegmentMasc(segment)
-        parts.push(segmentWord + ' ' + scaleWord)
-      }
-    }
-
-    scaleIndex--
-  }
-
-  return parts.join(' ')
-}
-
-function decimalPartToWords (decimalPart, options) {
-  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), options)
-  }
-
-  return result
-}
-
-/**
- * Converts a numeric value to Ukrainian words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @param {Object} [options] - Optional configuration
- * @param {('masculine'|'feminine')} [options.gender='masculine'] - Grammatical gender
- * @returns {string} The number in Ukrainian words
- */
-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
-}
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export { toWords }

package/lib/languages/ur.d.ts

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

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/yo.d.ts

@@ -1,7 +0,0 @@
-/**
- * Converts a numeric value to Yoruba words.
- *
- * @param {number | string | bigint} value - The numeric value to convert
- * @returns {string} The number in Yoruba words
- */
-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,55 +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 ka } from './languages/ka.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 yo } from './languages/yo.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, ka, kn, ko, lt, lv, mr, ms, nb, nl, pa, pl, pt, ro, ru, srCyrl, srLatn, sv, sw, ta, te, th, tr, uk, ur, vi, yo, zhHans, zhHant };

package/lib/n2words.js

@@ -1,126 +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 ka } from './languages/ka.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 yo } from './languages/yo.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,
-  ka,
-  kn,
-  ko,
-  lt,
-  lv,
-  mr,
-  ms,
-  nb,
-  nl,
-  pa,
-  pl,
-  pt,
-  ro,
-  ru,
-  srCyrl,
-  srLatn,
-  sv,
-  sw,
-  ta,
-  te,
-  th,
-  tr,
-  uk,
-  ur,
-  vi,
-  yo,
-  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;
-};