From 44ae72e338beced1176c597ef2d587389e8b7a37 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 22:22:03 +0000
Subject: [PATCH] feat(ux): Add Clear Search CTA to empty state and tooltips to
 tabs

- Adds helpful tooltips to the search filter tabs in the WPF interface (showing their respective slash commands like `/all`, `/t`)
- Adds an actionable "Clear Search" button directly within the empty state view, bound to the existing `ClearSearchButton_Click` handler.
- Records the UX learning in `.jules/palette.md`

Co-authored-by: AhmmedSamier <17784876+AhmmedSamier@users.noreply.github.com>
---
 .jules/palette.md                              |  4 ++++
 .../ToolWindows/SearchControl.xaml             | 18 ++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 .jules/palette.md

diff --git a/.jules/palette.md b/.jules/palette.md
new file mode 100644
index 0000000..d64c871
--- /dev/null
+++ b/.jules/palette.md
@@ -0,0 +1,4 @@
+
+## 2024-05-24 - Empty States Should Be Actionable
+**Learning:** Users often get stuck in empty search states because the path to recovery (clearing text or changing tabs) requires moving focus away from the empty state area.
+**Action:** Always provide an actionable recovery path (like a "Clear Search" button) directly within the empty state container to reduce interaction friction.
diff --git a/visual-studio-extension/DeepLensVisualStudio/DeepLensVisualStudio/ToolWindows/SearchControl.xaml b/visual-studio-extension/DeepLensVisualStudio/DeepLensVisualStudio/ToolWindows/SearchControl.xaml
index a9089b0..f89c256 100644
--- a/visual-studio-extension/DeepLensVisualStudio/DeepLensVisualStudio/ToolWindows/SearchControl.xaml
+++ b/visual-studio-extension/DeepLensVisualStudio/DeepLensVisualStudio/ToolWindows/SearchControl.xaml
@@ -149,31 +149,37 @@
                         Content="All"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterAll, Mode=TwoWay}"
+                        ToolTip="Search everywhere (/all)"
                         Style="{StaticResource TabButtonStyle}" />
                     <RadioButton
                         Content="Classes"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterClasses, Mode=TwoWay}"
+                        ToolTip="Search classes and types (/t)"
                         Style="{StaticResource TabButtonStyle}" />
                     <RadioButton
                         Content="Symbols"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterSymbols, Mode=TwoWay}"
+                        ToolTip="Search methods and variables (/s)"
                         Style="{StaticResource TabButtonStyle}" />
                     <RadioButton
                         Content="Files"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterFiles, Mode=TwoWay}"
+                        ToolTip="Search files by name (/f)"
                         Style="{StaticResource TabButtonStyle}" />
                     <RadioButton
                         Content="Text"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterText, Mode=TwoWay}"
+                        ToolTip="Search file content (/txt)"
                         Style="{StaticResource TabButtonStyle}" />
                     <RadioButton
                         Content="Endpoints"
                         GroupName="SearchTabs"
                         IsChecked="{Binding FilterEndpoints, Mode=TwoWay}"
+                        ToolTip="Search API routes (/e)"
                         Style="{StaticResource TabButtonStyle}" />
                 </StackPanel>
             </Border>
@@ -455,6 +461,18 @@
                     Foreground="{DynamicResource {x:Static vsshell:VsBrushes.GrayTextKey}}"
                     HorizontalAlignment="Center"
                     Margin="0,4,0,0" />
+                <Button
+                    Content="Clear Search"
+                    Margin="0,16,0,0"
+                    Padding="16,6"
+                    HorizontalAlignment="Center"
+                    Background="Transparent"
+                    BorderBrush="{DynamicResource {x:Static vsshell:VsBrushes.ToolWindowBorderKey}}"
+                    BorderThickness="1"
+                    Foreground="{DynamicResource {x:Static vsshell:VsBrushes.ToolWindowTextKey}}"
+                    Cursor="Hand"
+                    Click="ClearSearchButton_Click"
+                    AutomationProperties.Name="Clear search to try again" />
             </StackPanel>
 
             <!--  Status Bar (Sticky at Bottom)  -->