@ryokaringumi/english-number-naming-js 1.0.0

package/README.md

@@ -0,0 +1,38 @@
+# english-number-naming
+
+A JavaScript library to convert numbers to their English word representations.
+
+## Installation
+
+```bash
+npm install english-number-naming
+```
+
+## Usage
+
+```javascript
+const { numberToEnglish } = require('english-number-naming');
+
+console.log(numberToEnglish(123)); // "one hundred twenty-three"
+console.log(numberToEnglish(0)); // "zero"
+console.log(numberToEnglish(-5)); // "minus five"
+console.log(numberToEnglish(3.14)); // "three point one four"
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Test
+
+```bash
+npm run test
+```
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function numberToEnglish(n: number): string;

package/dist/index.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberToEnglish = numberToEnglish;
+function zeroToTowelve(n) {
+    const ones = [
+        "zero",
+        "one",
+        "two",
+        "three",
+        "four",
+        "five",
+        "six",
+        "seven",
+        "eight",
+        "nine",
+        "ten",
+        "eleven",
+        "twelve",
+    ];
+    return ones[n];
+}
+function thirteenToNineteen(n) {
+    if (n === 13)
+        return "thirteen";
+    if (n === 15)
+        return "fifteen";
+    if (n === 18)
+        return "eighteen";
+    return numberToEnglish(n % 10) + "teen";
+}
+function twentyToNinetyNine(n) {
+    const tens = [
+        "",
+        "ten",
+        "twenty",
+        "thirty",
+        "forty",
+        "fifty",
+        "sixty",
+        "seventy",
+        "eighty",
+        "ninety",
+    ];
+    const tenPart = Math.floor(n / 10);
+    const onePart = n % 10;
+    if (onePart === 0) {
+        return tens[tenPart];
+    }
+    else {
+        return tens[tenPart] + "-" + numberToEnglish(onePart);
+    }
+}
+function oneHundredToNineHundredNinetyNine(n) {
+    const hundredPart = Math.floor(n / 100);
+    const restPart = n % 100;
+    if (restPart === 0) {
+        return numberToEnglish(hundredPart) + " hundred";
+    }
+    else {
+        return numberToEnglish(hundredPart) + " hundred " + numberToEnglish(restPart);
+    }
+}
+function largeNumber(number) {
+    const digits = Math.floor(Math.log10(number)) + 1;
+    const largeNumberUnits = {
+        4: "thousand",
+        7: "million",
+        10: "billion",
+        13: "trillion",
+        16: "quadrillion",
+        19: "quintillion",
+    };
+    let unitsDigits = digits;
+    while (!(unitsDigits in largeNumberUnits) && unitsDigits > 3) {
+        unitsDigits--;
+    }
+    const unitName = largeNumberUnits[unitsDigits];
+    const unitValue = Math.pow(10, unitsDigits - 1);
+    const leadingPart = Math.floor(number / unitValue);
+    const restPart = number % unitValue;
+    let result = numberToEnglish(leadingPart) + " " + unitName;
+    if (restPart > 0) {
+        result += " " + numberToEnglish(restPart);
+    }
+    return result;
+}
+function decimalPointToEnglish(n) {
+    const naturalPart = Math.floor(n);
+    let result = numberToEnglish(naturalPart) + " point";
+    const decimalString = n.toString().split(".")[1].split("").map(c => numberToEnglish(parseInt(c))).join(" ");
+    return result + " " + decimalString;
+}
+function numberToEnglish(n) {
+    if (Number.isNaN(n)) {
+        throw new Error("Input is not a number");
+    }
+    if (n < 0) {
+        return "minus " + numberToEnglish(-n);
+    }
+    if (n % 1 !== 0) {
+        return decimalPointToEnglish(n);
+    }
+    const digits = Math.floor(Math.log10(n)) + 1;
+    if (digits >= 4) {
+        return largeNumber(n);
+    }
+    if (n >= 0 && n <= 12) {
+        return zeroToTowelve(n);
+    }
+    if (n >= 13 && n <= 19) {
+        return thirteenToNineteen(n);
+    }
+    if (n >= 20 && n <= 99) {
+        return twentyToNinetyNine(n);
+    }
+    if (n >= 100 && n <= 999) {
+        return oneHundredToNineHundredNinetyNine(n);
+    }
+    throw new Error("Number out of range");
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ryokaringumi/english-number-naming-js",
+  "version": "1.0.0",
+  "description": "A JavaScript library to convert numbers to their English word representations.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "number",
+    "english",
+    "conversion",
+    "words"
+  ],
+  "author": "RyoKaringumi",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ryokaringumi/english-number-naming-js.git"
+  },
+  "homepage": "https://github.com/ryokaringumi/english-number-naming-js#readme",
+  "bugs": {
+    "url": "https://github.com/ryokaringumi/english-number-naming-js/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "vitest": {
+    "include": ["src/**/*.test.ts"],
+    "exclude": ["dist/**"]
+  }
+}