From c84d85b31e840750a73f04ae250eb42dbc05253d Mon Sep 17 00:00:00 2001
From: Timothee Guerin <tiguerin@microsoft.com>
Date: Thu, 21 May 2026 15:20:02 -0400
Subject: [PATCH] feat(website): improve search by filtering JS API docs and
 release notes

- Add data-docsearch-ignore to sidebar to prevent crawler from indexing
  sidebar labels into search result titles (fixes long concatenated titles)
- Filter out JS API and release notes from default search results using
  transformItems client-side filtering
- Add $ prefix support to search all content including JS API and release notes
- Add Head.astro override to inject docsearch:tag meta for future server-side filtering
- Update search placeholder to hint at $ prefix
---
 website/astro.config.mjs                      |  1 +
 website/src/components/header/search.astro    | 37 ++++++++++++++++++-
 .../components/starlight-overrides/Head.astro | 14 +++++++
 .../starlight-overrides/Sidebar.astro         | 14 ++++---
 4 files changed, 59 insertions(+), 7 deletions(-)
 create mode 100644 website/src/components/starlight-overrides/Head.astro

diff --git a/website/astro.config.mjs b/website/astro.config.mjs
index 324902b35e3..0de5a38d7cf 100644
--- a/website/astro.config.mjs
+++ b/website/astro.config.mjs
@@ -92,6 +92,7 @@ export default defineConfig({
       customCss: ["./src/css/custom.css"],
       components: {
         Header: "./src/components/header/header.astro",
+        Head: "./src/components/starlight-overrides/Head.astro",
         PageFrame: "./src/components/starlight-overrides/PageFrame.astro",
         Sidebar: "./src/components/starlight-overrides/Sidebar.astro",
       },
diff --git a/website/src/components/header/search.astro b/website/src/components/header/search.astro
index 126b59b4886..499f132124f 100644
--- a/website/src/components/header/search.astro
+++ b/website/src/components/header/search.astro
@@ -24,7 +24,7 @@ import "@docsearch/css";
           stroke-linecap="round"
           stroke-linejoin="round"></path>
       </svg>
-      <span class="DocSearch-Button-Placeholder">Search...</span>
+      <span class="DocSearch-Button-Placeholder">Search… ($ for all)</span>
     </span>
     <span class="DocSearch-Button-Keys"></span>
   </button>
@@ -33,15 +33,50 @@ import "@docsearch/css";
 <script>
   import algoliaConfig from "@site/algolia";
 
+  const EXCLUDED_URL_PATTERNS = ["/reference/js-api/", "/release-notes/"];
+
   class StarlightDocSearch extends HTMLElement {
     constructor() {
       super();
       window.addEventListener("DOMContentLoaded", async () => {
         const { default: docsearch } = await import("@docsearch/js");
+
+        let showAllResults = false;
+
         const options: Parameters<typeof docsearch>[0] = {
           ...algoliaConfig,
           container: "sl-doc-search",
           keyboardShortcuts: { "/": false },
+          transformSearchClient(searchClient) {
+            return {
+              ...searchClient,
+              search(requests: any[]) {
+                return searchClient.search(
+                  requests.map((req: any) => {
+                    const query: string = req.params?.query ?? "";
+                    if (query.startsWith("$")) {
+                      showAllResults = true;
+                      return {
+                        ...req,
+                        params: {
+                          ...req.params,
+                          query: query.slice(1),
+                        },
+                      };
+                    }
+                    showAllResults = false;
+                    return req;
+                  }),
+                );
+              },
+            };
+          },
+          transformItems(items) {
+            if (showAllResults) return items;
+            return items.filter(
+              (item) => !EXCLUDED_URL_PATTERNS.some((pattern) => item.url.includes(pattern)),
+            );
+          },
         };
         docsearch(options);
       });
diff --git a/website/src/components/starlight-overrides/Head.astro b/website/src/components/starlight-overrides/Head.astro
new file mode 100644
index 00000000000..1b0df60f875
--- /dev/null
+++ b/website/src/components/starlight-overrides/Head.astro
@@ -0,0 +1,14 @@
+---
+import Default from "@astrojs/starlight/components/Head.astro";
+
+const route = Astro.locals.starlightRoute;
+const isJsApi = route.entry.data.jsApi === true;
+const isReleaseNotes = route.id.includes("release-notes");
+
+let tag = "docs";
+if (isJsApi) tag = "js-api";
+else if (isReleaseNotes) tag = "release-notes";
+---
+
+<Default {...Astro.props} />
+<meta name="docsearch:tag" content={tag} />
diff --git a/website/src/components/starlight-overrides/Sidebar.astro b/website/src/components/starlight-overrides/Sidebar.astro
index 4601c965b92..18ffd27205f 100644
--- a/website/src/components/starlight-overrides/Sidebar.astro
+++ b/website/src/components/starlight-overrides/Sidebar.astro
@@ -42,10 +42,12 @@ if (isReleaseNotes) {
 }
 ---
 
-<SidebarPersister>
-  <SidebarSublist sublist={filtered} />
-</SidebarPersister>
-
-<div class="md:sl-hidden">
-  <MobileMenuFooter />
+<div data-docsearch-ignore>
+  <SidebarPersister>
+    <SidebarSublist sublist={filtered} />
+  </SidebarPersister>
+
+  <div class="md:sl-hidden">
+    <MobileMenuFooter />
+  </div>
 </div>