#28 - tui: Gallery screen — search, filter, sort - charles/loom

charles commented

2026-04-11 13:04:13 +00:00

Owner

User story

As a user with a large gallery, I want to search, filter, and sort entries, so that I can find images by prompt, model, date, or favourite status.

Acceptance criteria

Search

/ enters search mode with an input overlay at the bottom of the Gallery
Real-time filtering as the user types (debounced 150 ms) against prompt text, tags, filename
Enter commits and exits search mode leaving the filter applied; Esc cancels and restores the full list
n / N cycles the selection to next/previous match within the applied filter

Filter panel

f opens a filter overlay with: folder, date range, favorites-only toggle, model, sampler
Each filter is an editable field; Enter applies, Esc cancels
Active filters shown as chips in the gallery header

Sort

S cycles through sort modes: date desc (default), date asc, favorites first, random
Current sort mode shown in the gallery header

Plumbing

All filter/sort state pushed down to loom-core GalleryFilter where possible; client-side only for search debouncing
Keybinds registered in the action registry

Tests

Unit test: applying a search then a folder filter produces a combined query on loom-core
Unit test: S cycles through all four sort modes and wraps

Out of scope

Folders / favorites / multi-select UI (separate ticket)
Grid/list mode toggling (separate ticket)

References

Spec §4.2.2 "Search", "Filtering", "Sorting"

## User story As a user with a large gallery, I want to search, filter, and sort entries, so that I can find images by prompt, model, date, or favourite status. ## Acceptance criteria ### Search - [ ] `/` enters search mode with an input overlay at the bottom of the Gallery - [ ] Real-time filtering as the user types (debounced 150 ms) against prompt text, tags, filename - [ ] `Enter` commits and exits search mode leaving the filter applied; `Esc` cancels and restores the full list - [ ] `n` / `N` cycles the selection to next/previous match within the applied filter ### Filter panel - [ ] `f` opens a filter overlay with: folder, date range, favorites-only toggle, model, sampler - [ ] Each filter is an editable field; `Enter` applies, `Esc` cancels - [ ] Active filters shown as chips in the gallery header ### Sort - [ ] `S` cycles through sort modes: date desc (default), date asc, favorites first, random - [ ] Current sort mode shown in the gallery header ### Plumbing - [ ] All filter/sort state pushed down to `loom-core` `GalleryFilter` where possible; client-side only for search debouncing - [ ] Keybinds registered in the action registry ### Tests - [ ] Unit test: applying a search then a folder filter produces a combined query on `loom-core` - [ ] Unit test: `S` cycles through all four sort modes and wraps ## Out of scope - Folders / favorites / multi-select UI (separate ticket) - Grid/list mode toggling (separate ticket) ## References - Spec §4.2.2 "Search", "Filtering", "Sorting"

charles added this to the loom-tui v0.1.0 milestone

2026-04-11 13:04:13 +00:00

charles added the

area:gallery

type:user-story

labels

2026-04-11 13:04:13 +00:00

charles referenced this issue

2026-04-11 13:07:50 +00:00

tui: tracking — loom-tui v0.1.0 roadmap & implementation order #47

charles referenced this issue from a commit

2026-04-11 16:22:16 +00:00