n2words 1.24.0 → 2.0.0

package/README.md

@@ -1,223 +1,352 @@
 # n2words
 
-[![CI](https://github.com/forzagreen/n2words/actions/workflows/test.yml/badge.svg)](https://github.com/forzagreen/n2words/actions/workflows/test.yml)
-[![Coverage Status](https://coveralls.io/repos/github/forzagreen/n2words/badge.svg)](https://coveralls.io/github/forzagreen/n2words)
-[![npm](https://img.shields.io/npm/v/n2words.svg)](https://npmjs.com/package/n2words)
-[![npm](https://img.shields.io/npm/dw/n2words)](https://npmjs.com/package/n2words)
-[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/n2words/badge)](https://www.jsdelivr.com/package/npm/n2words)
-
-**n2words** converts numerical numbers into written ones. Supports **45 languages** with **zero dependencies**.
-
-- 🌍 **45 languages** - Comprehensive international language support
-- 📦 **Zero dependencies** - Lightweight and fast
-- 🚀 **Performance optimized** - Highly tuned for speed
-- 📱 **Universal** - Works in browsers, Node.js, and TypeScript
-- 🧩 **Modular** - Import only the languages you need, keeping your bundle size minimal
-- 🔒 **Type-safe** - Full TypeScript support with language code literals and language-specific options
+[![CI](https://github.com/forzagreen/n2words/actions/workflows/ci.yml/badge.svg)](https://github.com/forzagreen/n2words/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/coveralls/github/forzagreen/n2words)](https://coveralls.io/github/forzagreen/n2words)
+[![npm version](https://img.shields.io/npm/v/n2words)](https://npmjs.com/package/n2words)
+[![npm provenance](https://img.shields.io/badge/npm-provenance-blue)](https://www.npmjs.com/package/n2words)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/n2words)](https://bundlephobia.com/package/n2words)
+[![npm downloads](https://img.shields.io/npm/dw/n2words)](https://npmjs.com/package/n2words)
+[![jsDelivr](https://img.shields.io/jsdelivr/npm/hm/n2words)](https://www.jsdelivr.com/package/npm/n2words)
+
+**Convert numbers to words in 48 languages with zero dependencies.**
+
+## Why n2words?
+
+- **Maximum Language Coverage** — 48 languages including European, Asian, Middle Eastern, and regional variants
+- **Zero Dependencies** — Pure JavaScript with no external runtime dependencies
+- **Universal Compatibility** — Works in Node.js, browsers (via CDN), and all modern bundlers
+- **Type-Safe** — Full TypeScript support with generated `.d.ts` declarations
+- **Production Ready** — Comprehensive test coverage (unit, integration, browser, type checking)
+- **BigInt Support** — Handle arbitrarily large numbers without precision loss
+- **Flexible Input** — Accepts `number`, `bigint`, or `string` inputs
+- **Tree-Shakable** — Import only the languages you need (~2-5 KB gzipped per language)
+- **Browser Tested** — Verified in Chromium, Firefox, and WebKit via automated tests
+
+## Contents
+
+- [Quick Start](#quick-start)
+- [Usage](#usage) — ESM, CommonJS, Browser (UMD)
+- [Type Safety](#type-safety) — TypeScript support
+- [Supported Languages](#supported-languages-48) — 48 languages with options
+- [Browser Compatibility](#browser-compatibility) — Chrome 67+, Firefox 68+, Safari 14+, Edge 79+
+- [Performance & Bundle Size](#performance--bundle-size) — Tree-shaking and benchmarks
+- [Examples](#examples) — Basic, gender agreement, language-specific features
+- [Documentation](#documentation) — Guides and API reference
+- [Contributing](#contributing) — How to contribute
+- [License](#license)
 
 ## Quick Start
 
-```js
-import n2words from 'n2words';
-
-n2words(123); // 'one hundred and twenty-three'
-n2words(-1.5); // 'minus one point five'
-n2words(123, { lang: 'zh-Hans' }); // '壹佰贰拾叁'
-n2words(123, { lang: 'hi' }); // 'एक सौ तेईस'
-n2words(123, { lang: 'es' }); // 'ciento veintitrés'
-n2words(123, { lang: 'ar' }); // 'مائة وثلاثة وعشرون'
-n2words(10000n, { lang: 'zh-Hans' }); // '壹万' (BigInt support!)
-```
-
-## Installation
-
-```sh
+```bash
 npm install n2words
 ```
 
-## Usage
-
-### Node.js / ESM
-
 ```js
-import n2words from 'n2words';
+import { EnglishConverter, SpanishConverter, ArabicConverter } from 'n2words'
 
-console.log(n2words(42)); // 'forty-two'
-console.log(n2words(3.14)); // 'three point one four'
+EnglishConverter(123)                       // 'one hundred and twenty-three'
+SpanishConverter(123)                       // 'ciento veintitrés'
+ArabicConverter(1, { gender: 'feminine' })  // 'واحدة' (with options)
 ```
 
-### TypeScript
-
-**Full type safety with language-specific options:**
-
-```ts
-import n2words, { type N2WordsOptions, type LanguageCode } from 'n2words';
-
-// Language code autocomplete (45+ languages)
-const lang: LanguageCode = 'zh-Hans'; // Full IntelliSense support
+## Usage
 
-// Type-safe language-specific options
-const result1 = n2words(123, { lang: 'zh-Hans', formal: true }); // Chinese financial numerals
-const result2 = n2words(42, { lang: 'ar', feminine: true }); // Arabic feminine forms
-const result3 = n2words(91, { lang: 'fr', withHyphenSeparator: true }); // French with hyphens
+**ESM (Node.js, modern bundlers):**
 
-// Comprehensive type safety
-const options: N2WordsOptions = {
-  lang: 'es',
-  genderStem: 'a' // TypeScript validates this option for Spanish
-};
+```js
+import { EnglishConverter } from 'n2words'
 ```
 
-See [TYPESCRIPT_GUIDE.md](guides/TYPESCRIPT_GUIDE.md) for comprehensive TypeScript documentation.
+**CommonJS (Node.js):**
 
-### CommonJS
+n2words is an ES module. For CommonJS environments, use dynamic import with Promises:
 
 ```js
-import('n2words').then(({ default: n2words }) => {
-  console.log(n2words(100)); // 'one hundred'
-});
+// Promise-based
+import('n2words').then(({ EnglishConverter }) => {
+  console.log(EnglishConverter(42))  // 'forty-two'
+})
+
+// Or use async function
+async function convertNumber(num) {
+  const { EnglishConverter } = await import('n2words')
+  return EnglishConverter(num)
+}
 ```
 
-### Browser (UMD)
+**Browser (UMD via CDN):**
 
 ```html
+<!-- All languages (~23KB gzipped) -->
 <script src="https://cdn.jsdelivr.net/npm/n2words/dist/n2words.js"></script>
 <script>
-  console.log(n2words(100)); // 'one hundred'
+  n2words.EnglishConverter(42)  // 'forty-two'
 </script>
-```
 
-Or import specific languages:
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/n2words/dist/languages/fr.js"></script>
+<!-- Individual languages (~2KB gzipped each) - load only what you need -->
+<script src="https://cdn.jsdelivr.net/npm/n2words/dist/EnglishConverter.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/n2words/dist/SpanishConverter.js"></script>
 <script>
-  console.log(n2words(100, { lang: 'fr' })); // 'cent'
+  n2words.EnglishConverter(42)   // 'forty-two'
+  n2words.SpanishConverter(123)  // 'ciento veintitrés'
 </script>
 ```
 
-## Supported Languages
-
-| Code      | Language             | Code      | Language         |
-| --------- | -------------------- | --------- | ---------------- |
-| `ar`      | Arabic               | `az`      | Azerbaijani      |
-| `bn`      | Bengali              | `cs`      | Czech            |
-| `de`      | German               | `da`      | Danish           |
-| `el`      | Greek                | `en`      | English          |
-| `es`      | Spanish              | `fa`      | Farsi/Persian    |
-| `fr`      | French               | `fr-BE`   | French (Belgium) |
-| `gu`      | Gujarati             | `he`      | Hebrew           |
-| `hi`      | Hindi                | `hr`      | Croatian         |
-| `hu`      | Hungarian            | `id`      | Indonesian       |
-| `it`      | Italian              | `ja`      | Japanese         |
-| `kn`      | Kannada              | `ko`      | Korean           |
-| `lt`      | Lithuanian           | `lv`      | Latvian          |
-| `mr`      | Marathi              | `ms`      | Malay            |
-| `nl`      | Dutch                | `nb`      | Norwegian        |
-| `pa-Guru` | Punjabi (Gurmukhi)   | `pl`      | Polish           |
-| `pt`      | Portuguese           | `ro`      | Romanian         |
-| `ru`      | Russian              | `sr-Latn` | Serbian (Latin)  |
-| `sv`      | Swedish              | `sw`      | Swahili          |
-| `ta`      | Tamil                | `te`      | Telugu           |
-| `th`      | Thai                 | `fil`     | Filipino/Tagalog |
-| `tr`      | Turkish              | `uk`      | Ukrainian        |
-| `ur`      | Urdu                 | `vi`      | Vietnamese       |
-| `zh-Hans` | Chinese (Simplified) | `gu`      | Gujarati         |
-
-## Performance
-
-Performance benchmarks (ops/sec) on latest hardware:
-
-| Language        | Performance   |
-| --------------- | ------------- |
-| Arabic (ar)     | ~180k ops/sec |
-| Indonesian (id) | ~160k ops/sec |
-| Vietnamese (vi) | ~165k ops/sec |
-| Persian (fa)    | ~125k ops/sec |
-| Hebrew (he)     | ~115k ops/sec |
-
-All languages are highly optimized. Run `npm run bench:perf` to benchmark on your system.
+## Type Safety
 
-## Examples
+Full TypeScript support via JSDoc annotations and generated type definitions - works in both JavaScript and TypeScript projects with IntelliSense and type checking:
 
-### Basic Usage
+```typescript
+import { EnglishConverter, ArabicConverter, SimplifiedChineseConverter } from 'n2words'
+import type { NumericValue, ArabicOptions } from 'n2words'
 
-```js
-n2words(0); // 'zero'
-n2words(1); // 'one'
-n2words(10); // 'ten'
-n2words(100); // 'one hundred'
-n2words(1000); // 'one thousand'
-n2words(1000000); // 'one million'
+// All converters accept: number | bigint | string
+EnglishConverter(42)       // ✓ number → 'forty-two'
+EnglishConverter('123')    // ✓ string → 'one hundred and twenty-three'
+EnglishConverter(100n)     // ✓ BigInt → 'one hundred'
+
+// Language-specific options with type checking
+ArabicConverter(1, { gender: 'feminine' })  // ✓ 'واحدة' (feminine form)
+ArabicConverter(1, { invalid: true })       // ✗ TypeScript error: invalid property
+
+SimplifiedChineseConverter(123, { formal: false })  // ✓ '一百二十三' (common style)
+SimplifiedChineseConverter(123, { formal: 'yes' })  // ✗ TypeScript error: wrong type
 ```
 
-### Decimal Numbers
+**Type Definitions:**
+
+n2words includes TypeScript declaration files (`.d.ts`) generated from JSDoc annotations:
+
+- **Source**: JSDoc annotations in JavaScript source files
+- **Generated**: TypeScript declarations built via `tsc` during package preparation
+- **Included**: Published to npm with the package (no separate `@types` package needed)
+- **Validated**: Comprehensive type tests ensure correctness
+
+**Exported Types:**
+
+- `NumericValue` - Accepted input types: `number | bigint | string`
+- Language-specific option types (e.g., `ArabicOptions`, `SimplifiedChineseOptions`, `DutchOptions`, etc.)
+
+## Supported Languages (48)
+
+Language codes follow [IETF BCP 47](https://tools.ietf.org/html/bcp47) standards.
+
+| Code      | Language            | Options | Code      | Language            | Options |
+| --------- | ------------------- | ------- | --------- | ------------------- | ------- |
+| `ar`      | Arabic              | ✓       | `az`      | Azerbaijani         |         |
+| `bn`      | Bengali             |         | `cs`      | Czech               | ✓       |
+| `da`      | Danish              | ✓       | `de`      | German              |         |
+| `el`      | Greek               |         | `en`      | English             |         |
+| `es`      | Spanish             | ✓       | `fa`      | Persian             |         |
+| `fil`     | Filipino            |         | `fr`      | French              | ✓       |
+| `fr-BE`   | Belgian French      | ✓       | `gu`      | Gujarati            |         |
+| `hbo`     | Biblical Hebrew     | ✓       | `he`      | Modern Hebrew       | ✓       |
+| `hi`      | Hindi               |         | `hr`      | Croatian            | ✓       |
+| `hu`      | Hungarian           |         | `id`      | Indonesian          |         |
+| `it`      | Italian             |         | `ja`      | Japanese            |         |
+| `kn`      | Kannada             |         | `ko`      | Korean              |         |
+| `lt`      | Lithuanian          | ✓       | `lv`      | Latvian             | ✓       |
+| `mr`      | Marathi             |         | `ms`      | Malay               |         |
+| `nb`      | Norwegian Bokmål    |         | `nl`      | Dutch               | ✓       |
+| `pa`      | Punjabi             |         | `pl`      | Polish              | ✓       |
+| `pt`      | Portuguese          |         | `ro`      | Romanian            | ✓       |
+| `ru`      | Russian             | ✓       | `sr-Cyrl` | Serbian Cyrillic    | ✓       |
+| `sr-Latn` | Serbian Latin       | ✓       | `sv`      | Swedish             |         |
+| `sw`      | Swahili             |         | `ta`      | Tamil               |         |
+| `te`      | Telugu              |         | `th`      | Thai                |         |
+| `tr`      | Turkish             | ✓       | `uk`      | Ukrainian           | ✓       |
+| `ur`      | Urdu                |         | `vi`      | Vietnamese          |         |
+| `zh-Hans` | Chinese Simplified  | ✓       | `zh-Hant` | Chinese Traditional | ✓       |
+
+### Language Options
+
+21 languages support additional options. Common options include:
+
+**`gender`** (`'masculine'` | `'feminine'`) - 13 languages
+Arabic, Biblical Hebrew, Croatian, Czech, Latvian, Lithuanian, Polish, Romanian, Russian, Serbian (both scripts), Spanish, Ukrainian
+
+**`formal`** (`boolean`) - 2 languages
+Simplified Chinese, Traditional Chinese - Toggle between formal/financial and common numerals
+
+**Other options:**
+
+- Dutch: `includeOptionalAnd`, `accentOne`, `noHundredPairing`
+- French/French Belgium: `withHyphenSeparator`
+- Hebrew (Modern & Biblical): `andWord`
+- Turkish: `dropSpaces`
+- Danish: `ordFlag` (ordinal numbers)
+- Arabic: `negativeWord` (custom negative word)
+
+[See complete options reference →](docs/ARCHITECTURE.md#language-specific-options)
+
+## Browser Compatibility
+
+**Minimum Requirements** (due to BigInt):
+
+- **Node.js**: 20 or above
+- **Browsers**: Chrome 67+, Firefox 68+, Safari 14+, Edge 79+ (desktop + mobile)
+- **Global Coverage**: ~86% of all users worldwide
+
+**Note**: BigInt is a hard requirement and cannot be polyfilled. Older browsers are not supported.
+
+**Build options:**
+
+- **Browser CDN**: Use `dist/n2words.js` (pre-built UMD, tested in real browsers)
+- **Node.js/Bundlers**: Use `lib/` source (ES modules, tree-shakable)
+
+[See detailed compatibility guide →](COMPATIBILITY.md)
+
+## Performance & Bundle Size
+
+### Bundle Size Comparison
+
+| Import Strategy              | Bundle Size (Minified) | Gzipped  | Languages Included |
+| ---------------------------- | ---------------------- | -------- | ------------------ |
+| All languages (UMD)          | ~92 KB                 | ~23 KB   | All 48             |
+| Single language (UMD)        | ~4-6 KB                | ~2 KB    | 1                  |
+| Tree-shaken (ESM, 1 lang)    | ~4-5 KB                | ~2 KB    | 1                  |
+| Tree-shaken (ESM, 3 langs)   | ~12-15 KB              | ~4-5 KB  | 3                  |
+| Tree-shaken (ESM, 10 langs)  | ~40-50 KB              | ~12-15 KB| 10                 |
+
+### Performance Characteristics
+
+- **Fast**: Sub-millisecond conversion for most numbers
+- **Efficient**: Zero dependencies, minimal memory footprint
+- **BigInt support**: Handles arbitrarily large numbers without precision loss
+- **Memory-efficient**: ~2 KB overhead per language when tree-shaken
+
+**Tree-shaking example:**
 
 ```js
-n2words(3.14); // 'three point one four'
-n2words(10.5); // 'ten point five'
-n2words(0.007); // 'zero point zero zero seven'
+// Import only what you need - bundler only includes used languages
+import { EnglishConverter, SpanishConverter } from 'n2words'
+// Final bundle: ~4-5 KB gzipped (only English + Spanish + core)
+```
 
-// Some languages read decimals digit-by-digit
-n2words(3.14, { lang: 'ja' }); // '三点一四' (Japanese: san-ten-ichi-yon)
-n2words(2.05, { lang: 'th' }); // 'สามจุดหนึ่งสี่' (Thai: each digit spoken)
+**Run benchmarks:**
+
+```bash
+npm run bench:perf    # Performance benchmarks (ops/sec)
+npm run bench:memory  # Memory usage benchmarks
 ```
 
-### Negative Numbers
+## Examples
+
+### Basic Conversions
 
 ```js
-n2words(-42); // 'minus forty-two'
-n2words(-3.14); // 'minus three point one four'
+import { EnglishConverter } from 'n2words'
+
+// Basic numbers
+EnglishConverter(0)        // 'zero'
+EnglishConverter(42)       // 'forty-two'
+EnglishConverter(1000000)  // 'one million'
+
+// Decimals & negatives
+EnglishConverter(3.14)     // 'three point one four'
+EnglishConverter(-42)      // 'minus forty-two'
+
+// Large numbers & BigInt
+EnglishConverter(1234567890)        // 'one billion two hundred and thirty-four million five hundred and sixty-seven thousand eight hundred and ninety'
+EnglishConverter(123456789012345n)  // Works with arbitrarily large integers
 ```
 
-### Large Numbers
+### Gender Agreement
 
 ```js
-n2words(1000000000); // 'one billion'
-n2words(1234567890); // 'one billion two hundred and thirty-four million five hundred and sixty-seven thousand eight hundred and ninety'
+import { SpanishConverter, ArabicConverter, RussianConverter } from 'n2words'
+
+// Spanish: masculine vs feminine
+SpanishConverter(1)                       // 'uno' (masculine, default)
+SpanishConverter(1, { gender: 'feminine' })  // 'una'
+SpanishConverter(21)                      // 'veintiuno' (masculine)
+SpanishConverter(21, { gender: 'feminine' }) // 'veintiuna'
+
+// Arabic: rich gender system
+ArabicConverter(1)                       // 'واحد' (masculine, default)
+ArabicConverter(1, { gender: 'feminine' })  // 'واحدة'
+
+// Russian: gender for numerals
+RussianConverter(1)                       // 'один' (masculine, default)
+RussianConverter(1, { gender: 'feminine' })  // 'одна'
 ```
 
-### BigInt Support
+### Language-Specific Features
 
 ```js
-n2words(123456789012345n); // Works with arbitrarily large integers
+import {
+  SimplifiedChineseConverter,
+  TraditionalChineseConverter,
+  JapaneseConverter,
+  DutchConverter,
+  FrenchConverter
+} from 'n2words'
+
+// Chinese: formal (financial) vs common numerals
+SimplifiedChineseConverter(123)                  // '壹佰贰拾叁' (formal, default)
+SimplifiedChineseConverter(123, { formal: false }) // '一百二十三' (common)
+
+TraditionalChineseConverter(456)                  // '肆佰伍拾陸' (formal, default)
+TraditionalChineseConverter(456, { formal: false }) // '四百五十六' (common)
+
+// Japanese: digit-by-digit decimals
+JapaneseConverter(3.14)  // '三点一四'
+
+// Dutch: flexible formatting
+DutchConverter(123)                              // 'honderddrieëntwintig' (default compound)
+DutchConverter(101, { includeOptionalAnd: true })  // 'honderdeneen' (with optional "en")
+DutchConverter(1)                                // 'één' (accented, default)
+DutchConverter(1, { accentOne: false })           // 'een' (unaccented)
+
+// French: selective hyphens vs all hyphens
+FrenchConverter(123)                              // 'cent vingt-trois' (default)
+FrenchConverter(123, { withHyphenSeparator: true }) // 'cent-vingt-trois' (all hyphens)
 ```
 
-## Documentation
+### Input Flexibility
 
-- [TYPESCRIPT_GUIDE.md](./guides/TYPESCRIPT_GUIDE.md) - **Comprehensive TypeScript guide** with enhanced type safety
-- [LANGUAGE_OPTIONS.md](./guides/LANGUAGE_OPTIONS.md) - Language-specific options and examples
-- [LANGUAGE_GUIDE.md](./guides/LANGUAGE_GUIDE.md) - Comprehensive guide for adding new languages
-- [BIGINT-GUIDE.md](./guides/BIGINT-GUIDE.md) - BigInt usage guide for language developers
-- [CONTRIBUTING.md](./CONTRIBUTING.md) - Contribution guidelines
-- [Wiki](https://github.com/forzagreen/n2words/wiki) - Detailed examples and guides
+```js
+import { EnglishConverter } from 'n2words'
 
-## Contributing
+// Multiple input types
+EnglishConverter(42)      // number → 'forty-two'
+EnglishConverter('42')    // string → 'forty-two'
+EnglishConverter(42n)     // BigInt → 'forty-two'
 
-This library is actively maintained and welcomes contributions!
+// Decimal strings
+EnglishConverter('3.14')  // 'three point one four'
+EnglishConverter('.5')    // 'zero point five'
 
-- 🐛 **Bug reports** - Help us fix issues
-- ✨ **Feature requests** - Suggest improvements
-- 🌐 **New languages** - Add support for more languages (use `npm run lang:add` to get started!)
-- 📝 **Documentation** - Improve guides and examples
+// Negative strings
+EnglishConverter('-42')   // 'minus forty-two'
 
-### Adding a New Language
+// Large BigInts (no precision loss)
+EnglishConverter(999999999999999999999999n)  // Accurate conversion
+```
+
+## Documentation
 
-We provide automated tools to streamline language implementation:
+- **[Compatibility Guide](COMPATIBILITY.md)** - Browser and Node.js compatibility
+- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute and add languages
+- **[Architecture Guide](docs/ARCHITECTURE.md)** - Implementation patterns and options reference
+- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community standards
 
-```bash
-# Generate boilerplate for a new language
-npm run lang:add
+## Contributing
 
-# Validate your implementation
-npm run lang:validate <language-code>
+We welcome contributions! Add a new language or improve existing ones:
 
-# Validate all languages
-npm run lang:validate
+```bash
+npm run lang:add <code>         # Scaffold a new language (BCP 47 code)
+npm run lang:validate -- <code> # Validate implementation
+npm test                        # Run full test suite
 ```
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) and [LANGUAGE_GUIDE.md](./guides/LANGUAGE_GUIDE.md) for detailed guidance.
+Also welcome: bug reports, feature requests, documentation improvements, and language enhancements.
+
+Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
+
+**[See full contributing guide →](CONTRIBUTING.md)**
 
 ## License
 
-[MIT](./LICENSE) © 2025
+[MIT](./LICENSE) © Wael TELLAT, Tyler Vigario & contributors

package/dist/ArabicConverter.js

@@ -0,0 +1,3 @@
+/*! n2words/ArabicConverter v2.0.0 | MIT License | github.com/forzagreen/n2words */
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).n2words=e.n2words||{})}(this,function(e){"use strict";class t{#e={};negativeWord="";decimalSeparatorWord="";zeroWord="";wordSeparator=" ";usePerDigitDecimals=!1;get options(){return this.#e}toWords(e,t,r){const s=[];return e&&s.push(this.negativeWord),s.push(this.integerToWords(t)),r&&(s.push(this.decimalSeparatorWord),s.push(...this.decimalDigitsToWords(r))),s.join(this.wordSeparator)}integerToWords(e){throw new Error("integerToWords() must be implemented by subclass")}setOptions(e={},t={}){this.#e={...e,...t}}decimalIntegerToWords(e){return this.integerToWords(e)}decimalDigitsToWords(e){const t=[];let r=0;for(;r<e.length&&"0"===e[r];)t.push(this.zeroWord),r++;const s=e.slice(r);if(!s)return t;if(this.usePerDigitDecimals)for(const e of s)t.push(this.decimalIntegerToWords(BigInt(e)));else t.push(this.decimalIntegerToWords(BigInt(s)));return t}}function r(e){const[t,r]=e.toLowerCase().split("e"),s=parseInt(r,10),n=t.indexOf("."),i=-1===n?t:t.slice(0,n)+t.slice(n+1),o=(-1===n?t.length:n)+s;return o>=i.length?i+"0".repeat(o-i.length):o<=0?"0."+"0".repeat(-o)+i:i.slice(0,o)+"."+i.slice(o)}const s=(n=class extends t{negativeWord="ناقص";decimalSeparatorWord="فاصلة";zeroWord="صفر";tensWords=["عشرون","ثلاثون","أربعون","خمسون","ستون","سبعون","ثمانون","تسعون"];hundredsWords=["","مائة","مئتان","ثلاثمائة","أربعمائة","خمسمائة","ستمائة","سبعمائة","ثمانمائة","تسعمائة"];scaleWords=["مائة","ألف","مليون","مليار","تريليون","كوادريليون","كوينتليون","سكستيليون"];scaleAppendedWords=["","ألفاً","مليوناً","ملياراً","تريليوناً","كوادريليوناً","كوينتليوناً","سكستيليوناً"];scalePluralWords=["","آلاف","ملايين","مليارات","تريليونات","كوادريليونات","كوينتليونات","سكستيليونات"];dualWords=["مئتان","ألفان","مليونان","ملياران","تريليونان","كوادريليونان","كوينتليونان","سكستيليونان"];dualAppendedWords=["مئتا","ألفا","مليونا","مليارا","تريليونا","كوادريليونا","كوينتليونا","سكستيليونا"];ones={masculine:["واحد","اثنان","ثلاثة","أربعة","خمسة","ستة","سبعة","ثمانية","تسعة","عشرة","أحد عشر","اثنا عشر","ثلاثة عشر","أربعة عشر","خمسة عشر","ستة عشر","سبعة عشر","ثمانية عشر","تسعة عشر"],feminine:["واحدة","اثنتان","ثلاث","أربع","خمس","ست","سبع","ثمان","تسع","عشر","إحدى عشرة","اثنتا عشرة","ثلاث عشرة","أربع عشرة","خمس عشرة","ست عشرة","سبع عشرة","ثماني عشرة","تسع عشرة"]};constructor(e={}){super(),this.setOptions({gender:"masculine"},e),void 0!==e.negativeWord&&(this.negativeWord=e.negativeWord)}get selectedOnes(){return this.ones["feminine"===this.options.gender?"feminine":"masculine"]}segmentToWords(e,t,r){const s=e%100,n=e/100,i=Math.trunc(n);let o="";if(i>0)if(0===s&&2===i)o=this.dualWords[0];else{const e=this.hundredsWords[i];e&&(o=e,0!==s&&(o+=" و"))}if(s>0)if(s<20)if(2===s&&0===i&&t>0){const s=Number(r),n=Math.trunc(Math.log10(s));o=n%3==0&&r===BigInt(2*Math.pow(10,n))?2===e?this.dualWords[t]:this.dualAppendedWords[t]:this.dualWords[t]}else o+=1===s&&t>0?this.scaleWords[t]:this.selectedOnes[s-1];else{const e=s%10,t=Math.trunc(s/10)-2;e>0&&(o+=this.selectedOnes[e-1],o+=" و"),o+=this.tensWords[t]}return o}integerToWords(e){if(0n===e)return this.zeroWord;let t=e,r=0,s="";for(;t>0n;){const n=Number(t%1000n);if(t/=1000n,n>0){const t=this.segmentToWords(n,r,e);t&&(r>0&&(s&&(s=" و"+s),n>2)&&(s=1==n%100?this.scaleWords[r]+" "+s:n>=3&&n<=10?this.scalePluralWords[r]+" "+s:(s?this.scaleAppendedWords[r]:this.scaleWords[r])+" "+s),s=t+" "+s)}r++}return s.replace(/\s+/g," ").trim()}},function(e,t){if(void 0!==t&&!function(e){if(null===e||"object"!=typeof e)return!1;const t=Object.getPrototypeOf(e);return t===Object.prototype||null===t}(t))throw new TypeError("options must be a plain object if provided");const{isNegative:s,integerPart:i,decimalPart:o}=function(e){const t=typeof e;if("bigint"===t)return e<0n?{isNegative:!0,integerPart:-e}:{isNegative:!1,integerPart:e};if("number"!==t&&"string"!==t)throw new TypeError(`Invalid value type: expected number, string, or bigint, received ${t}`);const s="number"===t?function(e){if(!Number.isFinite(e))throw new Error("Number must be finite (NaN and Infinity are not supported)");const t=e.toString();return t.includes("e")||t.includes("E")?r(t):t}(e):function(e){const t=e.trim();if(0===t.length)throw new Error(`Invalid number format: "${e}"`);if(Number.isNaN(Number(t)))throw new Error(`Invalid number format: "${e}"`);return t.includes("e")||t.includes("E")?r(t):t}(e);return function(e){const t="-"===e[0];t&&(e=e.slice(1));const r=e.indexOf(".");if(-1===r)return{isNegative:t,integerPart:BigInt(e)};const s=e.slice(0,r)||"0",n=e.slice(r+1);return{isNegative:t,integerPart:BigInt(s),decimalPart:n}}(s)}(e);return new n(t).toWords(s,i,o)});var n;e.ArabicConverter=s});
+//# sourceMappingURL=ArabicConverter.js.map