docs: picker and backdrop in the README and checklist

README.md

@@ -59,15 +59,36 @@ binds {
 |---|---|
 | `valw screen [--all]` | The focused output (or every output) |
 | `valw region` | Drag a region; Shift locks an axis, Alt grows from the centre, Space moves it; Space before dragging switches to window mode |
-| `valw window` | Click a window |
+| `valw window [--pick]` | Pick a window from cards over a liquid-paint background (Tab/arrows, Enter, Esc); `--pick` clicks it on screen instead |
 | `valw zoom` | Freeze the screen and zoom: wheel, drag, `f` flashlight, `c` capture the view, `0` reset, Esc |
 | `valw toolbar` | Pick a mode from a floating bar, with a timer and options |
 | `valw edit FILE` | The markup editor (clicking a preview opens it) |
+| `valw backdrop` | Keep running: the liquid-paint background behind niri's overview (below) |
 | `valw doctor` | What the compositor and system support |
 
 Capture commands take `--clipboard-only`, `-o PATH` (`-` for stdout),
 `--delay SECS`, `--cursor` and `--no-preview`.
 
+## The overview backdrop
+
+`valw backdrop` draws a slow liquid-paint background, coloured from the
+wallpaper (via Noctalia, if it runs), behind niri's overview. It only draws
+while the overview shows it. Start it with niri and place it in the
+backdrop:
+
+```kdl
+spawn-at-startup "valw" "backdrop"
+
+layer-rule {
+    match namespace="^valw-backdrop$"
+    place-within-backdrop true
+}
+```
+
+With Noctalia, turn its own backdrop off (`[backdrop] enabled = false`).
+Colours elsewhere (the region dim, the window picker's fallback) follow
+Noctalia's current community palette when there is one.
+
 ## Configuration
 
 Every key is optional; these are the defaults.

docs/test-checklist.md

@@ -168,3 +168,13 @@ image, a cancel brought the thumbnail back, and a swipe still dismissed it.
 - The README's module example assumes `inputs` is passed to home-manager modules.
 - The source filter drops any `docs` or `README.md` at any depth, not just the root ones.
 - The README's niri binds clash with niri's default `Print` bind if pasted next to it.
+
+## Theme
+
+- [ ] Region (Mod+Shift+S): the dim outside the selection takes the Noctalia theme's colour (light and dark mode), still see-through; it opens as fast as before.
+- [ ] `valw window` (Mod+Shift+W): cards for every window, most recently used first, icons right (Ghostty, Dolphin, Telegram, Spotify…), long titles ellipsised; Tab/Shift+Tab/arrows/hover move the selection; Enter or a click captures that window (shadow, sound, preview); Esc or a click outside cancels.
+- [ ] The picker's shader alternates swirl/flow per run and takes the selected window's colours, easing between cards; the picker never appears in the shot.
+- [ ] 20+ windows still fit (cards shrink); a window without an icon shows its initial.
+- [ ] Toolbar → Window opens the picker; Space in region mode still uses niri's click-a-window.
+- [ ] Overview (Mod+Tab): the paint flows slowly behind the workspaces, coloured from the current wallpaper; after the wallpaper changes, the next overview eases to the new colours; no GPU load while the overview is closed (`cat /sys/class/drm/card1/gt_act_freq_mhz` stays low).
+- [ ] Two monitors: each has its own backdrop; unplugging/replugging one keeps the other working.