pomotty 1.1.0 → 1.2.0

package/README.ja.md

@@ -2,7 +2,7 @@
 
 [English](./README.md) | 日本語
 
-Node.js 22以降で利用できる、ターミナル用のポモドーロタイマーです。
+Node.js `^22.18.0 || >=24.11.0`で利用できる、ターミナル用のポモドーロタイマーです。
 
 ```shell
 npx pomotty
@@ -40,6 +40,49 @@ pomotty --loop 5
 pomotty --work=25 --break=5 --loop=2
 ```
 
+タイマー実行中は、残り時間を大きな数字で表示し、同じ位置で更新し続けます。
+その下に、現在のフェーズの経過バー（経過時間・割合・合計時間）と、サイクルごとの
+作業・休憩の進み具合を並べたタイムラインを表示します。
+
+```text
+  🍅 WORK                      Cycle 2 / 3
+
+          ██████    ██  ██ ██████
+          ██  ██ ██ ██  ██     ██
+          ██████    ██████ ██████
+          ██  ██ ██     ██ ██
+          ██████        ██ ██████
+
+  ━━━━━━━━━━━━━━━━────────────────────────
+  6:18 elapsed      42%        15:00 total
+
+  #1  ███████████████ █████  ✓
+  #2  ██████▎········ ·····  ◀ now
+  #3  ··············· ·····
+      work 15:00      break 5:00
+
+  [space] pause   [s] skip   [q] quit
+```
+
+作業は赤、休憩は緑で表示します。`NO_COLOR`に空でない値を設定すると色を付けません。
+ターミナルの幅が狭い場合は、残り時間・割合・バーだけのコンパクト表示や1行表示に
+切り替え、起動時のロゴも短い見出しにします。
+
+タイマー実行中は次のキーで操作できます。
+
+| キー     | 動作                                                                           |
+| -------- | ------------------------------------------------------------------------------ |
+| `space`  | 一時停止 / 再開。一時停止中は時間が進みません                                  |
+| `s`      | 現在のフェーズをskipして次へ進みます。音は鳴らさず、作業の完了数にも数えません |
+| `q`      | タイマーを止めて終了します（終了コード0）                                      |
+| `Ctrl+C` | タイマーを止めて終了します（終了コード130）                                    |
+
+終了予定時刻を過ぎたフェーズでキーを押した場合は、先にそのフェーズを完了として扱ってから
+操作を適用します。`SIGTERM`（143）、`SIGHUP`（129）でも、非表示にしたカーソルと
+キー入力の設定を元に戻してから終了します。
+標準入出力がターミナルでない場合（パイプやリダイレクト）は、キー操作を受け付けず、
+フェーズの開始と完了を1行ずつ出力します。
+
 利用可能なオプションは、次のコマンドで確認できます。
 
 ```shell
@@ -49,5 +92,12 @@ pomotty --help
 作業と休憩の完了時には、それぞれ異なる通知音を再生します。macOSでは
 `afplay`、Linuxでは`paplay`または`aplay`、WindowsではPowerShellを利用し、
 再生できない環境では異なる回数のターミナルベルに切り替わります。
+再生コマンドは起動時に1回だけ絶対パスへ解決します。Linuxでは`PATH`のうち
+絶対パスのディレクトリだけを探索し、作業ディレクトリ配下と`node_modules/.bin`に
+ある同名コマンドは使いません。
 
 開発手順とnpmへの公開・更新手順は[開発ガイド](./DEVELOPMENT.ja.md)を参照してください。
+
+## ライセンス
+
+MIT

package/README.md

@@ -40,6 +40,51 @@ pomotty --loop 5
 pomotty --work=25 --break=5 --loop=2
 ```
 
+While the timer runs, the remaining time is shown in large digits and updated in
+place. Below it are a progress bar for the current phase (elapsed time, percentage,
+and total time) and a timeline showing the work and break progress of each cycle.
+
+```text
+  🍅 WORK                      Cycle 2 / 3
+
+          ██████    ██  ██ ██████
+          ██  ██ ██ ██  ██     ██
+          ██████    ██████ ██████
+          ██  ██ ██     ██ ██
+          ██████        ██ ██████
+
+  ━━━━━━━━━━━━━━━━────────────────────────
+  6:18 elapsed      42%        15:00 total
+
+  #1  ███████████████ █████  ✓
+  #2  ██████▎········ ·····  ◀ now
+  #3  ··············· ·····
+      work 15:00      break 5:00
+
+  [space] pause   [s] skip   [q] quit
+```
+
+Work is shown in red and breaks in green. Set `NO_COLOR` to a non-empty value to
+disable colors. In narrow terminals, the timer switches to a compact view with only
+the remaining time, percentage, and bar, or to a single line, and the startup logo
+is replaced with a short title.
+
+While the timer runs, you can use these keys:
+
+| Key      | Action                                                                               |
+| -------- | ------------------------------------------------------------------------------------ |
+| `space`  | Pause or resume. Time does not pass while paused                                     |
+| `s`      | Skip the current phase. No sound plays, and skipped work is not counted as completed |
+| `q`      | Stop the timer and exit (exit code 0)                                                |
+| `Ctrl+C` | Stop the timer and exit (exit code 130)                                              |
+
+If the current phase has already reached its end time when you press a key, the
+phase is completed first and the key then applies to the next phase. On `SIGTERM`
+(143) or `SIGHUP` (129), the timer also restores the hidden cursor and the terminal
+input mode before exiting. When standard input or output is not a terminal (for
+example, a pipe or redirect), keys are not read and the timer prints one line when
+each phase starts and finishes.
+
 To see the available options, run:
 
 ```shell
@@ -50,6 +95,9 @@ 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.
+Playback commands are resolved to absolute paths once at startup. On Linux, only
+absolute directories in `PATH` are searched, and commands under the working
+directory or `node_modules/.bin` are never used.
 
 For development and npm publishing instructions, see the [development guide](./DEVELOPMENT.md).