n2words 5.0.0 → 5.1.0

package/src/sw-KE.js

@@ -12,16 +12,24 @@
 import { parseCardinalValue } from './utils/parse-cardinal.js'
 import { parseCurrencyValue } from './utils/parse-currency.js'
 import { parseOrdinalValue } from './utils/parse-ordinal.js'
+import { checkMax } from './utils/check-max.js'
+import { western } from './utils/scale.js'
 
 // ============================================================================
 // Vocabulary
 // ============================================================================
 
 const ONES = ['sifuri', 'moja', 'mbili', 'tatu', 'nne', 'tano', 'sita', 'saba', 'nane', 'tisa']
+/** @type {Record<number, string>} */
 const TENS = { 10: 'kumi', 20: 'ishirini', 30: 'thelathini', 40: 'arobaini', 50: 'hamsini', 60: 'sitini', 70: 'sabini', 80: 'themanini', 90: 'tisini' }
 
 const SCALE_WORDS = ['', 'elfu', 'milioni', 'bilioni', 'trilioni', 'kwadrilioni', 'kwintilioni']
 
+// Supported magnitude ceiling (checked at the public entry points), derived from the scale table.
+export const cardinalMax = western(SCALE_WORDS.length - 1)
+export const ordinalMax = western(SCALE_WORDS.length - 1)
+export const currencyMax = western(SCALE_WORDS.length - 1)
+
 const ZERO = 'sifuri'
 const NEGATIVE = 'minus'
 const DECIMAL_SEP = 'nukta'
@@ -32,6 +40,7 @@ const DECIMAL_SEP = 'nukta'
 
 // Swahili ordinals use "wa" + cardinal: wa kwanza (1st), wa pili (2nd)
 // First few have special forms
+/** @type {Record<number, string>} */
 const ORDINAL_ONES = {
   1: 'wa kwanza',
   2: 'wa pili',
@@ -41,7 +50,7 @@ const ORDINAL_ONES = {
   6: 'wa sita',
   7: 'wa saba',
   8: 'wa nane',
-  9: 'wa tisa'
+  9: 'wa tisa',
 }
 const ORDINAL_PREFIX = 'wa'
 
@@ -56,7 +65,11 @@ const CENT = 'senti'
 // Conversion Functions
 // ============================================================================
 
-function wordsUnder100 (n) {
+/**
+ * @param {number} n The integer (0-99) to convert
+ * @returns {string} The number in Swahili words
+ */
+function wordsUnder100(n) {
   if (n < 10) return ONES[n]
   if (n === 10) return TENS[10]
   if (n < 20) {
@@ -69,7 +82,11 @@ function wordsUnder100 (n) {
   return TENS[tens] + ' na ' + ONES[ones]
 }
 
-function wordsUnder1000 (n) {
+/**
+ * @param {number} n The integer (0-999) to convert
+ * @returns {string} The number in Swahili words
+ */
+function wordsUnder1000(n) {
   if (n < 100) return wordsUnder100(n)
   if (n === 100) return 'mia moja'
   const hundreds = Math.trunc(n / 100)
@@ -81,7 +98,8 @@ function wordsUnder1000 (n) {
   if (rest > 0) {
     if (rest < 10) {
       parts.push('na ' + ONES[rest])
-    } else {
+    }
+    else {
       parts.push(wordsUnder100(rest))
     }
   }
@@ -89,7 +107,11 @@ function wordsUnder1000 (n) {
   return parts.join(' ')
 }
 
-function extractSegments (n) {
+/**
+ * @param {bigint} n The integer to split into 3-digit segments
+ * @returns {number[]} The segments, least-significant first
+ */
+function extractSegments(n) {
   const segments = []
   let temp = n
   while (temp > 0n) {
@@ -99,7 +121,11 @@ function extractSegments (n) {
   return segments
 }
 
-function integerToWords (n) {
+/**
+ * @param {bigint} n The integer to convert
+ * @returns {string} The number in Swahili words
+ */
+function integerToWords(n) {
   if (n === 0n) return ZERO
 
   // segments stored least-significant first: [ones, thousands, millions, ...]
@@ -115,13 +141,16 @@ function integerToWords (n) {
       // Units segment
       if (val < 10 && parts.length > 0) {
         parts.push('na ' + ONES[val])
-      } else if (val === 100 && parts.length > 0) {
+      }
+      else if (val === 100 && parts.length > 0) {
         // In compound numbers (e.g., 1100 -> 'elfu moja mia'), use 'mia' not 'mia moja'
         parts.push('mia')
-      } else {
+      }
+      else {
         parts.push(wordsUnder1000(val))
       }
-    } else {
+    }
+    else {
       // Scale segments: 'elfu moja', 'milioni mbili'
       const unit = (val === 1) ? 'moja' : wordsUnder1000(val)
       parts.push(SCALE_WORDS[scaleIndex] + ' ' + unit)
@@ -131,7 +160,11 @@ function integerToWords (n) {
   return parts.join(' ').trim()
 }
 
-function decimalPartToWords (decimalPart) {
+/**
+ * @param {string} decimalPart The digits after the decimal point
+ * @returns {string} The decimal digits in Swahili words
+ */
+function decimalPartToWords(decimalPart) {
   let result = ''
   let i = 0
 
@@ -152,12 +185,12 @@ function decimalPartToWords (decimalPart) {
 
 /**
  * Converts a numeric value to Swahili words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Swahili words
  */
-function toCardinal (value) {
+function toCardinal(value) {
   const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
+  checkMax(integerPart, cardinalMax, decimalPart)
 
   let result = ''
 
@@ -182,11 +215,10 @@ function toCardinal (value) {
  * Converts a non-negative integer to Swahili ordinal words.
  *
  * Swahili ordinals: wa kwanza (1st), wa pili (2nd), wa tatu (3rd), etc.
- *
  * @param {bigint} n - Positive integer to convert
  * @returns {string} Swahili ordinal words
  */
-function integerToOrdinal (n) {
+function integerToOrdinal(n) {
   // Special forms for 1-9
   if (n >= 1n && n <= 9n) {
     return ORDINAL_ONES[Number(n)]
@@ -198,19 +230,18 @@ function integerToOrdinal (n) {
 
 /**
  * Converts a numeric value to Swahili 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)    // 'wa kwanza'
  * toOrdinal(2)    // 'wa pili'
  * toOrdinal(10)   // 'wa kumi'
  */
-function toOrdinal (value) {
+function toOrdinal(value) {
   const integerPart = parseOrdinalValue(value)
+  checkMax(integerPart, ordinalMax)
   return integerToOrdinal(integerPart)
 }
 
@@ -222,19 +253,18 @@ function toOrdinal (value) {
  * Converts a numeric value to Swahili currency words (Kenyan Shilling).
  *
  * Uses shilingi and senti (100 senti = 1 shilingi).
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Swahili 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)     // 'shilingi arobaini na mbili'
  * toCurrency(1.50)   // 'shilingi moja na senti hamsini'
  * toCurrency(-5)     // 'minus shilingi tano'
  */
-function toCurrency (value) {
+function toCurrency(value) {
   const { isNegative, dollars: shillings, cents: senti } = parseCurrencyValue(value)
+  checkMax(shillings, currencyMax)
 
   let result = ''
   if (isNegative) {

package/src/ta-IN.d.ts

@@ -1,18 +1,18 @@
+export const cardinalMax: bigint;
+export const ordinalMax: bigint;
+export const currencyMax: bigint;
 /**
  * Converts a numeric value to Tamil words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Tamil words
  */
 export function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Tamil 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)    // 'முதல்'
  * toOrdinal(2)    // 'இரண்டாவது'
@@ -21,12 +21,10 @@ export function toCardinal(value: number | string | bigint): string;
 export function toOrdinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Tamil currency words (Indian Rupee).
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Tamil 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)  // 'நாற்பத்திரண்டு ரூபாய் ஐம்பது பைசா'
  * toCurrency(1)      // 'ஒன்று ரூபாய்'

package/src/ta-IN.js

@@ -16,6 +16,8 @@
 import { parseCardinalValue } from './utils/parse-cardinal.js'
 import { parseCurrencyValue } from './utils/parse-currency.js'
 import { parseOrdinalValue } from './utils/parse-ordinal.js'
+import { checkMax } from './utils/check-max.js'
+import { indian } from './utils/scale.js'
 
 // ============================================================================
 // Vocabulary
@@ -55,7 +57,7 @@ const BELOW_HUNDRED = [
   'அறுபது', 'அறுபத்தொன்று', 'அறுபத்திரண்டு', 'அறுபத்திமூன்று', 'அறுபத்திநான்கு', 'அறுபத்தைந்து', 'அறுபத்தாறு', 'அறுபத்தேழு', 'அறுபத்தெட்டு', 'அறுபத்தொன்பது',
   'எழுபது', 'எழுபத்தொன்று', 'எழுபத்திரண்டு', 'எழுபத்திமூன்று', 'எழுபத்திநான்கு', 'எழுபத்தைந்து', 'எழுபத்தாறு', 'எழுபத்தேழு', 'எழுபத்தெட்டு', 'எழுபத்தொன்பது',
   'எண்பது', 'எண்பத்தொன்று', 'எண்பத்திரண்டு', 'எண்பத்திமூன்று', 'எண்பத்திநான்கு', 'எண்பத்தைந்து', 'எண்பத்தாறு', 'எண்பத்தேழு', 'எண்பத்தெட்டு', 'எண்பத்தொன்பது',
-  'தொண்ணூறு', 'தொண்ணூற்று ஒன்று', 'தொண்ணூற்று இரண்டு', 'தொண்ணூற்று மூன்று', 'தொண்ணூற்று நான்கு', 'தொண்ணூற்று ஐந்து', 'தொண்ணூற்று ஆறு', 'தொண்ணூற்று ஏழு', 'தொண்ணூற்று எட்டு', 'தொண்ணூற்று ஒன்பது'
+  'தொண்ணூறு', 'தொண்ணூற்று ஒன்று', 'தொண்ணூற்று இரண்டு', 'தொண்ணூற்று மூன்று', 'தொண்ணூற்று நான்கு', 'தொண்ணூற்று ஐந்து', 'தொண்ணூற்று ஆறு', 'தொண்ணூற்று ஏழு', 'தொண்ணூற்று எட்டு', 'தொண்ணூற்று ஒன்பது',
 ]
 
 // Standalone hundreds (when not followed by remainder)
@@ -70,17 +72,23 @@ const ONES = ['ஒன்று', 'இரண்டு', 'மூன்று', '
 // Scale words: index 0 = units, 1 = thousand, 2 = lakh, etc.
 const SCALE_WORDS = ['', 'ஆயிரம்', 'லட்சம்', 'கோடி', 'அரபு', 'கராபு', 'நீல்', 'பத்ம', 'சங்கு']
 
+// 3-2-2 Indian grouping: a 3-digit base segment, then 2 digits per scale word
+// (SCALE_WORDS[0] = '' is the units slot). Past the table the scale word is
+// dropped, which collapses the magnitude — so cap there.
+export const cardinalMax = indian(SCALE_WORDS.length)
+export const ordinalMax = indian(SCALE_WORDS.length)
+export const currencyMax = indian(SCALE_WORDS.length)
+
 // ============================================================================
 // Segment Building
 // ============================================================================
 
 /**
  * Builds words for a 0-999 segment.
- *
  * @param {number} n - Number 0-999
  * @returns {string} Tamil words for the segment
  */
-function buildSegment (n) {
+function buildSegment(n) {
   if (n === 0) return ''
   if (n < 100) return BELOW_HUNDRED[n]
 
@@ -104,11 +112,10 @@ function buildSegment (n) {
  *
  * 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} Tamil words
  */
-function integerToWords (n) {
+function integerToWords(n) {
   if (n === 0n) return ZERO
 
   // Fast path: numbers < 1000
@@ -134,7 +141,8 @@ function integerToWords (n) {
 
     if (i === 0) {
       words.push(buildSegment(segment))
-    } else {
+    }
+    else {
       // Use 'ஒரு' for 1 at scale positions
       const groupWords = (segment === 1) ? 'ஒரு' : BELOW_HUNDRED[segment]
       words.push(groupWords)
@@ -148,7 +156,12 @@ function integerToWords (n) {
   return words.join(' ')
 }
 
-function decimalPartToWords (decimalPart) {
+/**
+ * Converts the decimal portion of a number to Tamil words (per-digit reading).
+ * @param {string} decimalPart - The fractional digits as a string
+ * @returns {string} Tamil words for each decimal digit
+ */
+function decimalPartToWords(decimalPart) {
   // Per-digit decimal reading
   const digits = []
   for (const char of decimalPart) {
@@ -160,12 +173,13 @@ function decimalPartToWords (decimalPart) {
 
 /**
  * Converts a numeric value to Tamil words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Tamil words
  */
-function toCardinal (value) {
+function toCardinal(value) {
   const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
+  // The fraction is spelled digit by digit, so only the integer part has a ceiling.
+  checkMax(integerPart, cardinalMax)
 
   let result = ''
 
@@ -190,11 +204,10 @@ function toCardinal (value) {
  * Converts a positive integer to Tamil ordinal words.
  *
  * Tamil ordinals: First has special form, 2-6 have special suffixes, then -ஆவது suffix.
- *
  * @param {bigint} n - Positive integer to convert
  * @returns {string} Tamil ordinal words
  */
-function integerToOrdinal (n) {
+function integerToOrdinal(n) {
   // Special ordinals for 1-6
   if (n >= 1n && n <= 6n) {
     return ORDINAL_SPECIAL[Number(n)]
@@ -207,19 +220,19 @@ function integerToOrdinal (n) {
 
 /**
  * Converts a numeric value to Tamil 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)    // 'முதல்'
  * toOrdinal(2)    // 'இரண்டாவது'
  * toOrdinal(10)   // 'பத்துஆவது'
  */
-function toOrdinal (value) {
+function toOrdinal(value) {
   const integerPart = parseOrdinalValue(value)
+  // Ordinals build on the cardinal speller, so they share its ceiling.
+  checkMax(integerPart, ordinalMax)
   return integerToOrdinal(integerPart)
 }
 
@@ -229,19 +242,18 @@ function toOrdinal (value) {
 
 /**
  * Converts a numeric value to Tamil currency words (Indian Rupee).
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Tamil 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)  // 'நாற்பத்திரண்டு ரூபாய் ஐம்பது பைசா'
  * toCurrency(1)      // 'ஒன்று ரூபாய்'
  * toCurrency(0.01)   // 'ஒன்று பைசா'
  */
-function toCurrency (value) {
+function toCurrency(value) {
   const { isNegative, dollars: rupees, cents: paise } = parseCurrencyValue(value)
+  checkMax(rupees, currencyMax)
 
   // Build result
   let result = ''

package/src/te-IN.d.ts

@@ -1,18 +1,18 @@
+export const cardinalMax: bigint;
+export const ordinalMax: bigint;
+export const currencyMax: bigint;
 /**
  * Converts a numeric value to Telugu words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Telugu words
  */
 export function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Telugu 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)    // 'మొదటి'
  * toOrdinal(2)    // 'రెండవ'
@@ -21,12 +21,10 @@ export function toCardinal(value: number | string | bigint): string;
 export function toOrdinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Telugu currency words (Indian Rupee).
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Telugu 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)  // 'నలభై రెండు రూపాయలు యాభై పైసలు'
  * toCurrency(1)      // 'ఒకటి రూపాయి'

package/src/te-IN.js

@@ -14,6 +14,8 @@
 import { parseCardinalValue } from './utils/parse-cardinal.js'
 import { parseCurrencyValue } from './utils/parse-currency.js'
 import { parseOrdinalValue } from './utils/parse-ordinal.js'
+import { checkMax } from './utils/check-max.js'
+import { indian } from './utils/scale.js'
 
 // ============================================================================
 // Vocabulary
@@ -55,7 +57,7 @@ const BELOW_HUNDRED = [
   'అరవై', 'అరవై ఒకటి', 'అరవై రెండు', 'అరవై మూడు', 'అరవై నాలుగు', 'అరవై ఐదు', 'అరవై ఆరు', 'అరవై ఏడు', 'అరవై ఎనిమిది', 'అరవై తొమ్మిది',
   'డెబ్బై', 'డెబ్బై ఒకటి', 'డెబ్బై రెండు', 'డెబ్బై మూడు', 'డెబ్బై నాలుగు', 'డెబ్బై ఐదు', 'డెబ్బై ఆరు', 'డెబ్బై ఏడు', 'డెబ్బై ఎనిమిది', 'డెబ్బై తొమ్మిది',
   'ఎనభై', 'ఎనభై ఒకటి', 'ఎనభై రెండు', 'ఎనభై మూడు', 'ఎనభై నాలుగు', 'ఎనభై ఐదు', 'ఎనభై ఆరు', 'ఎనభై ఏడు', 'ఎనభై ఎనిమిది', 'ఎనభై తొమ్మిది',
-  'తొంభై', 'తొంభై ఒకటి', 'తొంభై రెండు', 'తొంభై మూడు', 'తొంభై నాలుగు', 'తొంభై ఐదు', 'తొంభై ఆరు', 'తొంభై ఏడు', 'తొంభై ఎనిమిది', 'తొంభై తొమ్మిది'
+  'తొంభై', 'తొంభై ఒకటి', 'తొంభై రెండు', 'తొంభై మూడు', 'తొంభై నాలుగు', 'తొంభై ఐదు', 'తొంభై ఆరు', 'తొంభై ఏడు', 'తొంభై ఎనిమిది', 'తొంభై తొమ్మిది',
 ]
 
 const HUNDREDS = ['', 'వంద', 'రెండు వందలు', 'మూడు వందలు', 'నాలుగు వందలు', 'ఐదు వందలు', 'ఆరు వందలు', 'ఏడు వందలు', 'ఎనిమిది వందలు', 'తొమ్మిది వందలు']
@@ -66,14 +68,23 @@ const ONES = ['ఒకటి', 'రెండు', 'మూడు', 'నాలు
 // Scale words: index 0 = units, 1 = thousand, 2 = lakh, etc.
 const SCALE_WORDS = ['', 'వెయ్యి', 'లక్ష', 'కోటి', 'అరబ్', 'ఖరబ్', 'నిల్', 'పడ్మ', 'శంకు']
 
+// 3-2-2 Indian grouping: a 3-digit base segment, then 2 digits per scale word
+// (SCALE_WORDS[0] = '' is the units slot). Past the table the scale word is
+// dropped, which collapses the magnitude — so cap there.
+export const cardinalMax = indian(SCALE_WORDS.length)
+export const ordinalMax = indian(SCALE_WORDS.length)
+export const currencyMax = indian(SCALE_WORDS.length)
+
 // ============================================================================
 // Segment Building
 // ============================================================================
 
 /**
  * Builds words for a 0-999 segment.
+ * @param {number} n - Segment value (0-999)
+ * @returns {string} Telugu words for the segment
  */
-function buildSegment (n) {
+function buildSegment(n) {
   if (n === 0) return ''
   if (n < 100) return BELOW_HUNDRED[n]
 
@@ -95,11 +106,10 @@ function buildSegment (n) {
  *
  * 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} Telugu words
  */
-function integerToWords (n) {
+function integerToWords(n) {
   if (n === 0n) return ZERO
 
   // Fast path: numbers < 1000 (direct lookup)
@@ -125,7 +135,8 @@ function integerToWords (n) {
 
     if (i === 0) {
       words.push(buildSegment(segment))
-    } else {
+    }
+    else {
       // Use 'ఒక' for 1 at scale positions
       const groupWords = (segment === 1) ? 'ఒక' : BELOW_HUNDRED[segment]
       words.push(groupWords)
@@ -139,7 +150,12 @@ function integerToWords (n) {
   return words.join(' ')
 }
 
-function decimalPartToWords (decimalPart) {
+/**
+ * Reads a decimal fraction digit-by-digit in Telugu.
+ * @param {string} decimalPart - Fractional digits as a string
+ * @returns {string} Telugu words for each digit
+ */
+function decimalPartToWords(decimalPart) {
   // Per-digit decimal reading
   const digits = []
   for (const char of decimalPart) {
@@ -151,12 +167,13 @@ function decimalPartToWords (decimalPart) {
 
 /**
  * Converts a numeric value to Telugu words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Telugu words
  */
-function toCardinal (value) {
+function toCardinal(value) {
   const { isNegative, integerPart, decimalPart } = parseCardinalValue(value)
+  // The fraction is spelled digit by digit, so only the integer part has a ceiling.
+  checkMax(integerPart, cardinalMax)
 
   let result = ''
 
@@ -181,11 +198,10 @@ function toCardinal (value) {
  * Converts a positive integer to Telugu ordinal words.
  *
  * Telugu ordinals: First 6 are irregular, then add -వ suffix.
- *
  * @param {bigint} n - Positive integer to convert
  * @returns {string} Telugu ordinal words
  */
-function integerToOrdinal (n) {
+function integerToOrdinal(n) {
   // Special ordinals for 1-6
   if (n >= 1n && n <= 6n) {
     return ORDINAL_SPECIAL[Number(n)]
@@ -198,19 +214,19 @@ function integerToOrdinal (n) {
 
 /**
  * Converts a numeric value to Telugu 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)    // 'మొదటి'
  * toOrdinal(2)    // 'రెండవ'
  * toOrdinal(10)   // 'పదివ'
  */
-function toOrdinal (value) {
+function toOrdinal(value) {
   const integerPart = parseOrdinalValue(value)
+  // Ordinals build on the cardinal speller, so they share its ceiling.
+  checkMax(integerPart, ordinalMax)
   return integerToOrdinal(integerPart)
 }
 
@@ -220,19 +236,18 @@ function toOrdinal (value) {
 
 /**
  * Converts a numeric value to Telugu currency words (Indian Rupee).
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Telugu 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)  // 'నలభై రెండు రూపాయలు యాభై పైసలు'
  * toCurrency(1)      // 'ఒకటి రూపాయి'
  * toCurrency(0.01)   // 'ఒకటి పైసా'
  */
-function toCurrency (value) {
+function toCurrency(value) {
   const { isNegative, dollars: rupees, cents: paise } = parseCurrencyValue(value)
+  checkMax(rupees, currencyMax)
 
   // Build result
   let result = ''

package/src/th-TH.d.ts

@@ -1,18 +1,18 @@
+export const cardinalMax: null;
+export const ordinalMax: null;
+export const currencyMax: null;
 /**
  * Converts a numeric value to Thai words.
- *
  * @param {number | string | bigint} value - The numeric value to convert
  * @returns {string} The number in Thai words
  */
 export function toCardinal(value: number | string | bigint): string;
 /**
  * Converts a numeric value to Thai 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)    // 'ที่หนึ่ง'
  * toOrdinal(2)    // 'ที่สอง'
@@ -24,12 +24,10 @@ export function toOrdinal(value: number | string | bigint): string;
  *
  * Thai Baht uses satang as subunit (100 satang = 1 baht).
  * When whole amounts, adds "ถ้วน" (exactly) suffix.
- *
  * @param {number | string | bigint} value - The currency amount to convert
  * @returns {string} The amount in Thai 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)     // 'สี่สิบสองบาทถ้วน'
  * toCurrency(1.50)   // 'หนึ่งบาทห้าสิบสตางค์'