@marcobytes/digits-to-words 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# Convert Number to Words
+
+Convert numbers to words easily. Currently supports **English (`en-SG`)** and **Khmer (Cambodia, `km-KH`)**.
+
+> **Note:** Support for additional languages will be added in future releases.
+
+## Installation
+
+```bash
+npm install number-to-words
+```
+
+## Usage
+
+```ts
+import { toWords } from 'number-to-words';
+
+// English
+console.log(toWords(181035, 'en-SG')); // "One Hundred and Eighty-One Thousand and Thirty-Five"
+
+// Khmer
+console.log(toWords(181035, 'km-KH')); // "មួយរយប៉ែតសិបមួយពាន់សូន្យសាមសិបប្រាំ"
+```
+
+---
+
+## Example with Countries (Asia)
+
+| Country          | Language Code | Example: `181035`                                   |
+| ---------------- | ------------- | --------------------------------------------------- |
+| Cambodia 🇰🇭      | `km-KH`       | មួយរយប៉ែតសិបមួយពាន់សូន្យសាមសិបប្រាំ                          |
+| Vietnam 🇻🇳       | `vi-VN`       | (not supported yet)                                 |
+| Laos 🇱🇦          | `lo-LA`       | (not supported yet)                                 |
+| Myanmar 🇲🇲       | `my-MM`       | (not supported yet)                                 |
+| Malaysia 🇲🇾      | `ms-MY`       | (not supported yet)                                 |
+| Singapore 🇸🇬     | `en-SG`       | One Hundred and Eighty-One Thousand and Thirty-Five |
+| Indonesia 🇮🇩     | `id-ID`       | (not supported yet)                                 |
+| Philippines 🇵🇭   | `en-PH`       | One Hundred and Eighty-One Thousand and Thirty-Five |
+| Japan 🇯🇵         | `ja-JP`       | (not supported yet)                                 |
+| South Korea 🇰🇷   | `ko-KR`       | (not supported yet)                                 |
+| Thailand 🇹🇭      | `th-TH`       | (not supported yet)                                 |
+
+
+---
+
+## Example with Real Data
+
+```ts
+import { toWords } from 'number-to-words';
+
+const populationCambodia = 181035; // Area in km²
+console.log(`Area of Cambodia: ${toWords(populationCambodia, 'en-SG')} square kilometers`);
+// "Area of Cambodia: One Hundred Eighty-One Thousand Thirty-Five square kilometers"
+
+console.log(`ផ្ទៃដីប្រទេសកម្ពុជា: ${toWords(populationCambodia, 'km-KH')} គីឡូម៉ែត្រការេ`);
+// "ផ្ទៃដីប្រទេសកម្ពុជា: មួយរយប៉ែតសិបមួយពាន់សូន្យសាមសិបប្រាំ គីឡូម៉ែត្រការេ"
+```
+
+---
+
+## API
+
+```ts
+toWords(number: number, lang: string): string
+```
+
+* `number` → The number you want to convert
+* `lang` → Language code (`'en-SG'` or `'km-KH'`)
+
+> Currently, only **English (`en-SG`)** and **Khmer (`km`)** are supported.
+
+---
+
+## Contribution
+
+Contributions are welcome! If you want to help add **more Asian languages**, feel free to submit a PR.
+
+---

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Public API
+ */
+export declare function toWords(number: number, lang?: string): string;

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWords = toWords;
+const en_SG_1 = require("./languages/en-SG");
+const km_KH_1 = require("./languages/km-KH");
+/**
+ * Map all localization codes to internal converters.
+ * You can easily add more later.
+ */
+const LANGUAGE_ROUTER = {
+    // English variants
+    "en": en_SG_1.convertNumberToEnglishWords,
+    "en-SG": en_SG_1.convertNumberToEnglishWords,
+    "en-PH": en_SG_1.convertNumberToEnglishWords,
+    // Khmer variants
+    "km": km_KH_1.convertNumberToKhmerWords,
+    "km-KH": km_KH_1.convertNumberToKhmerWords,
+};
+/**
+ * Public API
+ */
+function toWords(number, lang = "en-SG") {
+    const key = lang.trim();
+    const converter = LANGUAGE_ROUTER[key] || LANGUAGE_ROUTER[key.toLowerCase()] || null;
+    if (!converter) {
+        throw new Error(`Language "${lang}" is not supported yet. Supported languages: ${Object.keys(LANGUAGE_ROUTER).join(", ")}`);
+    }
+    return converter(number);
+}

package/dist/languages/en-SG.d.ts

@@ -0,0 +1 @@
+export declare function convertNumberToEnglishWords(number: number | string): string;

package/dist/languages/en-SG.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertNumberToEnglishWords = convertNumberToEnglishWords;
+function convertNumberToEnglishWords(number) {
+    const hyphen = " ";
+    const conjunction = " ";
+    const separator = " ";
+    const negative = "negative ";
+    const decimal = " point ";
+    const dictionary = {
+        0: "zero",
+        1: "one",
+        2: "two",
+        3: "three",
+        4: "four",
+        5: "five",
+        6: "six",
+        7: "seven",
+        8: "eight",
+        9: "nine",
+        10: "ten",
+        11: "eleven",
+        12: "twelve",
+        13: "thirteen",
+        14: "fourteen",
+        15: "fifteen",
+        16: "sixteen",
+        17: "seventeen",
+        18: "eighteen",
+        19: "nineteen",
+        20: "twenty",
+        30: "thirty",
+        40: "forty",
+        50: "fifty",
+        60: "sixty",
+        70: "seventy",
+        80: "eighty",
+        90: "ninety",
+        100: "hundred",
+        1000: "thousand",
+        1000000: "million",
+        1000000000: "billion",
+        1000000000000: "trillion",
+    };
+    if (typeof number === "string")
+        number = parseFloat(number);
+    if (isNaN(number))
+        return "";
+    if (number < 0)
+        return negative + convertNumberToEnglishWords(Math.abs(number));
+    let string = "";
+    let fraction = null;
+    let numberStr = number.toString();
+    if (numberStr.includes(".")) {
+        [numberStr, fraction] = numberStr.split(".");
+        number = parseInt(numberStr);
+    }
+    if (number < 21) {
+        string = dictionary[number];
+    }
+    else if (number < 100) {
+        const tens = Math.floor(number / 10) * 10;
+        const units = number % 10;
+        string = dictionary[tens];
+        if (units)
+            string += hyphen + dictionary[units];
+    }
+    else if (number < 1000) {
+        const hundreds = Math.floor(number / 100);
+        const remainder = number % 100;
+        string = dictionary[hundreds] + " " + dictionary[100];
+        if (remainder)
+            string += conjunction + convertNumberToEnglishWords(remainder);
+    }
+    else {
+        const baseUnit = Math.pow(1000, Math.floor(Math.log(number) / Math.log(1000)));
+        const numBaseUnits = Math.floor(number / baseUnit);
+        const remainder = number % baseUnit;
+        string =
+            convertNumberToEnglishWords(numBaseUnits) +
+                " " +
+                dictionary[baseUnit];
+        if (remainder)
+            string +=
+                remainder < 100
+                    ? conjunction
+                    : separator + convertNumberToEnglishWords(remainder);
+    }
+    if (fraction) {
+        string +=
+            decimal +
+                fraction
+                    .split("")
+                    .map((d) => dictionary[parseInt(d)])
+                    .join(" ");
+    }
+    return string;
+}

package/dist/languages/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./km-KH";
+export * from "./en-SG";

package/dist/languages/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./km-KH"), exports);
+__exportStar(require("./en-SG"), exports);

package/dist/languages/km-KH.d.ts

@@ -0,0 +1 @@
+export declare function convertNumberToKhmerWords(number: number | string): string;

package/dist/languages/km-KH.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertNumberToKhmerWords = convertNumberToKhmerWords;
+function convertNumberToKhmerWords(number) {
+    const hyphen = "";
+    const conjunction = "";
+    const separator = "";
+    const negative = "negative ";
+    const decimal = "ចុច";
+    const dictionary = {
+        0: "សូន្យ",
+        1: "មួយ",
+        2: "ពីរ",
+        3: "បី",
+        4: "បួន",
+        5: "ប្រាំ",
+        6: "ប្រាំមួយ",
+        7: "ប្រាំពីរ",
+        8: "ប្រាំបី",
+        9: "ប្រាំបួន",
+        10: "ដប់",
+        11: "ដប់មួយ",
+        12: "ដប់ពីរ",
+        13: "ដប់បី",
+        14: "ដប់បួន",
+        15: "ដប់ប្រាំ",
+        16: "ដប់ប្រាំមួយ",
+        17: "ដប់ប្រាំពីរ",
+        18: "ដប់ប្រាំបី",
+        19: "ដប់ប្រាំបួន",
+        20: "ម្ភៃ",
+        30: "សាមសិប",
+        40: "សែសិប",
+        50: "ហាសិប",
+        60: "ហុកសិប",
+        70: "ចិតសិប",
+        80: "ប៉ែតសិប",
+        90: "កៅសិប",
+        100: "រយ",
+        1000: "ពាន់",
+        1000000: "លាន"
+    };
+    if (typeof number === "string")
+        number = parseFloat(number);
+    if (isNaN(number))
+        return "";
+    if (number < 0)
+        return negative + convertNumberToKhmerWords(Math.abs(number));
+    let string = "";
+    let fraction = null;
+    let numberStr = number.toString();
+    if (numberStr.includes(".")) {
+        [numberStr, fraction] = numberStr.split(".");
+        number = parseInt(numberStr);
+    }
+    if (number < 21) {
+        string = dictionary[number];
+    }
+    else if (number < 100) {
+        const tens = Math.floor(number / 10) * 10;
+        const units = number % 10;
+        string = dictionary[tens];
+        if (units)
+            string += hyphen + dictionary[units];
+    }
+    else if (number < 1000) {
+        const hundreds = Math.floor(number / 100);
+        const remainder = number % 100;
+        string = dictionary[hundreds] + dictionary[100];
+        if (remainder)
+            string += conjunction + convertNumberToKhmerWords(remainder);
+    }
+    else {
+        const baseUnit = Math.pow(1000, Math.floor(Math.log(number) / Math.log(1000)));
+        const numBaseUnits = Math.floor(number / baseUnit);
+        const remainder = number % baseUnit;
+        string =
+            convertNumberToKhmerWords(numBaseUnits) +
+                dictionary[baseUnit];
+        if (remainder)
+            string +=
+                remainder < 100
+                    ? conjunction
+                    : separator + convertNumberToKhmerWords(remainder);
+    }
+    if (fraction) {
+        if (string === "")
+            string = "0";
+        string += decimal + convertNumberToKhmerWords(fraction);
+    }
+    return string;
+}

package/dist/test/en-SG.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/en-SG.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const languages_1 = require("../languages");
+describe("Number to English Words", () => {
+    test('converts 0 to "zero"', () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(0)).toBe("zero");
+    });
+    test("converts single digits", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(5)).toBe("five");
+        expect((0, languages_1.convertNumberToEnglishWords)(19)).toBe("nineteen");
+    });
+    test("converts tens correctly", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(20)).toBe("twenty");
+        expect((0, languages_1.convertNumberToEnglishWords)(42)).toBe("forty two");
+        expect((0, languages_1.convertNumberToEnglishWords)(99)).toBe("ninety nine");
+    });
+    test("converts hundreds correctly", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(100)).toBe("one hundred");
+        expect((0, languages_1.convertNumberToEnglishWords)(123)).toBe("one hundred twenty three");
+        expect((0, languages_1.convertNumberToEnglishWords)(999)).toBe("nine hundred ninety nine");
+    });
+    test("converts thousands and above", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(1000)).toBe("one thousand");
+        expect((0, languages_1.convertNumberToEnglishWords)(1234)).toBe("one thousand two hundred thirty four");
+        expect((0, languages_1.convertNumberToEnglishWords)(1000000)).toBe("one million");
+    });
+    test("converts negative numbers", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(-5)).toBe("negative five");
+        expect((0, languages_1.convertNumberToEnglishWords)(-1234)).toBe("negative one thousand two hundred thirty four");
+    });
+    test("converts decimal numbers", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(12.34)).toBe("twelve point three four");
+        expect((0, languages_1.convertNumberToEnglishWords)(-0.56)).toBe("negative zero point five six");
+    });
+});

package/dist/test/en.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/en.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const languages_1 = require("../languages");
+describe("Number to English Words", () => {
+    test('converts 0 to "zero"', () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(0)).toBe("zero");
+    });
+    test("converts single digits", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(5)).toBe("five");
+        expect((0, languages_1.convertNumberToEnglishWords)(19)).toBe("nineteen");
+    });
+    test("converts tens correctly", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(20)).toBe("twenty");
+        expect((0, languages_1.convertNumberToEnglishWords)(42)).toBe("forty two");
+        expect((0, languages_1.convertNumberToEnglishWords)(99)).toBe("ninety nine");
+    });
+    test("converts hundreds correctly", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(100)).toBe("one hundred");
+        expect((0, languages_1.convertNumberToEnglishWords)(123)).toBe("one hundred twenty three");
+        expect((0, languages_1.convertNumberToEnglishWords)(999)).toBe("nine hundred ninety nine");
+    });
+    test("converts thousands and above", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(1000)).toBe("one thousand");
+        expect((0, languages_1.convertNumberToEnglishWords)(1234)).toBe("one thousand two hundred thirty four");
+        expect((0, languages_1.convertNumberToEnglishWords)(1000000)).toBe("one million");
+    });
+    test("converts negative numbers", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(-5)).toBe("negative five");
+        expect((0, languages_1.convertNumberToEnglishWords)(-1234)).toBe("negative one thousand two hundred thirty four");
+    });
+    test("converts decimal numbers", () => {
+        expect((0, languages_1.convertNumberToEnglishWords)(12.34)).toBe("twelve point three four");
+        expect((0, languages_1.convertNumberToEnglishWords)(-0.56)).toBe("negative zero point five six");
+    });
+});

package/dist/test/km-KH.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/km-KH.test.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const languages_1 = require("../languages");
+describe("Number to Khmer Words", () => {
+    test("converts 0 to empty string", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(0)).toBe("សូន្យ");
+    });
+    test("converts single digits", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(1)).toBe("មួយ");
+        expect((0, languages_1.convertNumberToKhmerWords)(19)).toBe("ដប់ប្រាំបួន");
+    });
+    test("converts tens correctly", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(20)).toBe("ម្ភៃ");
+        expect((0, languages_1.convertNumberToKhmerWords)(42)).toBe("សែសិបពីរ");
+        expect((0, languages_1.convertNumberToKhmerWords)(99)).toBe("កៅសិបប្រាំបួន");
+    });
+    test("converts hundreds correctly", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(100)).toBe("មួយរយ");
+        expect((0, languages_1.convertNumberToKhmerWords)(123)).toBe("មួយរយម្ភៃបី");
+        expect((0, languages_1.convertNumberToKhmerWords)(999)).toBe("ប្រាំបួនរយកៅសិបប្រាំបួន");
+    });
+    test("converts thousands and above", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(1000)).toBe("មួយពាន់");
+        expect((0, languages_1.convertNumberToKhmerWords)(1234)).toBe("មួយពាន់ពីររយសាមសិបបួន");
+        expect((0, languages_1.convertNumberToKhmerWords)(1000000)).toBe("មួយលាន");
+    });
+    test("converts decimal numbers", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(12.34)).toBe("ដប់ពីរចុចសាមសិបបួន");
+        expect((0, languages_1.convertNumberToKhmerWords)(0.56)).toBe("សូន្យចុចហាសិបប្រាំមួយ");
+    });
+});

package/dist/test/km.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/km.test.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const languages_1 = require("../languages");
+describe("Number to Khmer Words", () => {
+    test("converts 0 to empty string", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(0)).toBe("សូន្យ");
+    });
+    test("converts single digits", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(1)).toBe("មួយ");
+        expect((0, languages_1.convertNumberToKhmerWords)(19)).toBe("ដប់ប្រាំបួន");
+    });
+    test("converts tens correctly", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(20)).toBe("ម្ភៃ");
+        expect((0, languages_1.convertNumberToKhmerWords)(42)).toBe("សែសិបពីរ");
+        expect((0, languages_1.convertNumberToKhmerWords)(99)).toBe("កៅសិបប្រាំបួន");
+    });
+    test("converts hundreds correctly", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(100)).toBe("មួយរយ");
+        expect((0, languages_1.convertNumberToKhmerWords)(123)).toBe("មួយរយម្ភៃបី");
+        expect((0, languages_1.convertNumberToKhmerWords)(999)).toBe("ប្រាំបួនរយកៅសិបប្រាំបួន");
+    });
+    test("converts thousands and above", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(1000)).toBe("មួយពាន់");
+        expect((0, languages_1.convertNumberToKhmerWords)(1234)).toBe("មួយពាន់ពីររយសាមសិបបួន");
+        expect((0, languages_1.convertNumberToKhmerWords)(1000000)).toBe("មួយលាន");
+    });
+    test("converts decimal numbers", () => {
+        expect((0, languages_1.convertNumberToKhmerWords)(12.34)).toBe("ដប់ពីរចុចសាមសិបបួន");
+        expect((0, languages_1.convertNumberToKhmerWords)(0.56)).toBe("សូន្យចុចហាសិបប្រាំមួយ");
+    });
+});

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export interface NumberToWords {
+    convert(number: number): string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1 @@
+export declare function splitNumber(number: number): number[];

package/dist/utils.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitNumber = splitNumber;
+function splitNumber(number) {
+    return [];
+}

package/jest.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/test/**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json', 'node'],
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@marcobytes/digits-to-words",
+  "version": "1.0.0",
+  "description": "Convert numbers to words in multiple languages (Khmer, English, etc.)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "numbers",
+    "words",
+    "english",
+    "khmer",
+    "cambodia",
+    "convert",
+    "multi-language"
+  ],
+  "author": "Marco Bytes",
+  "license": "MIT",
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@types/jest": "^30.0.0",
+    "babel-jest": "^30.2.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+import { convertNumberToEnglishWords } from "./languages/en-SG";
+import { convertNumberToKhmerWords } from "./languages/km-KH";
+
+/**
+ * Map all localization codes to internal converters.
+ * You can easily add more later.
+ */
+const LANGUAGE_ROUTER: Record<string, (n: number) => string> = {
+  // English variants
+  "en": convertNumberToEnglishWords,
+  "en-SG": convertNumberToEnglishWords,
+  "en-PH": convertNumberToEnglishWords,
+
+  // Khmer variants
+  "km": convertNumberToKhmerWords,
+  "km-KH": convertNumberToKhmerWords,
+};
+
+/**
+ * Public API
+ */
+export function toWords(number: number, lang: string = "en-SG"): string {
+  const key = lang.trim();
+
+  const converter = LANGUAGE_ROUTER[key] || LANGUAGE_ROUTER[key.toLowerCase()] || null;
+
+  if (!converter) {
+    throw new Error(
+      `Language "${lang}" is not supported yet. Supported languages: ${Object.keys(
+        LANGUAGE_ROUTER
+      ).join(", ")}`
+    );
+  }
+
+  return converter(number);
+}

package/src/languages/en-SG.ts

@@ -0,0 +1,101 @@
+export function convertNumberToEnglishWords(number: number | string): string {
+  const hyphen = " ";
+  const conjunction = " ";
+  const separator = " ";
+  const negative = "negative ";
+  const decimal = " point ";
+
+  const dictionary: Record<number, string> = {
+    0: "zero",
+    1: "one",
+    2: "two",
+    3: "three",
+    4: "four",
+    5: "five",
+    6: "six",
+    7: "seven",
+    8: "eight",
+    9: "nine",
+    10: "ten",
+    11: "eleven",
+    12: "twelve",
+    13: "thirteen",
+    14: "fourteen",
+    15: "fifteen",
+    16: "sixteen",
+    17: "seventeen",
+    18: "eighteen",
+    19: "nineteen",
+    20: "twenty",
+    30: "thirty",
+    40: "forty",
+    50: "fifty",
+    60: "sixty",
+    70: "seventy",
+    80: "eighty",
+    90: "ninety",
+    100: "hundred",
+    1000: "thousand",
+    1_000_000: "million",
+    1_000_000_000: "billion",
+    1_000_000_000_000: "trillion",
+  };
+
+  if (typeof number === "string") number = parseFloat(number);
+
+  if (isNaN(number)) return "";
+
+  if (number < 0)
+    return negative + convertNumberToEnglishWords(Math.abs(number));
+
+  let string = "";
+  let fraction: string | null = null;
+
+  let numberStr = number.toString();
+  if (numberStr.includes(".")) {
+    [numberStr, fraction] = numberStr.split(".");
+    number = parseInt(numberStr);
+  }
+
+  if (number < 21) {
+    string = dictionary[number]!;
+  } else if (number < 100) {
+    const tens = Math.floor(number / 10) * 10;
+    const units = number % 10;
+    string = dictionary[tens]!;
+    if (units) string += hyphen + dictionary[units];
+  } else if (number < 1000) {
+    const hundreds = Math.floor(number / 100);
+    const remainder = number % 100;
+    string = dictionary[hundreds]! + " " + dictionary[100];
+    if (remainder)
+      string += conjunction + convertNumberToEnglishWords(remainder);
+  } else {
+    const baseUnit = Math.pow(
+      1000,
+      Math.floor(Math.log(number) / Math.log(1000))
+    );
+    const numBaseUnits = Math.floor(number / baseUnit);
+    const remainder = number % baseUnit;
+    string =
+      convertNumberToEnglishWords(numBaseUnits) +
+      " " +
+      dictionary[baseUnit as keyof typeof dictionary];
+    if (remainder)
+      string +=
+        remainder < 100
+          ? conjunction
+          : separator + convertNumberToEnglishWords(remainder);
+  }
+
+  if (fraction) {
+    string +=
+      decimal +
+      fraction
+        .split("")
+        .map((d) => dictionary[parseInt(d)])
+        .join(" ");
+  }
+
+  return string;
+}

package/src/languages/index.ts

@@ -0,0 +1,2 @@
+export * from "./km-KH";
+export * from "./en-SG";

package/src/languages/km-KH.ts

@@ -0,0 +1,92 @@
+export function convertNumberToKhmerWords(number: number | string): string {
+  const hyphen = "";
+  const conjunction = "";
+  const separator = "";
+  const negative = "negative ";
+  const decimal = "ចុច";
+
+  const dictionary: Record<number, string> = {
+    0: "សូន្យ",
+    1: "មួយ",
+    2: "ពីរ",
+    3: "បី",
+    4: "បួន",
+    5: "ប្រាំ",
+    6: "ប្រាំមួយ",
+    7: "ប្រាំពីរ",
+    8: "ប្រាំបី",
+    9: "ប្រាំបួន",
+    10: "ដប់",
+    11: "ដប់មួយ",
+    12: "ដប់ពីរ",
+    13: "ដប់បី",
+    14: "ដប់បួន",
+    15: "ដប់ប្រាំ",
+    16: "ដប់ប្រាំមួយ",
+    17: "ដប់ប្រាំពីរ",
+    18: "ដប់ប្រាំបី",
+    19: "ដប់ប្រាំបួន",
+    20: "ម្ភៃ",
+    30: "សាមសិប",
+    40: "សែសិប",
+    50: "ហាសិប",
+    60: "ហុកសិប",
+    70: "ចិតសិប",
+    80: "ប៉ែតសិប",
+    90: "កៅសិប",
+    100: "រយ",
+    1000: "ពាន់",
+    1_000_000: "លាន"
+  };
+
+  if (typeof number === "string") number = parseFloat(number);
+
+  if (isNaN(number)) return "";
+
+  if (number < 0) return negative + convertNumberToKhmerWords(Math.abs(number));
+
+  let string = "";
+  let fraction: string | null = null;
+
+  let numberStr = number.toString();
+  if (numberStr.includes(".")) {
+    [numberStr, fraction] = numberStr.split(".");
+    number = parseInt(numberStr);
+  }
+
+  if (number < 21) {
+    string = dictionary[number]!;
+  } else if (number < 100) {
+    const tens = Math.floor(number / 10) * 10;
+    const units = number % 10;
+    string = dictionary[tens]!;
+    if (units) string += hyphen + dictionary[units];
+  } else if (number < 1000) {
+    const hundreds = Math.floor(number / 100);
+    const remainder = number % 100;
+    string = dictionary[hundreds]! + dictionary[100];
+    if (remainder) string += conjunction + convertNumberToKhmerWords(remainder);
+  } else {
+    const baseUnit = Math.pow(
+      1000,
+      Math.floor(Math.log(number) / Math.log(1000))
+    );
+    const numBaseUnits = Math.floor(number / baseUnit);
+    const remainder = number % baseUnit;
+    string =
+      convertNumberToKhmerWords(numBaseUnits) +
+      dictionary[baseUnit as keyof typeof dictionary];
+    if (remainder)
+      string +=
+        remainder < 100
+          ? conjunction
+          : separator + convertNumberToKhmerWords(remainder);
+  }
+
+  if (fraction) {
+    if (string === "") string = "0";
+    string += decimal + convertNumberToKhmerWords(fraction);
+  }
+
+  return string;
+}

package/src/test/en-SG.test.ts

@@ -0,0 +1,46 @@
+import { convertNumberToEnglishWords } from "../languages";
+
+describe("Number to English Words", () => {
+  test('converts 0 to "zero"', () => {
+    expect(convertNumberToEnglishWords(0)).toBe("zero");
+  });
+
+  test("converts single digits", () => {
+    expect(convertNumberToEnglishWords(5)).toBe("five");
+    expect(convertNumberToEnglishWords(19)).toBe("nineteen");
+  });
+
+  test("converts tens correctly", () => {
+    expect(convertNumberToEnglishWords(20)).toBe("twenty");
+    expect(convertNumberToEnglishWords(42)).toBe("forty two");
+    expect(convertNumberToEnglishWords(99)).toBe("ninety nine");
+  });
+
+  test("converts hundreds correctly", () => {
+    expect(convertNumberToEnglishWords(100)).toBe("one hundred");
+    expect(convertNumberToEnglishWords(123)).toBe("one hundred twenty three");
+    expect(convertNumberToEnglishWords(999)).toBe("nine hundred ninety nine");
+  });
+
+  test("converts thousands and above", () => {
+    expect(convertNumberToEnglishWords(1000)).toBe("one thousand");
+    expect(convertNumberToEnglishWords(1234)).toBe(
+      "one thousand two hundred thirty four"
+    );
+    expect(convertNumberToEnglishWords(1_000_000)).toBe("one million");
+  });
+
+  test("converts negative numbers", () => {
+    expect(convertNumberToEnglishWords(-5)).toBe("negative five");
+    expect(convertNumberToEnglishWords(-1234)).toBe(
+      "negative one thousand two hundred thirty four"
+    );
+  });
+
+  test("converts decimal numbers", () => {
+    expect(convertNumberToEnglishWords(12.34)).toBe("twelve point three four");
+    expect(convertNumberToEnglishWords(-0.56)).toBe(
+      "negative zero point five six"
+    );
+  });
+});

package/src/test/km-KH.test.ts

@@ -0,0 +1,35 @@
+import { convertNumberToKhmerWords } from "../languages";
+
+describe("Number to Khmer Words", () => {
+  test("converts 0 to empty string", () => {
+    expect(convertNumberToKhmerWords(0)).toBe("សូន្យ");
+  });
+
+  test("converts single digits", () => {
+    expect(convertNumberToKhmerWords(1)).toBe("មួយ");
+    expect(convertNumberToKhmerWords(19)).toBe("ដប់ប្រាំបួន");
+  });
+
+  test("converts tens correctly", () => {
+    expect(convertNumberToKhmerWords(20)).toBe("ម្ភៃ");
+    expect(convertNumberToKhmerWords(42)).toBe("សែសិបពីរ");
+    expect(convertNumberToKhmerWords(99)).toBe("កៅសិបប្រាំបួន");
+  });
+
+  test("converts hundreds correctly", () => {
+    expect(convertNumberToKhmerWords(100)).toBe("មួយរយ");
+    expect(convertNumberToKhmerWords(123)).toBe("មួយរយម្ភៃបី");
+    expect(convertNumberToKhmerWords(999)).toBe("ប្រាំបួនរយកៅសិបប្រាំបួន");
+  });
+
+  test("converts thousands and above", () => {
+    expect(convertNumberToKhmerWords(1000)).toBe("មួយពាន់");
+    expect(convertNumberToKhmerWords(1234)).toBe("មួយពាន់ពីររយសាមសិបបួន");
+    expect(convertNumberToKhmerWords(1_000_000)).toBe("មួយលាន");
+  });
+
+  test("converts decimal numbers", () => {
+    expect(convertNumberToKhmerWords(12.34)).toBe("ដប់ពីរចុចសាមសិបបួន");
+    expect(convertNumberToKhmerWords(0.56)).toBe("សូន្យចុចហាសិបប្រាំមួយ");
+  });
+});

package/src/types.ts

@@ -0,0 +1,3 @@
+export interface NumberToWords {
+  convert(number: number): string;
+}

package/src/utils.ts

@@ -0,0 +1,3 @@
+export function splitNumber(number: number): number[] {
+  return [];
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES6",
+    "module": "CommonJS",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true
+  },
+  "include": ["src"]
+}