feat(search): scoped live search on browse pages (#938)

* feat(artists): scoped live search badge replaces page filter

Move Artists browse text search into the header Live Search with a page
scope badge (Users icon), field-local undo, and double-click/backspace
to clear scope. Block the live-search dropdown while scoped so results
only filter the Artists grid; mobile overlay follows the same rules.

* fix(artists): plain grid for scoped search fixes broken card layout

Route the browse grid through VirtualCardGrid, switch to non-virtual CSS
grid when live search filters the catalog, reset scroll on filter changes,
and skip content-visibility on plain tiles to avoid blank/black cards.

* fix(search): scope badge double-Backspace and single clear control

Require two Backspaces on an empty scoped field after prior text input;
one Backspace still clears the badge when the field was never filled.
Move live-search clear/advanced controls inside the field pill, drop the
extra outer clear button, and use type=text to avoid native search clears.

* fix(search): drop duplicate outer live-search clear button

Keep the native in-field clear on type=search and the original pill layout;
remove only the extra × control outside the search border. Reset dropdown
state when the query is cleared via the native control.

* refactor(search): generic scoped browse query helper, drop dead code

Rename artistsBrowseSearchQuery to scopedBrowseSearchQuery with an
expectedScope argument; wire Artists via useScopedBrowseSearchQuery.
Remove unused liveSearchScoped dropdown helper (scoped mode blocks it).

* feat(search): ghost scope badge and single-click badge remove

After clearing the artists scope on /artists, show a faded ghost chip to
restore page-only search while keeping the global search placeholder.
Active badge removes on one click; tooltips and styles updated.

* feat(search): scoped live search for All Albums and New Releases

Wire albums and newReleases scope badges with debounced album title search
(local index title-only FTS + filtered search3). Plain grid, scroll reset,
and session query restore on album grid browse pages.

* fix(browse): preserve scroll restore after album/artist detail back

Only reset in-page scroll when filter resetKey changes, not when
isScrollRestorePending clears after session restore.

* feat(search): scoped live search for Tracks browse

Wire /tracks to header live search with wide title/artist/album FTS,
hide hero and discovery rails while search is active, and remove the
inline search field from the browse list.

* fix(search): clear header query when leaving scoped browse pages

Prevent global live search from firing on album/detail routes after a
scoped browse query; browse session stashes still restore on back.

* fix(tracks): restore scroll after back from detail during scoped search

Hold stashed song results across fetchSongPage churn, defer leave-stash
teardown past AppShell scroll reset, restore tracks scroll after the list
is ready, and save scroll snapshot when opening artist from song context menu.

* fix(tracks): hide discovery headings during scoped search

Hide the page subtitle and "Browse all tracks" section title when
tracks search is active, matching hero/rails chrome behavior.

* feat(search): scoped live search for Composers browse

Wire /composers to header live search with composers scope badge,
session stash, scroll restore, and plain grid/list during text filter.
Remove the in-page filter input; add i18n and navigation helpers.

* docs: CHANGELOG and credits for scoped browse live search (PR #938)

src/hooks/useSongBrowseList.test.ts

@@ -0,0 +1,69 @@
+// @vitest-environment jsdom
+import { renderHook, waitFor } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type { SubsonicSong } from '../api/subsonicTypes';
+import { useSongBrowseList } from './useSongBrowseList';
+import { useAuthStore } from '../store/authStore';
+import { useLibraryIndexStore } from '../store/libraryIndexStore';
+
+vi.mock('../api/subsonicSearch', () => ({
+  searchSongsPaged: vi.fn(async () => []),
+}));
+
+vi.mock('../api/navidromeBrowse', () => ({
+  ndListSongs: vi.fn(async () => []),
+}));
+
+vi.mock('../utils/library/advancedSearchLocal', () => ({
+  runLocalSongBrowse: vi.fn(async () => []),
+}));
+
+vi.mock('../utils/library/browseTextSearch', () => ({
+  BROWSE_TEXT_DEBOUNCE_NETWORK_MS: 10,
+  BROWSE_TEXT_DEBOUNCE_RACE_MS: 10,
+  browseRaceCountsSongs: vi.fn(),
+  loadMoreLocalBrowseSongs: vi.fn(async () => []),
+  raceBrowseWithLocalFallback: vi.fn(async () => null),
+  runLocalBrowseSongPage: vi.fn(async () => []),
+  runNetworkBrowseSongPage: vi.fn(async () => [{ id: 'fresh' } as SubsonicSong]),
+}));
+
+const stashedSong = { id: 'stashed', title: 'Stashed', artist: 'A', duration: 180 } as SubsonicSong;
+
+describe('useSongBrowseList restore hold', () => {
+  beforeEach(() => {
+    useAuthStore.setState({ activeServerId: 'srv-1' });
+    useLibraryIndexStore.setState({ masterEnabled: true });
+  });
+
+  it('keeps stashed songs after fetchSongPage identity changes until query edits', async () => {
+    const { result, rerender } = renderHook(
+      ({ searchQuery }) => useSongBrowseList({
+        enabled: true,
+        searchQuery,
+        initialRestore: {
+          query: 'jazz',
+          songs: [stashedSong],
+          offset: 1,
+          hasMore: false,
+          localSearchMode: true,
+          browseUnsupported: false,
+          hasSearched: true,
+        },
+      }),
+      { initialProps: { searchQuery: 'jazz' } },
+    );
+
+    expect(result.current.songs).toEqual([stashedSong]);
+
+    rerender({ searchQuery: 'jazz' });
+    await waitFor(() => {
+      expect(result.current.songs).toEqual([stashedSong]);
+    }, { timeout: 500 });
+
+    rerender({ searchQuery: 'jazzx' });
+    await waitFor(() => {
+      expect(result.current.songs[0]?.id).toBe('fresh');
+    }, { timeout: 500 });
+  });
+});