{"_id":"@dak-ia/num-to-word","_rev":"4-3c697e80e9574c7067dab92bdaa9b200","name":"@dak-ia/num-to-word","dist-tags":{"beta":"0.2.0-test-1","latest":"0.3.0"},"versions":{"0.2.0-test-1":{"name":"@dak-ia/num-to-word","version":"0.2.0-test-1","keywords":["number","word","conversion","i18n","english","japanese","si-prefix","number-to-words"],"author":{"name":"dak-ia"},"license":"MIT","_id":"@dak-ia/num-to-word@0.2.0-test-1","maintainers":[{"name":"dak-ia","email":"xdak.iax@gmail.com"}],"homepage":"https://github.com/dak-ia/num-to-word#readme","bugs":{"url":"https://github.com/dak-ia/num-to-word/issues"},"dist":{"shasum":"7e44235126fb146412ccd370e88a0a093287aa12","tarball":"https://registry.npmjs.org/@dak-ia/num-to-word/-/num-to-word-0.2.0-test-1.tgz","fileCount":31,"integrity":"sha512-AacpAsAaDWkizdSYVjF9yB3hj5wmrbFxu6Y0vjq6M7G+BwRTuSknR5qWUg0iedHtl+OYb/nZxjkV215zn1QKhg==","signatures":[{"sig":"MEYCIQCpHBMRMqb5jy9jKzVY7eBJWeuxlBFD5ac3yDmajIbndQIhAMkUT9UeqSy5Qx3M6HqZpqjPGMA3wF46UzBK8w2v9n4n","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46305},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","unpkg":"./dist/index.umd.js","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"gitHead":"ca68caaed8a08d63a349b0db17cdc56ec960c683","scripts":{"dev":"vite","tsc":"tsc --noEmit","lint":"eslint .","test":"jest","build":"tsc --noEmit && vite build && tsc","format":"prettier --write \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","prepare":"husky","preview":"vite preview","lint:fix":"eslint . --fix","test:watch":"jest --watch","format:check":"prettier --check \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","test:coverage":"jest --coverage"},"_npmUser":{"name":"dak-ia","email":"xdak.iax@gmail.com"},"jsdelivr":"./dist/index.umd.js","repository":{"url":"git+https://github.com/dak-ia/num-to-word.git","type":"git"},"_npmVersion":"11.6.2","description":"Convert numbers to words in multiple languages (English, Japanese, SI prefixes)","directories":{},"lint-staged":{"src/**/*.{ts,tsx}":["bash -c 'tsc --noEmit --project tsconfig.json'"],"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}":["prettier --write","eslint . --fix"]},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","vite":"^7.2.2","husky":"^9.1.7","eslint":"^9.39.1","prettier":"^3.6.2","@swc/jest":"^0.2.39","typescript":"5.9.3","@types/jest":"30.0.0","lint-staged":"^16.2.6","typescript-eslint":"^8.46.4"},"_npmOperationalInternal":{"tmp":"tmp/num-to-word_0.2.0-test-1_1770839607525_0.22670515787052548","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@dak-ia/num-to-word","version":"0.2.0","keywords":["number","word","conversion","i18n","english","japanese","si-prefix","number-to-words"],"author":{"name":"dak-ia"},"license":"MIT","_id":"@dak-ia/num-to-word@0.2.0","maintainers":[{"name":"dak-ia","email":"xdak.iax@gmail.com"}],"homepage":"https://github.com/dak-ia/num-to-word#readme","bugs":{"url":"https://github.com/dak-ia/num-to-word/issues"},"dist":{"shasum":"be53432918b7ff1d0c416bfc5b7ab217968ae3eb","tarball":"https://registry.npmjs.org/@dak-ia/num-to-word/-/num-to-word-0.2.0.tgz","fileCount":31,"integrity":"sha512-obzOZaPFz12Z5teIsmmnYXf2gu4Mdu6ua5VQnN9DGo//szLw/hqFCkhbkmod/4K58MyLy83pLIB3efSDalcA/Q==","signatures":[{"sig":"MEUCICu3xe+ahm+sge/mWyW4KwJStRqdUpLJ3UD/D7xiuvkDAiEAik52pBumm85NSO3GWRRFVPhqwyxVYGJprccV0S8mU+0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dak-ia%2fnum-to-word@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":46277},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","unpkg":"./dist/index.umd.js","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"gitHead":"00bbfc75e767c4375d0ac5d956fb5bc6b26aa6cb","scripts":{"dev":"vite","tsc":"tsc --noEmit","lint":"eslint .","test":"jest","build":"tsc --noEmit && vite build && tsc","format":"prettier --write \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","prepare":"husky","preview":"vite preview","lint:fix":"eslint . --fix","test:watch":"jest --watch","format:check":"prettier --check \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","test:coverage":"jest --coverage"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:868b36b3-2b9b-4711-847e-c0ab53cae77d"}},"jsdelivr":"./dist/index.umd.js","repository":{"url":"git+https://github.com/dak-ia/num-to-word.git","type":"git"},"_npmVersion":"11.6.2","description":"Convert numbers to words in multiple languages (English, Japanese, SI prefixes)","directories":{},"lint-staged":{"src/**/*.{ts,tsx}":["bash -c 'tsc --noEmit --project tsconfig.json'"],"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}":["prettier --write","eslint . --fix"]},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","vite":"^7.2.2","husky":"^9.1.7","eslint":"^9.39.1","prettier":"^3.6.2","@swc/jest":"^0.2.39","typescript":"5.9.3","@types/jest":"30.0.0","lint-staged":"^16.2.6","typescript-eslint":"^8.46.4"},"_npmOperationalInternal":{"tmp":"tmp/num-to-word_0.2.0_1770841594139_0.7994305168201976","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@dak-ia/num-to-word","version":"0.2.1","keywords":["number","word","conversion","i18n","english","japanese","si-prefix","number-to-words"],"author":{"name":"dak-ia"},"license":"MIT","_id":"@dak-ia/num-to-word@0.2.1","maintainers":[{"name":"dak-ia","email":"xdak.iax@gmail.com"}],"homepage":"https://github.com/dak-ia/num-to-word#readme","bugs":{"url":"https://github.com/dak-ia/num-to-word/issues"},"dist":{"shasum":"a3c6c26419ace347472986fff45c8e9c00b267cc","tarball":"https://registry.npmjs.org/@dak-ia/num-to-word/-/num-to-word-0.2.1.tgz","fileCount":31,"integrity":"sha512-1yQXykiA2i09eAnwATcIn4nZgwCp+DV4rAS2zhMiRe4jzNPldI4Li6qlBb4lt/NyCoLD/nH0WqrcOKdzuivFQA==","signatures":[{"sig":"MEQCIGIe/FkHnl2tiEt97zHvJvb6MxOkCPwMFQWlNaWeGkIhAiBjbxWXJ8ls++X7JAUC4+WwYYtH4FNQwa6/OKY/JHE0eg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dak-ia%2fnum-to-word@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":52251},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","unpkg":"./dist/index.umd.js","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"gitHead":"1a791eb26412f3e6becf3c05fa8dda3c8274b7e9","scripts":{"dev":"vite","tsc":"tsc --noEmit","lint":"eslint .","test":"jest","build":"tsc --noEmit && vite build && tsc","format":"prettier --write \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","prepare":"husky","preview":"vite preview","lint:fix":"eslint . --fix","test:watch":"jest --watch","format:check":"prettier --check \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","test:coverage":"jest --coverage"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:868b36b3-2b9b-4711-847e-c0ab53cae77d"}},"jsdelivr":"./dist/index.umd.js","repository":{"url":"git+https://github.com/dak-ia/num-to-word.git","type":"git"},"_npmVersion":"11.6.2","description":"Convert numbers to words in multiple languages (English, Japanese, SI prefixes)","directories":{},"lint-staged":{"src/**/*.{ts,tsx}":["bash -c 'tsc --noEmit --project tsconfig.json'"],"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}":["prettier --write","eslint . --fix"]},"_nodeVersion":"25.2.1","dependencies":{"expand-exponential":"^0.1.1"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","vite":"^7.2.2","husky":"^9.1.7","eslint":"^9.39.1","prettier":"^3.6.2","@swc/jest":"^0.2.39","typescript":"5.9.3","@types/jest":"30.0.0","lint-staged":"^16.2.6","typescript-eslint":"^8.46.4"},"_npmOperationalInternal":{"tmp":"tmp/num-to-word_0.2.1_1774043204222_0.08741960738832888","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@dak-ia/num-to-word@0.3.0","bugs":{"url":"https://github.com/dak-ia/num-to-word/issues"},"dist":{"shasum":"0ea4b2accece72cade8e12be1e0bc0e60eed7d38","tarball":"https://registry.npmjs.org/@dak-ia/num-to-word/-/num-to-word-0.3.0.tgz","fileCount":81,"integrity":"sha512-lOnMDLlQp1YKerH65CmrrEL8gX3nSFzTYdCOJd6B7MH6hp2+n9XIKykuDeSuFXy4ZKqWaiC/cfSvuTeC5ls2SQ==","signatures":[{"sig":"MEUCIQCFexeH8ZJjNtUg/bzRN3flaIMOwwHMK2Sm/VFKA81Q0QIgY2cfAIyIE4xiqYrwzRZQqa60IQazkD349Xu1IWVP4nY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG6wYHOtxoQqdlk4RgKt7cXDHKzt4GufUJpmTczD+XJAAiEA2GJ0s8L9ZRXBgH6iQe6DEN57m+fFjp7JIQoVrYMnt10="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dak-ia%2fnum-to-word@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":125242},"main":"./dist/index.cjs","name":"@dak-ia/num-to-word","type":"module","types":"./dist/index.d.ts","unpkg":"./dist/index.umd.js","author":{"name":"dak-ia"},"module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"gitHead":"dfe175ee23b3dfc007985d05547ac3c39286fc4c","license":"MIT","scripts":{"dev":"vite","tsc":"tsc --noEmit && tsc -p tsconfig.scripts.json && tsc -p tsconfig.test.json","lint":"eslint .","test":"NODE_OPTIONS=--experimental-vm-modules jest","build":"npm run tsc && vite build && tsc","format":"prettier --write \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","prepare":"husky","preview":"vite preview","generate":"node scripts/generate.ts","lint:fix":"eslint . --fix","test:watch":"NODE_OPTIONS=--experimental-vm-modules jest --watch","format:check":"prettier --check \"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}\"","test:coverage":"NODE_OPTIONS=--experimental-vm-modules jest --coverage","generate:check":"node scripts/generate.ts --check"},"version":"0.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:868b36b3-2b9b-4711-847e-c0ab53cae77d"}},"homepage":"https://github.com/dak-ia/num-to-word#readme","jsdelivr":"./dist/index.umd.js","keywords":["number","word","conversion","i18n","number-to-words","si-prefix","roman-numerals","daiji","kanji","arabic","bengali","chinese","dutch","english","french","german","greek","hindi","indonesian","italian","japanese","korean","polish","portuguese","russian","spanish","thai","turkish","vietnamese"],"devEngines":{"runtime":{"name":"node","onFail":"error","version":">=22.18.0"}},"repository":{"url":"git+https://github.com/dak-ia/num-to-word.git","type":"git"},"_npmVersion":"11.6.2","description":"Convert numbers to words in multiple languages (English, Japanese, Chinese, Hindi, Spanish, Arabic, French and more), plus Roman numerals, Japanese daiji and SI prefixes","directories":{},"lint-staged":{"scripts/**/*.ts":["bash -c 'tsc --noEmit -p tsconfig.scripts.json'"],"src/**/*.{ts,tsx}":["bash -c 'tsc --noEmit --project tsconfig.json'","bash -c 'tsc --noEmit -p tsconfig.test.json'"],"**/*.{js,jsx,ts,tsx,json,md,html,css,scss}":["prettier --write","eslint --fix"]},"maintainers":[{"name":"dak-ia","email":"xdak.iax@gmail.com"}],"_nodeVersion":"25.2.1","dependencies":{"expand-exponential":"^0.3.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","vite":"^7.2.2","husky":"^9.1.7","eslint":"^9.39.1","esbuild":"^0.25.12","globals":"^14.0.0","prettier":"^3.6.2","@swc/jest":"^0.2.39","@eslint/js":"^9.39.5","typescript":"5.9.3","@types/jest":"30.0.0","@types/node":"^24.13.3","lint-staged":"^16.2.6","typescript-eslint":"^8.46.4"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/num-to-word_0.3.0_1789956239021_0.4333902713221176"}}},"time":{"created":"2026-02-11T19:53:27.435Z","modified":"2026-09-21T02:03:59.447Z","0.2.0-test-1":"2026-02-11T19:53:27.674Z","0.2.0":"2026-02-11T20:26:34.313Z","0.2.1":"2026-03-20T21:46:44.377Z","0.3.0":"2026-09-21T02:03:59.115Z"},"bugs":{"url":"https://github.com/dak-ia/num-to-word/issues"},"author":{"name":"dak-ia"},"license":"MIT","homepage":"https://github.com/dak-ia/num-to-word#readme","keywords":["number","word","conversion","i18n","number-to-words","si-prefix","roman-numerals","daiji","kanji","arabic","bengali","chinese","dutch","english","french","german","greek","hindi","indonesian","italian","japanese","korean","polish","portuguese","russian","spanish","thai","turkish","vietnamese"],"repository":{"url":"git+https://github.com/dak-ia/num-to-word.git","type":"git"},"description":"Convert numbers to words in multiple languages (English, Japanese, Chinese, Hindi, Spanish, Arabic, French and more), plus Roman numerals, Japanese daiji and SI prefixes","maintainers":[{"name":"dak-ia","email":"xdak.iax@gmail.com"}],"readme":"# num-to-word\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\n[![Node.js for development](<https://img.shields.io/badge/node%20(dev)-%3E%3D22.18.0-brightgreen.svg>)](https://nodejs.org/)\n[![Coverage](https://img.shields.io/badge/dynamic/json?url=https://gist.githubusercontent.com/dak-ia/1bf4a4df60ed549dfd9a42b24c72045e/raw/num-to-word-coverage.json&label=coverage&query=$.coverage&suffix=%25&color=brightgreen)](https://github.com/dak-ia/num-to-word/actions/workflows/jest-check.yml)\n\n数字を各言語の単語に変換します。1桁ずつの変換（棒読み）は多くの言語に対応していて、数としての変換は今のところ英語と日本語だけです。ローマ数字・大字・SI接頭語にも変換できます。\n\nConvert numbers to words. Digit-by-digit conversion covers many languages, while reading a number as a whole is currently English and Japanese only. Roman numerals, Japanese daiji and SI prefixes are supported too.\n\n---\n\n## 📖 目次 / Table of Contents\n\n- [📦 インストール / Installation](#インストール--installation)\n- [🚀 クイックスタート / Quick Start](#クイックスタート--quick-start)\n- [📚 APIリファレンス / API Reference](#apiリファレンス--api-reference)\n- [📝 入力形式 / Input Format](#入力形式--input-format)\n- [💻 TypeScriptサポート / TypeScript Support](#typescriptサポート--typescript-support)\n- [🎨 Examples](#examples)\n- [🛠️ 開発 / Development](#開発--development)\n\n---\n\n## 📦 インストール / Installation\n\n最新リリースは[Releasesページ](https://github.com/dak-ia/num-to-word/releases)からダウンロードできます。\n\nDownload the latest release from the [Releases page](https://github.com/dak-ia/num-to-word/releases).\n\n```bash\n# npm (scoped package)\nnpm install @dak-ia/num-to-word\n```\n\n## 🚀 クイックスタート / Quick Start\n\n### Node.js (CommonJS)\n\n```javascript\nconst { numToEnglish, numToJapanese, numToDaiji, numToSi, numToWord } = require(\"@dak-ia/num-to-word\");\n\nconsole.log(numToEnglish(123456.789));\n// → \"One hundred twenty-three thousand four hundred fifty-six point seven eight nine\"\n```\n\n### Node.js (ESM)\n\n```javascript\nimport { numToEnglish, numToJapanese, numToDaiji, numToSi, numToWord } from \"@dak-ia/num-to-word\";\n\nconsole.log(numToEnglish(123456.789));\n// → \"One hundred twenty-three thousand four hundred fifty-six point seven eight nine\"\n```\n\n### 🌐 CDN経由での利用 / Use via CDN\n\njsDelivrやunpkgのCDNから直接ブラウザで利用できます。\n\nYou can use the library directly in the browser via jsDelivr or unpkg CDN.\n\n```html\n<script src=\"https://cdn.jsdelivr.net/npm/@dak-ia/num-to-word/dist/index.umd.js\"></script>\n<script>\n  // グローバル変数NumToWord経由で利用できます\n  // Use via global variable NumToWord\n  const ntw = NumToWord;\n  console.log(ntw.numToWord(\"en\", 123)); // \"One hundred twenty-three\"\n  console.log(ntw.numToWord(\"jp\", 123)); // \"百二十三\"\n  console.log(ntw.numToWord(\"si\", 1234)); // \"1.234K\"\n</script>\n```\n\nunpkgも同様に利用可能です：\n\nYou can also use unpkg:\n\n```html\n<script src=\"https://unpkg.com/@dak-ia/num-to-word/dist/index.umd.js\"></script>\n```\n\n---\n\n## 📚 APIリファレンス / API Reference\n\n### `numToEnglish(number)` / `numToJapanese(number)` / `numToDaiji(number)` / `numToSi(number)`\n\n数を読み方どおりに変換します。桁の単位語（hundred、万など）やSI接頭語を使うため、変換できる桁数に上限があります。\n\nConvert a number the way it is read as a whole. They use scale words such as \"hundred\" or 万, or SI prefixes, so the number of digits is capped.\n\n- **引数 / Parameters**: `number` (number | string) - 変換する数字 / The number to convert\n- **戻り値 / Returns**: string - 数としての読み / The number as it is read\n- **負の数 / Negative numbers**: サポート / Supported\n- **例 / Example**:\n  ```javascript\n  numToEnglish(123); // \"One hundred twenty-three\"\n  numToJapanese(123); // \"百二十三\"\n  numToDaiji(123); // \"壱陌弐拾参\"\n  numToSi(1234); // \"1.234K\"\n  ```\n\n関数ごとの上限や詳細は[docs/places.md](https://github.com/dak-ia/num-to-word/blob/main/docs/places.md)にまとめています。\n\nThe upper limit and the details of each function are in [docs/places.md](https://github.com/dak-ia/num-to-word/blob/main/docs/places.md).\n\n### `numTo***Digits(number, letterCase?)`\n\n数字を1桁ずつ変換します（いわゆる棒読み）。IDなどのように、桁をそのまま表現したい場合に使います。多くの言語に対応し、ローマ数字と大字も同じ形で使えます。\n\nConvert a number digit by digit. Use these when the digits themselves matter, such as IDs. Many languages are supported, along with Roman numerals and Japanese daiji.\n\n- **引数 / Parameters**:\n  - `number` (number | string) - 変換する数字 / The number to convert\n  - `letterCase` (`\"capitalize\"` | `\"upper\"` | `\"lower\"`) - 大文字小文字の指定 / Letter case\n- **戻り値 / Returns**: string - 1桁ずつの読み（棒読み） / Digit-by-digit representation\n- **範囲 / Range**: 上限なし（桁の単位語を使わないため）/ No limit, because no scale words are used\n- **例 / Example**:\n  ```javascript\n  numToEnglishDigits(\"0123\"); // \"Zero one two three\"\n  numToJapaneseDigits(\"0123\"); // \"〇一二三\"\n  numToEnglishDigits(\"1.50\"); // \"One point five zero\"\n  numToEnglishDigits(-12); // \"Minus one two\"\n  numToEnglishDigits(\"12\", \"upper\"); // \"ONE TWO\"\n  ```\n\n対応する変換の関数名・ロケール・変換例は[docs/digits.md](https://github.com/dak-ia/num-to-word/blob/main/docs/digits.md)にまとめています。\n\nThe full list, with function names, locales and examples, is in [docs/digits.md](https://github.com/dak-ia/num-to-word/blob/main/docs/digits.md).\n\n### `numToWord(locale, number, letterCase?)`\n\n指定したロケールで数字を変換します。\n\nConvert a number using the specified locale.\n\n- **引数 / Parameters**:\n  - `locale` (string) - ロケール識別子 / Locale identifier: `\"si\"`, `\"en\"`, `\"english\"`, `\"jp\"`, `\"japanese\"`, `\"kanji\"`, `\"jpdaiji\"`, `\"daiji\"`\n    - 末尾に`-digits`を付けると1桁ずつ変換します（`\"en-digits\"`, `\"jp-digits\"`, `\"daiji-digits\"`など）。`\"si\"`は1桁ずつの変換がありません / Append `-digits` to convert digit by digit. Not available for `\"si\"`\n    - 1桁ずつの変換（棒読み）に使えるロケールの一覧は[docs/digits.md](https://github.com/dak-ia/num-to-word/blob/main/docs/digits.md) / The full list of digit-by-digit locales is in [docs/digits.md](https://github.com/dak-ia/num-to-word/blob/main/docs/digits.md)\n    - ロケールは`locales`としてexportしています / The locales are exported as `locales`\n  - `number` (number | string) - 変換する数字 / The number to convert\n  - `letterCase` (`\"capitalize\"` | `\"upper\"` | `\"lower\"`) - 大文字小文字の指定 / Letter case\n- **戻り値 / Returns**: string - 指定したロケールでの読み / Localized representation\n- **負の数 / Negative numbers**: 全ロケールでサポート / Supported in all locales\n- **例 / Example**:\n  ```javascript\n  numToWord(\"en\", 123); // \"One hundred twenty-three\"\n  numToWord(\"jp\", 123); // \"百二十三\"\n  numToWord(\"si\", 123456); // \"123.456K\"\n  numToWord(\"en\", -123); // \"Minus one hundred twenty-three\"\n  numToWord(\"en-digits\", \"0123\"); // \"Zero one two three\"\n  numToWord(\"jp-digits\", \"0123\"); // \"〇一二三\"\n  numToWord(\"en-digits\", \"0123\", \"upper\"); // \"ZERO ONE TWO THREE\"\n  ```\n\n## 📝 入力形式 / Input Format\n\n### 変換ルール / Conversion Policy\n\n- **言語への変換 / To words**: 数としての読み方に変換します。整数部の先頭のゼロや小数部の末尾のゼロは値に影響しないため取り除きます。 / converted as a numeral. Leading zeros in the integer part and trailing zeros in the decimal part are removed because they do not affect the value.\n- **単位への変換 / To units**: SI接頭語として適切な形式に整えます。末尾のゼロやゼロの符号など、表記として不要なものは取り除きます。 / formatted as a proper SI prefix notation. Anything unnecessary for the notation, such as trailing zeros and the sign of zero, is removed.\n\n```javascript\nnumToEnglish(\"0123.500\"); // \"One hundred twenty-three point five\"\nnumToJapanese(\"0123.500\"); // \"百二十三・五\"\nnumToSi(\"0123.500\"); // \"123.5\"\n```\n\n### サポートされている入力タイプ / Supported Input Types\n\n- **number型 / Number type**: `numToEnglish(123)`\n- **string型（推奨）/ String type (recommended)**: `numToEnglish(\"123\")`\n- **指数表記 / Exponential notation**: `numToEnglish(\"1.23e5\")` → `\"One hundred twenty-three thousand\"`\n- **全角数字 / Full-width numbers**: `numToEnglish(\"123\")` （自動変換 / converted automatically）\n- **区切り文字 / Separators**: `numToEnglish(\"123,456,789\")`, `numToGermanDigits(\"1.234,5\")` （桁区切りは自動的に削除。小数点と桁区切りに使う文字は言語ごと / group separators are removed automatically, and which characters are used depends on the language）\n- **Infinity / 無限大**: `numToEnglish(Infinity)` → `\"Infinity\"`, `numToJapanese(Infinity)` → `\"無限\"`\n\n### 指数表記について / About Exponential Notation\n\n指数表記（例: `1.23e5`、`5.67e-3`）がサポートされています。入力時に自動で展開します。\n\nExponential notation (e.g., `1.23e5`, `5.67e-3`) is supported and automatically expanded.\n\n```javascript\nnumToEnglish(\"1.23e5\"); // \"One hundred twenty-three thousand\"\nnumToEnglish(\"5.67e-3\"); // \"Zero point zero zero five six seven\"\nnumToJapanese(\"1.5e4\"); // \"一万五千\"\n```\n\n## 💻 TypeScriptサポート / TypeScript Support\n\nTypeScript型定義が含まれています。\n\nTypeScript definitions are included.\n\n```typescript\nimport { numToEnglish } from \"@dak-ia/num-to-word\";\n\nconst result: string = numToEnglish(123);\n```\n\n## 🎨 Examples\n\n[デモページ](https://dak-ia.github.io/num-to-word/)で動作を試せます。同じものがリポジトリにも含まれているので、手元で開くこともできます。\n\nTry it on the [demo page](https://dak-ia.github.io/num-to-word/). The same page is included in the repository, so you can also open it locally.\n\n```bash\n# 開発サーバーで、手元のコードを試す / Try the local code with the dev server\nnpm run dev\n# http://localhost:5173/\n```\n\n## 🛠️ 開発 / Development\n\n### ビルド / Build\n\n```bash\nnpm run build         # ビルドを実行 / Build the project\n```\n\n### テストの実行 / Running Tests\n\n```bash\nnpm test              # 全テストを実行 / Run all tests\nnpm run test:watch    # ウォッチモードでテストを実行 / Run tests in watch mode\nnpm run test:coverage # カバレッジレポート付きでテストを実行 / Run tests with coverage report\n```\n\n### 1桁ずつの変換（棒読み）の生成 / Generating the Digit Converters\n\n`src/converters/digits/`以下の`numTo***Digits`と一覧の`docs/digits.md`は`src/dictionaries/`の辞書から自動生成しています。\n\nThe `numTo***Digits` functions under `src/converters/digits/` and the list in `docs/digits.md` are generated from the dictionaries in `src/dictionaries/`.\n\n```bash\nnpm run generate       # 辞書から1桁ずつの変換を生成 / Generate the converters from the dictionaries\nnpm run generate:check # 生成物が辞書と一致するか確認 / Check the generated files match the dictionaries\n```\n\n---\n\n## ライセンス / License\n\nMIT License\n\n## 作者 / Author\n\n[dak-ia](https://github.com/dak-ia)\n\n## リポジトリ / Repository\n\nhttps://github.com/dak-ia/num-to-word\n","readmeFilename":"README.md"}