From 2159711cd0f89bacc4c36c99c1437ebcd1194e7a Mon Sep 17 00:00:00 2001 From: Hare Date: Fri, 1 May 2026 23:16:02 +0900 Subject: [PATCH] =?UTF-8?q?feat(tui):=20=E3=83=9E=E3=82=A6=E3=82=B9?= =?UTF-8?q?=E3=83=9B=E3=82=A4=E3=83=BC=E3=83=AB=E3=82=B9=E3=82=AF=E3=83=AD?= =?UTF-8?q?=E3=83=BC=E3=83=AB=E5=AE=8C=E4=BA=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tickets/tui-mouse-scroll.md | 5 ++++ tickets/tui-mouse-scroll.review.md | 40 ++++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 tickets/tui-mouse-scroll.review.md diff --git a/tickets/tui-mouse-scroll.md b/tickets/tui-mouse-scroll.md index b84a8be8..486d83e9 100644 --- a/tickets/tui-mouse-scroll.md +++ b/tickets/tui-mouse-scroll.md @@ -26,3 +26,8 @@ TUIのヒストリービューはキー操作（Shift+↑/↓、PageUp/PageDown - ホイール以外のマウス操作（クリックでフォーカス移動、ドラッグ選択、スクロールバー表示など） - picker / spawn のインラインフェーズでのマウス対応 - ホイール感度の設定可能化 + +## Review +- 状態: Approve +- レビュー詳細: [./tui-mouse-scroll.review.md](./tui-mouse-scroll.review.md) +- 日付: 2026-05-01 diff --git a/tickets/tui-mouse-scroll.review.md b/tickets/tui-mouse-scroll.review.md new file mode 100644 index 00000000..3e28efba --- /dev/null +++ b/tickets/tui-mouse-scroll.review.md @@ -0,0 +1,40 @@ +# Review: TUI マウスホイールでヒストリーをスクロール + +## 前提・要件の確認 + +- フルスクリーンモード中にマウスホイールでスクロール可能 + - `enter_fullscreen` で `EnableMouseCapture` を `EnterAlternateScreen` と一緒に発行（`crates/tui/src/main.rs:258`）。`run_loop` の `event::read` 分岐に `TermEvent::Mouse(mouse) => handle_mouse(app, mouse)` を追加（`crates/tui/src/main.rs:314-316`）。要件達成。 +- ホイール上 = `scroll_up` / 下 = `scroll_down`、感覚は Shift+↑/↓ と同等 + - `handle_mouse` が `MouseEventKind::ScrollUp/Down` をそのまま `app.scroll.scroll_up/down(WHEEL_LINES)` にマップ（`crates/tui/src/main.rs:366-372`）。`Scroll::scroll_up` は `top_offset` を減らす実装（`scroll.rs:47-50`）で「過去方向」と整合。`WHEEL_LINES = 3` は Shift+↑/↓ の 1 行より速いがページ未満で、ticket の「同じ感覚で良い」と矛盾しない。妥当。 +- マウスキャプチャは alt-screen 中に限定し、終了時に確実に解除 + - 有効化は `enter_fullscreen` 1 箇所のみ（`main.rs:258`）。解除は `run_spawn` の child reap 前（`main.rs:237-241`）と `main` 末尾の最終 cleanup（`main.rs:173-178`）の 2 箇所で `DisableMouseCapture` を `LeaveAlternateScreen` と対で発行。picker / spawn のインラインフェーズでは `enter_fullscreen` を経由しないので有効化されない。要件達成。 +- ホイール以外のマウスイベントでマッチ漏れエラーが出ないこと + - `handle_mouse` の `match` は `_ => {}` で吸収（`main.rs:370`）。`run_loop` 側は `TermEvent::Mouse(_)` を新たに拾うので未処理エラーは発生しない。要件達成。 + +## 完了条件の検証 + +- フルスクリーンTUIでホイールが効く: コードパスは成立。実機確認はユーザー側で実施予定（ticket補足通り）。 +- 正常終了でターミナル状態が残らない: `main` 末尾の cleanup は `result` の match より前に走るので、`Ok` でも `Err` でも必ず `DisableMouseCapture` を発行する。`run_spawn` 経由で `run` がエラー return しても、戻った直後の `execute!` で disable した後に `?` 相当の伝播が起きるため、二重 disable になっても idempotent で安全。 +- 既存キー操作のスクロール挙動に変化なし: `Scroll` API・`handle_key` のスクロール経路は無変更。 + +## アーキテクチャ・スコープ + +- 変更は `crates/tui/src/main.rs` の terminal lifecycle と event loop に限定。新規モジュール・新規 trait・新規抽象は導入していない。既存の `Scroll` API をそのまま再利用しており、過剰な抽象化はない。 +- `WHEEL_LINES` を `main.rs` 内の `const` として置いた選択は、現状のキー側のマジックナンバー（page_up/down 等は `area_height` から導出、Shift+↑/↓ は `1` 直書き）と粒度が揃っている。`scroll.rs` 側に押し込む価値は今のところない。 +- マウス捕捉の対称性（alt-screen と同じスコープでEnable/Disable）は ticket の「範囲外」記述と一致しており、picker / spawn のインラインフェーズでホイール挙動が変わらないことが保証されている。 +- 依存追加なし。crossterm の既存featureで `MouseEvent` 系が利用可能（既に import 済みの `event` モジュールから引いている）。 + +## 指摘事項 + +### Non-blocking / Follow-up + +- パニック時のクリーンアップは未対応。tui には `std::panic::set_hook` 等のフックが存在せず、これは本変更前から同じ（bracketed paste も alt-screen も同じく panic 時には残る）。本ticket の「異常終了でもキャプチャ状態が残らない」を厳密に取ると未達だが、既存の他リソース（alt-screen、bracketed paste、raw mode）と同レベルで揃っており、本ticketで先んじて対応するのは過剰。別ticket（パニック時のターミナル復帰一括対応）として扱うのが適切。 +- `enter_fullscreen` 内で `EnterAlternateScreen` の後に `EnableMouseCapture` が失敗した場合、その関数は `?` で早期 return するが、`main` 末尾の cleanup が `DisableMouseCapture, LeaveAlternateScreen` を流すので結果的に状態は復帰する。明示性を上げるなら `enter_fullscreen` 内でロールバックを書く手もあるが、final cleanup と二重になるだけで価値は薄い。現状維持で良い。 + +### Nits + +- `WHEEL_LINES` のドキュメントコメントは根拠が読みやすく良い。指摘なし。 + +## 判断 + +Approve — ticket の前提・要件・完了条件はすべて実装で達成されており、コードベースを歪めず最小差分で収まっている。実機確認はユーザー側で予定通り実施すれば良い。