feat(#300): スペクトラムに透明度と角丸の設定キーを追加

[GeneralD]

概要

#297 のフォローアップ。スペクトラムアナライザに bar_opacity（バーの不透明度）と bar_corner_radius（バーの角丸半径）の設定キーを追加する。どちらもデフォルトで既存の描画結果を保つ後方互換な追加。

変更内容

• bar_opacity（0–1、既定 1）: バー全体の不透明度。背景描画の後・バー塗りの前に GraphicsContext.opacity としてバー層へ適用するので、bar_color 自身のアルファと乗算合成され、background_color とは独立して効く。不透明な bar_color と併用すれば「色」と「透明度」を分離指定できる。ConfigRepository で 0…1 にクランプ。
• bar_corner_radius（既定 nil = 自動）: バーの角丸半径（pt）。従来コード固定だった min(bar_width/4, 3) を純粋関数 autoCornerRadius(thickness:) に抽出してテスタブル化し、spectrumBarRects にオプショナルの cornerRadius: 引数を追加。指定時は per-bar で厚みの半分にクランプ（0 で角なし）。ConfigRepository で 0 下限にクランプ。
• Config → Style → View の既存パイプライン（SpectrumConfig / SpectrumStyle / ConfigRepository / SpectrumView）に沿って伝搬。
• README.md / .claude/CLAUDE.md を更新。
• バージョンを 2.20.0 に更新。

背景・動機

#297 のクローズ時に残った軽微な設定化2項目を切り出したフォローアップ（#297 → #300）。「良い状態をデフォルトで見せつつ、必要なら調整できる」という本プロジェクトの方針に沿って、curated-default-but-configurable として追加する。

テスト計画

• ConfigDecodingTests: セクション欠如で bar_opacity == 1 / bar_corner_radius == nil、明示指定のデコード
• ConfigTemplateTests: TOML / JSON テンプレートのスナップショット更新
• ConfigRepositoryTests: opacity の 0…1 クランプ、corner radius の 0 下限クランプ、パススルー
• SpectrumBarRectsTests: autoCornerRadius(thickness:)、cornerRadius の nil→自動 / 明示 / 0→角なし / 厚み半分クランプ / 負値フロア
• 全テスト 1090 件パス、make lint クリーン

備考

• デフォルトの描画結果は不変（bar_opacity 既定 1.0 + bar_corner_radius 既定 = 従来の自動式と同一）。2つのノブはどちらも opt-in。
• 視覚デモはデフォルトでは差分ゼロで、ノブの効果を映すにはスペクトラム有効化 + System Audio Recording の TCC 許可 + 実際の再生音源が要る。必要なら別途キャプチャして貼るので声かけてください。

Closes #300

Summary by CodeRabbit

• New Features

  • Added optional [spectrum] tuning keys for bar appearance: bar_opacity and bar_corner_radius.
  • Spectrum bars now use derived corner rounding by default, with an explicit per-config override when set.

• Bug Fixes

  • Improved spectrum style sanitization by clamping bar_opacity to 0…1 and ensuring bar_corner_radius is non-negative.

• Documentation

  • Updated configuration docs and generated config templates to include the new spectrum options.

• Tests

  • Expanded tests for spectrum config decoding, style sanitization, and corner-radius behavior.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f45e7cbb-eed2-43b1-b93a-812755b07500

📥 Commits

Reviewing files that changed from the base of the PR and between 28fe7a7 and 289d820.

📒 Files selected for processing (1)

• Tests/PresentersTests/SpectrumPresenterTests.swift

---

📝 Walkthrough

Walkthrough

Adds two backward-compatible Spectrum options, bar_opacity and bar_corner_radius, through config decoding, style loading, rendering, tests, docs, and a version bump.

Changes

Spectrum bar opacity and corner radius

Layer / File(s)	Summary
Config schema and decoding Sources/Entity/Config/SpectrumConfig.swift, Tests/ConfigDataSourceTests/*	Adds barOpacity and barCornerRadius to SpectrumConfig with defaults, coding keys, decode fallback, and updated decoding/template expectations.
Style struct and repository clamping Sources/Entity/Style/SpectrumStyle.swift, Sources/ConfigRepository/ConfigRepositoryImpl.swift, Tests/ConfigRepositoryTests/ConfigRepositoryTests.swift	Adds matching SpectrumStyle fields and initializer parameters, then clamps opacity and corner radius when loading app style.
Bar rendering with opacity and corner radius Sources/Views/Spectrum/SpectrumView.swift, Tests/ViewsTests/SpectrumBarRectsTests.swift	Applies style.barOpacity during drawing and routes barCornerRadius into bar rectangle generation, which now supports explicit or derived corner radii.
Documentation and version bump README.md, .claude/CLAUDE.md, Sources/VersionHandler/Resources/version.txt	Documents the new [spectrum] keys and updates the stored version to 2.20.0.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

• GeneralD/lyra#296: Introduces the spectrum overlay pipeline that this PR extends with bar_opacity and bar_corner_radius.

🚥 Pre-merge checks | ✅ 3 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	⚠️ Warning	Most changes are in scope, but the SpectrumPresenterTests tickUntil rewrite appears unrelated to the requested config feature.	Remove or justify the SpectrumPresenterTests helper rewrite unless it is required for this PR's spectrum config work.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding independent opacity and corner-radius settings for the spectrum display.
Linked Issues check	✅ Passed	The PR appears to implement both requested follow-ups, keeps them in [spectrum], preserves defaults, and updates docs, tests, and config plumbing.

✨ 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 feat/#300-spectrum-opacity-corner

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[Copilot]

Pull request overview

Adds two new opt-in spectrum appearance knobs—master bar opacity and configurable bar corner radius—wired through the existing Config → Style → View pipeline while keeping default rendering unchanged.

Changes:

• Add [spectrum] config keys bar_opacity (0–1, default 1) and bar_corner_radius (optional; default auto).
• Implement bar-layer opacity in SpectrumView and extract the default corner radius into autoCornerRadius(thickness:), with per-bar clamping.
• Update docs, templates/snapshots, tests, and bump version to 2.20.0.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
Tests/ViewsTests/SpectrumBarRectsTests.swift	Adds unit tests for autoCornerRadius and spectrumBarRects corner-radius clamping behavior.
Tests/ConfigRepositoryTests/ConfigRepositoryTests.swift	Verifies repository clamping for bar_opacity (0…1) and bar_corner_radius (floored at 0).
Tests/ConfigDataSourceTests/ConfigTemplateTests.swift	Updates expected TOML/JSON templates to reflect the new default bar_opacity field.
Tests/ConfigDataSourceTests/ConfigDecodingTests.swift	Adds decoding coverage for default and explicitly-specified bar_opacity / bar_corner_radius.
Sources/Views/Spectrum/SpectrumView.swift	Applies barOpacity to the bar layer and threads barCornerRadius into geometry; introduces autoCornerRadius.
Sources/VersionHandler/Resources/version.txt	Bumps version from 2.19.0 to 2.20.0.
Sources/Entity/Style/SpectrumStyle.swift	Extends SpectrumStyle with barOpacity and barCornerRadius.
Sources/Entity/Config/SpectrumConfig.swift	Extends SpectrumConfig Codable model with bar_opacity and bar_corner_radius keys + defaults.
Sources/ConfigRepository/ConfigRepositoryImpl.swift	Clamps barOpacity and floors barCornerRadius when building SpectrumStyle.
README.md	Documents the new spectrum keys and their behavior/defaults.
.claude/CLAUDE.md	Updates architecture/feature notes to include the new spectrum knobs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 78.26087% with 5 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
Sources/Views/Spectrum/SpectrumView.swift	61.53%	5 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated no new comments.