big slow change: prebuilt shaders (SPIR-V/Metal), core gui reflow, docs, web + snapshot refresh

1 files changed, 14 insertions, 8 deletions

diff --git a/test/web-snapshots/README.md b/test/web-snapshots/README.md
index c6564ba0..3b121949 100644
--- a/test/web-snapshots/README.md
+++ b/test/web-snapshots/README.md
@@ -7,13 +7,19 @@ To recapture it:
 
 1. Build and launch the native TTY in this checkout with `PARDES_DUMP` pointing
    at a temporary file.
-2. Enter TTY mode, run `clear`, then run `git ls-files '*.zig'`.
-3. Leave the pane in TTY mode and middle-click Pardes's `Dump` builtin.
+2. Enter raw TTY mode, run `clear`, then run
+   `git ls-files --cached --others --exclude-standard -- '*.zig' | sort`.
+   This is the archive generator's tracked-plus-new/nonignored selection in its
+   deterministic display order.
+3. Leave raw TTY mode, press `gg` so the listing starts at scrollback row zero,
+   and middle-click Pardes's `Dump` builtin.
 4. Copy the resulting dump into `source-list.dump.zon` without editing it.
 
-The visible `.body` must exactly match the command plus every path reported by
-Git (and the final prompt). The base64 PTY stream must contain the command
-itself. `source-list.snap` then drives the freestanding WASM + DOM build through
-Chromium: it checks the full listing, taps `build.zig`, snapshots packed cell
-styles (including Tree-sitter's Zig highlighting), resizes the pane separator,
-and finally verifies body scrolling.
+The visible `.body` is the first terminal viewport; `.terminal.stream` must
+contain the command plus every path reported by Git, and every listed path must
+exist. The base64 PTY stream is the real interaction and must contain the
+command itself. `source-list.snap` then drives the freestanding WASM + DOM build
+through Chromium: top and bottom launcher snapshots jointly cover the complete
+listing, then it taps `build.zig`, snapshots packed cell styles (including
+Tree-sitter's Zig highlighting), resizes the pane separator, and finally
+verifies body scrolling.