Speed up downloads by combining multiple network connections in parallel
TypeScript bandwidth-aggregationcross-platformdesktop-appdownloaderdownloadmanagerlinuxmacosmulticonnectionparallel-downloadswindows
feat(ui): add real-time search and filter to downloads list (#226)
Dhruvil Patel2e44a2f3e9db
diff --git a/e2e/downloadSearch.spec.ts b/e2e/downloadSearch.spec.tsnew file mode 100644index 0000000..4aeb5cc--- /dev/null+++ b/e2e/downloadSearch.spec.ts@@ -0,0 +1,91 @@+import { expect, test } from '@playwright/test'+import {+ filterDownloadsByQuery,+ matchesSearch,+ normalizeSearchQuery,+ searchTokens+} from '../src/shared/downloadSearch'++test.describe('download search @smoke', () => {+ const sampleDownloads = [+ {+ fileName: 'Ubuntu-24.04-desktop-amd64.iso',+ url: 'https://releases.ubuntu.com/24.04/ubuntu-24.04-desktop-amd64.iso'+ },+ {+ fileName: 'Node-v22.1.0-linux-x64.tar.gz',+ url: 'https://nodejs.org/dist/v22.1.0/node-v22.1.0-linux-x64.tar.gz'+ },+ {+ fileName: 'Debian-12.5.0-netinst.iso',+ url: 'https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-12.5.0-amd64-netinst.iso'+ },+ {+ fileName: 'Big_Buck_Bunny_1080p.mp4',+ url: 'https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4'+ },+ {+ fileName: 'café_recording.mp3',+ url: 'https://example.com/audio/caf%C3%A9.mp3'+ }+ ]++ test('empty or whitespace query matches everything', () => {+ expect(matchesSearch(sampleDownloads[0], '')).toBe(true)+ expect(matchesSearch(sampleDownloads[0], ' ')).toBe(true)+ expect(filterDownloadsByQuery(sampleDownloads, '')).toEqual(sampleDownloads)+ expect(filterDownloadsByQuery(sampleDownloads, ' \t ')).toEqual(sampleDownloads)+ })++ test('case-insensitive substring match on fileName', () => {+ expect(matchesSearch(sampleDownloads[0], 'ubuntu')).toBe(true)+ expect(matchesSearch(sampleDownloads[0], 'UBUNTU')).toBe(true)+ expect(matchesSearch(sampleDownloads[0], 'amd64')).toBe(true)+ expect(matchesSearch(sampleDownloads[1], 'node')).toBe(true)+ expect(matchesSearch(sampleDownloads[1], 'TAR.GZ')).toBe(true)+ expect(matchesSearch(sampleDownloads[2], 'debian')).toBe(true)+ })++ test('matches against url if fileName does not match', () => {+ // URL contains "releases.ubuntu.com", fileName does not+ expect(matchesSearch(sampleDownloads[0], 'releases')).toBe(true)+ // URL contains "cdimage", fileName does not+ expect(matchesSearch(sampleDownloads[2], 'cdimage')).toBe(true)+ // URL contains "commondatastorage", fileName does not+ expect(matchesSearch(sampleDownloads[3], 'commondatastorage')).toBe(true)+ })++ test('multi-token AND search matches across name and url', () => {+ expect(matchesSearch(sampleDownloads[0], 'ubuntu iso')).toBe(true)+ expect(matchesSearch(sampleDownloads[0], 'ubuntu 24.04 desktop')).toBe(true)+ expect(matchesSearch(sampleDownloads[0], 'ubuntu 24.04 windows')).toBe(false)+ expect(matchesSearch(sampleDownloads[3], 'bunny 1080p')).toBe(true)+ })++ test('unicode normalization matches composed and decomposed characters', () => {+ const composed = 'café'+ const decomposed = 'cafe\u0301'++ expect(matchesSearch(sampleDownloads[4], composed)).toBe(true)+ expect(matchesSearch(sampleDownloads[4], decomposed)).toBe(true)+ expect(normalizeSearchQuery(decomposed)).toBe(normalizeSearchQuery(composed))+ })++ test('filters array preserving original order', () => {+ const isoDownloads = filterDownloadsByQuery(sampleDownloads, 'iso')+ expect(isoDownloads).toHaveLength(2)+ expect(isoDownloads[0].fileName).toBe('Ubuntu-24.04-desktop-amd64.iso')+ expect(isoDownloads[1].fileName).toBe('Debian-12.5.0-netinst.iso')++ const noMatches = filterDownloadsByQuery(sampleDownloads, 'nonexistent_file')+ expect(noMatches).toHaveLength(0)+ })++ test('searchTokens and token array matching avoid redundant string splitting', () => {+ const tokens = searchTokens(' UBUNTU Desktop ')+ expect(tokens).toEqual(['ubuntu', 'desktop'])+ expect(searchTokens(' ')).toEqual([])+ expect(matchesSearch(sampleDownloads[0], tokens)).toBe(true)+ expect(matchesSearch(sampleDownloads[1], tokens)).toBe(false)+ })+})diff --git a/e2e/selection.spec.ts b/e2e/selection.spec.tsindex c151d16..ba51a15 100644--- a/e2e/selection.spec.ts+++ b/e2e/selection.spec.ts@@ -2,6 +2,7 @@ import { existsSync } from 'node:fs'import { mkdir, readFile, writeFile } from 'node:fs/promises'import { basename, dirname, join } from 'node:path'import type { Page } from '@playwright/test'+import { DEFAULT_DOWNLOAD_SCHEDULE } from '../src/shared/downloadSchedule'import { BLOCK, expect, test, treeSha } from './fixtures'import { seededBytes } from './origin'import { named, Swarm, torrentFileOnDisk } from './torrentSwarm'@@ -274,3 +275,96 @@ test('a removal that fails for one download still removes the rest, and asks agaawait expect(page.getByRole('checkbox', { name: 'Select goes.bin' })).toHaveCount(0)expect(existsSync(join(trashed, 'goes.bin'))).toBe(true)})++test('search and filter interaction with selection: no crash on empty query filter, Cmd+A selects matching only, Esc clears selection', async ({+ plexo,+ serve+}) => {+ const first = await serve({ size: BLOCK })+ await plexo.start(first.url(), first.sha256, { fileName: 'alpha-doc.bin' })+ await plexo.waitForStatus('completed')++ const second = await serve({ size: BLOCK })+ await plexo.start(second.url(), second.sha256, { fileName: 'beta-video.bin' })+ await plexo.waitForStatus('completed')++ const page = plexo.page+ const search = page.getByRole('textbox', { name: 'Search downloads' })++ // 1. Pick a status filter ('Finished') and type a query matching nothing ('zzz').+ // Verifies bug 1: no white screen / crash occurs when a group has 0 matches.+ await page.getByRole('button', { name: 'All downloads' }).click()+ await page.getByRole('menuitemradio', { name: 'Finished' }).click()+ await search.fill('zzz')+ await expect(page.getByText(/No downloads matching/)).toBeVisible()++ // 2. Search for 'alpha': only alpha-doc.bin shows+ await search.fill('alpha')+ await expect(page.getByText('alpha-doc.bin')).toBeVisible()+ await expect(page.getByText('beta-video.bin')).toHaveCount(0)++ // 3. Press Cmd+A / Ctrl+A: selects only the matching row (alpha-doc.bin)+ const modifier = process.platform === 'darwin' ? 'Meta' : 'Control'+ await search.blur()+ await page.keyboard.press(`${modifier}+a`)+ await expect(page.getByRole('checkbox', { name: 'Select alpha-doc.bin' })).toBeChecked()++ // 4. Press Escape with a selection: first Esc clears selection (not the hidden query)+ await page.keyboard.press('Escape')+ await expect(page.getByRole('checkbox', { name: 'Select alpha-doc.bin' })).not.toBeChecked()+ // Search box is visible again with 'alpha' still in it+ await expect(search).toHaveValue('alpha')++ // 5. Select row again and press Cmd+F: selection is cleared and search box is focused+ await page.getByRole('checkbox', { name: 'Select alpha-doc.bin' }).check()+ await expect(search).toBeHidden()+ await page.keyboard.press(`${modifier}+f`)+ await expect(page.getByRole('checkbox', { name: 'Select alpha-doc.bin' })).not.toBeChecked()+ await expect(search).toBeVisible()+ await expect(search).toBeFocused()+})++test('search box maintains minimum usable width at 720px minimum window width with active download', async ({+ plexo,+ serve+}) => {+ // Set window to minimum 720px width+ await plexo.evaluateMain(({ BrowserWindow }) => {+ const window = BrowserWindow.getAllWindows()[0]+ window.setSize(720, 620)+ }, null)+ // The default schedule allows 0:00–7:00, so set the clock inside it: otherwise the download+ // waits for the schedule and never starts.+ await plexo.evaluateMain(() => {+ const insideSchedule = new Date(2000, 0, 1, 3).getTime()+ Date.now = () => insideSchedule+ }, null)+ await plexo.api.updateSettings({+ downloadSchedule: { ...DEFAULT_DOWNLOAD_SCHEDULE, enabled: true }+ })+ // The window reads the schedule when it loads, so reload it to show the schedule button.+ await plexo.page.reload()+ await expect(plexo.page.getByRole('button', { name: 'Download schedule enabled' })).toBeVisible()++ const origin = await serve({ size: 24 * BLOCK })+ const reached = origin.hold(6 * BLOCK)+ await plexo.start(origin.url(), origin.sha256, { fileName: 'active-download.bin' })+ await reached++ const page = plexo.page+ const searchInput = page.getByRole('textbox', { name: 'Search downloads' })+ await expect(searchInput).toBeVisible()++ // Verify bounding box width is at least 130px (container is w-40 = 160px; was ~2px before fix)+ const box = await searchInput.boundingBox()+ expect(box).not.toBeNull()+ expect(box!.width).toBeGreaterThanOrEqual(130)+ await expect(page.getByRole('button', { name: 'New download' })).toBeInViewport({ ratio: 1 })+ expect(+ await page.evaluate(+ () => document.documentElement.scrollWidth <= document.documentElement.clientWidth+ )+ ).toBe(true)++ origin.release()+})diff --git a/src/renderer/src/components/DownloadFilterMenu.tsx b/src/renderer/src/components/DownloadFilterMenu.tsxindex 888d99a..0d42e8e 100644--- a/src/renderer/src/components/DownloadFilterMenu.tsx+++ b/src/renderer/src/components/DownloadFilterMenu.tsx@@ -22,7 +22,7 @@ export function DownloadFilterMenu({return (<Menu.Root><h1>- <Menu.Trigger className="flex h-8 items-center gap-2 rounded-lg px-2.5 font-sans text-[14px] leading-none font-semibold outline-none hover:bg-secondary focus-visible:ring-2 focus-visible:ring-ring">+ <Menu.Trigger className="flex h-8 items-center gap-2 rounded-lg px-2.5 font-sans text-[14px] leading-none font-semibold whitespace-nowrap outline-none hover:bg-secondary focus-visible:ring-2 focus-visible:ring-ring">{label}<ChevronDown aria-hidden className="size-3.5 text-muted-foreground" /></Menu.Trigger>diff --git a/src/renderer/src/components/NetworksMenu.tsx b/src/renderer/src/components/NetworksMenu.tsxindex 2ec9507..1ff5e92 100644--- a/src/renderer/src/components/NetworksMenu.tsx+++ b/src/renderer/src/components/NetworksMenu.tsx@@ -1,4 +1,4 @@-import { ChevronDown, ChevronRight } from 'lucide-react'+import { ChevronDown, ChevronRight, CircleOff } from 'lucide-react'import { useState } from 'react'import { useNetworkUsage } from '../hooks/useNetworks'import { useNetworkVisuals } from '../hooks/useNetworkVisuals'@@ -37,34 +37,49 @@ export function NetworksMenu({}}const total = [...speeds.values()].reduce((sum, speed) => sum + speed, 0)+ const networkLabel =+ interfaces.length === 0+ ? 'No network'+ : `${interfaces.length} ${interfaces.length === 1 ? 'network' : 'networks'}`return (<Popover open={open} onOpenChange={setOpen}><PopoverTrigger- render={<Button type="button" variant="secondary" className="gap-2.5 px-3 text-[13px]" />}+ render={+ <Button+ type="button"+ variant="secondary"+ aria-label={networkLabel}+ className="gap-1.5 px-2 text-[13px] md:gap-2.5 md:px-3"+ />+ }>- <span className="flex gap-1" aria-hidden>- {interfaces.slice(0, 4).map((iface) => (- <span- key={iface.id}- className="size-2 rounded-full"- style={{ background: networkVisual(iface.id, iface.kind, iface.displayName).solid }}- />- ))}- </span>{interfaces.length === 0 ? (- <span className="text-[var(--color-danger)]">No network</span>+ <CircleOff className="size-3.5 text-[var(--color-danger)]" aria-hidden />+ ) : (+ <span className="flex gap-1" aria-hidden>+ {interfaces.slice(0, 4).map((iface) => (+ <span+ key={iface.id}+ className="size-2 rounded-full"+ style={{ background: networkVisual(iface.id, iface.kind, iface.displayName).solid }}+ />+ ))}+ </span>+ )}+ {interfaces.length === 0 ? (+ <span className="hidden text-[var(--color-danger)] md:inline">No network</span>) : (<>- {interfaces.length} {interfaces.length === 1 ? 'network' : 'networks'}+ <span className="hidden md:inline">{networkLabel}</span>{total > 0 && (- <span className="font-mono text-[11.5px] text-muted-foreground">+ <span className="hidden font-mono text-[11.5px] text-muted-foreground md:inline">{formatSpeed(total)}</span>)}</>)}- <ChevronDown className="size-3.5 text-muted-foreground" />+ <ChevronDown className="hidden size-3.5 text-muted-foreground md:block" /></PopoverTrigger><PopoverContent align="end" className="w-[340px] gap-0 p-0"><div className="border-b-[0.5px] border-border px-4 py-3 text-[14px] font-semibold">diff --git a/src/renderer/src/screens/DownloadsScreen.tsx b/src/renderer/src/screens/DownloadsScreen.tsxindex 258f4ab..84b9846 100644--- a/src/renderer/src/screens/DownloadsScreen.tsx+++ b/src/renderer/src/screens/DownloadsScreen.tsx@@ -1,7 +1,7 @@import type { DownloadState, FinishedDownload } from '@shared/types'-import { ChevronRight, Plus, Send, X } from 'lucide-react'+import { ChevronRight, Plus, Search, Send, X } from 'lucide-react'import { cn } from 'cn'-import { Fragment, memo, useCallback, useEffect, useState } from 'react'+import { Fragment, memo, useCallback, useEffect, useMemo, useRef, useState } from 'react'import { DownloadContextMenu } from '../components/DownloadContextMenu'import { useDownloadActions, useDownloadActionsState } from '../components/downloadActionsContext'import { ACTION_META, toolbarLabel } from '../components/downloadActionMeta'@@ -12,11 +12,18 @@ import { LimitsDialog } from '../components/LimitsDialog'import { ScheduleIndicator } from '../components/ScheduleIndicator'import { networkStatusText } from '../components/NetworkRow'import { scheduleMessage, scheduleWindow } from '@shared/downloadSchedule'+import { matchesSearch, searchTokens } from '@shared/downloadSearch'import { NetworksMenu } from '../components/NetworksMenu'import { TorrentBadge } from '../components/TorrentBadge'import { UsenetBadge } from '../components/UsenetBadge'import { Button } from '../components/ui/button'import { Checkbox } from '../components/ui/checkbox'+import {+ InputGroup,+ InputGroupAddon,+ InputGroupButton,+ InputGroupInput+} from '../components/ui/input-group'import { Tooltip, TooltipContent, TooltipTrigger } from '../components/ui/tooltip'import { useNetworkVisuals, type ResolveNetworkVisual } from '../hooks/useNetworkVisuals'import { useAppStore, type DownloadFilter } from '../store/useAppStore'@@ -100,6 +107,11 @@ export function DownloadsScreen(): React.JSX.Element {const [limitsOpen, setLimitsOpen] = useState(false)const [showSchedule, setShowSchedule] = useState(false)const [limitsPage, setLimitsPage] = useState<string | null>(null)+ const [searchQuery, setSearchQuery] = useState('')+ const searchInputRef = useRef<HTMLInputElement>(null)+ const isMac = window.plexo.platform === 'darwin'+ const tokens = useMemo(() => searchTokens(searchQuery), [searchQuery])+ const isSearching = tokens.length > 0const [now, setNow] = useState(() => Date.now())useEffect(() => {@@ -119,9 +131,14 @@ export function DownloadsScreen(): React.JSX.Element {failed: 0}for (const item of allItems) counts[filterOf(item)]++- const groups = allGroups.filter(- (group) => filter === 'all' || filterOf(group.items[0]) === filter- )+ const groups = allGroups+ .map((group) => ({+ ...group,+ items: isSearching ? group.items.filter((item) => matchesSearch(item, tokens)) : group.items+ }))+ .filter(+ (group) => group.items.length > 0 && (filter === 'all' || filterOf(group.items[0]) === filter)+ )const items = groups.flatMap((group) => group.items)// Only what's still listed counts: one that finished or went is no longer selected.const chosen = items.filter((item) => selected.has(item.id))@@ -146,6 +163,7 @@ export function DownloadsScreen(): React.JSX.Element {// the selected off the list (with Cmd/Ctrl, moves their files to the Trash), each asking first.useEffect(() => {const onKeyDown = (event: KeyboardEvent): void => {+ const command = isMac ? event.metaKey : event.ctrlKeyconst target = event.targetif (event.defaultPrevented ||@@ -154,9 +172,22 @@ export function DownloadsScreen(): React.JSX.Element {document.querySelector('[role="dialog"], [role="alertdialog"], [role="menu"]'))return- const command = window.plexo.platform === 'darwin' ? event.metaKey : event.ctrlKey- if (event.key === 'Escape') setSelected(new Set())- else if (command && event.key.toLowerCase() === 'a') {++ if (event.key === 'Escape') {+ setSelected(new Set())+ } else if (command && event.key.toLowerCase() === 'f') {+ event.preventDefault()+ if (chosen.length > 0) {+ setSelected(new Set())+ requestAnimationFrame(() => {+ searchInputRef.current?.focus()+ searchInputRef.current?.select()+ })+ } else {+ searchInputRef.current?.focus()+ searchInputRef.current?.select()+ }+ } else if (command && event.key.toLowerCase() === 'a') {event.preventDefault()setSelected(new Set(items.map((item) => item.id)))} else if (event.key === 'Delete' || event.key === 'Backspace') {@@ -171,7 +202,7 @@ export function DownloadsScreen(): React.JSX.Element {}window.addEventListener('keydown', onKeyDown)return () => window.removeEventListener('keydown', onKeyDown)- }, [items, chosen, perform])+ }, [items, chosen, perform, isMac])// What the toolbar offers: the two actions most needed for what's selected as buttons, and// the rest of what the menu does for the selection behind More, so six never need more room.@@ -186,7 +217,7 @@ export function DownloadsScreen(): React.JSX.Element {return (<div className="flex h-full flex-col bg-background">{chosen.length === 0 ? (- <div className="flex h-12 shrink-0 items-center gap-3 border-b-[0.5px] border-border px-5">+ <div className="relative flex h-12 shrink-0 items-center gap-2 border-b-[0.5px] border-border px-3 sm:gap-3 sm:px-5"><DownloadFilterMenuvalue={filter}counts={counts}@@ -197,11 +228,55 @@ export function DownloadsScreen(): React.JSX.Element {/>{/* One group already says it in its header. */}{allGroups.length > 1 && (- <div className="font-mono text-[11.5px] leading-none text-muted-foreground">+ <div className="hidden font-mono text-[11.5px] leading-none whitespace-nowrap text-muted-foreground lg:block">{summaryOf(downloads)}</div>)}<div className="flex-1" />+ <div className="relative w-44 shrink-0 sm:w-48 md:w-52 min-[900px]:absolute min-[900px]:left-1/2 min-[900px]:-translate-x-1/2 lg:w-60">+ <InputGroup className="h-7 w-full border-border/70 bg-secondary/30">+ <InputGroupAddon align="inline-start">+ <Search className="size-3.5 text-muted-foreground" />+ </InputGroupAddon>+ <InputGroupInput+ ref={searchInputRef}+ type="text"+ value={searchQuery}+ onChange={(e) => setSearchQuery(e.target.value)}+ onKeyDown={(event) => {+ if (event.key === 'Escape') {+ event.preventDefault()+ if (searchQuery) {+ setSearchQuery('')+ } else {+ searchInputRef.current?.blur()+ }+ }+ }}+ placeholder="Search downloads"+ className="h-7 text-xs placeholder:text-muted-foreground/70"+ aria-label="Search downloads"+ />+ <InputGroupAddon align="inline-end">+ {searchQuery ? (+ <InputGroupButton+ size="icon-xs"+ onClick={() => {+ setSearchQuery('')+ searchInputRef.current?.focus()+ }}+ aria-label="Clear search"+ >+ <X className="size-3" />+ </InputGroupButton>+ ) : (+ <kbd className="hidden font-mono text-[10px] text-muted-foreground/60 select-none sm:inline-block">+ {isMac ? '⌘F' : 'Ctrl+F'}+ </kbd>+ )}+ </InputGroupAddon>+ </InputGroup>+ </div><ScheduleIndicator onClick={openSchedule} /><NetworksMenuonOpenLimits={(page) => {@@ -210,10 +285,23 @@ export function DownloadsScreen(): React.JSX.Element {setLimitsOpen(true)}}/>- <Button type="button" variant="secondary" onClick={() => openTelegram()}>- <Send data-icon="inline-start" />- Telegram- </Button>+ <Tooltip>+ <TooltipTrigger+ render={+ <Button+ type="button"+ variant="secondary"+ onClick={() => openTelegram()}+ aria-label="Telegram"+ className="px-2.5"+ >+ <Send className="size-3.5" />+ <span className="hidden lg:inline">Telegram</span>+ </Button>+ }+ />+ <TooltipContent>Telegram Saved Messages</TooltipContent>+ </Tooltip><Button type="button" onClick={() => openNewDownload()}><Plus data-icon="inline-start" />New download@@ -277,7 +365,17 @@ export function DownloadsScreen(): React.JSX.Element {<div className="min-h-0 flex-1 overflow-y-auto px-5 pb-5">{groups.length === 0 &&- (filter === 'all' ? (+ (isSearching ? (+ <div role="status" className="flex flex-col items-center gap-2 px-5 py-16 text-center">+ <Search className="size-8 stroke-[1.5] text-muted-foreground opacity-40" />+ <p className="text-[16px] font-semibold">+ No downloads matching “{searchQuery.trim()}”+ </p>+ <Button type="button" variant="secondary" onClick={() => setSearchQuery('')}>+ Clear search+ </Button>+ </div>+ ) : filter === 'all' ? (<EmptyState />) : (<div role="status" className="flex flex-col items-center gap-2 px-5 py-16 text-center">@@ -315,7 +413,7 @@ export function DownloadsScreen(): React.JSX.Element {<span className="ml-2.5 tracking-normal">{group.items.length}</span></h2><div className="flex-1" />- {group.label === 'Finished' && history.length > 0 && (+ {group.label === 'Finished' && history.length > 0 && !isSearching && (<buttontype="button"className="text-[12.5px] text-[var(--text-secondary)] hover:text-foreground"diff --git a/src/shared/downloadSearch.ts b/src/shared/downloadSearch.tsnew file mode 100644index 0000000..af610fa--- /dev/null+++ b/src/shared/downloadSearch.ts@@ -0,0 +1,46 @@+/**+ * Normalizes a search query by trimming whitespace and normalizing Unicode (NFC).+ */+export function normalizeSearchQuery(query: string): string {+ return query.trim().normalize('NFC').toLowerCase()+}++/**+ * Splits a search query into non-empty lowercase normalized tokens.+ */+export function searchTokens(query: string): string[] {+ const normalized = normalizeSearchQuery(query)+ return normalized ? normalized.split(/\s+/).filter(Boolean) : []+}++/**+ * Checks whether a download item matches a search query or a pre-computed list of tokens.+ * Matches case-insensitively across fileName and url.+ * Multiple space-separated keywords must all match (AND search).+ * An empty or whitespace-only query matches all items.+ */+export function matchesSearch(+ item: { fileName: string; url?: string },+ queryOrTokens: string | readonly string[]+): boolean {+ const tokens = typeof queryOrTokens === 'string' ? searchTokens(queryOrTokens) : queryOrTokens+ if (tokens.length === 0) return true++ const name = item.fileName.normalize('NFC').toLowerCase()+ const url = (item.url ?? '').normalize('NFC').toLowerCase()+ const haystack = `${name} ${url}`++ return tokens.every((token) => haystack.includes(token))+}++/**+ * Filters an array of download items against a search query.+ */+export function filterDownloadsByQuery<T extends { fileName: string; url?: string }>(+ items: readonly T[],+ query: string+): T[] {+ const tokens = searchTokens(query)+ if (tokens.length === 0) return [...items]+ return items.filter((item) => matchesSearch(item, tokens))+}