add the transient message row

11 files changed, 286 insertions, 41 deletions

diff --git a/test/snapshot.zig b/test/snapshot.zig
index 0a2b299d..39350bee 100644
--- a/test/snapshot.zig
+++ b/test/snapshot.zig
@@ -313,9 +313,11 @@ fn runScript(arena: std.mem.Allocator, exe_z: [:0]const u8, script_path: []const
     _ = setenv("XDG_CONFIG_HOME", config_home, 1);
     _ = setenv("TERM", "xterm-256color", 1);
     _ = setenv("LC_ALL", "C", 1);
-    // durations cannot live in a golden; the lsp introspection views print
-    // `-` for them when this is set (see lsp_zls.zig hideTime)
-    _ = setenv("PARDES_LSP_NOTIME", "1", 1);
+    // a wall clock cannot live in a golden; everything that would print one
+    // prints fixed characters instead when this is set — the lsp introspection
+    // views' durations (lsp_zls.zig hideTime) and the transient message row's
+    // time of day (message.zig stamp)
+    _ = setenv("PARDES_NOTIME", "1", 1);
     // Pin the dump path: live runs use a timestamped file under the user data
     // dir (dump.outPath), which would make the dump/load/restore goldens
     // nondeterministic. Per-SCRIPT, not one shared /tmp/pardes-dump.zon: four
diff --git a/test/snapshots/filewatch.golden b/test/snapshots/filewatch.golden
index 650c290d..3224dd27 100644
--- a/test/snapshots/filewatch.golden
+++ b/test/snapshots/filewatch.golden
@@ -45,7 +45,7 @@
 |
 |
 |
-|
+|  --:--:--  reloaded /tmp/pardes-snap/filewatch/cw
 |  /tmp/pardes-snap/filewatch/cwd/sub/s.txt Save Ne  /tmp/pardes-snap/filewatch/cwd New Del
 |     1 line 1
 |     2 line 2                                       sub  w.txt
@@ -76,7 +76,7 @@
 |
 |
 |
-|
+|  --:--:--  reloaded /tmp/pardes-snap/filewatch/cw
 |  /tmp/pardes-snap/filewatch/cwd/sub/s.txt Save Ne  /tmp/pardes-snap/filewatch/cwd New Del
 |     1 RENAMED
 |     2                                              sub  w.txt
@@ -90,7 +90,7 @@
 |
 |
 |
-|
+|  --:--:--  reloaded /tmp/pardes-snap/filewatch/cw
 == snap undone grid=150x30 cursor=15,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/filewatch/cwd/w.txt Save New De  /tmp/pardes-snap/filewatch/cwd New Del            /tmp/pardes-snap/filewatch/cwd New Del
diff --git a/test/snapshots/find.golden b/test/snapshots/find.golden
index 6217c428..6419cba0 100644
--- a/test/snapshots/find.golden
+++ b/test/snapshots/find.golden
@@ -39,9 +39,9 @@
 |
 |
 |
-== snap armed grid=120x40 cursor=56,1
+== snap armed grid=120x40 cursor=9,39
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/find/cwd/here.txt Save New Del Find /
+|  /tmp/pardes-snap/find/cwd/here.txt Save New Del
 |     1 Find
 |
 |
@@ -79,10 +79,10 @@
 |
 |
 |
-|
-== snap typing grid=120x40 cursor=59,1
+|   Find /
+== snap typing grid=120x40 cursor=12,39
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/find/cwd/here.txt Save New Del Find /zqm
+|  /tmp/pardes-snap/find/cwd/here.txt Save New Del
 |     1 Find
 |
 |
@@ -120,7 +120,7 @@
 |
 |
 |
-|
+|   Find /zqm
 == snap results grid=120x40 cursor=7,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/find/cwd/here.txt Save New Del
@@ -367,13 +367,13 @@
 |     1 sub/ZQMARK-beta.txt
 |     2 sub/nest/zqmark-gamma.txt
 |     3 zqmark-alpha.txt
-== snap word grid=120x40 cursor=56,1
+== snap word grid=120x40 cursor=9,5
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/find/cwd/here.txt Save New Del Find /
+|  /tmp/pardes-snap/find/cwd/here.txt Save New Del
 |     1 Find
 |
 |
-|
+|   Find /
 |  /tmp/pardes-snap/find/cwd/zqmark-alpha.txt Save New Del
 |     1 alpha body
 |
diff --git a/test/snapshots/fsearch.golden b/test/snapshots/fsearch.golden
index 61866b75..08132e28 100644
--- a/test/snapshots/fsearch.golden
+++ b/test/snapshots/fsearch.golden
@@ -29,9 +29,9 @@
 |
 |
 |
-== snap typing grid=180x30 cursor=55,1
+== snap typing grid=180x30 cursor=8,29
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/fsearch/cwd/g.txt Save New Del /MARK       /tmp/pardes-snap/fsearch/cwd New Del                        /tmp/pardes-snap/fsearch/cwd New Del
+|  /tmp/pardes-snap/fsearch/cwd/g.txt Save New Del             /tmp/pardes-snap/fsearch/cwd New Del                        /tmp/pardes-snap/fsearch/cwd New Del
 |     1 l1
 |     2 MARK a                                                 g.txt                                                       g.txt
 |     3 l3
@@ -59,7 +59,7 @@
 |
 |
 |
-|
+|   /MARK
 == snap results grid=180x30 cursor=7,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/fsearch/cwd/g.txt Save New Del             /tmp/pardes-snap/fsearch/cwd New Del                        /tmp/pardes-snap/fsearch/cwd New Del
diff --git a/test/snapshots/grep.golden b/test/snapshots/grep.golden
index 01761d87..f64119a8 100644
--- a/test/snapshots/grep.golden
+++ b/test/snapshots/grep.golden
@@ -29,9 +29,9 @@
 |
 |
 |
-== snap typing grid=180x30 cursor=59,1
+== snap typing grid=180x30 cursor=15,29
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/grep/cwd/a.txt Save New Del Grep /TARGET   /tmp/pardes-snap/grep/cwd New Del                           /tmp/pardes-snap/grep/cwd New Del
+|  /tmp/pardes-snap/grep/cwd/a.txt Save New Del                /tmp/pardes-snap/grep/cwd New Del                           /tmp/pardes-snap/grep/cwd New Del
 |     1 hello TARGET one
 |     2 nothing here                                           a.txt  noise.txt  sub                                       a.txt  noise.txt  sub
 |     3 last TARGET line
@@ -59,7 +59,7 @@
 |
 |
 |
-|
+|   Grep /TARGET
 == snap results grid=180x30 cursor=7,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/grep/cwd/a.txt Save New Del                /tmp/pardes-snap/grep/cwd New Del                           /tmp/pardes-snap/grep/cwd New Del
diff --git a/test/snapshots/msg.golden b/test/snapshots/msg.golden
new file mode 100644
index 00000000..67ab94ea
--- /dev/null
+++ b/test/snapshots/msg.golden
@@ -0,0 +1,166 @@
+== snap opened grid=70x14 cursor=7,2
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|
+== snap saved grid=70x14 cursor=7,2
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|  --:--:--  saved /tmp/pardes-snap/msg/cwd/a.txt
+== snap repainted grid=70x16 cursor=7,2
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|
+|
+|  --:--:--  saved /tmp/pardes-snap/msg/cwd/a.txt
+== snap keycleared grid=70x16 cursor=7,3
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|
+|
+|
+== snap saved-again grid=70x16 cursor=7,3
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|
+|
+|  --:--:--  saved /tmp/pardes-snap/msg/cwd/a.txt
+== snap mousecleared grid=70x16 cursor=7,3
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 line 1
+|     2 line 2
+|     3 line 3
+|     4 line 4
+|     5 line 5
+|     6 line 6
+|     7
+|
+|
+|
+|
+|
+|
+|
+== snap reloaded grid=70x16 cursor=7,3
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 EXTERNAL
+|     2
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|  --:--:--  reloaded /tmp/pardes-snap/msg/cwd/a.txt
+== snap prompt grid=70x16 cursor=7,15
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 EXTERNAL
+|     2
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|   /EXT
+== snap prompt-wins grid=70x16 cursor=7,15
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 AGAIN
+|     2
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|   /EXT
+== snap esc grid=70x16 cursor=7,3
+|New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
+|  /tmp/pardes-snap/msg/cwd/a.txt Save New Del
+|     1 AGAIN
+|     2
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
diff --git a/test/snapshots/msg.snap b/test/snapshots/msg.snap
new file mode 100644
index 00000000..640e9a0c
--- /dev/null
+++ b/test/snapshots/msg.snap
@@ -0,0 +1,77 @@
+# The transient message row: the LAST row of a pane, left-aligned at the text
+# area's origin, saying what just happened to that pane and when. An OVERLAY,
+# not geometry — nothing shrinks to make room, so a pane with nothing to say is
+# not touched at all, which is why the other 71 goldens only moved where a
+# prompt or a message actually appears.
+#
+# The clock reads `--:--:--` here and only here: $PARDES_NOTIME (set by
+# snapshot.zig, the same flag that hides the language backend's durations)
+# blanks the DIGITS rather than the row, because a message that disappeared
+# under the harness could not be pinned at all.
+#
+# The row has exactly two possible occupants and they are not the same kind of
+# thing. A MESSAGE is a report of something that already happened, and the next
+# key or mouse event wipes it. An armed PROMPT is what that keystroke is being
+# typed INTO, it lives until Enter or Esc, and it WINS.
+lines a.txt 6
+start 14 70 a.txt
+wait 8000 New Newcol
+wait 8000 a.txt
+stable 700 20000
+snap opened
+# Save (SPC f s) writes the file; the SHELL is where the write and the clock
+# both are, so the shell is what posts the message once the bytes are down.
+key space f s
+stable 700 15000
+snap saved
+# A REPAINT is not input. A resize redraws every cell in the window from
+# scratch and the message is still there on the other side of it — the row is
+# state, not one frame's flash. (Different rows, or the kernel sends no
+# SIGWINCH and nothing repaints.)
+resize 16 70
+stable 700 15000
+snap repainted
+# ...but the next KEY takes it away. `j` is a plain cursor motion and changes
+# nothing else on screen, so the vanishing message is the whole diff.
+key j
+stable 700 15000
+snap keycleared
+# Again, and this time a bare mouse MOTION — no button, nothing clicked —
+# clears it: any mouse event counts, the rule is "you are back", not "you did
+# something".
+key space f s
+stable 700 15000
+snap saved-again
+motion 20 6
+stable 700 15000
+snap mousecleared
+# The other message: an external write lands in the pane (filewatch.snap owns
+# that contract) and the row says which of the two things happened. `run` is a
+# child of the RUNNER, so the app receives no keystroke here and nothing but
+# the watch could have posted this.
+run printf 'EXTERNAL\n' > a.txt
+wait 10000 EXTERNAL
+stable 700 15000
+snap reloaded
+# `/` still types into the tag tail — same buffer, same offsets, same one-line
+# editor, same Enter and Esc — but it is DRAWN here now, so the tagline keeps
+# its builtins instead of losing them to a long pattern. Note the tag row above
+# ends at `Del`: the marker and the pattern are no longer on it at all. (The
+# `/` keystroke also cleared the reload message, which is the rule above.)
+key /
+text EXT
+stable 700 15000
+snap prompt
+# ...and a message arriving UNDER an armed prompt does not disturb it: a second
+# external write reloads the pane and posts one, the row stays the prompt's.
+run printf 'AGAIN\n' > a.txt
+wait 10000 AGAIN
+stable 700 15000
+snap prompt-wins
+# Esc abandons the input, and the very key that abandoned it is also the key
+# that clears the message queued underneath — so the row goes empty rather than
+# handing back a report from before you started typing.
+key esc
+settle 100
+stable 700 15000
+snap esc
diff --git a/test/snapshots/pipe.golden b/test/snapshots/pipe.golden
index 42e12959..0cd57642 100644
--- a/test/snapshots/pipe.golden
+++ b/test/snapshots/pipe.golden
@@ -1,6 +1,6 @@
-== snap prompt grid=180x12 cursor=61,1
+== snap prompt grid=180x12 cursor=14,11
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/pipe/cwd/pipe.txt Save New Del |tr a-z A-Z
+|  /tmp/pardes-snap/pipe/cwd/pipe.txt Save New Del
 |     1 alpha beta
 |     2 gamma delta
 |
@@ -10,7 +10,7 @@
 |
 |
 |
-|
+|   |tr a-z A-Z
 == snap filtered grid=180x12 cursor=17,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/pipe/cwd/pipe.txt Save New Del
diff --git a/test/snapshots/psearch.golden b/test/snapshots/psearch.golden
index a3e65037..0ce9f2ee 100644
--- a/test/snapshots/psearch.golden
+++ b/test/snapshots/psearch.golden
@@ -29,9 +29,9 @@
 |
 |
 |
-== snap typing grid=140x30 cursor=44,1
+== snap typing grid=140x30 cursor=8,29
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/psearch/cwd New Del /MARK
+|  /tmp/pardes-snap/psearch/cwd New Del
 |
 |  x MARK a
 |  zz
@@ -59,7 +59,7 @@
 |
 |
 |
-|
+|   /MARK
 == snap results grid=140x30 cursor=4,8
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/psearch/cwd New Del
diff --git a/test/snapshots/selregex.golden b/test/snapshots/selregex.golden
index b66d0d1e..8317a2a6 100644
--- a/test/snapshots/selregex.golden
+++ b/test/snapshots/selregex.golden
@@ -1,6 +1,6 @@
-== snap prompt-armed grid=160x24 cursor=59,1
+== snap prompt-armed grid=160x24 cursor=11,23
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del Select /
+|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del
 |     1 const one = 1;
 |     2 const two = 2;
 |     3 const three = 3;
@@ -22,10 +22,10 @@
 |
 |
 |
-|
-== snap preview grid=160x24 cursor=64,1
+|   Select /
+== snap preview grid=160x24 cursor=16,23
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del Select /const
+|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del
 |     1 const one = 1;
 |     2 const two = 2;
 |     3 const three = 3;
@@ -47,10 +47,10 @@
 |
 |
 |
-|
+|   Select /const
 == style preview
 |0: 0-56 #949494,#121212, 57-159 d,#121212,
-|1: 0-1 #ffffff,#626262, 2-63 #949494,#121212, 64-159 d,#121212,
+|1: 0-1 #ffffff,#626262, 2-49 #949494,#121212, 50-159 d,#121212,
 |2: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #080808,#80a0ff, 11-11 #80a0ff,#080808, 12-18 #bdbdbd,#080808, 19-19 #e3c78a,#080808, 20-20 #bdbdbd,#080808, 21-159 d,#080808,
 |3: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #080808,#445483, 11-11 #80a0ff,#080808, 12-18 #bdbdbd,#080808, 19-19 #e3c78a,#080808, 20-20 #bdbdbd,#080808, 21-159 d,#080808,
 |4: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #080808,#445483, 11-11 #80a0ff,#080808, 12-20 #bdbdbd,#080808, 21-21 #e3c78a,#080808, 22-22 #bdbdbd,#080808, 23-159 d,#080808,
@@ -72,7 +72,7 @@
 |20: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |21: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |22: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
-|23: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
+|23: 0-0 d,#444444, 1-1 d,#080808, 2-15 #949494,#121212, 16-159 d,#121212,
 == snap three-selected grid=160x24 cursor=11,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del
@@ -123,9 +123,9 @@
 |21: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |22: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |23: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
-== snap narrowed grid=160x24 cursor=60,1
+== snap narrowed grid=160x24 cursor=12,23
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
-|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del Select /t
+|  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del
 |     1 const one = 1;
 |     2 const two = 2;
 |     3 const three = 3;
@@ -147,10 +147,10 @@
 |
 |
 |
-|
+|   Select /t
 == style narrowed
 |0: 0-56 #949494,#121212, 57-159 d,#121212,
-|1: 0-1 #ffffff,#626262, 2-59 #949494,#121212, 60-159 d,#121212,
+|1: 0-1 #ffffff,#626262, 2-49 #949494,#121212, 50-159 d,#121212,
 |2: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #bdbdbd,#080808, 11-11 #80a0ff,#080808, 12-18 #bdbdbd,#080808, 19-19 #e3c78a,#080808, 20-20 #bdbdbd,#080808, 21-159 d,#080808,
 |3: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #bdbdbd,#080808, 11-11 #80a0ff,#080808, 12-18 #bdbdbd,#080808, 19-19 #e3c78a,#080808, 20-20 #bdbdbd,#080808, 21-159 d,#080808,
 |4: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-10 #bdbdbd,#080808, 11-11 #80a0ff,#080808, 12-20 #bdbdbd,#080808, 21-21 #e3c78a,#080808, 22-22 #bdbdbd,#080808, 23-159 d,#080808,
@@ -172,7 +172,7 @@
 |20: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |21: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
 |22: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
-|23: 0-0 d,#444444, 1-1 d,#080808, 2-6 #626262,#080808, 7-159 d,#080808,
+|23: 0-0 d,#444444, 1-1 d,#080808, 2-11 #949494,#121212, 12-159 d,#121212,
 == snap esc-restores grid=160x24 cursor=11,2
 |New Newcol Find Grep Help Tutor Dump NextColor Debug Kill
 |  /tmp/pardes-snap/selregex/cwd/m.zig Save New Del
diff --git a/test/snapshots/tagcmd.golden b/test/snapshots/tagcmd.golden
index 6bba1787..57fbd567 100644
--- a/test/snapshots/tagcmd.golden
+++ b/test/snapshots/tagcmd.golden
@@ -121,7 +121,7 @@
 |
 |
 |
-|
+|  --:--:--  saved /tmp/pardes-snap/tagcmd/cwd/c.txt
 == file written
 ZZEDITline 1
 line 2