fix(#265): モニタ抜き差し後のレイアウト崩れとアートワーク消失を修復 by GeneralD · Pull Request #266 · GeneralD/lyra

GeneralD · 2026-06-11T16:48:51Z

Closes #265

根本原因

1. レイアウト崩れ（歌詞の重なり・壁紙の偏り）

ディスプレイ再構成中、window server はアプリの裏でウィンドウを移動・リサイズする（切断ディスプレイからの退避、再接続時の復元など）。一方 lyra がジオメトリを再適用するのは モデル値 (resolveLayout() の結果) が前回と変わったときだけ だった：

AppPresenter.onWindowFrameChange が removeDuplicates { $0.windowFrame == $1.windowFrame } でゲート
モデル値が同じままシステム側だけが実ウィンドウを動かすと、そのズレは永遠に修復されない

ズレたウィンドウ内では、AppKit が contentView を自動リサイズする一方：

hostingView（autoresizing なし）は古い hostingFrame のまま → SwiftUI の GeometryReader が誤ったサイズで歌詞カラムを組む → 行の重なり・はみ出し
AVPlayerLayer は attach 時の frame ＋比例 autoresizing 頼みで再適用されない → 壁紙が画面の一部に偏る

抜き差しを繰り返すほどズレが固定化し、再起動（全ジオメトリ再構築）でのみ直る — issue の症状と一致します。

2. アートワーク消失

TrackInteractorImpl.artwork が map(\.artworkData) の素通しだったため、同一トラックの artwork なし再ブロードキャスト（ディスプレイ再構成時などに MediaRemote が発する）で表示中のアートワークが nil 上書きされていた。

修正方針 — 照合は履歴とでなく実状態と

変更	内容
`AppPresenter.onWindowFrameChange`	`removeDuplicates` を撤去。解決レイアウトの emit ごとに毎回再適用
`AppWindow.apply`	冪等な再適用に変更。`surface.frame` が一致していれば `setFrame` をスキップ（通知ループ防止）し、container / hostingView / `AVPlayerLayer` のジオメトリを毎回再アサート。playerLayer は wallpaper scale の transform を保持するため `frame` でなく `bounds` + `position` で設定
`ScreenInteractor.screenChanges`	`NSWindow.didMove` / `didResize` を merge。システムがウィンドウを動かした直後にも再解決が走る（apply 側が冪等なので自己発火はループしない）
`TrackInteractorImpl.artwork`	`scan` で直前トラックと比較し、同一トラック（`sameTrack` 判定）の間は最後のアートワークを保持。トラック変更時の nil は従来どおりクリア

ループ安全性の説明

applyLayout が setFrame → didResize 通知 → screenChanges → 再解決 → apply という循環が起きうるが、2 周目では surface.frame == layout.windowFrame が成立して setFrame がスキップされるため、通知が再発火せず 1 バウンドで収束する。vacant モードの 5 秒ポーリングも同様に no-op になる。

テスト

AppPresenterTests: 旧仕様テスト（dedup を検証）を新仕様（同一フレームでも毎回発火）に置き換え
AppWindowTests: ① frame 一致時の setFrame スキップ、② システムに改変された container / hostingView / playerLayer ジオメトリの修復、③ wallpaper scale transform の保持
ScreenInteractorImplTests: NSWindow.didMove / didResize での emit（parameterized）
TrackInteractorArtworkTests: 同一トラック nil イベントでの保持＋トラック変更時のクリア

swift test 全 924 件パス（2 連続）、make lint クリーン。

検証の限界

実モニタの抜き差しを伴う再現は手元で実施できていないため、根本原因の特定はコード解析とスクリーンショットの幾何（壁紙レイヤが部分領域に固定）に基づきます。マージ前にデバッグビルドでの実機確認（.claude/rules/dev-verification.md のフロー）を推奨します。

TODO

実機でモニタ抜き差し後にレイアウトが自己修復することを確認

Summary by CodeRabbit

Bug Fixes
- Improved window geometry recovery during display reconfiguration, window moves/resizes, and layout reapplication.
- Prevented artwork from disappearing when repeated track updates omit artwork bytes.
- Safer, idempotent overlay window/view/layer geometry reconciliation to avoid layout loops.
Tests
- Added regression and async tests covering window-frame reassertion, screen notifications, artwork retention, and overlay geometry fixes.
Documentation
- Edited architecture guidance and layout reconciliation notes.
Chores
- Version bumped to 2.13.8.

モニタの抜き差し中は window server がアプリの裏でオーバーレイウィンドウを移動・リサイズするが、従来は resolveLayout() のモデル値が変化したときしか applyLayout が走らないため (removeDuplicates によるゲート)、モデル値が同じままシステム側だけが動かしたズレを永遠に修復できなかった。 hostingView (autoresizing なし) と AVPlayerLayer (比例 autoresizing のみ) が実ウィンドウと食い違ったまま固定され、歌詞の重なり・壁紙の偏り・ヘッダ崩れとして現れる。再起動で直るのはこのため。 - AppPresenter.onWindowFrameChange: removeDuplicates を撤去し、解決レイアウトの emit ごとに毎回再適用する - AppWindow.apply: 実状態と照合する冪等な再適用に変更。windowFrame が一致していれば setFrame をスキップ (通知ループ防止)、AVPlayerLayer は transform を保ったまま bounds + position で幾何を再アサート - ScreenInteractor.screenChanges: NSWindow.didMove / didResize 通知を merge し、システムがウィンドウを動かした直後にも再解決が走るようにする

MediaRemote の再ブロードキャスト (ディスプレイ再構成時などに発生) は artwork バイトを含まないことがあり、artwork ストリームが artworkData を素通ししていたため表示中のアートワークが nil で上書きされて消えていた。 scan で直前のトラックと比較し、同一トラック (sameTrack 判定) の間は最後に得たアートワークを保持する。トラックが変わって新トラックにアートワークが無い場合は従来どおり nil を流してクリアする。

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

coderabbitai · 2026-06-11T16:49:04Z

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6a993387-f99c-483c-8447-093398e856e0

📥 Commits

Reviewing files that changed from the base of the PR and between aa965a0 and 188edab.

📒 Files selected for processing (10)

.claude/CLAUDE.md
Sources/Presenters/App/AppPresenter.swift
Sources/ScreenInteractor/ScreenInteractorImpl.swift
Sources/TrackInteractor/TrackInteractorImpl.swift
Sources/VersionHandler/Resources/version.txt
Sources/Views/Overlay/AppWindow.swift
Tests/PresentersTests/AppPresenterTests.swift
Tests/ScreenInteractorTests/ScreenInteractorImplTests.swift
Tests/TrackInteractorTests/TrackInteractorArtworkTests.swift
Tests/ViewsTests/AppWindowTests.swift

📝 Walkthrough

Walkthrough

Idempotent geometry reconciliation introduced for AppWindow.apply; ScreenInteractor emits on window move/resize; AppPresenter invokes layout reassertion for every resolved layout emission (no frame dedup); TrackInteractor preserves artwork across same-track nil updates; docs updated and version bumped to 2.13.8.

Changes

Monitor hot-plug layout recovery

Layer / File(s)	Summary
Architecture guidance and version `.claude/CLAUDE.md`, `Sources/VersionHandler/Resources/version.txt`	Added "Layout reconciliation (no dedup on apply)" guidance and formatting tweaks; bumped version from `2.13.7` → `2.13.8`.
AppWindow idempotent geometry reconciliation `Sources/Views/Overlay/AppWindow.swift`, `Tests/ViewsTests/AppWindowTests.swift`	Refactored `apply(layout:to:hostingView:)` to conditionally call `setFrame`, update hosting view frame, early-exit when contentView differs, and reassert `AVPlayerLayer` bounds/position; added helpers and regression/tests for frame-skip, corruption recovery, and affine-transform preservation.
Screen-change signal expansion `Sources/ScreenInteractor/ScreenInteractorImpl.swift`, `Tests/ScreenInteractorTests/ScreenInteractorImplTests.swift`	`screenChanges` now merges `NSWindow.didMoveNotification` and `NSWindow.didResizeNotification` with `NSApplication.didChangeScreenParametersNotification` to trigger layout re-resolution during hot-plug scenarios; added test asserting emissions on window move/resize.
AppPresenter non-dedup layout assertion `Sources/Presenters/App/AppPresenter.swift`, `Tests/PresentersTests/AppPresenterTests.swift`	`onWindowFrameChange` now executes the handler for every resolved `layout` emission (removed `removeDuplicates` on `windowFrame`), ensuring geometry reassertion even when resolved frame appears unchanged; test renamed and expanded to assert multiple invocations.
Track artwork state preservation `Sources/TrackInteractor/TrackInteractorImpl.swift`, `Tests/TrackInteractorTests/TrackInteractorArtworkTests.swift`	`artwork` publisher changed from direct `map` to stateful `scan` that preserves last-known artwork for same-track nil updates and clears only when the track actually changes without artwork; added tests covering preservation and clearing scenarios (regression `#265`).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

GeneralD/lyra#245: Overlaps on TrackInteractorImpl artwork emission/dedup logic and related tests.
GeneralD/lyra#251: Also modifies TrackInteractorImpl.artwork handling and added similar regression coverage.
GeneralD/lyra#221: Related AppWindow.apply geometry reconciliation refactor and overlay surface changes.

"I hop through frames when monitors plug and play,
I nudge a layer back where the pixels stray.
If artwork hides with a missing byte,
I keep the last one close until the next light.
Reassert, don't dedup — that’s my rabbit way."

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 40.63% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Title check	❓ Inconclusive	The title references issue `#265` and summarizes the key fixes: layout recovery and artwork preservation after monitor hot-plugging. However, the title is in Japanese while the codebase and all documentation are in English.	Consider using an English title like 'fix(`#265`): Recover layout and artwork after display reconfiguration' to match project documentation standards and improve discoverability.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check	✅ Passed	All primary coding objectives from `#265` are addressed: layout idempotency in AppWindow.apply, geometry re-assertion on every layout signal via onWindowFrameChange, screen change detection with window notifications, and artwork preservation via stateful scan in TrackInteractorImpl.
Out of Scope Changes check	✅ Passed	All changes are directly aligned with `#265` requirements: layout reconciliation, artwork preservation, and screen change handling. Version bump and documentation updates are standard supporting changes.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch fix/#265-layout-reconciliation-after-display-change

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@Tests/TrackInteractorTests/TrackInteractorArtworkTests.swift`:
- Around line 167-168: Replace the fixed Task.sleep by polling with a deadline:
repeatedly check collector.snapshot for equality with [realArt] in a short-loop
(sleeping tiny increments, e.g. Task.sleep for a few milliseconds) until a
deadline (Date()+timeout) is reached, then assert collector.snapshot ==
[realArt] and additionally assert that no further emissions appear after that
deadline; remove the one-off try? await Task.sleep(for: .milliseconds(100)) and
implement the deadline-based loop in TrackInteractorArtworkTests using the
existing collector and realArt symbols to locate the check.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8218b98a-c2d7-48ca-a5f7-db7926b24d3c

📥 Commits

Reviewing files that changed from the base of the PR and between aa965a0 and 3caf486.

📒 Files selected for processing (10)

.claude/CLAUDE.md
Sources/Presenters/App/AppPresenter.swift
Sources/ScreenInteractor/ScreenInteractorImpl.swift
Sources/TrackInteractor/TrackInteractorImpl.swift
Sources/VersionHandler/Resources/version.txt
Sources/Views/Overlay/AppWindow.swift
Tests/PresentersTests/AppPresenterTests.swift
Tests/ScreenInteractorTests/ScreenInteractorImplTests.swift
Tests/TrackInteractorTests/TrackInteractorArtworkTests.swift
Tests/ViewsTests/AppWindowTests.swift

codecov · 2026-06-11T16:54:50Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

CodeRabbit 指摘 (no fixed sleep guideline) への対応。同一トラックの nil イベント後に必ず emit される次トラックのイベントをフェンスとし、イベントが順序どおり処理される性質を利用して「nil が emit されなかった」ことを決定的に検証する。

chatgpt-codex-connector · 2026-06-11T18:17:19Z

To use Codex here, create a Codex account and connect to github.

GeneralD · 2026-06-11T18:20:16Z

@codex review

chatgpt-codex-connector · 2026-06-11T18:23:20Z

Codex Review: Didn't find any major issues. Chef's kiss.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

CodeRabbit の Docstring Coverage 警告に対応するため、今回の PR で変更のあった主要クラス・メンバにドキュメントコメントを追加しました。

GeneralD · 2026-06-11T18:37:25Z

CodeRabbit の Docstring Coverage に対応するため、今回の PR で変更のあった主要なクラスおよびメンバにをしました。

これですべての指摘事項がしたはずです。

GeneralD

ディスプレイ再構成やシステムによるウィンドウ移動に伴うレイアウト崩れ (#265) を、冪等なジオメトリ再アサートと通知イベントの拡充によって的確に修正しています。アートワーク保持ロジックも堅牢です。

GeneralD · 2026-06-11T18:44:12Z

    public lazy var artwork: AnyPublisher<Data?, Never> =
        activeNowPlaying
-        .map(\.artworkData)
+        .scan((track: NowPlaying?.none, data: Data?.none)) { state, incoming in


同一トラック判定に Self.sameTrack を使用していますが、NowPlaying の title と artist が共に nil の場合（未知のトラック同士）も true を返します。通常、再生中であればタイトルは存在しますが、より安全にするならタイトルが非 nil であることも条件に含めることを検討してください。

Suggested change

.scan((track: NowPlaying?.none, data: Data?.none)) { state, incoming in

let isSameTrack = state.track.map { $0.title != nil && Self.sameTrack($0, incoming) } ?? false

しました。ご提案どおり artwork の同一トラック判定に title 非 nil 条件を追加し、未知トラック同士で artwork が引き継がれないことを検証する回帰テスト (artworkDoesNotStickAcrossNilTitleTracks) も追加しています。740cdae を参照。

GeneralD · 2026-06-11T18:44:12Z

-        }
+        guard let containerView = surface.contentView, containerView !== hostingView else { return }
+        containerView.frame = CGRect(origin: .zero, size: layout.windowFrame.size)
+        guard let playerLayer = playerLayer(in: surface) else { return }


containerView.frame を設定する前に、現在のフレームと比較するガードを入れることで、不要な AppKit のレイアウトパスをさらに削減できます（applyWindowFrame と同様のパターン）。

Suggested change

guard let playerLayer = playerLayer(in: surface) else { return }

if containerView.frame != CGRect(origin: .zero, size: layout.windowFrame.size) {

containerView.frame = CGRect(origin: .zero, size: layout.windowFrame.size)

}

しました。提案の if 文形式ではなく、既存の applyWindowFrame と揃えた guard ヘルパー (applyFrame(_:to:)) として実装し、containerView に加えて hostingView の frame 再代入にも同じスキップを適用しています。188edab を参照。

GeneralD · 2026-06-11T18:44:12Z

    public func onWindowFrameChange(_ handler: @escaping @MainActor (ScreenLayout) -> Void) {
        $layout
-            .removeDuplicates { $0.windowFrame == $1.windowFrame }
            .dropFirst()


.removeDuplicates() を削除したことで意図通り「自己修復」が可能になりましたが、高頻度な通知が発生した場合に備え、必要であれば applyLayout の直前で throttle や debounce を入れることも検討の余地があります。現状の apply が十分に軽量であればこのままで問題ありません。

現状とします。apply は全ジオメトリ書き込みが一致時スキップの冪等実装になっており(188edab で view frame もスキップ対象に追加)、無変化シグナルの実コストはほぼ比較のみです。また didMove/didResize が高頻度になるのはディスプレイ再構成中の短いバーストに限られ、throttle/debounce を挟むとまさに #265 の自己修復が遅延する側に働くため、入れない判断としました。

レビュー指摘対応。title が両方 nil の場合 sameTrack は true を返すため、未知トラック同士で前の artwork が残り続ける可能性があった。artwork の同一トラック判定に title 非 nil 条件を追加し、回帰テストを追加。

レビュー指摘対応。applyWindowFrame と同じ guard ヘルパー形式で不要な AppKit レイアウトパスを削減。

GeneralD · 2026-06-12T02:21:32Z

@coderabbitai full review

coderabbitai · 2026-06-12T02:21:40Z

✅ Action performed

Full review finished.

GeneralD added 3 commits June 12, 2026 01:47

chore: bump version to 2.13.8

3caf486

Copilot AI review requested due to automatic review settings June 11, 2026 16:48

GeneralD self-assigned this Jun 11, 2026

Copilot AI reviewed Jun 11, 2026

coderabbitai Bot reviewed Jun 11, 2026

View reviewed changes

Comment thread Tests/TrackInteractorTests/TrackInteractorArtworkTests.swift Outdated

docs(#265): 修正対象ファイルの docstring を追加しカバレッジ警告に対応

2634afb

CodeRabbit の Docstring Coverage 警告に対応するため、今回の PR で変更のあった主要クラス・メンバにドキュメントコメントを追加しました。

GeneralD commented Jun 11, 2026

View reviewed changes

GeneralD added 2 commits June 12, 2026 03:50

refactor(#265): container/hosting view の frame 再代入を一致時にスキップ

188edab

レビュー指摘対応。applyWindowFrame と同じ guard ヘルパー形式で不要な AppKit レイアウトパスを削減。

GeneralD merged commit be94a5c into main Jun 12, 2026
3 of 4 checks passed

GeneralD deleted the fix/#265-layout-reconciliation-after-display-change branch June 12, 2026 02:25

This was referenced Jun 12, 2026

CodeRabbit Docstring Coverage が Swift を計測できず常に 0.00% 警告になる #267

Closed

chore(#267): CodeRabbit の Docstring Coverage チェックを無効化 #268

Merged

	.scan((track: NowPlaying?.none, data: Data?.none)) { state, incoming in
	let isSameTrack = state.track.map { $0.title != nil && Self.sameTrack($0, incoming) } ?? false

Conversation

GeneralD commented Jun 11, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

根本原因

1. レイアウト崩れ（歌詞の重なり・壁紙の偏り）

2. アートワーク消失

修正方針 — 照合は履歴とでなく実状態と

テスト

検証の限界

TODO

Summary by CodeRabbit

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

coderabbitai Bot commented Jun 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

❌ Failed checks (1 warning, 1 inconclusive)

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codecov Bot commented Jun 11, 2026

Codecov Report

Uh oh!

chatgpt-codex-connector Bot commented Jun 11, 2026

Uh oh!

GeneralD commented Jun 11, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jun 11, 2026

Uh oh!

GeneralD commented Jun 11, 2026

Uh oh!

GeneralD left a comment

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD Jun 11, 2026

Choose a reason for hiding this comment

Uh oh!

GeneralD commented Jun 12, 2026

Uh oh!

coderabbitai Bot commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

GeneralD commented Jun 11, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jun 11, 2026 •

edited

Loading

coderabbitai Bot commented Jun 12, 2026 •

edited

Loading