feat: filter bar with search, URL sync, and active-filter chips

Adds the spec §6.7 filter bar to the top of the timeline with:
  - Date range (native date inputs)
  - Media type chips (Photo / Video / RAW / HEIC, multi-select)
  - Min star rating (click to set, click again to clear)
  - Color label dots (red/orange/yellow/green/blue/purple, single)
  - Flag (any / picked / rejected / unflagged)
  - Clear-all button

Active filters surface as removable chips below the bar so they're
visible whether the bar is collapsed or open. The TopBar search input
is now wired to the same filter store with a 300ms debounce, and shows
a clear button when populated.

Filter state is the source of truth in a Zustand store and round-trips
through the URL via history.replaceState — bookmarkable and shareable
per spec §6.7. Hydrate happens once on mount; subsequent store changes
write back to ?q=&date_from=&… without navigation.

Timeline reads filter state, builds the backend params via
filtersToParams, and includes them in the React Query key so the cache
invalidates on every filter change. Also fixes a latent bug: Timeline
was sending limit=1000&offset=0, which the backend silently ignores —
swapped to page=1&per_page=500 with explicit sort=taken_at&order=desc.

New keyboard shortcuts:
  - \\  toggles the filter bar
  - /   focuses the TopBar search input
  - Cmd/Ctrl+F  same as /

Filter button in the TopBar now lights up when filters are active or
the bar is open.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

frontend/src/components/layout/TopBar.tsx

@@ -1,24 +1,57 @@
-import { useState } from 'react'
-import { 
-  Search, 
-  Grid, 
-  List, 
+import { useState, useEffect, useRef } from 'react'
+import {
+  Search,
+  Grid,
+  List,
   SlidersHorizontal,
   FolderOpen,
   Upload,
   Settings,
   Menu,
-  Trash2
+  Trash2,
+  X,
 } from 'lucide-react'
 import clsx from 'clsx'
 import { usePhotoStore } from '../../store/photoStore'
+import { useFilterStore, hasActiveFilters } from '../../store/filterStore'
 import { photos } from '../../services/api'
 import { toast } from '../ToastContainer'
 import { useMutation, useQueryClient } from '@tanstack/react-query'
 import muliLogo from '../../assets/muli-logo.png'
 
+const SEARCH_DEBOUNCE_MS = 300
+
 export function TopBar() {
-  const [searchQuery, setSearchQuery] = useState('')
+  // Filter store is the source of truth for search; the input has a local
+  // mirror so typing stays responsive while we debounce store updates.
+  const storeQ = useFilterStore((s) => s.q)
+  const setStoreQ = useFilterStore((s) => s.setQ)
+  const filterBarOpen = useFilterStore((s) => s.filterBarOpen)
+  const toggleFilterBar = useFilterStore((s) => s.toggleFilterBar)
+  const filterState = useFilterStore()
+  const filtersActive = hasActiveFilters(filterState) || filterBarOpen
+
+  const [searchQuery, setSearchQuery] = useState(storeQ)
+
+  // Keep local input in sync if the store is changed externally (URL hydrate,
+  // active-chip removal, clear-all).
+  useEffect(() => {
+    setSearchQuery(storeQ)
+  }, [storeQ])
+
+  // Debounce local input -> store.
+  const debounceRef = useRef<number | null>(null)
+  useEffect(() => {
+    if (searchQuery === storeQ) return
+    if (debounceRef.current) window.clearTimeout(debounceRef.current)
+    debounceRef.current = window.setTimeout(() => {
+      setStoreQ(searchQuery)
+    }, SEARCH_DEBOUNCE_MS)
+    return () => {
+      if (debounceRef.current) window.clearTimeout(debounceRef.current)
+    }
+  }, [searchQuery, storeQ, setStoreQ])
+
   const [viewMode, setViewMode] = useState<'grid' | 'list'>('grid')
   const selectedPhotos = usePhotoStore((state) => state.selectedPhotos)
   const clearSelection = usePhotoStore((state) => state.clearSelection)
@@ -80,12 +113,32 @@ export function TopBar() {
         <div className="relative w-full">
           <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-text-muted" />
           <input
+            id="topbar-search"
             type="text"
             value={searchQuery}
             onChange={(e) => setSearchQuery(e.target.value)}
+            onKeyDown={(e) => {
+              if (e.key === 'Escape') {
+                setSearchQuery('')
+                setStoreQ('')
+                e.currentTarget.blur()
+              }
+            }}
             placeholder="Search photos..."
-            className="w-full rounded-md border border-border bg-bg py-1.5 pl-9 pr-3 text-sm text-text placeholder-text-muted focus:border-primary focus:outline-none"
+            className="w-full rounded-md border border-border bg-bg py-1.5 pl-9 pr-9 text-sm text-text placeholder-text-muted focus:border-primary focus:outline-none"
           />
+          {searchQuery && (
+            <button
+              onClick={() => {
+                setSearchQuery('')
+                setStoreQ('')
+              }}
+              className="absolute right-2 top-1/2 -translate-y-1/2 rounded p-0.5 text-text-muted hover:bg-surface-2 hover:text-text"
+              title="Clear search"
+            >
+              <X className="h-3.5 w-3.5" />
+            </button>
+          )}
         </div>
       </div>
       
@@ -121,12 +174,18 @@ export function TopBar() {
         
         {/* Filter Button */}
         <button
-          className="group relative rounded p-1.5 text-text-muted hover:bg-surface-2 hover:text-text"
-          title="Filter photos (Ctrl+F)"
+          onClick={toggleFilterBar}
+          className={clsx(
+            'group relative rounded p-1.5 transition-colors',
+            filtersActive
+              ? 'bg-primary/20 text-primary'
+              : 'text-text-muted hover:bg-surface-2 hover:text-text'
+          )}
+          title="Toggle filters (\\)"
         >
           <SlidersHorizontal className="h-4 w-4" />
           <kbd className="absolute -bottom-5 left-1/2 -translate-x-1/2 whitespace-nowrap rounded bg-surface-offset px-1 py-0.5 text-[9px] font-medium text-text opacity-0 group-hover:opacity-100">
-            Ctrl+F
+            \
           </kbd>
         </button>