Skip to content

armgit / plexo

Public Imported from GitHub
0

Speed up downloads by combining multiple network connections in parallel

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.ts
new file mode 100644
index 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.ts
index 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 aga
await 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.tsx
index 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.tsx
index 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.tsx
index 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 > 0
const [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.ctrlKey
const target = event.target
if (
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">
<DownloadFilterMenu
value={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} />
<NetworksMenu
onOpenLimits={(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 &ldquo;{searchQuery.trim()}&rdquo;
+ </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 && (
<button
type="button"
className="text-[12.5px] text-[var(--text-secondary)] hover:text-foreground"
diff --git a/src/shared/downloadSearch.ts b/src/shared/downloadSearch.ts
new file mode 100644
index 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))
+}