n2words 2.0.0 → 3.1.0

package/lib/languages/bn.js

@@ -1,131 +1,166 @@
-import { SouthAsianLanguage } from '../classes/south-asian-language.js'
-
 /**
- * Bangla language converter.
+ * Bangla language converter - Functional Implementation
+ *
+ * Self-contained module with its own input validation, ready for subpath exports.
  *
- * Supports:
+ * Key features:
  * - Indian numbering system (হাজার, লাখ, কোটি)
  * - Bangla script (Bengali)
+ * - 3-2-2 grouping pattern (last 3 digits, then groups of 2)
  * - Complete word forms for 0-99
  */
-export class Bangla extends SouthAsianLanguage {
-  negativeWord = 'মাইনাস'
-  decimalSeparatorWord = 'দশমিক'
-  zeroWord = 'শূন্য'
-  hundredWord = 'শত'
-
-  belowHundredWords = [
-    'শূন্য',
-    'এক',
-    'দুই',
-    'তিন',
-    'চার',
-    'পাঁচ',
-    'ছয়',
-    'সাত',
-    'আট',
-    'নয়',
-    'দশ',
-    'এগারো',
-    'বারো',
-    'তেরো',
-    'চৌদ্দ',
-    'পনেরো',
-    'ষোল',
-    'সতেরো',
-    'আঠারো',
-    'উনিশ',
-    'বিশ',
-    'একুশ',
-    'বাইশ',
-    'তেইশ',
-    'চব্বিশ',
-    'পঁচিশ',
-    'ছাব্বিশ',
-    'সাতাশ',
-    'আঠাশ',
-    'উনত্রিশ',
-    'ত্রিশ',
-    'একত্রিশ',
-    'বত্রিশ',
-    'তেত্রিশ',
-    'চৌত্রিশ',
-    'পঁয়ত্রিশ',
-    'ছত্রিশ',
-    'সাঁইত্রিশ',
-    'আটত্রিশ',
-    'উনচল্লিশ',
-    'চল্লিশ',
-    'একচল্লিশ',
-    'বেয়াল্লিশ',
-    'তেতাল্লিশ',
-    'চুয়াল্লিশ',
-    'পঁয়তাল্লিশ',
-    'ছেচল্লিশ',
-    'সাতচল্লিশ',
-    'আটচল্লিশ',
-    'উনপঞ্চাশ',
-    'পঞ্চাশ',
-    'একান্ন',
-    'বাহান্ন',
-    'তিপ্পান্ন',
-    'চুয়ান্ন',
-    'পঞ্চান্ন',
-    'ছাপ্পান্ন',
-    'সাতান্ন',
-    'আটান্ন',
-    'উনষাট',
-    'ষাট',
-    'একষট্টি',
-    'বাষট্টি',
-    'তেষট্টি',
-    'চৌষট্টি',
-    'পঁয়ষট্টি',
-    'ছেষট্টি',
-    'সাতষট্টি',
-    'আটষট্টি',
-    'ঊনসত্তর',
-    'সত্তর',
-    'একাত্তর',
-    'বাহাত্তর',
-    'তেহাত্তর',
-    'চুয়াত্তর',
-    'পঁচাত্তর',
-    'ছিয়াত্তর',
-    'সাতাত্তর',
-    'আটাত্তর',
-    'উনআশি',
-    'আশি',
-    'একাশি',
-    'বিরাশি',
-    'তিরাশি',
-    'চুরাশি',
-    'পঁচাশি',
-    'ছিয়াশি',
-    'সাতাশি',
-    'আটাশি',
-    'উননব্বই',
-    'নব্বই',
-    'একানব্বই',
-    'বিরানব্বই',
-    'তিরানব্বই',
-    'চুরানব্বই',
-    'পঁচানব্বই',
-    'ছিয়ানব্বই',
-    'সাতানব্বই',
-    'আটানব্বই',
-    'নিরানব্বই'
-  ]
-
-  scaleWords = [
-    '',
-    'হাজার',
-    'লাখ',
-    'কোটি',
-    'আরব',
-    'খরব',
-    'নীল',
-    'পদ্ম',
-    'শঙ্খ'
-  ]
+
+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.
+ */
+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 Bengali 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} Bengali 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
+  // First segment is 3 digits (thousands), rest are 2 digits (lakhs, crores, etc.)
+  // Segments stored least-significant first
+  const segments = []
+
+  // First segment: last 3 digits
+  segments.push(Number(n % 1000n))
+  let temp = n / 1000n
+
+  // Remaining segments: 2 digits each (lakh = 100k, crore = 10M, etc.)
+  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) {
+      // First segment (units place) can be 0-999
+      words.push(buildSegment(segment))
+    } else {
+      // Other segments are 0-99
+      words.push(BELOW_HUNDRED[segment])
+    }
+
+    // Add scale word if not the units segment
+    if (i > 0 && SCALE_WORDS[i]) {
+      words.push(SCALE_WORDS[i])
+    }
+  }
+
+  return words.join(' ')
+}
+
+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 Bengali words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert
+ * @returns {string} The number in Bengali 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/cs.d.ts

@@ -1,88 +1,18 @@
 /**
- * Czech language converter.
+ * Converts a numeric value to Czech words.
  *
- * Supports:
- * - Three-form pluralization (one/few/many)
- * - Dynamic decimal separator (celá/celé/celých)
- * - Gender agreement in number 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 Czech words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toWords(21)           // 'dvacet jedna'
+ * toWords(1000)         // 'tisíc'
+ * toWords(2000)         // 'dva tisíce'
+ * toWords(5000)         // 'pět tisíc'
  */
-export class Czech extends SlavicLanguage {
-    constructor(options?: {});
-    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: {
-        1: string;
-        2: string;
-        3: string;
-        4: string;
-        5: string;
-        6: string;
-        7: string;
-        8: string;
-        9: string;
-    };
-    pluralForms: {
-        1: string[];
-        2: string[];
-        3: string[];
-        4: string[];
-        5: string[];
-        6: string[];
-        7: string[];
-        8: string[];
-        9: string[];
-        10: string[];
-    };
-    /** Returns decimal separator word based on integer part (celá/celé/celých). */
-    get decimalSeparatorWord(): "celá" | "celé" | "celých";
-    /**
-     * Override toWords to cache integer part before decimal separator is accessed.
-     */
-    toWords(isNegative: any, integerPart: any, decimalPart: any): string;
-    /** Selects Czech plural form: 1 = singular, 2-4 = few, else = many. */
-    pluralize(n: any, forms: any): any;
-    #private;
-}
-import { SlavicLanguage } from '../classes/slavic-language.js';
+export function toWords(value: number | string | bigint): string;