summaryrefslogtreecommitdiff
path: root/docs/next-daemon.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-29 19:52:55 -0300
committerGabriel Schneider <[email protected]>2026-10-29 19:53:05 -0300
commit32b80ad0393321d44f929e501e5515bbf6e51c12 (patch)
tree6dbf92426f6f07c1f1c030d542064b48ad6eaca8 /docs/next-daemon.md
parentb3b2768cc82105fa2a1845b7a7a3767c51173afb (diff)
downloadpardes-32b80ad0393321d44f929e501e5515bbf6e51c12.tar.gz
pardes-32b80ad0393321d44f929e501e5515bbf6e51c12.zip
views: a terminal shown in a view shorter than it is passed down to its cursor, a shell's prompt never out of sight, an arrow in the gutter where rows are above; a name drafted in a tag is the view's that opened it
A terminal takes the size of the view that typed into it last; a shorter view used to show its top rows, the prompt below them cut. It now passes over as many as keep the cursor's row in sight, as tmux pans a bigger window in a smaller client: `Pane.pan` (per view, derived) is made in the step's sync and again when a view is drawn out of turn (views.unpark), by terminal.panFor (0 in the view that sizes it, in one tall enough, or folded), and read where the body's rows start: `Pane.scroll`, the body walk in tty mode, the visible cursor. One view never pans: the view that sizes a terminal returns 0 at its first test. A `.name` prompt (a file's name drafted in its tag) is the view's that opened it (`Pane.prompt_view`): another view's step, where that pane has not the keyboard, no longer drops it; its view closing does. views-pan.snap: a shell sized for a 24-row view, its last lines and prompt in a 12-row one under the arrow, then typed into from the short view and sized for it. A unit test: the short view's frame has the cursor's row, and the line on it, inside the pane. docs: the notes, the reference. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/next-daemon.md')
-rw-r--r--docs/next-daemon.md41
1 files changed, 25 insertions, 16 deletions
diff --git a/docs/next-daemon.md b/docs/next-daemon.md
index 3d4c8a08..e7ddcf5f 100644
--- a/docs/next-daemon.md
+++ b/docs/next-daemon.md
@@ -314,15 +314,23 @@ the ponytail lens:
workspace tag, prompts, messages, registers (decided), the macro being
recorded, look-hover (one pointer at a time), mouse sweeps, query
panes, search state, settings and theme, the effect and input queues,
- `needs_frame` (any change draws every view).
+ `needs_frame` (any change draws every view). A `.name` prompt (a
+ file's name drafted in its tag) is the view's that opened it
+ (`Pane.prompt_view`): only that view's focus leaving the pane drops it,
+ and its closing.
- **A terminal shown at two sizes** takes the size of the view that typed
into it last (`Pane.sized_by`, set by a key or a paste; a new pane's is
its maker's; a closed view's goes to the next to sync it). The others show
it at that size: `sync` resizes no pty for them, and `pane.cols/rows`
stay the terminal's own, so the terminal code's invariant (pane size is
- the emulator's) holds. ponytail: a smaller view sees its top rows, cut;
- panning to the cursor as tmux does is the upgrade, if a small view must
- follow a shell it never types into.
+ the emulator's) holds. A view shorter than the terminal is passed down
+ its top rows as far as keeps its cursor's row in sight, as tmux shows a
+ bigger window in a smaller client (`Pane.pan`, terminal.panFor: per view,
+ made in the step and again when a view is drawn out of turn, read where
+ the body's rows start, `Pane.scroll` and the body walk), an arrow in its
+ gutter's first row saying rows are above; a shell's prompt, at the
+ bottom, is never out of sight. ponytail: a panned view's mouse reports to
+ the terminal's program and its kitty images are placed as unpanned.
- **Panes come and go under parked views.** A view keeps the serial of
each slot when it goes out; unparked, the ids whose serial changed leave
its layout and its keyboard moves to its first pane left. A pane focused
@@ -390,8 +398,6 @@ the ponytail lens:
named in a path yet (a script's focus or layout is that view's).
- Every change draws every view (`needs_frame` is the session's); a
view's own dirtiness waits for a measurement that wants it.
- - Prompts are the pane's: a `.name` prompt drafted in one view is
- closed by another view's step, where that pane has not the keyboard.
- Dump, Restore and Handover keep one view, the live one.
- **What proved wrong in the design.** "Views" in the design were a
struct the core reads through; the swap made them cheaper and kept every
@@ -433,21 +439,24 @@ Two views (not gated): every frame draws both, so a change costs two
renders; a view switch copies ~60 fields and each pane's share, a few
microseconds.
-Gates, on the line rebased onto main's tty throughput fix (qzsouslm):
+Gates, on the line rebased onto main's screen-state terminals (mnlwlpvk):
-- `zig build replay -Dplatform=tty`: 112 snapshot scripts pass (the 110,
- views.snap and views-term.snap), their 130 tapes replay in all three
- replicas (390 runs, 29,355 digests); 20 monkey seeds at one view (60
- runs, 14,010 digests) and 20 at three views (60 runs, 9,720 digests);
- no divergence, no panic. views.snap: 75 digests a replica,
- views-term.snap 35.
-- Unit tests: tty 1478 of 1498 pass, 20 skipped; GUI 1549 of 1560, 9
+- `zig build replay -Dplatform=tty`: 113 snapshot scripts pass (the 110,
+ views.snap, views-term.snap and views-pan.snap), their 131 tapes replay
+ in all three replicas (393 runs, 29,436 digests); 20 monkey seeds at one
+ view (60 runs, 14,004 digests) and 20 at three views (60 runs, 9,666
+ digests); no divergence, no panic. views.snap: 75 digests a replica,
+ views-term.snap 35. core-test: 1117 of 1135, 18 skipped.
+- Unit tests (on qzsouslm): tty 1478 of 1498 pass, 20 skipped; GUI 1549 of 1560, 9
skipped and 2 failed, the same two that fail on phase 1's line (`tagline
pointer mapping retains physical grips...` and `a tag caret past its
- row's end glides...`). The views' own: 7 (own cursor, scroll, mode,
+ row's end glides...`). The views' own: 8 (own cursor, scroll, mode,
layout and focus; an edit and a register shared; a terminal sized by its
last typist; views closing; the other views drawn leave the digest; a
- view keeps its place in a text another edits).
+ view keeps its place in a text another edits; a short view keeps a tall
+ terminal's cursor in sight). views-pan.snap: a shell sized for the tall
+ view, its prompt and last lines in the short one under an arrow, then
+ typed into from the short one and sized for it.
- test/fs.py passes (with a TMPDIR short enough for the 9P sockets'
paths). test/daemon.py: 20 detach and attach cycles, then a second
terminal on the attached session, both drawn, detached from inside and