pomotty 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iririn1998
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,53 @@
+# pomotty
+
+[English](./README.md) | 日本語
+
+Node.js 22以降で利用できる、ターミナル用のポモドーロタイマーです。
+
+```shell
+npx pomotty
+```
+
+グローバルにインストールする場合は、次のコマンドを実行します。
+
+```shell
+npm install --global pomotty
+pomotty
+```
+
+`pomotty`で作業開始の選択メニューを表示します。上下キーで`OK`を選んで
+Enterを押すと15分の作業と5分の休憩を3セット実行し、`NG`を選ぶとタイマーを
+開始せず終了します。
+
+```shell
+pomotty
+```
+
+作業時間と休憩時間は、1〜1440の整数（分）で指定できます。片方だけを指定した
+場合、もう片方には既定値が使われます。
+
+```shell
+pomotty --work 30 --break 10
+pomotty --work=45 --break=15
+```
+
+`--loop`で作業・休憩の繰り返し回数を指定できます。既定値は3で、1以上の整数
+（最大9007199254740991）を受け付けます。開始確認は最初の1回だけで、最後の休憩が
+完了すると終了します。
+
+```shell
+pomotty --loop 5
+pomotty --work=25 --break=5 --loop=2
+```
+
+利用可能なオプションは、次のコマンドで確認できます。
+
+```shell
+pomotty --help
+```
+
+作業と休憩の完了時には、それぞれ異なる通知音を再生します。macOSでは
+`afplay`、Linuxでは`paplay`または`aplay`、WindowsではPowerShellを利用し、
+再生できない環境では異なる回数のターミナルベルに切り替わります。
+
+開発手順とnpmへの公開・更新手順は[開発ガイド](./DEVELOPMENT.ja.md)を参照してください。

package/README.md

@@ -1,77 +1,58 @@
 # pomotty
 
-Node.js 22以降で利用できる、ターミナル用のポモドーロタイマーです。
+English | [日本語](./README.ja.md)
+
+A Pomodoro timer for the terminal, available on Node.js `^22.18.0 || >=24.11.0`.
 
 ```shell
 npx pomotty
 ```
 
-グローバルにインストールする場合は、次のコマンドを実行します。
+To install it globally, run:
 
 ```shell
 npm install --global pomotty
 pomotty
 ```
 
-`pomotty`で作業開始の選択メニューを表示します。上下キーで`OK`を選んで
-Enterを押すと15分の作業と5分の休憩を3セット実行し、`NG`を選ぶとタイマーを
-開始せず終了します。
+Run `pomotty` to display the start menu. Use the up and down arrow keys to select
+`OK`, then press Enter to start 3 cycles of 15 minutes of work and 5 minutes of
+break. Select `NG` to exit without starting the timer.
 
 ```shell
 pomotty
 ```
 
-作業時間と休憩時間は、1〜1440の整数（分）で指定できます。片方だけを指定した
-場合、もう片方には既定値が使われます。
+Work and break durations accept whole numbers from 1 to 1440, in minutes. If you
+specify only one duration, the other uses its default value.
 
 ```shell
 pomotty --work 30 --break 10
 pomotty --work=45 --break=15
 ```
 
-`--roop`で作業・休憩の繰り返し回数を指定できます。既定値は3で、1以上の整数
-（最大9007199254740991）を受け付けます。開始確認は最初の1回だけで、最後の休憩が
-完了すると終了します。
+Use `--loop` to set the number of work and break cycles. It defaults to 3 and
+accepts whole numbers from 1 to 9007199254740991. The start confirmation appears
+only once, and the timer exits after the final break finishes.
 
 ```shell
-pomotty --roop 5
-pomotty --work=25 --break=5 --roop=2
+pomotty --loop 5
+pomotty --work=25 --break=5 --loop=2
 ```
 
-利用可能なオプションは、次のコマンドで確認できます。
+To see the available options, run:
 
 ```shell
 pomotty --help
 ```
 
-作業と休憩の完了時には、それぞれ異なる通知音を再生します。macOSでは
-`afplay`、Linuxでは`paplay`または`aplay`、WindowsではPowerShellを利用し、
-再生できない環境では異なる回数のターミナルベルに切り替わります。
-
-## 開発
-
-```shell
-pnpm install --frozen-lockfile
-pnpm start
-pnpm test
-pnpm lint
-pnpm format:check
-```
+Different notification sounds play when work and break sessions end. Sound
+playback uses `afplay` on macOS, `paplay` or `aplay` on Linux, and PowerShell on
+Windows. If audio playback is unavailable, the timer falls back to different
+numbers of terminal bells for work and break notifications.
 
-## npmへの公開・更新
+For development and npm publishing instructions, see the [development guide](./DEVELOPMENT.md).
 
-開発と公開にはpnpmを使用します。初回または認証が切れた場合は
-`pnpm login --registry=https://registry.npmjs.org/`でnpmへログインします。
-
-更新時は変更内容に応じて`pnpm version patch`、`pnpm version minor`、
-`pnpm version major`で未公開のバージョンへ更新します。
-これらのコマンドはGitコミットとタグも作成するため、先に変更をコミットしてください。
-
-```shell
-pnpm publish --dry-run --no-git-checks
-pnpm publish
-```
+## License
 
-公開前にテスト・lint・フォーマット検証が実行され、パッケージ作成時にビルドされます。
-配布物にはCLI、通知音、README、package.jsonが含まれます。
-公開時にnpmから認証を求められたら、表示される案内に従って完了してください。
+MIT

package/dist/bin/pomotty.js

@@ -30,7 +30,7 @@ const OPTIONS = [
 	},
 	{
 		description: `Work-break repetitions (positive integer, default: 3)`,
-		name: "--roop",
+		name: "--loop",
 		valueName: "<count>"
 	},
 	{
@@ -236,12 +236,12 @@ const EQUALS_SIGN_NOT_FOUND = -1;
 const HELP_OPTIONS = ["--help", "-h"];
 const MAXIMUM_DURATION_MINUTES = 1440;
 const NEXT_ARGUMENT_OFFSET = 1;
-const ROOP_PATTERN = /^[1-9][0-9]*$/u;
-const isNumericOption = (value) => value === "--break" || value === "--work" || value === "--roop";
+const LOOP_PATTERN = /^[1-9][0-9]*$/u;
+const isNumericOption = (value) => value === "--break" || value === "--work" || value === "--loop";
 const isHelpOption = (value) => HELP_OPTIONS.some((option) => option === value);
 const createValueError = (option) => {
 	let maximum = MAXIMUM_DURATION_MINUTES;
-	if (option === "--roop") maximum = Number.MAX_SAFE_INTEGER;
+	if (option === "--loop") maximum = Number.MAX_SAFE_INTEGER;
 	return {
 		kind: "error",
 		message: `Error: ${option} requires an integer from 1 to ${maximum}.\n`
@@ -253,8 +253,8 @@ const createDuplicateError = (option) => ({
 });
 const parseNumericValue = (option, value) => {
 	let pattern = DURATION_PATTERN, maximum = MAXIMUM_DURATION_MINUTES;
-	if (option === "--roop") {
-		pattern = ROOP_PATTERN;
+	if (option === "--loop") {
+		pattern = LOOP_PATTERN;
 		maximum = Number.MAX_SAFE_INTEGER;
 	}
 	if (typeof value !== "string" || !pattern.test(value)) return;
@@ -278,7 +278,7 @@ const parseNumericArgument = (argument, nextArgument) => {
 const parseCliArguments = (arguments_) => {
 	if (arguments_.some((argument) => isHelpOption(argument))) return { kind: "help" };
 	const specifiedOptions = /* @__PURE__ */ new Set();
-	let breakDurationMinutes = 5, roopCount = 3, workDurationMinutes = 15;
+	let breakDurationMinutes = 5, loopCount = 3, workDurationMinutes = 15;
 	for (let argumentIndex = ARGUMENTS_START_INDEX; argumentIndex < arguments_.length; argumentIndex += ARGUMENT_INDEX_INCREMENT) {
 		const argument = arguments_[argumentIndex] ?? "", { consumesNextArgument, optionName, value } = parseNumericArgument(argument, arguments_[argumentIndex + NEXT_ARGUMENT_OFFSET]);
 		if (!isNumericOption(optionName)) return {
@@ -291,13 +291,13 @@ const parseCliArguments = (arguments_) => {
 		specifiedOptions.add(optionName);
 		if (consumesNextArgument) argumentIndex += NEXT_ARGUMENT_OFFSET;
 		if (optionName === "--work") workDurationMinutes = numericValue;
-		else if (optionName === "--roop") roopCount = numericValue;
+		else if (optionName === "--loop") loopCount = numericValue;
 		else breakDurationMinutes = numericValue;
 	}
 	return {
 		breakDurationMinutes,
 		kind: "run",
-		roopCount,
+		loopCount,
 		workDurationMinutes
 	};
 };
@@ -454,7 +454,7 @@ const runCli = async ({ arguments_ = process$1.argv.slice(CLI_ARGUMENTS_START_IN
 		writeOutput("⏹️ Work was not started.\n");
 		return SUCCESS_EXIT_CODE;
 	}
-	for (let cycleIndex = 0; cycleIndex < parsedArguments.roopCount; cycleIndex += COUNT_INCREMENT) await runPomodoroCycle({
+	for (let cycleIndex = 0; cycleIndex < parsedArguments.loopCount; cycleIndex += COUNT_INCREMENT) await runPomodoroCycle({
 		breakDurationMs: parsedArguments.breakDurationMinutes * MILLISECONDS_PER_MINUTE,
 		onPhaseCompleted: (phase) => {
 			writeOutput(`✅ ${PHASE_NAMES[phase]} complete.\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pomotty",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "An interactive terminal Pomodoro timer with configurable work and break sessions and sound notifications.",
   "keywords": [
     "cli",
@@ -12,8 +12,8 @@
   "bugs": {
     "url": "https://github.com/iririn1998/pomotty/issues"
   },
-  "license": "ISC",
-  "author": "",
+  "license": "MIT",
+  "author": "iririn1998",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/iririn1998/pomotty.git"
@@ -45,7 +45,7 @@
     }
   },
   "engines": {
-    "node": ">=22"
+    "node": "^22.18.0 || >=24.11.0"
   },
   "scripts": {
     "build": "rolldown -c rolldown.config.mjs",