From a6b2cfcad06bbd0ea34f663794e921c5518c8eab Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 12 Jun 2026 06:15:45 +0000
Subject: [PATCH] Add help tooltips to disabled action buttons in MenuBarView

Added dynamic .help() modifiers to the Scan, Quick Clean, and Docker Prune
buttons in MenuBarView to provide sighted mouse users with clear explanations
for why these primary actions are disabled (e.g., "Scan in progress",
"Nothing to clean"). This enhances overall usability and accessibility
by clarifying UI states without cluttering the compact menubar popover.

Co-authored-by: acebytes <2820910+acebytes@users.noreply.github.com>
---
 Sources/Cacheout/Views/MenuBarView.swift | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Sources/Cacheout/Views/MenuBarView.swift b/Sources/Cacheout/Views/MenuBarView.swift
index 9084b59..afbd941 100644
--- a/Sources/Cacheout/Views/MenuBarView.swift
+++ b/Sources/Cacheout/Views/MenuBarView.swift
@@ -219,6 +219,7 @@ struct MenuBarView: View {
             }
             .buttonStyle(.bordered)
             .disabled(viewModel.isScanning)
+            .help(viewModel.isScanning ? "Scan in progress" : "Scan for caches")
 
             if viewModel.isScanning {
                 ProgressView()
@@ -241,6 +242,7 @@ struct MenuBarView: View {
             .buttonStyle(.borderedProminent)
             .tint(Color(red: 0.85, green: 0.45, blue: 0.1)) // burnt orange — readable white text
             .disabled(viewModel.totalRecoverable == 0 || viewModel.isCleaning)
+            .help(viewModel.isCleaning ? "Cleanup in progress" : (viewModel.totalRecoverable == 0 ? "Nothing to clean" : "Quick clean recoverable items"))
 
             // Open main window
             Button {
@@ -288,6 +290,7 @@ struct MenuBarView: View {
             .buttonStyle(.bordered)
             .controlSize(.mini)
             .disabled(viewModel.isDockerPruning)
+            .help(viewModel.isDockerPruning ? "Pruning in progress" : "Run Docker prune")
         }
     }