search: purge stale Algolia records on deploy, fix EN result URLs, polish dropdown (#275)

1. Stale duplicates — index-to-algolia.cjs used saveObjects(), which only
   adds/updates and never deletes, so records from old slug formats (e.g. the
   pre-language-prefix EN slugs) lingered across deploys. Switch to
   replaceAllObjects(... { safe: true }) so each deploy atomically replaces the
   whole index and drops pages/slugs that no longer exist.

2. Broken EN result links — the index stores EN slugs with an `en/` prefix, but
   production/preview serve the default locale at the site root (/installation/…),
   so EN hits linked to /en/… and 404'd. DocSearch transformItems now strips the
   leading /en off result URLs on non-localhost hosts (localhost still serves /en/).

3. Visual — theme the DocSearch modal/results/recents/footer with the redesign
   tokens (Figtree, 16px modal radius, soft surface-2 input with accent focus ring,
   accent section headers, accent-soft selected row, kbd-styled footer keys).

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: estradino

scripts/index-to-algolia.cjs

@@ -30,19 +30,20 @@ readFile(__dirname + '/../public/search-index.json', (err, data) => {
                 body: page.body
             })
         })
-        const chunkSize = 500;
-        for (let i = 0; i < objects.length; i += chunkSize) {
-            const chunk = objects.slice(i, i + chunkSize);
-            // do wher
-            index.saveObjects(chunk)
+        // replaceAllObjects atomically replaces the ENTIRE index with the current
+        // build's objects (temp index + atomic move, batching handled internally).
+        // Records for pages that no longer exist — e.g. old slug formats left over
+        // from earlier deploys — are dropped instead of lingering forever.
+        // saveObjects() only added/updated and never deleted, which is what left
+        // stale duplicates in the index.
+        index.replaceAllObjects(objects, { safe: true })
             .then( ({objectIDs}) => {
-                console.log(objectIDs.length, " elements indexed")
+                console.log(objectIDs.length, " elements indexed (index fully replaced)")
+                console.log("Process done")
             }).catch( err => {
                 console.log(err)
                 console.log(err.transporterStackTrace)
             })
-        }    
-        console.log("Process done")
     } catch (e) {
         console.error("Error parsing index JSON data")
         console.error(e)

src/components/Header/DocSearch.css

@@ -112,3 +112,38 @@
 
 
 }
+
+/* ============================================================
+   Redesign polish for the search dropdown (results, recents, footer)
+   ============================================================ */
+.DocSearch-Modal { font-family: var(--fb); border-radius: 16px; }
+
+/* section / group headers (e.g. "Sanitize Data (Web)", "Recent") */
+.DocSearch-Hit-source {
+	font-family: var(--fb);
+	font-weight: 700;
+	font-size: 12px;
+	letter-spacing: 0.02em;
+	color: var(--accent);
+	padding-top: 14px;
+}
+
+/* result + recent rows */
+.DocSearch-Hit a { background: transparent; }
+.DocSearch-Hit[aria-selected='true'] a { background: var(--accent-soft); }
+.DocSearch-Hit-title { color: var(--text-2); }
+.DocSearch-Hit-icon, .DocSearch-Hit-Tree { color: var(--text-3); }
+
+/* favourite (star) + remove (x) buttons on recents */
+.DocSearch-Hit-action { color: var(--text-3); }
+.DocSearch-Hit-action:hover { color: var(--accent); }
+
+/* footer key-hints → redesign kbd look */
+.DocSearch-Footer { background: var(--surface); }
+.DocSearch-Commands-Key {
+	border-radius: 6px;
+	background: var(--surface-2);
+	box-shadow: inset 0 -1px 0 var(--or-border);
+	color: var(--text-3);
+}
+.DocSearch-Label, .DocSearch-Commands li { color: var(--text-3); font-family: var(--fb); }

src/components/Header/DocSearch.tsx

@@ -66,6 +66,13 @@ export default function Search({ lang = 'en', labels }: Props) {
 			// searchParameters={{ facetFilters: [`lang:${lang}`, `version:${version}`] }}
 			// hitComponent={CustomHit}
 			transformItems={(items) => {
+				// Production/preview builds serve the default locale (en) at the site
+				// root (e.g. /installation/...), so a slug like "en/installation/x"
+				// must drop its /en prefix or the result 404s. On localhost pages are
+				// served under /en/, so keep it there.
+				const onLocalhost =
+					typeof location !== 'undefined' &&
+					(location.hostname === 'localhost' || location.hostname.startsWith('127.'));
 				return items.map((item) => {
 					// We transform the absolute URL into a relative URL to
 					// work better on localhost, preview URLS.
@@ -74,9 +81,10 @@ export default function Search({ lang = 'en', labels }: Props) {
 					item.type = 'lvl1';
 					item.title = '';
 					const hash = a.hash === '#overview' ? '' : a.hash;
+					const pathname = onLocalhost ? a.pathname : a.pathname.replace(/^\/en(?=\/|$)/, '');
 					return {
 						...item,
-						url: `${a.pathname}${hash}`,
+						url: `${pathname || '/'}${hash}`,
 					};
 				});
 			}}