diff options
Diffstat (limited to 'test/process/tty_editing.zig')
| -rw-r--r-- | test/process/tty_editing.zig | 2556 |
1 files changed, 2555 insertions, 1 deletions
diff --git a/test/process/tty_editing.zig b/test/process/tty_editing.zig index 8d125aeb..72cbb573 100644 --- a/test/process/tty_editing.zig +++ b/test/process/tty_editing.zig @@ -1,3 +1,2557 @@ //! The tty frontend's own cases (test/tty.zig), editing: modes, selections, look, search, the language client, diffs. +const std = @import("std"); +const Tty = @import("../tty.zig").Tty; -pub const cases = .{}; +pub const cases = .{ + .{ "tty editing: edit", edit }, + .{ "tty editing: fileedit", fileedit }, + .{ "tty editing: modal", modal }, + .{ "tty editing: multicursor", multicursor }, + .{ "tty editing: selregex", selregex }, + .{ "tty editing: yankpaste", yankpaste }, + .{ "tty editing: pipe", pipe }, + .{ "tty editing: chordcut", chordcut }, + .{ "tty editing: selarg", selarg }, + .{ "tty editing: find", find }, + .{ "tty editing: fsearch", fsearch }, + .{ "tty editing: grep", grep }, + .{ "tty editing: stepgrain", stepgrain }, + .{ "tty editing: look-center", look_center }, + .{ "tty editing: look-file", look_file }, + .{ "tty editing: look-file-1col", look_file_1col }, + .{ "tty editing: lookloaded", lookloaded }, + .{ "tty editing: lookpanes", lookpanes }, + .{ "tty editing: lookrange", lookrange }, + .{ "tty editing: jumps", jumps }, + .{ "tty editing: cmdword", cmdword }, + .{ "tty editing: lsp", lsp }, + .{ "tty editing: lsp-client", lsp_client }, + .{ "tty editing: lsp-client-edit", lsp_client_edit }, + .{ "tty editing: lspcomplete", lspcomplete }, + .{ "tty editing: lspcompletemoved", lspcompletemoved }, + .{ "tty editing: lspdebug", lspdebug }, + .{ "tty editing: lsprelpath", lsprelpath }, + .{ "tty editing: lsp-rename", lsp_rename }, + .{ "tty editing: lsp-rename-files", lsp_rename_files }, + .{ "tty editing: callstack", callstack }, + .{ "tty editing: diffview", diffview }, + .{ "tty editing: dirpane", dirpane }, + .{ "tty editing: scrolloff", scrolloff }, + .{ "tty editing: wrap", wrap }, + .{ "tty editing: hscroll", hscroll }, + .{ "tty editing: follow", follow }, + .{ "tty editing: tagcmd", tagcmd }, + .{ "tty editing: tagnav", tagnav }, + .{ "tty editing: tagpath", tagpath }, + .{ "tty editing: tag", tag }, +}; + +// insert-mode splice: click into a body row, type, escape back to normal +fn edit(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "edit"); + defer t.deinit(); + try t.file("e.txt", "x"); + try t.start(31, 100, &.{ "-n", "3" }); + try t.wait(8000, "e.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 11); + try t.release("left", "5", 11); + try t.stable(400, 8000); + try t.key("i"); + try t.send("hello-insert"); + try t.key("esc"); + try t.settle(100); + try t.stable(500, 8000); + try t.snap("inserted"); + try t.style("inserted"); + try t.done(); +} + +// file panes: modal editing on real content, undo, Save writes to disk +fn fileedit(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "fileedit"); + defer t.deinit(); + try t.lines("f.txt", 20, ""); + try t.start(31, 150, &.{ "-n", "3" }); + try t.wait(8000, "f.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("f.txt"); + try t.key("esc"); + try t.settle(100); + try t.press("right", "6", 9); + try t.release("right", "6", 9); + try t.wait(10000, "line 3"); + try t.stable(700, 15000); + // edit line 1: click it, insert, esc + try t.press("left", "10", 8); + try t.release("left", "10", 8); + try t.stable(400, 5000); + try t.key("i"); + try t.send("EDIT''ME"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("edited"); + // x-select line 2 and delete it + try t.key("j g h"); + try t.stable(400, 5000); + try t.key("x d"); + try t.stable(400, 5000); + try t.snap("deleted"); + try t.key("u"); + try t.stable(400, 5000); + try t.snap("undone"); + // Save through the file pane's own tag: `:` focuses that same tag and `w` + // selects Save before the ordinary execute key runs it. + try t.key(":"); + try t.stable(400, 5000); + try t.key("w tab"); + try t.stable(600, 8000); + try t.snapFile("saved", "/tmp/pardes-snap/fileedit/cwd/f.txt"); + try t.done(); +} + +// helix-modal normal mode: motions, x/v selections, y/d, insert, undo/redo +fn modal(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "modal"); + defer t.deinit(); + try t.file("words.txt", "alpha beta"); + try t.start(31, 100, &.{ "-n", "3" }); + try t.wait(8000, "words.txt"); + try t.stable(700, 20000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.send("printf 'one two three\\nfour five six\\nseven eight nine\\n'"); + try t.key("enter"); + try t.wait(8000, "seven"); + try t.stable(700, 10000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.press("left", "5", 7); + try t.release("left", "5", 7); + try t.stable(400, 5000); + try t.key("g g"); + try t.stable(400, 5000); + try t.snap("top"); + try t.key("j j w"); + try t.stable(400, 5000); + try t.snap("moved"); + try t.key("x"); + try t.stable(400, 5000); + try t.snap("xsel"); + try t.style("xsel"); + try t.key("x"); + try t.stable(400, 5000); + try t.snap("xsel2"); + try t.key("y"); + try t.stable(400, 5000); + try t.snap("yanked"); + try t.key("v j l"); + try t.stable(400, 5000); + try t.snap("vsel"); + try t.style("vsel"); + try t.key("esc"); + try t.settle(100); + try t.key("i"); + try t.send("TYPED"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("typed"); + try t.key("u"); + try t.stable(400, 5000); + try t.snap("undone"); + try t.key("U"); + try t.stable(400, 5000); + try t.snap("redone"); + try t.key("g e"); + try t.stable(400, 5000); + try t.snap("bottom"); + try t.done(); +} + +// MULTIPLE CURSORS on a real file pane. The differential suite (hxdiff) proves +// the model against a real helix but is headless, so this is the part it cannot +// see: that every range is actually on screen, that the primary reads +// differently from the others, and that ONE keystroke edits at all of them. +fn multicursor(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "multicursor"); + defer t.deinit(); + try t.lines("f.txt", 12, ""); + try t.start(31, 150, &.{ "-n", "3" }); + try t.wait(8000, "f.txt"); + try t.stable(700, 20000); + // open f.txt in the left pane (type its name, right-click to Look) + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("f.txt"); + try t.key("esc"); + try t.settle(100); + try t.press("right", "6", 9); + try t.release("right", "6", 9); + try t.wait(10000, "line 3"); + try t.stable(700, 15000); + // top of the file, then C C: three cursors, one per line, primary on line 3 + try t.key("g g"); + try t.stable(400, 5000); + try t.key("C C"); + try t.stable(400, 5000); + try t.snap("three-cursors"); + // the colours ARE the feature here: the primary's cell against the two dimmer + // ones, each with its own bright cursor cell + try t.style("three-cursors"); + // one keystroke, three edits + try t.key("i"); + try t.send(">>"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("edited-at-three"); + // a selection per cursor: e selects to the end of the first word at each + try t.key("g h w"); + try t.stable(400, 5000); + try t.snap("three-selections"); + try t.style("three-selections"); + // `,` drops back to the primary alone; the two dim highlights must vanish + try t.key(","); + try t.stable(400, 5000); + try t.snap("keep-primary"); + try t.style("keep-primary"); + try t.done(); +} + +// Interactive regex selection (`s` / `S`) and the comment toggle, on a real +// file pane. hxdiff pins what they DO against a real helix, but it is headless, +// so this is the half it cannot see: the prompt living in the TAG rather than a +// popup, the matches lighting up under a pattern as it is typed, Esc putting +// back what was there, and Ctrl-c using the token this file's EXTENSION asks +// for — `//`, where a buffer with no language would get `#`. +fn selregex(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "selregex"); + defer t.deinit(); + try t.file("m.zig", "const one = 1;\nconst two = 2;\nconst three = 3;\n"); + // wide on purpose: the whole point of this script is a tag long enough to hold + // the marker AND the pattern, and a narrow pane simply truncates it away + try t.start(25, 160, &.{"m.zig"}); + try t.wait(8000, "m.zig"); + try t.stable(700, 20000); + try t.key("g g"); + try t.stable(400, 5000); + // `%` takes the whole file, `s` arms the regex input: the marker goes into the + // tag tail after the path, and the pane is in insert mode ON THE TAG — the + // same one-line editor `/` and Find use, and nothing has moved in the body yet. + try t.key("%"); + try t.key("s"); + try t.stable(400, 5000); + try t.snap("prompt-armed"); + // ...and now the point: the selection follows the pattern as it is typed. Three + // `const` runs light up with Enter nowhere near, and the colours ARE the + // feature — the primary bright, the other two dim, each with its own cursor. + try t.send("const"); + try t.stable(400, 5000); + try t.snap("preview"); + try t.style("preview"); + try t.key("enter"); + try t.stable(400, 5000); + try t.snap("three-selected"); + try t.style("three-selected"); + // a second `s` narrows the three to one `t` apiece... + try t.key("s"); + try t.send("t"); + try t.stable(400, 5000); + try t.snap("narrowed"); + // the grid text cannot show a selection, so this is where the styles carry the + // whole point: three one-cell ranges here, three five-cell ones after the Esc + try t.style("narrowed"); + // ...and Esc throws that away for the selection the prompt opened on, which is + // free: the preview is re-derived from that snapshot on every keystroke, so + // cancelling is just applying the empty pattern. + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("esc-restores"); + try t.style("esc-restores"); + // Ctrl-c comments every line the three cursors touch — one decision for the + // whole selection, not one per cursor — and again to take it back off. + try t.key("c-c"); + try t.stable(400, 5000); + try t.snap("commented"); + try t.key("c-c"); + try t.stable(400, 5000); + try t.snap("uncommented"); + try t.done(); +} + +// y -> p round-trips through the core's own yank register (regression: p used +// to request the SYSTEM clipboard via OSC 52, which plain terminals — and this +// harness — never answer, so paste silently no-oped). Pins helix placement: +// a linewise yank (x) pastes as whole lines below (p) / above (P), a charwise +// yank (v) splices inline after the selection. +fn yankpaste(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "yankpaste"); + defer t.deinit(); + try t.lines("f.txt", 5, ""); + try t.start(31, 100, &.{"f.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.wait(8000, "line 5"); + try t.stable(700, 20000); + // linewise: x-select line 2, yank, move down, paste below line 3 + try t.press("left", "8", 5); + try t.release("left", "8", 5); + try t.stable(400, 5000); + try t.key("x y j p"); + try t.stable(400, 5000); + try t.snap("linewise-below"); + // P from the pasted line: its copy lands above + try t.key("x y P"); + try t.stable(400, 5000); + try t.snap("linewise-above"); + // charwise: v-select two chars of line 1, yank, paste splices after them + try t.press("left", "8", 4); + try t.release("left", "8", 4); + try t.stable(400, 5000); + try t.key("v l y p"); + try t.stable(400, 5000); + try t.snap("charwise-inline"); + // a BLANK line yanks as a bare "\n": the block is empty, lineCount says 0 + // lines, and every `n - 1` in the linewise paste used to underflow — panic on + // y then p. It pastes as one empty line. + try t.key("o"); + try t.key("esc"); + try t.settle(100); + try t.key("y p"); + try t.stable(400, 5000); + try t.snap("blankline"); + try t.done(); +} + +// `|`: visible tag prompt, native async shell filter, and one-step undo. +fn pipe(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "pipe"); + defer t.deinit(); + try t.file("pipe.txt", "alpha beta\ngamma delta"); + try t.start(13, 180, &.{"pipe.txt"}); + try t.wait(8000, "alpha beta"); + try t.stable(700, 20000); + try t.key("x |"); + try t.send("tr a-z A-Z"); + try t.stable(300, 5000); + try t.snap("prompt"); + try t.key("enter"); + try t.wait(8000, "ALPHA BETA"); + try t.stable(500, 8000); + try t.snap("filtered"); + try t.key("u"); + try t.stable(400, 5000); + try t.snap("undone"); + try t.done(); +} + +// acme 1-2/1-3 chords in a file pane: with the left button holding a drag +// selection, tapping middle Cuts it into the snarf (yank) register; tapping +// right Pastes the register (replacing the selection, or splicing at a bare +// click point); cut then paste in ONE hold nets out to copy/Snarf. The left +// release after a chord is inert (the cursor stays where the op left it). +// Also the cancel chords: tapping right during a middle (execute) drag or +// left during a right (look) drag cancels the gesture entirely. +fn chordcut(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "chordcut"); + defer t.deinit(); + try t.lines("f.txt", 5, ""); + try t.lines("g.txt", 2, ""); + // The narrow-window fallback splits below the source shell and leaves the + // unrelated right column untouched. Give the caller enough cells that the selected + // `echo B''OO g.txt` remains one displayed row; this test is about chords, not + // soft-wrap traversal. + try t.start(31, 120, &.{ "-n", "3" }); + try t.wait(8000, "f.txt"); + try t.stable(700, 20000); + // open f.txt: click a body spot, type the name, look it + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("f.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "6", 9); + try t.release("right", "6", 9); + try t.wait(10000, "line 3"); + try t.stable(700, 15000); + try t.snap("opened"); + // 1-2 Cut: left-drag over "line" on line 2, tap middle while holding + try t.press("left", "8", 10); + try t.drag("left", "11", 10); + try t.press("middle", "11", 10); + try t.release("middle", "11", 10); + try t.release("left", "11", 10); + try t.stable(400, 5000); + try t.snap("cut"); + // 1-2 then 1-3 in one hold = copy: line 3 keeps its text, register loaded + try t.press("left", "8", 11); + try t.drag("left", "11", 11); + try t.press("middle", "11", 11); + try t.release("middle", "11", 11); + try t.press("right", "11", 11); + try t.release("right", "11", 11); + try t.release("left", "11", 11); + try t.stable(400, 5000); + try t.snap("copied"); + // 1-3 at a bare click point: hold left past the end of line 4, tap right — + // the register splices in at the click + try t.press("left", "14", 12); + try t.press("right", "14", 12); + try t.release("right", "14", 12); + try t.release("left", "14", 12); + try t.stable(400, 5000); + try t.snap("pointpaste"); + // 1-3 over a fresh selection replaces it with the register + try t.press("left", "9", 13); + try t.drag("left", "11", 13); + try t.press("right", "11", 13); + try t.release("right", "11", 13); + try t.release("left", "11", 13); + try t.stable(400, 5000); + try t.snap("replaced"); + // arm the cancel tests: append `echo B''OO g.txt` to line 2 + try t.press("left", "10", 10); + try t.release("left", "10", 10); + try t.stable(400, 5000); + try t.key("i"); + try t.send("echo B''OO g.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + // 2-3 cancel (acme textselect2): tap right during the middle execute-drag + // over `echo B''OO` — the command never runs (no BOO anywhere) + try t.press("middle", "10", 10); + try t.drag("middle", "19", 10); + try t.press("right", "19", 10); + try t.release("right", "19", 10); + try t.release("middle", "19", 10); + try t.stable(700, 8000); + try t.snap("cancelexec"); + // the same drag released clean proves the word was live: BOO appears + try t.press("middle", "10", 10); + try t.drag("middle", "19", 10); + try t.release("middle", "19", 10); + try t.wait(10000, "BOO"); + try t.stable(700, 10000); + try t.snap("execafter"); + // 3-1 cancel (acme textselect3): tap left during the right look-drag over + // g.txt — no pane opens + try t.press("right", "21", 10); + try t.drag("right", "25", 10); + try t.press("left", "25", 10); + try t.release("left", "25", 10); + try t.release("right", "25", 10); + try t.stable(700, 8000); + try t.snap("cancellook"); + // the same look released clean opens g.txt + try t.press("right", "21", 10); + try t.drag("right", "25", 10); + try t.release("right", "25", 10); + try t.wait(10000, "line 2"); + try t.stable(700, 10000); + try t.snap("lookafter"); + // a fresh left click dismisses the chord's leftover selection instead of + // dragging the anchored span to the click: copy `line` on g.txt line 1 + // (styled snap shows the selection), then click the next row (it's gone) + try t.press("left", "8", 24); + try t.drag("left", "11", 24); + try t.press("middle", "11", 24); + try t.release("middle", "11", 24); + try t.press("right", "11", 24); + try t.release("right", "11", 24); + try t.release("left", "11", 24); + try t.stable(400, 5000); + try t.style("chordsel"); + try t.press("left", "8", 25); + try t.release("left", "8", 25); + try t.stable(400, 5000); + try t.style("clickdismiss"); + // g.txt opened under the lower shell's text and left it three rows: close it, + // and the shell grows back into its rows, for what follows to run in + try t.press("middle", "59", 23); + try t.release("middle", "59", 23); + try t.stable(700, 15000); + // tty paste chord: over a mouse-listening app B1 is the app's, so the + // chord's B1 holds Shift (B3 is pardes's either way); the app gets a click + // where the text goes (SGR, body-relative) then the register between + // bracketed-paste markers — cat -v prints the received bytes visibly + try t.press("left", "35", 23); + try t.release("left", "35", 23); + try t.stable(400, 5000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.send("stty -icanon -echo; printf '\\x1b[?2004h\\x1b[?1000h\\x1b[?1006h'; cat -v"); + try t.key("enter"); + try t.stable(700, 8000); + try t.press("shift-left", "40", 25); + try t.press("right", "40", 25); + try t.release("right", "40", 25); + try t.release("shift-left", "40", 25); + try t.stable(700, 8000); + try t.snap("ttyprobe"); + // a plain prompt (mouse modes off) gets no click bytes — just the paste; + // readline's own 2004 strips the markers and inserts the register text + try t.key("c-c"); + try t.stable(600, 8000); + try t.send("stty sane; printf '\\x1b[?1000l\\x1b[?1006l'"); + try t.key("enter"); + try t.stable(600, 8000); + try t.press("left", "40", 25); + try t.press("right", "40", 25); + try t.release("right", "40", 25); + try t.release("left", "40", 25); + try t.stable(700, 8000); + try t.snap("ttyprompt"); + try t.done(); +} + +// 2-1 chord borrows the argument selection from ANOTHER pane: pane A (left) +// holds the selection, pane B (right) middle-drags the command with no +// selection of its own — the chord's left tap finds A's kept left selection, +// and later A's explicit v selection, and rides it as the argument. +fn selarg(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "selarg"); + defer t.deinit(); + try t.file("s.txt", "x"); + try t.start(31, 100, &.{ "-n", "3" }); + try t.wait(8000, "s.txt"); + try t.stable(700, 20000); + // pane A (left, active at boot): print the two argument words + try t.key("c-b"); + try t.stable(600, 8000); + try t.send("clear; printf 'ZZARG ZZVEE\\n'"); + try t.key("enter"); + try t.wait(8000, "ZZVEE"); + try t.stable(700, 15000); + try t.key("c-b"); + try t.stable(600, 8000); + // pane B (top right): create the arg-printing script and show its path + try t.press("left", "60", 7); + try t.release("left", "60", 7); + try t.stable(400, 5000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.send("printf '#!/bin/sh\\necho CHORDARG:\"$1\"\\n' > c.sh; chmod +x c.sh; clear; printf './c.sh\\n'"); + try t.key("enter"); + try t.wait(10000, "./c.sh"); + try t.stable(700, 15000); + try t.key("c-b"); + try t.stable(600, 8000); + // keep a left selection over ZZARG in pane A (this also focuses A) + try t.press("left", "3", 5); + try t.drag("left", "7", 5); + try t.release("left", "7", 5); + try t.stable(400, 5000); + try t.snap("kept"); + // chord in pane B: middle on ./c.sh + left tap (B has NO selection: the + // argument comes from pane A's kept left selection) + middle release runs + try t.press("middle", "55", 5); + try t.press("left", "55", 5); + try t.release("middle", "55", 5); + try t.release("left", "55", 5); + try t.wait(10000, "CHORDARG:ZZARG"); + try t.stable(700, 10000); + try t.snap("crosspane"); + // now an explicit modal selection: plain-click ZZVEE in A (drops A's kept + // left selection), select it with v e, chord in B again + try t.press("left", "9", 5); + try t.release("left", "9", 5); + try t.stable(400, 5000); + try t.send("ve"); + try t.stable(400, 5000); + try t.press("middle", "55", 5); + try t.press("left", "55", 5); + try t.release("middle", "55", 5); + try t.release("left", "55", 5); + try t.wait(10000, "CHORDARG:ZZVEE"); + try t.stable(700, 10000); + try t.snap("vselarg"); + try t.done(); +} + +// SPC f f: a query pane under the pane (Query.zig), line 1 `Find `, typed +// into. The files below the pane's directory are listed once, on the disk +// engine's worker (rg --files when it is on PATH, else the sorted walk: both +// pass over .git), and each key scores them fuzzily (pick's scorer), the best +// first, the matched letters tinted. The current one is shown in the +// +Preview under the query pane, born with it so nothing moves later; +// Ctrl-n / Ctrl-p step it, never the pointer. Enter makes the preview the +// file's pane where it stands. Esc while typing closes the query pane and +// gives its rows back. A query that matches nothing is a count of 0, not an +// exit. B2 on `Find` with a selection asks with that word, the keyboard +// staying in the text. +fn find(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "find"); + defer t.deinit(); + try t.dir("sub"); + try t.dir("sub/nest"); + try t.dir(".git"); + try t.file("here.txt", "Find zqm"); + try t.file("zqmark-alpha.txt", "alpha body"); + try t.file("sub/ZQMARK-beta.txt", "beta body"); + try t.file("sub/nest/zqmark-gamma.txt", "gamma body"); + try t.file("other.txt", "nothing to match here"); + try t.file(".git/zqmark-hidden.txt", "hidden body"); + try t.start(41, 120, &.{"here.txt"}); + try t.wait(8000, "here.txt"); + try t.stable(700, 20000); + // SPC f is a group (Find, New, Save, Recent, Grep): the indicator waits + try t.key("space"); + try t.key("f"); + try t.stable(400, 5000); + try t.snap("group"); + // the second f opens the query pane: every file listed, line 1 `Find ` + try t.key("f"); + try t.wait(10000, "zqmark-alpha.txt"); + try t.stable(700, 15000); + try t.snap("armed"); + try t.send("zqm"); + try t.stable(700, 15000); + try t.snap("typing"); + // the next one current, its text in the preview + try t.key("c-n"); + try t.wait(10000, "beta body"); + try t.stable(700, 15000); + try t.snap("next"); + // Enter: the preview is that file's pane now, where it stood + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("promoted"); + // a second Find from here.txt reuses its query pane; nothing found is 0 + try t.press("left", "8", 4); + try t.release("left", "8", 4); + try t.stable(400, 5000); + try t.key("space"); + try t.key("f"); + try t.key("f"); + try t.send("zzqq"); + try t.stable(700, 15000); + try t.snap("nomatch"); + // Esc: the kept rows of the last query are back + try t.key("esc"); + try t.settle(100); + try t.stable(700, 15000); + try t.snap("cancel"); + // B2 on Find with `zqm` selected in here.txt: the query pane under it, the + // keyboard still in here.txt + try t.press("left", "13", 4); + try t.drag("left", "15", 4); + try t.release("left", "15", 4); + try t.stable(400, 5000); + try t.press("middle", "@Find", 1); + try t.release("middle", "@Find", 1); + try t.wait(10000, "Find zqm"); + try t.stable(700, 15000); + try t.snap("topbar"); + try t.done(); +} + +// `/` in a file: its query pane under it (Query.zig), line 1 `/` and the +// pattern, typed into; nothing on the notice band. Each key searches the +// file again (a regex, any case unless it has a capital): every match is +// tinted and ticked on the scroll rail, the first at or after the cursor +// selected and in view, and the rows under line 1 are the lines holding a +// match, a line number in the gutter. Ctrl-n steps while typing; Enter puts +// the keyboard on the match, the pattern in `/`, and keeps the rows as text; +// n / N then step the matches in the file, round the end without a word. A +// later `/` reuses the pane; Esc while typing brings the kept rows back. A +// pattern that matches nothing is a count of 0, not an exit. +fn fsearch(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "fsearch"); + defer t.deinit(); + try t.file("g.txt", "l1\nMARK a\nl3\nl4\nl5\nMARK b\nl7\nl8\nl9\nMARK c\nl11\nl12"); + // Builtins announce themselves by default, and an announcement is a band at + // the top of the body -- which moves every row this script clicks. What the + // verbs do is what is under test, not the announcement. + try t.config("Verbose off"); + try t.start(31, 180, &.{ "-n", "3" }); + try t.wait(8000, "g.txt"); + try t.stable(700, 20000); + // open g.txt: type the name in the shell, look it (as in look-file.snap) + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("g.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "6", 9); + try t.release("right", "6", 9); + try t.wait(10000, "MARK a"); + try t.stable(700, 15000); + try t.snap("opened"); + try t.key("/"); + try t.stable(400, 5000); + try t.snap("slash"); + try t.send("MARK"); + try t.stable(400, 5000); + try t.snap("typing"); + try t.style("typing"); + try t.key("c-n"); + try t.stable(400, 5000); + try t.snap("ctrln"); + try t.key("enter"); + try t.stable(700, 10000); + try t.snap("landed"); + try t.send("n"); + try t.stable(400, 5000); + try t.snap("n"); + try t.send("N"); + try t.stable(400, 5000); + try t.snap("N"); + try t.key("/"); + try t.send("zz"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("cancel"); + try t.key("/"); + try t.send("zzqq"); + try t.stable(700, 10000); + try t.snap("nomatch"); + try t.done(); +} + +// The Grep builtin (topbar word, `SPC f g`): the query pane under the pane +// that asked, line 1 `Grep ` and the text, the lines of the files below its +// directory holding it (literally, any case unless it has a capital), on the +// disk engine's worker once the typing pauses: rg --json when it is on PATH, +// else the sorted walk. The rows sit under their file's name, a line number +// in the gutter. A hit in a file an open pane shows is shown there; one in a +// file nothing shows, in the +Preview under the query pane, which Enter makes +// the file's pane. A query that matches nothing is a count of 0, and Esc +// while typing brings the kept rows back. +fn grep(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "grep"); + defer t.deinit(); + try t.dir("sub"); + try t.file("a.txt", "hello TARGET one\nnothing here\nlast TARGET line"); + try t.file("sub/b.txt", "deep\nTARGET inside sub"); + try t.file("noise.txt", "nothing to see"); + try t.config("Verbose off"); + try t.start(31, 180, &.{ "-n", "3" }); + try t.wait(8000, "a.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("a.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "6", 9); + try t.release("right", "6", 9); + try t.wait(10000, "hello TARGET"); + try t.stable(700, 15000); + try t.snap("opened"); + // middle-click Grep on the topbar: the query pane under a.txt, typed into + try t.press("middle", "@Grep", 1); + try t.release("middle", "@Grep", 1); + try t.stable(400, 5000); + try t.send("TARGET"); + // three lines (the pane is short: its count says how many) + try t.wait(10000, "+Search 1/3"); + try t.stable(700, 15000); + try t.snap("typing"); + // a.txt's hits are shown in a.txt; sub/b.txt's in the preview + try t.key("c-n"); + try t.stable(700, 15000); + try t.snap("second"); + try t.key("c-n"); + try t.wait(10000, "deep"); + try t.stable(700, 15000); + try t.snap("preview"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("opened-hit"); + try t.key("space"); + try t.key("f"); + try t.key("g"); + try t.stable(400, 5000); + try t.send("zzqq"); + try t.stable(700, 10000); + try t.snap("nomatch"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("esc"); + try t.done(); +} + +// ONE PRESS, ONE ROW. A query pane's rows are one a line with a hit, the +// hit's line under a gutter number, and Ctrl-n / Ctrl-p (typing on line 1) +// step them a row at a time, round the end: row 2 below matched on a line +// that mentions `sub/b.txt`, and the step does not stop on that word, as the +// old word-grained walk did; the fourth press wraps back to row 1. +// +// A path with a BLANK in it is one name: `two words.txt` is found whole by +// Find and Enter opens exactly it. +fn stepgrain(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "stepgrain"); + defer t.deinit(); + try t.dir("sub"); + try t.file("a.txt", "hello ZQMARK one\nsee also sub/b.txt for ZQMARK two"); + try t.file("sub/b.txt", "ZQMARK inside sub"); + try t.run("touch 'two words.txt'"); + try t.start(31, 150, &.{"a.txt"}); + try t.wait(8000, "hello ZQMARK"); + try t.stable(700, 20000); + // Grep from the leader: three hits, under their files, the empty file + // contributing none. Row 2 is the one whose TEXT holds a path. + try t.key("space"); + try t.key("f"); + try t.key("g"); + try t.stable(400, 5000); + try t.send("ZQMARK"); + try t.wait(10000, "ZQMARK inside sub"); + try t.stable(700, 15000); + try t.snap("results"); + try t.key("c-n"); + try t.stable(400, 5000); + try t.snap("step-row2"); + try t.style("step-row2"); + try t.key("c-n"); + try t.stable(400, 5000); + try t.snap("step-row3"); + try t.key("c-n"); + try t.stable(400, 5000); + try t.snap("step-wrap"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + // Find `words`: the name with a blank in it, whole + try t.key("space"); + try t.key("f"); + try t.key("f"); + try t.send("words"); + try t.wait(10000, "two words.txt"); + try t.stable(700, 15000); + try t.snap("blank-in-path"); + try t.style("blank-in-path"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("blank-opened"); + try t.done(); +} + +// a look on path:NN opens the file with the target line CENTERED in the body +// (scroll = line - body/2): fresh open at a deep line, then dedup re-looks at +// the same path re-center the existing pane, and a look near line 1 clamps +// the scroll at 0 (no negative scroll) +fn look_center(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "look-center"); + defer t.deinit(); + try t.lines("big.txt", 200, ""); + try t.start(31, 150, &.{ "-n", "3" }); + try t.wait(8000, "big.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("big.txt:100 big.txt:150 big.txt:2"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "7", 9); + try t.release("right", "7", 9); + try t.stable(700, 15000); + try t.snap("center-open"); + // The narrow-window split keeps the source shell above the new file. Use the + // unchanged right-hand shell for the remaining references, so they stay visible. + try t.press("left", "80", 9); + try t.release("left", "80", 9); + try t.key("i"); + try t.send("big.txt:150 big.txt:2"); + try t.key("esc"); + try t.stable(400, 5000); + try t.press("right", "82", 9); + try t.release("right", "82", 9); + try t.stable(700, 15000); + try t.snap("center-dedup"); + try t.press("right", "94", 9); + try t.release("right", "94", 9); + try t.stable(700, 15000); + try t.snap("center-clamp"); + try t.done(); +} + +// right-click look on a typed path:NN opens a file pane scrolled to the line; +// Enter chord on the same path focuses the existing pane (dedup) +fn look_file(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "look-file"); + defer t.deinit(); + try t.lines("big.txt", 60, ""); + try t.start(31, 150, &.{ "-n", "3" }); + try t.wait(8000, "big.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("big.txt:40"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "7", 9); + try t.release("right", "7", 9); + try t.stable(700, 15000); + try t.snap("file-open"); + try t.style("file-open"); + try t.done(); +} + +// single narrow column (-n 1): the first document splits below its source +// shell, like Term. A new column would require at least 200 cells of width. +fn look_file_1col(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "look-file-1col"); + defer t.deinit(); + try t.lines("big.txt", 60, ""); + try t.start(31, 100, &.{ "-n", "1" }); + try t.wait(8000, "big.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("big.txt:40"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "7", 9); + try t.release("right", "7", 9); + try t.stable(700, 15000); + try t.snap("file-open-1col"); + try t.done(); +} + +// a look matches an already-LOADED pane before touching the filesystem: open +// big.txt:40 from a look, rm the file on disk, then look big.txt:10 — the +// loaded pane focuses and recenters even though realpath now fails. (This +// fs-last ordering is what lets the fs-less web build focus dump panes.) +fn lookloaded(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lookloaded"); + defer t.deinit(); + try t.lines("big.txt", 60, ""); + try t.start(31, 100, &.{ "-n", "3" }); + try t.wait(8000, "big.txt"); + try t.stable(700, 20000); + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("big.txt:40 big.txt:10"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "7", 9); + try t.release("right", "7", 9); + try t.stable(700, 15000); + try t.snap("file-open"); + // Use the unrelated right-hand shell to remove the file: the source shell now + // stays above its file and is only a few rows tall. + try t.press("left", "70", 12); + try t.release("left", "70", 12); + try t.stable(400, 5000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.send("rm big.txt; echo GO''NE"); + try t.key("enter"); + try t.wait(8000, "GONE"); + try t.stable(700, 15000); + try t.key("c-b"); + try t.stable(600, 8000); + try t.snap("removed"); + // look big.txt:10: nothing on disk, but the pane is loaded — it focuses and + // recenters on line 10 (before this change: realpath fails, look no-ops) + // Put a fresh reference in the right-hand shell, then look it. This ensures the + // gesture hits the missing path rather than empty space after source resizing. + try t.press("left", "55", 9); + try t.release("left", "55", 9); + try t.key("i"); + try t.send("big.txt:10"); + try t.key("esc"); + try t.stable(400, 5000); + try t.press("right", "57", 9); + try t.release("right", "57", 9); + try t.stable(700, 15000); + try t.snap("look-noFS"); + try t.done(); +} + +// a look resolves against EVERY open pane's directory, in access order: the +// pane the click came from first, then the rest most-recently-focused first, +// and only a word NO directory holds falls through to a search. Two dirs +// (alpha, beta) hold same-named files and the shell's own cwd holds none of +// them, so every look below would have been a search before. alpha's pane +// is its directory window (a look at a directory opens a pane listing it), +// whose directory is alpha. +fn lookpanes(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lookpanes"); + defer t.deinit(); + try t.dir("alpha"); + try t.dir("beta"); + try t.file("zzboot.txt", "x"); + try t.file("alpha/amark.txt", "a"); + try t.file("alpha/zqonly.txt", "ONLY-IN-ALPHA"); + try t.file("alpha/pick.txt", "PICK-FROM-ALPHA"); + try t.file("alpha/twin.txt", "TWIN-FROM-ALPHA"); + try t.file("alpha/both.txt", "BOTH-FROM-ALPHA"); + try t.file("beta/pick.txt", "PICK-FROM-BETA"); + try t.file("beta/twin.txt", "TWIN-FROM-BETA"); + try t.file("beta/both.txt", "BOTH-FROM-BETA"); + // the file argument opens a pane whose directory is beta's, and nothing else — + // so the workdir shell every look below falls through is opened with Alt-n + // (`New`/`Newcol` open an empty +New scratch now, and one inheriting beta's + // directory at that) and Alt-c puts it in a column of its own on the right; + // its first line is a word to look FROM that pane + try t.file("beta/bmark.txt", "both.txt\nb-marker"); + // Builtins announce themselves by default, and an announcement is a band at + // the top of the body -- which moves every row this script clicks. What the + // verbs do is what is under test, not the announcement. + try t.config("Verbose off"); + try t.start(51, 130, &.{"beta/bmark.txt"}); + try t.wait(8000, "b-marker"); + try t.stable(700, 20000); + try t.key("a-n"); + try t.key("a-c"); + try t.wait(8000, "zzboot.txt"); + try t.stable(700, 20000); + try t.key("space w h"); + try t.stable(400, 5000); + // an ordinary dir look on the shell's own ls output: alpha's directory pane, + // split below it, which takes the keyboard + try t.press("right", "@alpha", 6); + try t.release("right", "@alpha", 6); + try t.wait(10000, "amark.txt"); + try t.stable(700, 20000); + // type the words to look into what is left of the workdir shell (past its own + // ls output, on the same row: its last row is the resize handle) + try t.press("left", "95", 5); + try t.release("left", "95", 5); + try t.stable(400, 5000); + try t.key("i"); + try t.send("zqonly.txt pick.txt twin.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("shells"); + // make the beta pane the most recently focused, so the walk has to pass it + try t.press("left", "10", 5); + try t.release("left", "10", 5); + try t.stable(700, 10000); + // zqonly.txt is only under alpha: the clicked shell's cwd fails, beta fails, + // alpha's directory pane answers. Before, this word became a search. + try t.press("right", "@zqonly.txt", 5); + try t.release("right", "@zqonly.txt", 5); + try t.wait(10000, "ONLY-IN-ALPHA"); + try t.stable(700, 20000); + try t.snap("other-dir"); + // both.txt is in BOTH dirs and alpha is now the most recent (its file pane + // just opened), but the CLICK still wins: looked inside the beta pane it + // opens beta's copy + try t.press("right", "10", 5); + try t.release("right", "10", 5); + try t.wait(10000, "BOTH-FROM-BETA"); + try t.stable(700, 20000); + try t.snap("clicked-wins"); + // from a pane whose own dir holds neither copy the access order decides: + // focus alpha's directory pane (a click on its first row), look pick.txt (in + // both dirs) from the workdir shell -> alpha's + try t.press("left", "@amark.txt", 9); + try t.release("left", "@amark.txt", 9); + try t.stable(700, 10000); + try t.press("right", "@pick.txt", 5); + try t.release("right", "@pick.txt", 5); + try t.wait(10000, "PICK-FROM-ALPHA"); + try t.stable(700, 20000); + try t.snap("mru-alpha"); + // focus the beta pane instead and the same look flips: twin.txt is in both + // dirs, beta is most recent, beta's copy opens + try t.press("left", "10", 5); + try t.release("left", "10", 5); + try t.stable(700, 10000); + try t.press("right", "@twin.txt", 5); + try t.release("right", "@twin.txt", 5); + try t.wait(10000, "TWIN-FROM-BETA"); + try t.stable(700, 20000); + try t.snap("mru-beta"); + try t.style("mru-beta"); + try t.done(); +} + +// RANGED LOOK PATHS. `path:LINE:COL` says where to PARK; a range says what to +// SELECT, and it belongs to the PATH (config.range_sep) rather than to the +// search that is merely the first thing writing one. So this script right- +// clicks the three spellings as ordinary words sitting in a file: +// r.txt:3-5 whole lines 3 through 5 +// r.txt:7:4-9 line 7, columns 4 through 9 +// r.txt:3:2-5:3 line 3 column 2 through line 5 column 3 +// ...and only then presses `/`, whose result rows are exactly this syntax — +// which is how n/N select a hit and Enter lands on it with the matched text +// selected. +// +// `snapstyle` is the assertion that matters: the grid TEXT after a ranged look +// is the same text a plain `:LINE:COL` look leaves, so the selection only shows +// in the styles. +fn lookrange(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lookrange"); + defer t.deinit(); + try t.file("r.txt", "aaaa\nbbbb\ncccc dccc\ndddd\neeee\nffff\ngg NEEDLE gg\nhhhh NEEDLE\niiii"); + try t.file("look.txt", "r.txt:3-5\nr.txt:7:4-9\nr.txt:3:2-5:3\nr.txt:8:6-99:9"); + // Builtins announce themselves by default, and an announcement is a band at + // the top of the body -- which moves every row this script clicks. What the + // verbs do is what is under test, not the announcement. + try t.config("Verbose off"); + try t.start(31, 150, &.{"look.txt"}); + try t.wait(8000, "r.txt:3-5"); + try t.stable(700, 20000); + try t.snap("opened"); + // --- form 1: whole lines. r.txt opens BELOW look.txt (an ordinary look) with + // lines 3, 4 and 5 selected whole, terminators included — helix's own `x`. + try t.press("right", "10", 4); + try t.release("right", "10", 4); + try t.wait(10000, "cccc dccc"); + try t.stable(700, 15000); + try t.snap("wholelines"); + try t.style("wholelines"); + // --- form 2: one line, a column span. r.txt is open now, so this re-uses that + // pane (focusPaneByPath) — the same route a `/` result row takes. + try t.press("right", "12", 5); + try t.release("right", "12", 5); + try t.stable(700, 15000); + try t.snap("onelinespan"); + try t.style("onelinespan"); + // --- form 3: the general one, across both lines and columns + try t.press("right", "12", 6); + try t.release("right", "12", 6); + try t.stable(700, 15000); + try t.snap("fullspan"); + try t.style("fullspan"); + // --- a STALE range: line 99 of a nine-line file, which is what a result row + // looks like once the file has changed underneath it. It must CLAMP — no crash, + // no garbage highlight — landing on the last cell that really exists. + try t.press("right", "12", 7); + try t.release("right", "12", 7); + try t.stable(700, 15000); + try t.snap("stale"); + try t.style("stale"); + // --- and `/`: its query pane under r.txt, line 1 the pattern, the lines + // holding it as rows (a line number in the gutter, the match tinted); Enter + // puts the keyboard on the match after the cursor, the word itself selected. + try t.key("/"); + try t.send("NEEDLE"); + try t.wait(10000, "gg NEEDLE gg"); + try t.stable(700, 15000); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("hit1"); + try t.style("hit1"); + // n: the next match in the text, selected + try t.send("n"); + try t.stable(700, 15000); + try t.snap("hit2"); + try t.style("hit2"); + // N walks back onto the first, still selected + try t.send("N"); + try t.stable(700, 15000); + try t.snap("back"); + try t.style("back"); + try t.done(); +} + +// RULE: there is ONE focus history and it is a stack of LOCATIONS — a pane and +// a spot in it. Ctrl-o walks it back, Ctrl-i walks it forward again, `SPC j j` +// (Last) hops to the newest OTHER pane, and `SPC j l` (Jumplist) writes the +// same stack out as an output buffer whose rows are ordinary look targets, so +// n/N step them. What gets ONTO the stack is decided in one place (trackJump): +// focus ended the update in a different pane, or more than a bodyful of rows +// away in the same one — which is why `100G` below leaves a location behind +// and the j/k that follow it do not. +// +// Focus and position both show in the golden's `cursor=` header: that is the +// ACTIVE pane's cursor, so each snap is named by where it should land. +fn jumps(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "jumps"); + defer t.deinit(); + try t.lines("big.txt", 200, ""); + try t.start(31, 150, &.{"big.txt"}); + try t.wait(8000, "big.txt"); + try t.stable(700, 20000); + // a FILE boots alone now, so this is one column holding big.txt, focused, and + // the stack is one entry deep + try t.snap("start"); + // two focus moves. The shell has to be opened before it can be walked to + // (`New`/`Newcol` open an empty +New scratch now, so the shell is asked for by + // name): Alt-n opens it AND focuses it, Alt-c moves it into a column of its + // own on the right — so opening it IS the first of the two moves, and the + // stack below is the same one a shell at boot left. Walking straight back to + // the file does NOT leave `file -> shell -> file` behind: a hop to the entry + // under the top one is the same two places again, so trackJump swaps them + // rather than appending, and the stack is `shell -> file` with the file on top + // (see trackJump). + try t.key("a-n"); + try t.key("a-c"); + try t.stable(700, 15000); + try t.snap("to-shell"); + try t.key("space w h enter"); + try t.stable(400, 5000); + try t.snap("to-file"); + // a FAR motion inside one pane: 100G is a jump, so the line we left is + // remembered and Ctrl-o can come back to it + try t.send("100"); + try t.key("G"); + try t.stable(400, 5000); + try t.snap("goto-100"); + // Ctrl-o: back to line 1 of the same pane — a stack of panes could not do this + try t.key("c-o"); + try t.stable(400, 5000); + try t.snap("back-in-file"); + // ...and back again into the shell + try t.key("c-o"); + try t.stable(400, 5000); + try t.snap("back-to-shell"); + // Ctrl-i forward, twice: back to line 1 of the file, then line 100 again. Sent as the + // kitty-protocol CSI u (`CSI 105;5u`) because on the wire Ctrl-i IS Tab — + // see config.jump_keys. + try t.send("\x1b[105;5u"); + try t.stable(400, 5000); + try t.snap("forward-file"); + try t.send("\x1b[105;5u"); + try t.stable(400, 5000); + try t.snap("forward-100"); + // SPC j j — the newest OTHER pane, and pressing it again comes straight back + try t.key("space j j"); + try t.stable(400, 5000); + try t.snap("last"); + try t.key("space j j"); + try t.stable(400, 5000); + try t.snap("last-back"); + // SPC j l — the stack as text: `location text` rows, the file naming itself + // and the shell spelled @pN because it has no path + try t.key("space j l"); + try t.stable(700, 15000); + try t.snap("jumplist"); + // n/N select the next/prev row and Enter looks it, exactly as they do a + // +Search: the stepped span is selected in the buffer (snapstyle) and the Enter + // after it moves the pane the row names. Row 1 is the shell (no path, so + // `@pN`), row 2 the file at line 1, row 4 the file at line 100 — so the body + // visibly rides the list. + // + // ONE PRESS PER ROW, and this buffer is where that rule earns itself: an `@pN` + // row's trailing text is the pane's DIRECTORY, which is a look-able word of its + // own, so rows 1 and 3 used to hold TWO stops each and reaching the next row + // took two steps. A results buffer is a LIST — its rows are locations, and the + // text after one says what is THERE rather than naming another place to go — so + // the walk takes the location at the head of a row and moves on to the next row + // (output_pane.Grain.line). Free text still steps every word. + // + // An `@pN` row moves focus like any other, which it did not use to: the STEP + // only selects now, and the look Enter runs goes to the pane by the same route + // a path takes. + try t.key("space j n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step1-shell"); + try t.style("step1-shell"); + // on to row 2 — one press, the directory on row 1 is no longer a stop of its own + try t.key("space j n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step2-file"); + // row 3 is the shell again, then row 4 + try t.key("space j n"); + try t.stable(400, 5000); + try t.key("space j n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step4-line100"); + // N is the exact inverse: one press back onto row 3's location, and Enter + // follows it to the shell + try t.key("space j p"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step-back"); + // and an ordinary LOOK on a row goes there too — the leading word IS a + // location, so the right-click look resolves it like any other path. Row 4 + // again, this time by clicking it: the list shows every row, and its row 4 is + // screen row 21. + try t.press("right", "16", 21); + try t.release("right", "16", 21); + try t.stable(700, 15000); + try t.snap("look-row"); + try t.done(); +} + +// `@`...`` — a word that names a COMMAND instead of a file to open. The +// delimiters are config.cmd_open/cmd_close and nothing else in the editor knows +// how one is spelled. +// +// A backtick is not a file char, so the ordinary word expansion would stop dead +// inside one and hand a look the fragment `echo`. config.wordBounds takes the +// whole run instead, which is what makes a single CLICK the way you invoke one +// (acme does the same for its own `<`/`|`/`>` command words). +// +// EXECUTE runs it, as a command pane, and leaves you where you were; LOOK runs +// it and lands you in the pane that answered — looking at a thing means being +// shown it, and a directory's look is a pane listing it, as acme's directory +// window is. +// +// And Look and Exec are ORDINARY BUILTINS now, so their names are executable +// words like Save or Grep: `Look p.txt` run off the page is the same look a +// right click on `p.txt` is. Which is also what makes `@`Look .`` nest — Exec +// unwraps it and the contents go straight back through the one dispatcher. +fn cmdword(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "cmdword"); + defer t.deinit(); + try t.file("cmds.txt", "@`echo ZZ''E` @`echo ZZ''L` Look p.txt @`Look .`"); + try t.file("p.txt", "just text"); + try t.file("zzmark.txt", "x"); + // Builtins announce themselves by default, and an announcement is a band at + // the top of the body -- which would move every row this script clicks. The + // verbs are what is under test here, not the announcement. + try t.config("Verbose off"); + try t.start(31, 120, &.{"cmds.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.wait(8000, "cmds.txt"); + try t.stable(700, 20000); + try t.snap("opened"); + // a single middle CLICK inside the run (col 11 is inside `echo`) expands to the + // whole `@`echo ZZ''E`` and runs it as a command pane; focus stays on the file + try t.press("middle", "11", 4); + try t.release("middle", "11", 4); + try t.wait(10000, "ZZE"); + try t.stable(700, 15000); + try t.snap("atexec"); + // LOOK on the second one (col 24, inside its `echo`) runs it too, in the same + // command pane now its first is done, below it, AND focuses it — that is the + // whole difference between the two verbs + try t.press("right", "24", 4); + try t.release("right", "24", 4); + try t.wait(10000, "ZZL"); + try t.stable(700, 15000); + try t.snap("atlook"); + // `Look p.txt` middle-dragged: the builtin by NAME, with an argument + try t.press("middle", "36", 4); + try t.drag("middle", "45", 4); + try t.release("middle", "45", 4); + try t.wait(10000, "just text"); + try t.stable(700, 15000); + try t.snap("lookword"); + // nesting: `@`Look .`` — Exec unwraps it, `Look .` is parsed as the ordinary + // Look builtin with an argument, and Look opens the directory: a pane named + // for it with a trailing /, listing it (zzmark.txt is only ever in that + // listing: no pane here shows it otherwise), which takes the keyboard + try t.press("middle", "49", 4); + try t.release("middle", "49", 4); + try t.wait(10000, "zzmark.txt"); + try t.stable(700, 15000); + try t.snap("nested"); + // the same syntax typed into a TAG — the other place the expansion has to know + // about backticks. The look above left the directory pane focused, so `:` + // opens ITS tag; `A` appends at the end of it, Esc and `h` put the + // normal-mode cursor on the last character typed, and the execute key runs + // the word under it exactly as the body's does. + try t.key(":"); + try t.key("A"); + try t.key("space"); + try t.send("Exec"); + try t.key("esc"); + try t.settle(100); + try t.key("h"); + try t.key("tab"); + try t.stable(700, 8000); + // ...except that word is `Exec` ITSELF, with nothing to execute. This is the + // case that must not hang a re-entrant dispatcher: it runs out of argument + // immediately and does nothing at all. Executing gave the keyboard back to the + // body, and `:` finds the tag's cursor where it was left. + try t.snap("execword"); + // a command word run from that tag runs as a command pane in the directory + // the pane lists, as a word run from any text pane's tag does + try t.key(":"); + try t.key("A"); + try t.key("space"); + try t.send("@`echo ZZ''T`"); + try t.key("esc"); + try t.settle(100); + try t.key("h"); + try t.key("tab"); + try t.wait(10000, "ZZT"); + try t.stable(700, 15000); + try t.snap("tagcmd"); + try t.done(); +} + +// Language intelligence end to end: the helix keymap, the async round trip and +// the two dispositions of an answer. +// +// The backend behind the seam here is zls, run as a child process by the +// protocol client (it must be on PATH): `gd` is a request on a worker thread +// whose result comes back as an ordinary event, the same shape a pty read +// already had. Nothing in this script knows that: it presses keys and reads +// the grid, which is the point of the seam. +// +// a.zig is deliberately self-contained — a definition, a call site, and not one +// symbol from std — so these goldens do not encode this machine's stdlib +// version or its install path. +fn lsp(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsp"); + defer t.deinit(); + try t.file("a.zig", "const std = @import(\"std\");\n\nfn helper(x: u32) u32 {\n return x + 1;\n}\n\npub fn main() void {\n _ = helper(41);\n}\n"); + try t.start(41, 120, &.{"a.zig"}); + try t.wait(8000, "helper"); + try t.stable(700, 20000); + try t.snap("opened"); + // park the cursor inside the CALL `helper(41)` (file line 8, grid row 9) + try t.press("left", "18", 11); + try t.release("left", "18", 11); + try t.stable(400, 5000); + try t.snap("cursor"); + // gd on a call: exactly one location comes back, so it JUMPS rather than + // opening a picker — and lands SELECTING the definition's name token on line 3, + // because ZLS answers with a range and a ranged row is one a look selects. + // The jumplist is pinned first, so ctrl-o comes back. + try t.key("g"); + try t.key("d"); + try t.stable(700, 15000); + try t.snap("definition"); + // SPC l k is hover (K is keep_selections in helix and stays that way). The answer + // is prose, not locations, so it opens +Hover and does NOT arm the n/N stepper. + try t.key("space"); + try t.key("l"); + try t.key("k"); + try t.stable(700, 15000); + try t.snap("hover"); + // SPC l s lists the file's own symbols. Several rows, so it opens a +Search + // buffer — which IS the picker: n selects a row and Enter looks it, exactly as + // the Find and `/` results already do, with no picker code of its own. + try t.key("space"); + try t.key("l"); + try t.key("s"); + try t.stable(700, 15000); + try t.snap("symbols"); + try t.key("space j n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step"); + // gd on something with no declaration behind it (a keyword) answers nothing, + // and nothing is a legal answer: no buffer opens, no error is rendered. + try t.press("left", "8", 6); + try t.release("left", "8", 6); + try t.key("g"); + try t.key("d"); + try t.stable(700, 10000); + try t.snap("nothing"); + try t.done(); +} + +// The protocol client end to end, against the deterministic mock server the +// harness pins via PARDES_LSP_RS (test/lspmock.zig). What this exercises is +// everything BETWEEN the keymap and the analyser: spawn, handshake, the reader +// thread, $/progress narration onto the transient message row, and the +// location shapes coming back as +Search rows. +// gd on a cross-file Location -> a look: lib.rs opens with `add` selected, +// and the message row still carries the server's settled state +// ("lsp lspmock: ready") because nothing has cleared it yet. +// gr -> the text's query pane, line 1 `Refs`, rows under their files, +// the next occurrence current, the keyboard on it in normal mode +// (a list answered, not a query typed); n/N step the places. +fn lsp_client(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsp-client"); + defer t.deinit(); + try t.file("main.rs", "mod lib;\n\nfn main() {\n let x = add(1, 2);\n let y = add(3, 4);\n let _ = x + y;\n}\n"); + try t.file("lib.rs", "// mock fixture\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n"); + try t.start(25, 100, &.{"main.rs"}); + try t.wait(8000, "add(1, 2)"); + try t.stable(700, 20000); + // cursor into the first `add` call, then helix's goto-definition + try t.press("left", "13", 6); + try t.release("left", "13", 6); + try t.key("g"); + try t.key("d"); + try t.wait(10000, "pub fn add"); + try t.stable(700, 15000); + try t.snap("gd-jumped"); + // references from the definition the look landed on (cursor sits on `add`) + try t.key("g"); + try t.key("r"); + try t.wait(10000, "add(3, 4)"); + try t.stable(700, 15000); + try t.snap("gr-list"); + // the list opens in normal mode, the caret on the current row: n steps to + // the next hit, Enter lands there; N in the text goes back to the one + // before, round the places in main.rs + try t.key("n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("gr-opened"); + try t.send("N"); + try t.stable(700, 15000); + try t.snap("gr-back"); + try t.done(); +} + +// The protocol client's MUTATING answers, through the @put record path: a +// server TextEdit response becomes one atomic buffer edit with one undo step. +// = applies the mock's formatting edit (a header line) and narrates +// "formatted 1 range(s)" on the message row +// SPC l r renames both `add` calls via the server's WorkspaceEdit +// u reverses each as a single transaction +fn lsp_client_edit(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsp-client-edit"); + defer t.deinit(); + try t.file("main.rs", "mod lib;\n\nfn main() {\n let x = add(1, 2);\n let y = add(3, 4);\n let _ = x + y;\n}\n"); + try t.file("lib.rs", "// mock fixture\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n"); + try t.start(25, 100, &.{"main.rs"}); + try t.wait(8000, "add(1, 2)"); + try t.stable(700, 20000); + try t.key("="); + try t.wait(10000, "formatted by mock"); + try t.stable(700, 15000); + try t.snap("formatted"); + try t.key("u"); + try t.wait(8000, "mod lib;"); + try t.stable(700, 15000); + try t.snap("unformatted"); + // rename through the leader prompt: both call sites change in one step + try t.press("left", "13", 6); + try t.release("left", "13", 6); + try t.key("space"); + try t.key("l"); + try t.key("r"); + try t.stable(400, 5000); + try t.send("sum"); + try t.key("enter"); + try t.wait(10000, "sum(3, 4)"); + try t.stable(700, 15000); + try t.snap("renamed"); + try t.key("u"); + try t.wait(8000, "add(3, 4)"); + try t.stable(700, 15000); + try t.snap("unrenamed"); + try t.done(); +} + +// Tab after a dot in insert mode: "what could go here". +// +// Each wait for zls's answer allows a minute: it returns as soon as the answer +// is drawn (2 s alone), and a zls slowed by a loaded machine (the parallel +// snap run) took over 15 s, which failed the old wait. The answer is a +// `+Search` buffer of zls's candidates, one row each at the cursor (a +// completion item names no declaration) — nothing is inserted and nothing pops +// up. +// +// a.zig is std-free for the reason lsp.snap's is: these goldens must not encode +// this machine's stdlib version or its install path. Its enum members are +// nonsense words, and the dot is TYPED into an empty switch body, so a row +// naming line 2 or 3 can only have come from a member's declaration — the line +// the cursor is on is line 8 and holds nothing but the dot. +// +// Typing it is the point rather than pointing at one already there: the moment +// the dot lands the file STOPS PARSING (`switch (s) { . }` loses the whole +// switch to the parser's error recovery), and that is the normal input to a +// completion, not a corner case. +// +// The helix corpora cannot reach any of this — hxOpenFileContent names its pane +// `/hxcase.txt`, so lsp.speaks is false for all 1042 cases — which makes this +// script the only end-to-end coverage the feature has. +fn lspcomplete(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lspcomplete"); + defer t.deinit(); + try t.file("a.zig", "const Shade = enum {\n verdigris,\n cinnabar,\n};\n\nfn pick(s: Shade) u8 {\n return switch (s) {\n \n };\n}\n\n// note. see below\n"); + try t.file("notes.txt", "abc.def ghi\n"); + try t.start(41, 120, &.{"a.zig"}); + try t.wait(8000, "verdigris"); + try t.stable(700, 20000); + try t.snap("opened"); + // Tab with no dot before it is still Tab: line 10 is the closing `}`, and this + // is the plain insert_tab path putting spaces in front of it. + try t.press("left", "8", 13); + try t.release("left", "8", 13); + try t.key("i"); + try t.key("tab"); + try t.stable(400, 5000); + try t.snap("indent"); + try t.key("esc"); + try t.settle(100); + // A dot the backend cannot answer must STILL indent. Line 12 is a comment, so + // the position context is `.comment` and no candidate can exist — and because + // Tab had already diverted to the backend, the indent has to happen + // retroactively when the empty answer arrives (lspResponse), on the condition + // that the cursor has not moved meanwhile. Four spaces go in after `// note.` + // and the keystroke is not eaten, which is the whole contract. + try t.press("left", "16", 15); + try t.release("left", "16", 15); + try t.stable(400, 5000); + try t.key("i"); + try t.key("tab"); + try t.stable(700, 15000); + try t.snap("commentindent"); + try t.key("esc"); + try t.settle(100); + // Line 8 (grid row 9, 1-based click row 10) is the switch's empty body. End + // puts the cursor past its indent, and then the dot is typed. + try t.press("left", "8", 11); + try t.release("left", "8", 11); + try t.stable(400, 5000); + try t.key("i"); + try t.key("end"); + try t.send("."); + try t.stable(400, 5000); + try t.snap("athedot"); + try t.key("tab"); + // The rows that prove it: `verdigris` and `cinnabar` can only have come from + // resolving the switch's condition to `Shade` and asking what it declares. + // Line 8 still reads `.` and nothing else — a completion INSERTS NOTHING. + try t.wait(60000, "+Search"); + try t.stable(700, 30000); + try t.snap("completion"); + // Two more Tabs. Every one of them answers, and every answer REFILLS the one + // `+Search` rather than opening its twin. The SECOND press is already the whole + // assertion: without the refill it leaves a second byte-identical `+Search` and + // this golden diverges. What TWENTY do is only worse in degree — fifteen + // stacked panes, the file crushed to one visible line, and from the sixteenth + // on freeSlot returns null and the keystroke is eaten for the rest of the + // session — and that story is told here rather than replayed in three seconds of + // every suite run. One file pane, one results pane, same as after the first. + try t.key("tab"); + try t.settle(150); + try t.key("tab"); + try t.settle(150); + try t.key("tab"); + try t.stable(700, 30000); + try t.snap("refill"); + // The pane is still in insert mode, which is right — the query answered beside + // the cursor and typing goes on — so walking the answer means leaving it first, + // the same as for any other results buffer. + try t.key("esc"); + try t.settle(100); + // Several rows, so the buffer IS the picker and n walks it; completion does not + // jump the way a goto with one row does. The first step selects row 1, and the + // Enter after it looks that row and lands SELECTING `verdigris` on line 2 of + // a.zig. + try t.key("space j n"); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("step"); + // A pane the backend does not speak: same keystrokes, same dot before the + // cursor, and Tab must still indent — synchronously this time, since the core + // never asks. The gate is lsp.speaks, which the core consults and the backend + // owns. + try t.start(41, 120, &.{"notes.txt"}); + try t.wait(8000, "abc.def"); + try t.stable(700, 20000); + try t.press("left", "12", 4); + try t.release("left", "12", 4); + try t.key("i"); + try t.key("tab"); + try t.stable(400, 5000); + try t.snap("txtindent"); + // ---- the two genuinely INCOMPLETE states ---- + // + // Everything above types its dot into syntax that is otherwise finished, which + // is the easy half and is why a repair chosen by parse-error count looked like + // it worked. Mid-typing, the line is short of its terminator too. + // + // `const z: Shade = .` is ONE parse error with or without a placeholder + // identifier spliced in, so the repair has to be chosen by whether it makes the + // dot reachable in the tree, never by counting errors. + try t.file("c.zig", "const Shade = enum {\n verdigris,\n cinnabar,\n};\n\npub fn nosemi() void {\n const z: Shade = \n}\n"); + try t.start(19, 100, &.{"c.zig"}); + try t.wait(8000, "nosemi"); + try t.stable(700, 20000); + try t.press("left", "8", 10); + try t.release("left", "8", 10); + try t.stable(400, 5000); + try t.key("i"); + try t.key("end"); + try t.send("."); + try t.stable(400, 5000); + try t.key("tab"); + try t.wait(60000, "+Search"); + try t.stable(700, 30000); + try t.snap("nosemi"); + // ...and a construct still hanging OPEN. The switch has no closing brace at + // all — the one `}` in the file closes it and leaves the function unclosed — + // which makes Zig's recovery throw the whole declaration away. No placeholder + // sitting at the dot can survive that, so the repair has to close the construct + // as well, on the same line (a spelling containing a newline would move every + // line number the rows are built from). + try t.file("d.zig", "const Shade = enum {\n verdigris,\n cinnabar,\n};\n\npub fn nobrace(s: Shade) void {\n switch (s) {\n \n}\n"); + try t.start(19, 100, &.{"d.zig"}); + try t.wait(8000, "nobrace"); + try t.stable(700, 20000); + try t.press("left", "8", 11); + try t.release("left", "8", 11); + try t.stable(400, 5000); + try t.key("i"); + try t.key("end"); + try t.send("."); + try t.stable(400, 5000); + try t.key("tab"); + try t.wait(60000, "+Search"); + try t.stable(700, 30000); + try t.snap("nobrace"); + try t.done(); +} + +// The guard that makes "an empty answer indents" safe to have at all. +// +// lspcomplete.snap pins the indent itself: Tab after a dot the backend cannot +// answer diverts, the answer comes back empty, and four spaces go in LATE so +// the keystroke is not eaten. That late write is the dangerous half — it lands +// a few hundred milliseconds after the key, by which time the hands have moved +// on — so lspResponse only performs it if nothing has: same pane, still insert, +// one cursor, cursor still on the cell the Tab was pressed at. Nothing covered +// the condition, only its happy side. +// +// Same file and same click as lspcomplete's `commentindent` arm — line 12 is a +// comment, so no candidate can exist and the answer is certainly empty — but +// here an `x` is typed straight after the Tab, in the same write, long before a +// ZLS analysis can finish. The buffer below is the assertion: `// note.x`, with +// neither `// note. x` (the indent landing under the typing) nor +// `// note.x ` (the indent landing on top of it). +fn lspcompletemoved(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lspcompletemoved"); + defer t.deinit(); + try t.file("a.zig", "const Shade = enum {\n verdigris,\n cinnabar,\n};\n\nfn pick(s: Shade) u8 {\n return switch (s) {\n \n };\n}\n\n// note. see below\n"); + try t.start(21, 120, &.{"a.zig"}); + try t.wait(8000, "verdigris"); + try t.stable(700, 20000); + try t.press("left", "16", 15); + try t.release("left", "16", 15); + try t.stable(400, 5000); + try t.key("i"); + try t.key("tab"); + try t.send("x"); + try t.stable(700, 20000); + try t.snap("typedthrough"); + try t.key("esc"); + try t.settle(100); + try t.key("space f s"); + try t.stable(700, 15000); + try t.snapFile("buffer", "/tmp/pardes-snap/lspcompletemoved/cwd/a.zig"); + try t.done(); +} + +fn lspdebug(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lspdebug"); + defer t.deinit(); + try t.file("z.zig", "const std = @import(\"std\");\n\nfn helper() u32 {\n return 3;\n}\n\npub fn main() void {\n const v = helper();\n _ = v;\n}\n"); + // Builtins announce themselves by default, and an announcement is a band at + // the top of the body -- which moves every row this script clicks. What the + // verbs do is what is under test, not the announcement. + try t.config("Verbose off"); + try t.start(45, 120, &.{"z.zig"}); + try t.wait(8000, "fn helper"); + try t.stable(700, 20000); + try t.snap("opened"); + + // Ctrl-click jumps to the definition; plain click only moves the cursor. + try t.press("ctrl-left", "22", 11); + try t.release("ctrl-left", "22", 11); + try t.stable(700, 15000); + try t.snap("ctrlclick"); + try t.press("left", "22", 11); + try t.release("left", "22", 11); + try t.stable(700, 15000); + try t.snap("plainclick"); + + try t.send("3gg1g|"); + try t.stable(400, 10000); + try t.key("space l w"); + try t.wait(10000, "lsp explain — the definition query"); + try t.wait(10000, "row(s)"); + try t.key("space w j enter"); + try t.key("space d"); + try t.stable(700, 15000); + try t.snap("why-closed"); + + // Check the report's answers, not installed compiler paths or dependency counts. + try t.key("space l i"); + try t.wait(10000, "language servers:"); + try t.wait(10000, "zls"); + try t.key("space w j enter"); + try t.key("/"); + try t.send("client queries"); + try t.key("enter"); + try t.wait(10000, "client queries"); + try t.wait(10000, "definition"); + // Enter left the keyboard in the report, on the match; its query pane is + // attached to it, so one Del closes both, their rows back to the source + try t.key("space d"); + try t.stable(700, 15000); + try t.snap("report-closed"); + try t.done(); +} + +// What a language row SPELLS its path as, and that both spellings still LOOK. +// +// A row spells its path the shortest way a Look from the query pane resolves +// (Query.lookPath): relative to the pane's directory, `../` included, when that +// is shorter than the absolute path, else absolute — a `gr` list was otherwise +// the same forty-character prefix repeated down the pane with the part you came +// to read pushed off the right edge. +// +// A row in the SAME directory shortens to a bare basename; the two that a +// careless shortening can get wrong are here, one app each, as `gr` rows +// (the file headers of the asking text's query pane, line 1 `Refs`): +// +// PARENT the enum is one level UP from the asking file, so the row +// climbs: `../shade.zig`, shorter than `/tmp/.../cwd/shade.zig`, +// and a Look from the pane still lands on it. +// SUBDIRECTORY the enum is one level DOWN, so the strip leaves a path with a +// separator still in it — `inner/tint.zig`, not `tint.zig`. A +// strip that took the basename instead would produce a row that +// resolves to nothing. +// +// `n` and the Enter after it are the assertion in both, not the row text: the +// step selects row 1, the look opens the right file with the member SELECTED +// on its own line, and focus follows what opened — so the snap header's cursor +// is that pane's, and the style capture is where the selection itself shows. +fn lsprelpath(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsprelpath"); + defer t.deinit(); + try t.dir("sub"); + try t.dir("sub/inner"); + try t.file("shade.zig", "pub const Shade = enum {\n verdigris,\n cinnabar,\n};\n"); + try t.file("sub/inner/tint.zig", "pub const Tint = enum {\n ochre,\n indigo,\n};\n"); + try t.file("sub/parent.zig", "const shade = @import(\"../shade.zig\");\n\npub fn pick(s: shade.Shade) u8 {\n return switch (s) {\n \n };\n}\n"); + try t.file("sub/subdir.zig", "const tint = @import(\"inner/tint.zig\");\n\npub fn hue(t: tint.Tint) u8 {\n return switch (t) {\n \n };\n}\n"); + // ---- PARENT: outside the asking file's tree, so the row climbs ---- + try t.start(35, 100, &.{"sub/parent.zig"}); + try t.wait(8000, "fn pick"); + try t.stable(700, 20000); + try t.press("left", "31", 6); + try t.release("left", "31", 6); + try t.stable(400, 5000); + try t.key("g"); + try t.key("r"); + // the query pane under parent.zig, line 1 `Refs`, the rows under each file: + // shade.zig's spelled from above, `../shade.zig` + try t.wait(15000, "../shade.zig:1"); + try t.stable(700, 15000); + try t.snap("absrow"); + // the current row is parent.zig's own; the one before it is shade.zig's, + // shown in the +Preview (N, the list in normal mode), which Enter makes + // shade.zig's pane + try t.key("N"); + try t.wait(10000, "verdigris"); + try t.stable(700, 15000); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("abslook"); + try t.style("abslook"); + try t.start(35, 100, &.{"sub/subdir.zig"}); + try t.wait(8000, "fn hue"); + try t.stable(700, 20000); + try t.press("left", "29", 6); + try t.release("left", "29", 6); + try t.stable(400, 5000); + try t.key("g"); + try t.key("r"); + try t.wait(15000, "inner/tint.zig"); + try t.stable(700, 15000); + try t.snap("subrow"); + try t.key("N"); + try t.wait(10000, "ochre"); + try t.stable(700, 15000); + try t.key("enter"); + try t.stable(700, 15000); + try t.snap("sublook"); + try t.style("sublook"); + try t.press("right", "12", 13); + try t.release("right", "12", 13); + try t.stable(700, 15000); + try t.snap("clicked"); + try t.done(); +} + +// Rename end to end: the leader prompt, async ZLS resolution, atomic file edit, +// shadow filtering, and one-step undo/redo. The source has a same-spelled local +// which must not be changed when the top-level helper is renamed. +fn lsp_rename(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsp-rename"); + defer t.deinit(); + try t.file("rename.zig", "const std = @import(\"std\");\n\nfn helper(x: u32) u32 {\n return x + 1;\n}\n\npub fn main() void {\n _ = helper(41);\n}\n\nfn shadowed() void {\n const helper: u32 = 7;\n _ = helper;\n}\n"); + try t.start(25, 110, &.{"rename.zig"}); + try t.wait(8000, "helper(41)"); + try t.stable(700, 20000); + // Put the cursor inside the top-level call, then use the helix rename binding. + try t.press("left", "18", 11); + try t.release("left", "18", 11); + try t.key("space"); + try t.key("l"); + try t.key("r"); + try t.stable(400, 5000); + try t.send("renamed_helper"); + try t.key("enter"); + try t.wait(10000, "renamed_helper(41)"); + try t.stable(700, 15000); + try t.snap("renamed"); + // Both resolved top-level occurrences changed; the shadowed local stayed helper. + // The whole asynchronous rename is one history transaction. + try t.key("u"); + try t.stable(400, 5000); + try t.snap("undone"); + try t.key("U"); + try t.stable(400, 5000); + try t.snap("redone"); + try t.done(); +} + +// A Rename reaches the other files open in the editor. A server renames in +// the documents it has seen (zls's store), so before a query whose answer can +// reach other files the client tells it of every open file of its language. +// Here main.rs is opened by a look, asking the server nothing, and the rename +// is asked from lib.rs: the mock answers in each document it was told of, so +// the preview lists main.rs's two calls and lib.rs's definition. +fn lsp_rename_files(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "lsp-rename-files"); + defer t.deinit(); + try t.file("lib.rs", "// main.rs\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n"); + try t.file("main.rs", "mod lib;\n\nfn main() {\n let x = add(1, 2);\n let y = add(3, 4);\n let _ = x + y;\n}\n"); + try t.start(25, 100, &.{"lib.rs"}); + try t.wait(8000, "pub fn add"); + try t.stable(700, 20000); + try t.press("right", "@main.rs", 4); + try t.release("right", "@main.rs", 4); + try t.wait(8000, "let x = add"); + try t.stable(700, 15000); + try t.snap("opened"); + // into lib.rs's `add`, and rename it from there + try t.press("left", "@add", 5); + try t.release("left", "@add", 5); + try t.stable(400, 5000); + try t.key("space"); + try t.key("l"); + try t.key("r"); + try t.stable(400, 5000); + try t.send("sum"); + try t.key("enter"); + try t.wait(10000, "sum"); + try t.stable(700, 15000); + try t.snap("previewed"); + try t.done(); +} + +// Static call hierarchy in a dedicated pane; sites and declarations are Look +// targets, the source's colours on them. +fn callstack(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "callstack"); + defer t.deinit(); + try t.file("main.rs", "mod lib;\n\nfn main() {\n let x = add(1, 2);\n let y = add(3, 4);\n let _ = x + y;\n}\n"); + try t.file("lib.rs", "// mock fixture\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n"); + try t.start(40, 110, &.{"main.rs"}); + try t.wait(8000, "add(1, 2)"); + try t.stable(700, 20000); + try t.press("left", "13", 6); + try t.release("left", "13", 6); + try t.key("g c"); + try t.wait(10000, "Callstack"); + try t.wait(10000, "recursion"); + try t.stable(700, 15000); + try t.snap("hierarchy"); + try t.style("hierarchy"); + // LookNext selects the caller signature; Enter opens it in the source pane. + try t.key("space j n"); + try t.key("enter"); + try t.wait(10000, "fn main"); + try t.stable(700, 15000); + try t.snap("caller"); + try t.done(); +} + +// A diff pane, for reviewing a change: each hunk's code coloured as Zig (a +// multi-line string over three lines, `defer` inside it no keyword), added and +// removed rows tinted to the pane's edge with their prefix in the tint's hue, +// headers muted. Then a right click on an added line's `+` opens the new file +// at that line: the path is the repository's (a `.git` above the diff), b/ +// dropped. +fn diffview(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "diffview"); + defer t.deinit(); + try t.dir(".git"); + try t.dir("src"); + try t.file("src/shape.zig", "const std = @import(\"std\");\n\npub const Shape = union(enum) {\n circle: f32,\n square: f32,\n triangle: struct { base: f32, height: f32 },\n\n const note =\n \\\\areas, defer\n \\\\summed\n ;\n};\n"); + try t.file("change.diff", "diff --git a/src/shape.zig b/src/shape.zig\nindex 1111111..2222222 100644\n--- a/src/shape.zig\n+++ b/src/shape.zig\n@@ -1,10 +1,12 @@\n const std = @import(\"std\");\n \n pub const Shape = union(enum) {\n circle: f32,\n- square: u8 = 7,\n+ square: f32,\n+ triangle: struct { base: f32, height: f32 },\n \n const note =\n- \\\\areas\n+ \\\\areas, defer\n+ \\\\summed\n ;\n };\n"); + try t.start(31, 100, &.{"change.diff"}); + try t.wait(8000, "Newcol Joincol"); + try t.stable(700, 20000); + try t.snap("diff-pane"); + try t.style("diff-colours"); + try t.press("right", "8", 15); + try t.release("right", "8", 15); + try t.stable(700, 15000); + try t.snap("look-added-line"); + // The same diff printed by a command (`git diff`, here `cat`) into a command + // pane: its output is told for a diff and coloured the same, over the colours + // the program printed, and a right click on a `+` there opens the file too. + try t.file("cmds.txt", "cat change.diff\n"); + try t.start(31, 100, &.{"cmds.txt"}); + try t.wait(8000, "cmds.txt"); + try t.stable(700, 20000); + try t.press("middle", "7", 4); + try t.drag("middle", "22", 4); + try t.release("middle", "22", 4); + try t.wait(10000, "exit 0"); + try t.stable(700, 15000); + try t.snap("command-pane"); + try t.style("command-colours"); + try t.press("right", "3", 21); + try t.release("right", "3", 21); + try t.stable(700, 15000); + try t.snap("command-look"); + try t.done(); +} + +// a look at a directory opens a pane named for it with a trailing /, its +// entries in columns as acme's directory window lays them out: down each +// column first, a directory's marked /, dotfiles shown. A look at an entry +// opens it from that directory. No shell anywhere: nothing here races a prompt. +fn dirpane(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "dirpane"); + defer t.deinit(); + try t.dir("sub"); + try t.dir("sub/deeper"); + try t.file("sub/inner.txt", "inner-marker"); + try t.file("sub/.hidden", "x"); + try t.file("sub/alpha.txt", "x"); + try t.file("sub/beta-gamma.txt", "x"); + try t.file("sub/zeta", "x"); + try t.file("top.txt", "sub"); + try t.config("Verbose off"); + try t.start(24, 80, &.{"top.txt"}); + try t.wait(8000, "top.txt"); + try t.stable(700, 20000); + try t.press("right", "@sub", 4); + try t.release("right", "@sub", 4); + try t.wait(8000, "inner.txt"); + try t.stable(700, 20000); + try t.snap("dir-open"); + // an entry, by its name alone: sub's inner.txt + try t.press("right", "@inner.txt", 7); + try t.release("right", "@inner.txt", 7); + try t.wait(8000, "inner-marker"); + try t.stable(700, 20000); + try t.snap("entry-open"); + try t.done(); +} + +// scrolloff: keyboard motion keeps 3 context rows above/below the cursor, +// clamped at file boundaries (cursor may reach the top/bottom body row there) +fn scrolloff(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "scrolloff"); + defer t.deinit(); + try t.lines("g.txt", 40, ""); + try t.start(16, 210, &.{ "-n", "1" }); + try t.wait(8000, "g.txt"); + try t.stable(700, 20000); + // right-click the g.txt name in the greeting ls -> file pane under the shell's + // text, 9 body rows + try t.press("right", "4", 5); + try t.release("right", "4", 5); + try t.wait(10000, "line 3"); + try t.stable(700, 15000); + try t.press("left", "10", 9); + try t.release("left", "10", 9); + try t.stable(400, 5000); + // (b) gg: cursor CAN sit on the top body row, no forced scroll + try t.key("g g"); + try t.stable(400, 5000); + try t.snap("top"); + // (a) five j's reach the bottom margin (visual row 5 of 9) without scrolling... + try t.key("j j j j j"); + try t.stable(400, 5000); + try t.snap("edge"); + // ...the sixth j scrolls: view slides one line, cursor holds the margin + try t.key("j"); + try t.stable(400, 5000); + try t.snap("scrolled1"); + try t.key("j j j j"); + try t.stable(400, 5000); + try t.snap("jdown"); + // (d) ge (goto last line; bare G is a helix no-op): bottom clamp, view stops + // at EOF-at-bottom, cursor on the bottom row + try t.key("g e"); + try t.stable(400, 5000); + try t.snap("end"); + // (c) k-walk up: cursor climbs to the top margin, then the view scrolls + try t.key("k k k k k k k k"); + try t.stable(400, 5000); + try t.snap("kup"); + // (b) again from deep in the file: gg puts the cursor back on the top row + try t.key("g g"); + try t.stable(400, 5000); + try t.snap("top2"); + try t.done(); +} + +// Soft line breaks: ON by default, off with the Wrap builtin (`SPC t w`). A +// file line too long for the pane renders across several body rows instead of +// running off the right edge. +// +// Three rules pinned here. The break is at the PANE'S OWN content width and +// nothing else — there is no upper bound, a wide window breaks wide. A +// continuation row carries a BLANK gutter (the number belongs to the LINE, and +// a number repeated down a wrapped line would read as several lines) and the +// row it broke out of ends in `↩`, in the one column the wrap keeps free for +// it — a break is otherwise invisible, and an absent line number is a poor +// thing to read a document by. And the mouse follows the render: a click on a +// continuation row lands on the character under the pointer, which only works +// if the click resolves through the same row->line map the body was drawn from. +// +// The line is 20 decades, each headed by its own column marker: `0` at column +// 0, `4` at 40, `A` at 100. So the first character of a continuation row NAMES +// the column it broke at, and the width rule is readable straight off the grid. +fn wrap(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "wrap"); + defer t.deinit(); + try t.file("long.txt", "0---------1---------2---------3---------4---------5---------6---------7---------8---------9---------A---------B---------C---------D---------E---------F---------G---------H---------I---------J---------\nsecond line\nthird line\n"); + // 48 columns: the 2-column chrome gutter, the 5-column line-number gutter and + // the 1 column the `↩` sits in leave 40 for content. + try t.start(15, 48, &.{"long.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.stable(700, 20000); + // the default: five rows for line 1 (200 bytes / 40), the four continuations + // gutterless and starting at `4` `8` `C` `G` — the columns 40, 80, 120, 160 — + // and each of the first four rows ending in the break marker + try t.snap("on-narrow"); + // a click on the SECOND row of line 1, on the `5` marker at column 50. The + // cursor must come back to the cell that was clicked (grid 17,3): the click + // resolved to line 1 column 50, and the render put line 1 column 50 back where + // the finger was. Off by one row and it would land in line 2. + try t.press("left", "18", 5); + try t.release("left", "18", 5); + try t.stable(400, 5000); + try t.snap("clicked"); + // motions stay LOGICAL: one `j` from line 1 leaves the whole wrapped line + // behind and lands on line 2, four screen rows down at once. + try t.key("j"); + try t.stable(400, 5000); + try t.snap("logical-j"); + // ...while `gj`/`gk` are the VISUAL pair. `gg` puts the cursor back at line 1 + // column 0 with no goal column left over, `3l` moves three in, and from there + // each `gj` steps ONE screen row: still line 1, the column kept INSIDE the row, + // so the cursor stays in grid column 10 while the row walks 2 -> 3 -> 4. `gk` + // steps back onto the row it came from. This is the only motion that reads the + // wrap map's own arithmetic, so it is the one that can silently become `j`. + try t.key("g g"); + try t.stable(400, 5000); + try t.key("3 l"); + try t.stable(400, 5000); + try t.key("g j"); + try t.stable(400, 5000); + try t.snap("visual-gj"); + try t.key("g j"); + try t.stable(400, 5000); + try t.snap("visual-gj-again"); + try t.key("g k"); + try t.stable(400, 5000); + try t.snap("visual-gk"); + // a count is counted in ROWS too, and two of them are still inside line 1 + try t.key("2 g j"); + try t.stable(400, 5000); + try t.snap("visual-count-gj"); + // SPC t w turns it off: line 1 back on ONE row, clipped at the right edge with + // no marker, lines 2 and 3 under it — the render this pane had before soft + // breaks existed, because the map the readers consult goes back to empty and + // every one of them falls back to the row arithmetic it used before any of it + try t.key("space t w"); + try t.stable(400, 5000); + try t.snap("off"); + // ...and on again is on + try t.key("space t w"); + try t.stable(400, 5000); + try t.snap("on-again"); + // 128 columns: 120 for content, and the break is at the `C` — column 120, the + // window's own width. The old 100-column cap would have broken at the `A`. + try t.start(15, 128, &.{"long.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.stable(700, 20000); + try t.snap("on-wide"); + try t.done(); +} + +// horizontal scroll, file panes only (terminals wrap at pty width): the +// horizontal wheel shifts the content window (gutter stays put, no scrollbar), +// and keyboard movement keeps the scrolloff margin sideways — $ on a long +// line pulls the view right, 0 snaps it back. Overscroll right is allowed; +// a cursor move reels it in. +fn hscroll(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "hscroll"); + defer t.deinit(); + try t.file("wide.txt", "short1 END_A_MARKER_WAY_OUT_RIGHT_padpadpadpadpadpadpadpadpadpadpadpadpadpad_TAIL"); + try t.start(31, 90, &.{ "-n", "3" }); + try t.wait(8000, "wide.txt"); + try t.stable(700, 20000); + // soft wrap is ON by default and a wrapped body has nothing to scroll sideways + // — hscroll is what you get when you turn it OFF, so this whole script runs + // with it off. SPC t w is global, so it is spent once, before the file exists. + try t.key("space t w"); + try t.stable(400, 5000); + // open wide.txt: click a body spot, type the name, look it + try t.press("left", "5", 9); + try t.release("left", "5", 9); + try t.stable(400, 5000); + try t.key("i"); + try t.send("wide.txt"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.press("right", "7", 9); + try t.release("right", "7", 9); + try t.stable(700, 15000); + try t.snap("opened"); + // wheel right over the file pane: content shifts, line numbers stay + try t.send("\x1b[<66;10;8M"); + try t.send("\x1b[<66;10;8M"); + try t.stable(400, 5000); + try t.snap("wheeled"); + // wheel back left past the start clamps at column 0 + try t.send("\x1b[<67;10;8M"); + try t.send("\x1b[<67;10;8M"); + try t.send("\x1b[<67;10;8M"); + try t.stable(400, 5000); + try t.snap("clamped"); + // gl walks the cursor to the line end: the view follows with the margin + try t.key("g g"); + try t.stable(400, 5000); + try t.key("g l"); + try t.stable(400, 5000); + try t.snap("dollar"); + // 0 back to column zero: the view snaps home + try t.key("0"); + try t.stable(400, 5000); + try t.snap("zero"); + try t.done(); +} + +// Follow (SPC c f) twice on a 300-line file: three pages in three columns, +// each going on the line after the one before ends; Unfollow on the two +// followers' tags only. Then j past the first page's last row takes the +// keyboard to the second page without scrolling, and a wheel notch in the +// last page moves all three. +fn follow(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "follow"); + defer t.deinit(); + try t.lines("big.txt", 300, ""); + try t.start(30, 150, &.{"big.txt"}); + try t.wait(8000, "big.txt"); + try t.stable(500, 15000); + try t.key("space c f"); + try t.stable(500, 8000); + try t.key("space c f"); + try t.stable(500, 8000); + try t.snap("three-pages"); + try t.send("27j"); + try t.stable(500, 8000); + try t.snap("hop"); + try t.wheel("down", "120", 12); + try t.stable(500, 8000); + try t.snap("wheel"); + try t.done(); +} + +// `:` — vim's command line with acme's vocabulary. It focuses the pane's OWN +// tag in NORMAL mode (block cursor; the layout box shows the pane's BODY mode, +// which for this file pane is normal either way). The tag remembers where its +// cursor was; the first time there is nothing to remember and it starts on +// Save. The tag's normal mode is the body's: w selects the "Save" span exactly +// as a body word motion does, and the execute key runs the word under the +// cursor and hands the body back — same keys as the body, so Tab by default +// (see config.look_key/exec_key). `:` again backs out instead, leaving the tag +// as it was. +fn tagcmd(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "tagcmd"); + defer t.deinit(); + try t.lines("c.txt", 6, ""); + try t.start(31, 100, &.{"c.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.wait(8000, "c.txt"); + try t.stable(700, 20000); + // edit line 1 so Save has something to write + try t.key("i"); + try t.send("ZZEDIT"); + try t.key("esc"); + try t.settle(100); + try t.stable(400, 5000); + try t.snap("edited"); + // `:` -> the tag, in normal mode, cursor on Save + try t.key(":"); + try t.stable(400, 5000); + try t.snap("colon"); + // w -> the "Save" span (selected, like the body's word motion) + try t.key("w"); + try t.stable(400, 5000); + try t.snap("word"); + // Tab executes it: c.txt is written and focus is back in the body + try t.key("tab"); + try t.stable(600, 8000); + try t.stable(400, 5000); + try t.snap("saved"); + try t.snapFile("written", "/tmp/pardes-snap/tagcmd/cwd/c.txt"); + // `:` then `:`: back to the body with the tag untouched, nothing run + try t.key(":"); + try t.stable(400, 5000); + try t.key(":"); + try t.stable(400, 5000); + try t.snap("escaped"); + try t.done(); +} + +// A tag's normal mode is the body's: h/l/w move in the tag's own text, and +// moving between panes is the window keys' job from a tag as from a body -- +// there are no tag-only hops. `:` is the one key a tag and a body do not +// share: from the body it focuses the pane's own tag, from the tag it hands the +// keyboard back to the body. Each tag remembers its cursor; the first time +// there is nothing to remember and it starts on Save. +// +// Evidence is the `cursor=` header (the ACTIVE pane's cursor, which while a tag +// is focused sits on THAT pane's tag row) plus each pane's layout box, which +// carries its BODY mode as one character: ` ` normal, `^` insert, `$` tty. The +// tag has a mode of its own, so the box never changes while a tag is used. +fn tagnav(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "tagnav"); + defer t.deinit(); + try t.file("w.txt", "alpha\nbeta\ngamma"); + try t.start(31, 100, &.{"w.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.wait(8000, "w.txt"); + try t.stable(700, 20000); + // A FILE boots alone, so the launch shell is opened here: Alt-n opens it and + // focuses it, Alt-c puts it in a column of its own on the right, SPC w h Enter + // comes back to the file. + try t.key("a-n"); + try t.key("a-c"); + try t.stable(700, 15000); + try t.key("space w h enter"); + try t.stable(400, 5000); + // Alt-n: a shell below the file, so the left column has two rows and every + // direction has somewhere to go + try t.key("a-n"); + try t.stable(700, 15000); + try t.key("space w k enter"); + try t.stable(400, 5000); + try t.snap("start"); + // `:` -> the file's OWN tagline, normal mode, on Save + try t.key(":"); + try t.stable(400, 5000); + try t.snap("colon"); + // w selects in the tag the way it selects in a body + try t.key("w"); + try t.stable(400, 5000); + try t.snap("word"); + // l is a motion in the tag, not a hop to the next pane + try t.key("l l"); + try t.stable(400, 5000); + try t.snap("in-tag"); + // the window keys move between panes from a tag as from a body: the tag lets + // go and the neighbour's BODY takes the keyboard + try t.key("c-w l enter"); + try t.stable(400, 5000); + try t.snap("right"); + // `:` there -> that pane's own tag, on its Save the first time + try t.key(":"); + try t.stable(400, 5000); + try t.snap("right-tag"); + // back left, and `:` finds the file's tag cursor where l left it + try t.key("c-w h enter"); + try t.stable(400, 5000); + try t.key(":"); + try t.stable(400, 5000); + try t.snap("left-tag"); + // `:` in the tag's normal mode: back to the body + try t.key(":"); + try t.stable(400, 5000); + try t.snap("back-to-body"); + // A TERMINAL KEEPS ITS TTY MODE. Put the launch shell in raw tty mode (Ctrl-b), + // click its tagline and come back: its box reads `$` throughout, because the + // tag's mode is the tag's own. + try t.key("c-w l enter"); + try t.stable(400, 5000); + try t.key("c-b"); + try t.stable(700, 15000); + try t.snap("tty-on"); + try t.press("left", "@Mode", 3); + try t.release("left", "@Mode", 3); + try t.stable(400, 5000); + try t.snap("tty-tag"); + try t.key(":"); + try t.stable(400, 5000); + try t.snap("tty-restored"); + // The column and workspace tags are Texts in the same layout, with the same + // keys: Up from a pane with nothing above it reaches its column's tag, in + // normal mode, then the workspace's; Down comes back the same way. + try t.key("c-b"); + try t.stable(700, 15000); + try t.key("c-w h enter"); + try t.stable(400, 5000); + try t.key("c-w k"); + try t.stable(400, 5000); + try t.snap("column-tag"); + try t.key("w"); + try t.stable(400, 5000); + try t.snap("column-word"); + try t.key("c-w k"); + try t.stable(400, 5000); + try t.snap("workspace-tag"); + // `$` is the last cell; five long-word steps back land on `Dump`, and the + // execute key runs it and gives the keyboard back to the body FIRST -- `Exit` + // lives up here too, so a builtin that frees the session must never return + // into a focused header. Dump grows a `Restore <path>` word, which is also the + // case where the line gets longer than the column you were parked on. + try t.key("g l"); + try t.stable(400, 5000); + try t.snap("topbar-dollar"); + try t.key("B B B B B"); + try t.stable(400, 5000); + try t.snap("topbar-dump-word"); + try t.key("tab"); + try t.stable(700, 15000); + try t.snap("topbar-exec"); + // THE DELETION HAZARD, from the bar itself: `Restore` frees every pane and + // swaps the core out from under the caller. Walk back up onto the word the + // Dump just grew -- B twice off the tail, because the LONG word motions are the + // ones that step over a path in one go -- and run it. + try t.key("c-w k"); + try t.key("c-w k"); + try t.stable(400, 5000); + try t.key("g l B B"); + try t.stable(400, 5000); + try t.snap("topbar-restore-word"); + try t.key("tab"); + try t.stable(900, 15000); + try t.snap("topbar-restored"); + try t.done(); +} + +// The path is part of the tag's text for the keyboard as for the mouse: `0` +// goes to its start, `E` selects it and `y` yanks it. It is read-only, but +// typing into it drafts a new name there, as a click on it does. Escape +// cancels; Enter changes buffer identity, never renames a disk file. +fn tagpath(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "tagpath"); + defer t.deinit(); + try t.lines("c.txt", 4, ""); + try t.start(31, 100, &.{"c.txt"}); + try t.wait(8000, "Newcol Joincol"); + try t.wait(8000, "c.txt"); + try t.stable(700, 20000); + try t.snap("start"); + try t.key(":"); + try t.stable(400, 5000); + try t.snap("colon"); + try t.key("0"); + try t.stable(400, 5000); + try t.snap("col0"); + try t.key("E"); + try t.stable(400, 5000); + try t.snap("sel-path"); + try t.style("sel-path"); + try t.key("y"); + // `:` gives the keyboard back to the body, and `p` puts the path there + try t.key(":"); + try t.key("p"); + try t.stable(400, 5000); + try t.snap("yanked-path"); + // Sweep across the path / command boundary without injected padding. + try t.press("left", "12", 3); + try t.drag("left", "30", 3); + try t.drag("left", "42", 3); + try t.release("left", "42", 3); + try t.stable(400, 5000); + try t.snap("drag-cross"); + try t.style("drag-cross"); + // Esc is the tag's normal mode; typed at the path's start, `/renamed` drafts + // a name + try t.key("esc"); + try t.settle(100); + try t.key("0"); + try t.key("i"); + try t.send("/renamed"); + try t.stable(400, 5000); + try t.snap("name-draft"); + // Esc keeps the draft pending; a second drops it + try t.key("esc"); + try t.settle(100); + try t.key("esc"); + try t.stable(400, 5000); + try t.snap("name-cancelled"); + try t.key(":"); + try t.key("0"); + try t.key("i"); + try t.send("/renamed"); + try t.key("enter"); + try t.stable(400, 5000); + try t.snap("name-committed"); + try t.done(); +} + +// a CLICKED tag is in normal mode, its cursor where it was clicked: `i` types +// there (`:` is the door back to the body, see tagcmd); backspace edits; Esc drops to the tag's normal mode, which is +// the body's normal mode, and `:` there hands the keyboard back to the body; +// Enter looks the word at the cursor (Tab executes it). Multi-word execution +// from the tag stays the mouse's job (middle-drag), like anywhere else. +fn tag(gpa: std.mem.Allocator, exe: [:0]const u8) !void { + var t = try Tty.init(gpa, exe, "tag"); + defer t.deinit(); + try t.file("t.txt", "ZZLOOKED"); + try t.start(31, 150, &.{ "-n", "3" }); + try t.wait(8000, "t.txt"); + try t.stable(700, 20000); + // Click the one editable separator before Save, directly after the cwd. + // The former generated alignment gap no longer exists. + // The layout box shows + // the pane's BODY mode, not the tag's; `i` then types into the tag where it + // was clicked. + try t.press("left", "@Save-1", 3); + try t.release("left", "@Save-1", 3); + try t.stable(400, 5000); + try t.snap("tag-focus"); + try t.key("i"); + try t.send(" t.txt"); + try t.stable(600, 8000); + try t.stable(400, 5000); + try t.snap("tag-typed"); + try t.key("bs"); + try t.key("bs"); + try t.key("bs"); + try t.key("bs"); + try t.stable(400, 5000); + try t.snap("tag-del"); + try t.send(".txt"); + try t.stable(600, 8000); + try t.stable(400, 5000); + // Esc: the tag's normal mode; `:` then gives the keyboard back to the body, + // which is in normal mode, and the typed text stays + try t.key("esc"); + try t.settle(100); + try t.key(":"); + try t.stable(400, 5000); + try t.snap("tag-exit"); + // re-enter the tag and look the typed word: Enter in normal mode opens t.txt + // as a file pane. Click the inserted word itself; filename, separator and + // commands are compact. + try t.press("left", "@t.txt", 3); + try t.release("left", "@t.txt", 3); + try t.stable(400, 5000); + try t.key("enter"); + try t.wait(10000, "ZZLOOKED"); + try t.stable(700, 15000); + try t.snap("tag-look"); + try t.done(); +} |
