n2words 3.1.0 → 4.0.0

package/{lib/languages/da.js → src/da-DK.js}

@@ -1,7 +1,7 @@
 /**
- * Danish language converter - Functional Implementation
+ * Danish (Denmark) language converter
  *
- * Self-contained module with its own input validation, ready for subpath exports.
+ * CLDR: da-DK | Danish as used in Denmark
  *
  * Key features:
  * - Vigesimal (base-20) tens naming: halvtreds (50), treds (60), etc.
@@ -11,7 +11,9 @@
  * - Long scale for millions+
  */
 
-import { parseNumericValue } from '../utils/parse-numeric.js'
+import { parseCardinalValue } from './utils/parse-cardinal.js'
+import { parseCurrencyValue } from './utils/parse-currency.js'
+import { parseOrdinalValue } from './utils/parse-ordinal.js'
 
 // ============================================================================
 // Vocabulary (module-level constants)
@@ -36,6 +38,35 @@ const DECIMAL_SEP = 'komma'
 // Long scale: millioner, millarder, billioner, etc.
 const SCALES = ['millioner', 'millarder', 'billioner', 'billarder', 'trillioner', 'trillarder', 'quadrillioner', 'quadrillarder']
 
+// ============================================================================
+// Ordinal Vocabulary
+// ============================================================================
+
+// Danish ordinals: 1st-2nd special, others use -te/-nde suffix
+// "anden/andet" for 2nd (common/neuter), we use common form
+const ORDINAL_SPECIAL = {
+  1: 'første',
+  2: 'anden',
+  3: 'tredje',
+  4: 'fjerde',
+  5: 'femte',
+  6: 'sjette',
+  7: 'syvende',
+  8: 'ottende',
+  9: 'niende',
+  10: 'tiende',
+  11: 'ellevte',
+  12: 'tolvte'
+}
+
+// ============================================================================
+// Currency Vocabulary (Danish Krone)
+// ============================================================================
+
+const KRONE = 'krone'
+const KRONER = 'kroner' // plural
+const ORE = 'øre' // same singular and plural
+
 // ============================================================================
 // Segment Building
 // ============================================================================
@@ -47,8 +78,8 @@ function buildSegment (n) {
   if (n === 0) return ''
 
   const ones = n % 10
-  const tens = Math.floor(n / 10) % 10
-  const hundreds = Math.floor(n / 100)
+  const tens = Math.trunc(n / 10) % 10
+  const hundreds = Math.trunc(n / 100)
 
   const parts = []
 
@@ -259,12 +290,12 @@ function decimalPartToWords (decimalPart) {
  * @throws {Error} If value is not a valid number format
  *
  * @example
- * toWords(21)       // 'enogtyve'
- * toWords(1000)     // 'ettusind'
- * toWords(1000000)  // 'en millioner'
+ * toCardinal(21)       // 'enogtyve'
+ * toCardinal(1000)     // 'ettusind'
+ * toCardinal(1000000)  // 'en millioner'
  */
-function toWords (value) {
-  const { isNegative, integerPart, decimalPart } = parseNumericValue(value)
+function toCardinal (value) {
+  const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
 
   let result = ''
 
@@ -281,8 +312,97 @@ function toWords (value) {
   return result
 }
 
+// ============================================================================
+// ORDINAL: toOrdinal(value)
+// ============================================================================
+
+/**
+ * Converts a non-negative integer to Danish ordinal words.
+ *
+ * Danish ordinals: første (1st), anden (2nd), tredje (3rd), etc.
+ * 1-12 have special forms, others use cardinal + -de/-nde suffix.
+ *
+ * @param {bigint} n - Positive integer to convert
+ * @returns {string} Danish ordinal words
+ */
+function integerToOrdinal (n) {
+  // Special forms for 1-12
+  if (n >= 1n && n <= 12n) {
+    return ORDINAL_SPECIAL[Number(n)]
+  }
+
+  // For numbers > 12, add -de suffix to cardinal
+  const cardinal = integerToWords(n)
+  return cardinal + 'de'
+}
+
+/**
+ * Converts a numeric value to Danish ordinal words.
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @returns {string} The number as ordinal words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {RangeError} If value is negative, zero, or has a decimal part
+ *
+ * @example
+ * toOrdinal(1)    // 'første'
+ * toOrdinal(2)    // 'anden'
+ * toOrdinal(21)   // 'enogtyvede'
+ */
+function toOrdinal (value) {
+  const integerPart = parseOrdinalValue(value)
+  return integerToOrdinal(integerPart)
+}
+
+// ============================================================================
+// CURRENCY: toCurrency(value)
+// ============================================================================
+
+/**
+ * Converts a numeric value to Danish currency words (Danish Krone).
+ *
+ * Uses krone/kroner and øre (100 øre = 1 krone).
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @returns {string} The amount in Danish currency words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toCurrency(1)      // 'en krone'
+ * toCurrency(42)     // 'toogfyrre kroner'
+ * toCurrency(1.50)   // 'en krone og halvtreds øre'
+ */
+function toCurrency (value) {
+  const { isNegative, dollars: kroner, cents: ore } = parseCurrencyValue(value)
+
+  let result = ''
+  if (isNegative) {
+    result = NEGATIVE + ' '
+  }
+
+  // Kroner part - use "en" for 1 krone
+  if (kroner > 0n || ore === 0n) {
+    if (kroner === 1n) {
+      result += 'en ' + KRONE
+    } else {
+      result += integerToWords(kroner) + ' ' + KRONER
+    }
+  }
+
+  // Øre part
+  if (ore > 0n) {
+    if (kroner > 0n) {
+      result += ' og '
+    }
+    result += integerToWords(ore) + ' ' + ORE
+  }
+
+  return result
+}
+
 // ============================================================================
 // Public API
 // ============================================================================
 
-export { toWords }
+export { toCardinal, toOrdinal, toCurrency }

package/src/de-DE.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Converts a numeric value to German 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 German words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toCardinal(21)           // 'einundzwanzig'
+ * toCardinal(1000)         // 'eintausend'
+ * toCardinal(1000000)      // 'eine Million'
+ */
+export function toCardinal(value: number | string | bigint): string;
+/**
+ * Converts a numeric value to German ordinal words.
+ *
+ * German ordinals add -te for 1-19 and -ste for 20+.
+ * Irregular forms: erste (1st), dritte (3rd), siebte (7th), achte (8th).
+ *
+ * @param {number | string | bigint} value - The numeric value to convert (positive integer)
+ * @returns {string} The number as ordinal words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {RangeError} If value is negative, zero, or has a decimal part
+ *
+ * @example
+ * toOrdinal(1)    // 'erste'
+ * toOrdinal(2)    // 'zweite'
+ * toOrdinal(3)    // 'dritte'
+ * toOrdinal(21)   // 'einundzwanzigste'
+ * toOrdinal(100)  // 'einhundertste'
+ * toOrdinal(1000) // 'eintausendste'
+ */
+export function toOrdinal(value: number | string | bigint): string;
+/**
+ * Converts a numeric value to German currency words (Euro).
+ *
+ * @param {number | string | bigint} value - The currency amount to convert
+ * @param {Object} [options] - Optional configuration
+ * @param {boolean} [options.and=true] - Use "und" between euros and cents
+ * @returns {string} The amount in German currency words
+ * @throws {TypeError} If value is not a valid numeric type
+ * @throws {Error} If value is not a valid number format
+ *
+ * @example
+ * toCurrency(42.50)                 // 'zweiundvierzig Euro und fünfzig Cent'
+ * toCurrency(1)                     // 'ein Euro'
+ * toCurrency(0.99)                  // 'neunundneunzig Cent'
+ * toCurrency(0.01)                  // 'ein Cent'
+ * toCurrency(42.50, { and: false }) // 'zweiundvierzig Euro fünfzig Cent'
+ */
+export function toCurrency(value: number | string | bigint, options?: {
+    and?: boolean | undefined;
+}): string;