fix: debounce source toggle searches

Author: SysAdminDoc

CHANGELOG.md

@@ -14,6 +14,7 @@ All notable changes to ScriptHunt will be documented in this file.
 - Propagated each search AbortSignal through direct, proxy, GitHub code, and custom-source requests so replacement searches cancel network work instead of only ignoring late results.
 - Removed Google Fonts runtime requests by vendoring OFL-licensed Outfit and JetBrains Mono WOFF2 assets and adding them to the offline shell cache.
 - Stale-while-revalidate assets now compare ETags, modification metadata, or SHA-256 body fingerprints and show one actionable reload notice when cached content changes.
+- Rapid source-toggle changes now coalesce into one replacement search while checkbox state and preferences update immediately.
 
 ### Added
 - Added versioned source result envelopes and visible per-source provenance for partiality, pagination, latency, cache use, privacy route, HTTP status, and normalized failures.

README.md

@@ -66,7 +66,7 @@ npm run qa
 | **Source Health** | Persists failing source cooldowns with retry controls and versioned per-source provenance for partiality, route, latency, HTTP status, and cache use |
 | **Offline Recent Searches** | Versioned records preserve source route, status, partiality, errors, and scan age/hash evidence; legacy IndexedDB/localStorage records reconcile by newest valid copy |
 | **Cache Diagnostics** | Shows offline/scan cache counts, schema and eviction state, browser quota estimates, and independent cache-clear recovery controls |
-| **Source Toggles** | Enable/disable sources with preferences persisted across sessions |
+| **Source Toggles** | Enable/disable sources with preferences persisted across sessions; rapid changes coalesce into one replacement search |
 | **Live Status Chips** | Real-time per-source indicators with partial-result reasons, search mode, privacy route, latency, cache use, and suspension status |
 | **Sort Controls** | Sort by relevance, trust score, total/daily installs, rating, last updated, or name |
 | **Infinite Scroll** | Automatic pagination fetches next page from all active sources |

index.html

@@ -4002,6 +4002,15 @@ <h3>Search userscripts everywhere</h3>
         panel.innerHTML = '';
     }
 
+    var sourceToggleDebounce = null;
+    function scheduleSourceToggleSearch() {
+        clearTimeout(sourceToggleDebounce);
+        sourceToggleDebounce = setTimeout(function() {
+            sourceToggleDebounce = null;
+            if (state.rawQuery) executeSearch(state.rawQuery);
+        }, 300);
+    }
+
     function renderSourceToggles() {
         var bar = document.getElementById('sourcesBar'); bar.innerHTML = '';
         Object.values(SOURCES).forEach(function(src) {
@@ -4015,7 +4024,7 @@ <h3>Search userscripts everywhere</h3>
                 src.enabled = !src.enabled; el.classList.toggle('active', src.enabled);
                 el.setAttribute('aria-checked', String(src.enabled));
                 var sp = {}; Object.keys(SOURCES).forEach(function(k) { sp[k] = SOURCES[k].enabled; }); _prefSet('sources', sp);
-                if (state.rawQuery) executeSearch(state.rawQuery);
+                if (state.rawQuery) scheduleSourceToggleSearch();
             }
             el.addEventListener('click', toggle);
             el.addEventListener('keydown', function(e) { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); toggle(); } });

tests/smoke.spec.js

@@ -277,6 +277,28 @@ test('source toggles are keyboard accessible', async ({ page }) => {
   await expect(toggle).toHaveAttribute('aria-checked', 'false');
 });
 
+test('rapid source toggles coalesce into one replacement search', async ({ page }) => {
+  await page.goto('/');
+  await runSearch(page, 'youtube');
+  await page.evaluate(() => {
+    window.__sourceToggleSearches = 0;
+    const original = executeSearch;
+    executeSearch = function(...args) {
+      window.__sourceToggleSearches += 1;
+      return original.apply(this, args);
+    };
+  });
+
+  const toggle = page.getByLabel('Greasy Fork source');
+  await toggle.click();
+  await toggle.click();
+  await toggle.click();
+  await toggle.click();
+  await expect(toggle).toHaveAttribute('aria-checked', 'true');
+  expect(await page.evaluate(() => window.__sourceToggleSearches)).toBe(0);
+  await expect.poll(() => page.evaluate(() => window.__sourceToggleSearches)).toBe(1);
+});
+
 test('theme toggle cycles through modes', async ({ page }) => {
   await page.goto('/');
   const btn = page.locator('#themeToggle');