summaryrefslogtreecommitdiff
path: root/test/web-snapshots/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'test/web-snapshots/README.md')
-rw-r--r--test/web-snapshots/README.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/test/web-snapshots/README.md b/test/web-snapshots/README.md
new file mode 100644
index 00000000..d2ea84f8
--- /dev/null
+++ b/test/web-snapshots/README.md
@@ -0,0 +1,18 @@
+# Web browser snapshots
+
+`source-list.dump.zon` is a byte-for-byte dump from a running Pardes instance.
+It is not assembled or normalized by a fixture generator.
+
+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.
+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 that dump through Chromium: it checks the
+full listing, taps `build.zig`, snapshots tree-sitter style runs, resizes the
+pane separator, and finally verifies body scrolling.