From 7d9f4e2f0cc6657050612521879cd490f2c28ea6 Mon Sep 17 00:00:00 2001
From: mbeaulne <matt.beaulne@gmail.com>
Date: Mon, 29 Jun 2026 13:31:32 -0400
Subject: [PATCH] Simplify editor source filter tooltips

---
 .../DashboardComponentsV2SourceFilter.tsx     | 51 ++++++++++++++++---
 .../ComponentSearchV2Content.test.tsx         | 49 ++++++++++++++++++
 .../components/ComponentSearchV2Content.tsx   | 12 +++++
 .../components/componentSearchV2Logic.ts      |  9 ++++
 .../Editor/hooks/useComponentSearchV2State.ts | 45 +++++++++++++---
 5 files changed, 152 insertions(+), 14 deletions(-)

diff --git a/src/routes/Dashboard/DashboardComponentsV2SourceFilter.tsx b/src/routes/Dashboard/DashboardComponentsV2SourceFilter.tsx
index 7d39a2d84..1ebb65b07 100644
--- a/src/routes/Dashboard/DashboardComponentsV2SourceFilter.tsx
+++ b/src/routes/Dashboard/DashboardComponentsV2SourceFilter.tsx
@@ -1,6 +1,7 @@
 import { Button } from "@/components/ui/button";
 import { Icon } from "@/components/ui/icon";
 import { BlockStack, InlineStack } from "@/components/ui/layout";
+import { QuickTooltip } from "@/components/ui/tooltip";
 import { Paragraph, Text } from "@/components/ui/typography";
 import { cn } from "@/lib/utils";
 import type {
@@ -27,6 +28,16 @@ const SOURCE_FILTER_LABEL_BY_KIND: Record<
   user: "User generated",
 };
 
+const SOURCE_FILTER_TOOLTIP_BY_KIND: Record<
+  ComponentSearchSource["kind"],
+  string
+> = {
+  standard: "Standard",
+  published: "Published",
+  registered: "Registered",
+  user: "User",
+};
+
 export interface SourceFilterOption {
   source: ComponentSearchSource;
   count: number;
@@ -79,6 +90,7 @@ interface SourceFilterBarProps {
   disabledSourceKeys: string[];
   onToggle: (sourceKey: string) => void;
   onEnableAll: () => void;
+  display?: "full" | "icons";
 }
 
 export const SourceFilterBar = ({
@@ -86,6 +98,7 @@ export const SourceFilterBar = ({
   disabledSourceKeys,
   onToggle,
   onEnableAll,
+  display = "full",
 }: SourceFilterBarProps) => {
   const disabled = new Set(disabledSourceKeys);
   const activeCount = options.filter(
@@ -103,16 +116,20 @@ export const SourceFilterBar = ({
         {options.map(({ source, count }) => {
           const key = sourceFilterKey(source);
           const active = !disabled.has(key);
-          return (
+          const label = `${source.label} source (${count} component${count === 1 ? "" : "s"})`;
+          const button = (
             <Button
               key={key}
               type="button"
-              size="xs"
+              size={display === "icons" ? "min" : "xs"}
               variant={active ? "secondary" : "outline"}
               aria-pressed={active}
-              aria-label={`${source.label} source (${count} component${count === 1 ? "" : "s"})`}
+              aria-label={label}
               onClick={() => onToggle(key)}
-              className={cn(!active && "opacity-60")}
+              className={cn(
+                display === "icons" && "h-7 w-7 rounded-full p-1.5",
+                !active && "opacity-60",
+              )}
               {...tracking("component_library.source_filter", {
                 source_kind: source.kind,
                 enabled_after_click: !active,
@@ -123,12 +140,30 @@ export const SourceFilterBar = ({
                 size="sm"
                 className={SOURCE_ICON_TONE_BY_KIND[source.kind]}
               />
-              {source.label}
-              <Text as="span" size="xs" tone="subdued">
-                {count}
-              </Text>
+              {display === "full" && (
+                <>
+                  {source.label}
+                  <Text as="span" size="xs" tone="subdued">
+                    {count}
+                  </Text>
+                </>
+              )}
             </Button>
           );
+
+          if (display === "icons") {
+            return (
+              <QuickTooltip
+                key={key}
+                content={SOURCE_FILTER_TOOLTIP_BY_KIND[source.kind]}
+                side="bottom"
+              >
+                {button}
+              </QuickTooltip>
+            );
+          }
+
+          return button;
         })}
         {activeCount < options.length && (
           <Button
diff --git a/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.test.tsx b/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.test.tsx
index 244b9dc1b..f73860026 100644
--- a/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.test.tsx
+++ b/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.test.tsx
@@ -55,6 +55,10 @@ describe("ComponentSearchV2Content", () => {
       isRerankActive: false,
       rerank: vi.fn(),
       clearRerank: vi.fn(),
+      sourceFilterOptions: [],
+      disabledSourceKeys: [],
+      toggleSourceFilter: vi.fn(),
+      enableAllSources: vi.fn(),
     }));
   });
 
@@ -98,6 +102,10 @@ describe("ComponentSearchV2Content", () => {
       isRerankActive: false,
       rerank: vi.fn(),
       clearRerank: vi.fn(),
+      sourceFilterOptions: [],
+      disabledSourceKeys: [],
+      toggleSourceFilter: vi.fn(),
+      enableAllSources: vi.fn(),
     }));
 
     render(<ComponentSearchV2Content />);
@@ -115,6 +123,47 @@ describe("ComponentSearchV2Content", () => {
     );
   });
 
+  it("shows source filters and toggles them from editor search", () => {
+    const toggleSourceFilter = vi.fn();
+    const enableAllSources = vi.fn();
+    mocks.useComponentSearchV2State.mockImplementation(() => ({
+      results: [],
+      browseFolders: [],
+      searchSuggestions: [],
+      isLoading: false,
+      canRerank: false,
+      isReranking: false,
+      isRerankActive: false,
+      rerank: vi.fn(),
+      clearRerank: vi.fn(),
+      sourceFilterOptions: [
+        {
+          source: { kind: "standard", id: "standard", label: "Standard" },
+          count: 2,
+        },
+        {
+          source: { kind: "user", id: "user", label: "User generated" },
+          count: 1,
+        },
+      ],
+      disabledSourceKeys: ["user"],
+      toggleSourceFilter,
+      enableAllSources,
+    }));
+
+    render(<ComponentSearchV2Content />);
+
+    fireEvent.click(
+      screen.getByRole("button", {
+        name: "User generated source (1 component)",
+      }),
+    );
+    fireEvent.click(screen.getByRole("button", { name: "Show all" }));
+
+    expect(toggleSourceFilter).toHaveBeenCalledWith("user");
+    expect(enableAllSources).toHaveBeenCalled();
+  });
+
   it("tracks editor component search completions without query text", async () => {
     render(<ComponentSearchV2Content />);
 
diff --git a/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.tsx b/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.tsx
index 3e2c4d400..a6e7725a5 100644
--- a/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.tsx
+++ b/src/routes/v2/pages/Editor/components/ComponentSearchV2Content.tsx
@@ -9,6 +9,7 @@ import { Spinner } from "@/components/ui/spinner";
 import { Text } from "@/components/ui/typography";
 import { useDebouncedSearchValue } from "@/hooks/useDebouncedSearchValue";
 import { useAnalytics } from "@/providers/AnalyticsProvider";
+import { SourceFilterBar } from "@/routes/Dashboard/DashboardComponentsV2SourceFilter";
 import { useComponentSearchV2State } from "@/routes/v2/pages/Editor/hooks/useComponentSearchV2State";
 import { tracking } from "@/utils/tracking";
 
@@ -96,6 +97,10 @@ export function ComponentSearchV2Content() {
     isRerankActive,
     rerank,
     clearRerank,
+    sourceFilterOptions,
+    disabledSourceKeys,
+    toggleSourceFilter,
+    enableAllSources,
   } = useComponentSearchV2State(deferredQuery);
 
   const handleQueryCommit = (value: string) => {
@@ -183,6 +188,13 @@ export function ComponentSearchV2Content() {
           </Button>
         </InlineStack>
         {isReranking && <AiRerankProgress />}
+        <SourceFilterBar
+          options={sourceFilterOptions}
+          disabledSourceKeys={disabledSourceKeys}
+          onToggle={toggleSourceFilter}
+          onEnableAll={enableAllSources}
+          display="icons"
+        />
       </BlockStack>
       <ComponentSearchResults
         query={deferredQuery}
diff --git a/src/routes/v2/pages/Editor/components/componentSearchV2Logic.ts b/src/routes/v2/pages/Editor/components/componentSearchV2Logic.ts
index 10e0ef128..a4e9fd29d 100644
--- a/src/routes/v2/pages/Editor/components/componentSearchV2Logic.ts
+++ b/src/routes/v2/pages/Editor/components/componentSearchV2Logic.ts
@@ -68,16 +68,25 @@ export interface ComponentSearchV2Result {
   rerankReason?: string;
 }
 
+interface ComponentSearchV2SourceFilterOption {
+  source: ComponentSearchSource;
+  count: number;
+}
+
 export interface ComponentSearchV2State {
   results: ComponentSearchV2Result[];
   browseFolders: UIComponentFolder[];
   searchSuggestions: ComponentSearchSuggestion[];
+  sourceFilterOptions: ComponentSearchV2SourceFilterOption[];
+  disabledSourceKeys: string[];
   isLoading: boolean;
   canRerank: boolean;
   isReranking: boolean;
   isRerankActive: boolean;
   rerank: () => void;
   clearRerank: () => void;
+  toggleSourceFilter: (sourceKey: string) => void;
+  enableAllSources: () => void;
 }
 
 export function registeredSource(
diff --git a/src/routes/v2/pages/Editor/hooks/useComponentSearchV2State.ts b/src/routes/v2/pages/Editor/hooks/useComponentSearchV2State.ts
index b61a63c0c..c18aec362 100644
--- a/src/routes/v2/pages/Editor/hooks/useComponentSearchV2State.ts
+++ b/src/routes/v2/pages/Editor/hooks/useComponentSearchV2State.ts
@@ -17,6 +17,10 @@ import {
   LibraryDB,
   type StoredLibrary,
 } from "@/providers/ComponentLibraryProvider/libraries/storage";
+import {
+  createSourceFilterOptions,
+  filterIndexByDisabledSourceKeys,
+} from "@/routes/Dashboard/DashboardComponentsV2SourceFilter";
 import {
   buildAiCandidateMatches,
   buildLexicalMatches,
@@ -195,10 +199,20 @@ export function useComponentSearchV2State(
     }),
   );
 
+  const [disabledSourceKeys, setDisabledSourceKeys] = useState<string[]>([]);
+  const sourceFilterOptions = createSourceFilterOptions(index);
+  const filteredIndex = filterIndexByDisabledSourceKeys(
+    index,
+    disabledSourceKeys,
+  );
+
   const canUseEmbeddingSearch = aiConfig.apiBase.trim().length > 0;
   const trimmedQuery = query.trim();
-  const lexicalMatches = buildLexicalMatches(index, trimmedQuery);
-  const aiCandidateMatches = buildAiCandidateMatches(index, trimmedQuery);
+  const lexicalMatches = buildLexicalMatches(filteredIndex, trimmedQuery);
+  const aiCandidateMatches = buildAiCandidateMatches(
+    filteredIndex,
+    trimmedQuery,
+  );
   const {
     mutate,
     reset: resetRerank,
@@ -225,7 +239,7 @@ export function useComponentSearchV2State(
     setRerankedFor(null);
     setRerankBaseMatches([]);
     embeddingAbortControllerRef.current?.abort();
-  }, [query, resetRerank]);
+  }, [query, disabledSourceKeys, resetRerank]);
 
   useEffect(() => {
     return () => embeddingAbortControllerRef.current?.abort();
@@ -297,7 +311,7 @@ export function useComponentSearchV2State(
     const effectiveLimit = limit || LEXICAL_RESULT_LIMIT;
     const embeddingMatches = canUseEmbeddings
       ? await buildEmbeddingMatches({
-          sourceIndex: index,
+          sourceIndex: filteredIndex,
           limit: effectiveLimit,
         })
       : [];
@@ -335,6 +349,16 @@ export function useComponentSearchV2State(
     });
   };
 
+  const toggleSourceFilter = (sourceKey: string) => {
+    setDisabledSourceKeys((current) =>
+      current.includes(sourceKey)
+        ? current.filter((key) => key !== sourceKey)
+        : [...current, sourceKey],
+    );
+  };
+
+  const enableAllSources = () => setDisabledSourceKeys([]);
+
   const rerankMatchByDigest = buildRerankMatchByDigest(
     rerankData,
     isRerankActive,
@@ -347,11 +371,18 @@ export function useComponentSearchV2State(
 
   return {
     results,
-    browseFolders: buildResultFolders({ results, standardLibrary }),
-    searchSuggestions: buildComponentSearchSuggestions(index, {
+    browseFolders: buildResultFolders({
+      results,
+      standardLibrary: disabledSourceKeys.includes("standard")
+        ? undefined
+        : standardLibrary,
+    }),
+    searchSuggestions: buildComponentSearchSuggestions(filteredIndex, {
       includeSources: false,
       query: trimmedQuery,
     }),
+    sourceFilterOptions,
+    disabledSourceKeys,
     isLoading:
       isLoadingStandardLibrary ||
       isLoadingUserComponents ||
@@ -367,5 +398,7 @@ export function useComponentSearchV2State(
     isRerankActive,
     rerank,
     clearRerank,
+    toggleSourceFilter,
+    enableAllSources,
   };
 }