v0.2.14 63e33d9

render.go RawHistoryFolder

1package tui
2
3import (
4	"io"
5	"os"
6	"strings"
7
8	"github.com/mattn/go-runewidth"
9)
10
11// runewidthRune reports the number of cells a rune occupies, pinned
12// here so the renderer does not depend on the editor's helper.
13func runewidthRune(r rune) int { return runewidth.RuneWidth(r) }
14
15// Renderer maintains a previous frame and writes only the lines that
16// changed on each Draw(). Callers pass a full target frame (slice of
17// styled lines, already wrapped to width).
18type Renderer struct {
19	out  io.Writer
20	prev []string
21	rows int // terminal rows
22	cols int // terminal cols
23
24	// Cursor position after last draw (for placing input cursor).
25	cursorRow int
26	cursorCol int
27
28	// hideCursor when true prevents ShowCursor from being emitted.
29	hideCursor bool
30
31	// prevHadImage tracks whether the previous frame contained an
32	// inline-image escape so we can force a full clear+repaint whenever
33	// the image set changes. Only matters when inline images are
34	// enabled via ZOT_INLINE_IMAGES; defaults to false.
35	prevHadImage bool
36
37	// Main-screen flow renderer state. logLines is the full logical
38	// buffer (chat + live bottom band) from the previous DrawLog call.
39	// logViewportTop/logHardwareRow track where that logical buffer sits
40	// in the terminal's visible viewport so we can diff safely, and bail
41	// out to clear+replay when the diff would touch rows that are no
42	// longer addressable.
43	logChat        []string
44	logBottom      []string
45	logLines       []string
46	logViewportTop int
47	logHardwareRow int
48	logInit        bool
49
50	// keepScrollback is true when we must NOT emit \x1b[3J
51	// (erase-in-display 3, "clear scrollback").
52	//
53	// VS Code's integrated terminal (xterm.js) interprets \x1b[3J
54	// as "also snap the viewport to the top of the remaining
55	// buffer." Once the user has reopened a terminal with VS
56	// Code's persistent-sessions feature on, there is real
57	// replayed scrollback above the live cursor, and the snap is
58	// visible: the host scrollbar jumps to the top every time we
59	// do a full repaint (first paint, Ctrl+L via Renderer.Clear,
60	// any writeFull(true) shrink). On every other terminal we
61	// tested (iTerm, Ghostty, Kitty, Alacritty, Apple Terminal)
62	// \x1b[3J just drops scrollback rows without moving the
63	// viewport, which is what we actually want.
64	//
65	// The trade-off when keepScrollback is true: stale zot frames
66	// remain in scrollback above the live view, so scrolling up
67	// in VS Code's terminal shows old (already-superseded) zot
68	// output. That is strictly less disruptive than the
69	// scrollbar yanking to top on every Ctrl+L, and it is a
70	// limitation specific to VS Code's terminal that we have no
71	// way to work around without breaking other terminals.
72	keepScrollback bool
73
74	// theme is optional renderer-level styling applied at the final
75	// row-writing boundary. In particular, Theme.Background is painted
76	// as a full-width row background without making every View renderer
77	// know about terminal padding and reset semantics.
78	theme Theme
79}
80
81// NewRenderer returns a renderer that writes to out.
82//
83// Detects VS Code's integrated terminal via $TERM_PROGRAM and, when
84// detected, disables emission of \x1b[3J for the reasons documented
85// on Renderer.keepScrollback. The env var is set by VS Code itself
86// (and by Cursor, which forks VS Code's terminal — same xterm.js,
87// same bug), so no user configuration is required.
88func NewRenderer(out io.Writer) *Renderer {
89	return &Renderer{
90		out:            out,
91		keepScrollback: os.Getenv("TERM_PROGRAM") == "vscode",
92	}
93}
94
95// SetTheme updates renderer-level terminal styling. Changing the
96// background affects every row, so cached frame state is invalidated.
97func (r *Renderer) SetTheme(th Theme) {
98	r.theme = th
99	r.Invalidate()
100}
101
102// Resize tells the renderer the current terminal size.
103//
104// On a real size change we also issue a clear-screen so the next Draw
105// starts from a blank slate. Without the clear, characters from the
106// old (wider) layout linger past the new right edge and rows from
107// before the new bottom hang around as garbage.
108func (r *Renderer) ResetScrollRegion() {
109	if r.out != nil {
110		_, _ = io.WriteString(r.out, SeqResetScrollRegion)
111	}
112}
113
114func (r *Renderer) Resize(cols, rows int) {
115	if cols != r.cols || rows != r.rows {
116		r.cols = cols
117		r.rows = rows
118		r.prev = nil
119		r.logChat = nil
120		r.logBottom = nil
121		r.logLines = nil
122		r.logViewportTop = 0
123		r.logHardwareRow = 0
124		r.logInit = false
125		if r.out != nil {
126			if r.keepScrollback {
127				// A resize is a discrete user action, like Ctrl+L: the
128				// old-width frame must be fully purged or the in-place
129				// viewport clear leaves the scrolled-away rows behind
130				// (the user otherwise has to press Ctrl+L to fix it).
131				// Emit \x1b[3J to drop the retained scrollback and
132				// repaint clean, accepting VS Code's viewport-snap the
133				// same way Clear does.
134				_, _ = io.WriteString(r.out, SeqDeleteKittyImages+SeqClearScreen+SeqClearScrollback+MoveTo(1, 1))
135			} else {
136				// Clear both screen and (where safe) scrollback so stale
137				// content from the old width doesn't bleed through. Move
138				// to (1,1) so the next DrawLog/writeFull starts from a
139				// clean slate. Use the no-home variant: the explicit
140				// MoveTo below sets the cursor without triggering VS
141				// Code's viewport-snap.
142				_, _ = io.WriteString(r.out, SeqDeleteKittyImages+SeqClearScreenNoHome+r.clearScrollbackSeq()+MoveTo(1, 1))
143			}
144		}
145	}
146}
147
148// Clear forces a full repaint on the next Draw and clears the screen
149// plus scrollback. In main-screen flow mode this is required whenever
150// already-emitted transcript layout changes (for example ctrl+o
151// expand/collapse), because terminal scrollback cannot be edited
152// reliably once printed.
153func (r *Renderer) Clear() {
154	r.prev = nil
155	r.logChat = nil
156	r.logBottom = nil
157	r.logLines = nil
158	r.logViewportTop = 0
159	r.logHardwareRow = 0
160	r.logInit = false
161	if r.keepScrollback {
162		// On VS Code's xterm.js the transcript is taller than the
163		// viewport, so an in-place clear (home + erase-to-end) only
164		// wipes the visible rows: the part that scrolled above the
165		// viewport stays in the retained buffer and the next full
166		// repaint stacks a duplicate above the live frame.
167		//
168		// Clear() is an explicit user refresh (Ctrl+L), so here we do
169		// emit \x1b[3J to actually drop that scrollback, then home and
170		// repaint. This is the one place we accept VS Code's
171		// viewport-snap, because the user asked for a clean screen.
172		// (Implicit repaints, e.g. closing a dialog, deliberately
173		// avoid this path so they never snap the viewport.)
174		if r.out != nil {
175			_, _ = io.WriteString(r.out, SeqDeleteKittyImages+SeqClearScreen+SeqClearScrollback+MoveTo(1, 1))
176		}
177		return
178	}
179	_, _ = io.WriteString(r.out, SeqDeleteKittyImages+SeqClearScreenNoHome+r.clearScrollbackSeq()+MoveTo(1, 1))
180}
181
182// clearScrollbackSeq returns the scrollback-clear escape, or the
183// empty string when we are running under a terminal where emitting
184// it has user-visible side effects (see Renderer.keepScrollback).
185// Callers concatenate this into a larger control sequence; an empty
186// return value is a no-op there.
187func (r *Renderer) clearScrollbackSeq() string {
188	if r.keepScrollback {
189		return ""
190	}
191	return SeqClearScrollback
192}
193
194// KeepsScrollback reports whether this renderer suppresses the
195// scrollback-clear escape (true under VS Code's terminal). Callers
196// use it to pick a viewport-safe full repaint (Invalidate) over a
197// scrollback-clearing one (Clear) when redrawing overlays.
198func (r *Renderer) KeepsScrollback() bool { return r.keepScrollback }
199
200// Invalidate forces a full repaint on the next Draw without clearing the
201// whole terminal first. Useful when the cached diff is unreliable but a
202// visible full-screen flash would be too distracting.
203func (r *Renderer) Invalidate() {
204	r.prev = nil
205	r.logLines = nil
206}
207
208// Draw updates the terminal so that the visible frame ends with the
209// given lines (bottom-aligned). cursorRow/cursorCol are offsets within
210// the lines slice indicating where to place the terminal cursor; use
211// -1 to hide it.
212// containsImageEscape reports whether the line carries an inline-image
213// escape we must repaint rather than diff against the previous frame.
214func containsImageEscape(s string) bool {
215	return strings.Contains(s, "\x1b]1337;File=") || strings.Contains(s, "\x1b_G")
216}
217
218// paintBackgroundRow applies the optional theme background to a single
219// already-truncated terminal row. It pads with spaces to cols so the
220// background reaches the right edge, and re-applies the background
221// after full SGR resets inside the row so local styling does not punch
222// transparent holes through the global tint.
223func paintBackgroundRow(line string, cols int, th Theme) string {
224	bg := th.BackgroundStyle()
225	if bg == "" || cols <= 0 || containsImageEscape(line) {
226		return line
227	}
228	line = strings.ReplaceAll(line, reset, reset+bg)
229	if w := visibleWidth(line); w < cols {
230		line += strings.Repeat(" ", cols-w)
231	}
232	return bg + line + reset
233}
234
235// truncateToWidth clips s so its on-screen width doesn't exceed cols
236// cells, preserving ANSI CSI escape sequences (which don't consume
237// cells). Lines carrying an inline-image escape are returned as-is
238// since we can't measure their painted size.
239//
240// Fast path: a byte-length <= cols is a conservative upper bound
241// guaranteeing the cell width is also <= cols, so we skip all the
242// rune-width math. That covers the vast majority of lines in a
243// transcript (narrow terminals wrap early; wide ones leave headroom).
244func truncateToWidth(s string, cols int) string {
245	if cols <= 0 || containsImageEscape(s) {
246		return s
247	}
248	if len(s) <= cols {
249		return s
250	}
251	var out strings.Builder
252	out.Grow(len(s))
253	seen := 0
254	runes := []rune(s)
255	for i := 0; i < len(runes); {
256		r := runes[i]
257		// CSI escape sequence (ESC [ ... final): zero-width.
258		if r == 0x1b && i+1 < len(runes) && runes[i+1] == '[' {
259			out.WriteRune(r)
260			out.WriteRune(runes[i+1])
261			i += 2
262			for i < len(runes) {
263				c := runes[i]
264				out.WriteRune(c)
265				i++
266				if c >= 0x40 && c <= 0x7e {
267					break
268				}
269			}
270			continue
271		}
272		rw := runewidthRune(r)
273		if seen+rw > cols {
274			// Flush any trailing ANSI escapes (resets, erase-to-EOL)
275			// so background colors and cleanup sequences survive.
276			for i < len(runes) {
277				if runes[i] == 0x1b && i+1 < len(runes) && runes[i+1] == '[' {
278					out.WriteRune(runes[i])
279					out.WriteRune(runes[i+1])
280					i += 2
281					for i < len(runes) {
282						c := runes[i]
283						out.WriteRune(c)
284						i++
285						if c >= 0x40 && c <= 0x7e {
286							break
287						}
288					}
289				} else {
290					break
291				}
292			}
293			break
294		}
295		out.WriteRune(r)
296		seen += rw
297		i++
298	}
299	return out.String()
300}
301
302func (r *Renderer) Draw(lines []string, cursorRow, cursorCol int) {
303	if r.cols == 0 || r.rows == 0 {
304		return
305	}
306	// Bottom-align: only the last r.rows lines are visible.
307	visible := lines
308	if len(visible) > r.rows {
309		visible = visible[len(visible)-r.rows:]
310		cursorRow -= len(lines) - len(visible)
311	}
312	// Pad to r.rows with empty lines at the top. Every line is also
313	// hard-truncated to cols so the terminal never soft-wraps our output
314	// (which would push the status bar out of its row).
315	frame := make([]string, r.rows)
316	top := r.rows - len(visible)
317	for i := 0; i < top; i++ {
318		frame[i] = ""
319	}
320	for i, line := range visible {
321		frame[top+i] = paintBackgroundRow(truncateToWidth(line, r.cols), r.cols, r.theme)
322	}
323	if r.theme.Background != nil {
324		for i := 0; i < top; i++ {
325			frame[i] = paintBackgroundRow("", r.cols, r.theme)
326		}
327	}
328
329	var w strings.Builder
330	w.WriteString(SeqSynchronizedOn)
331	w.WriteString(SeqHideCursor)
332
333	// When inline images are in play we always full-repaint (clear
334	// screen first, then rewrite every row). Terminals manage image
335	// pixels in a layer we cannot diff against, so the per-line cache
336	// is unreliable. Inline images are opt-in via ZOT_INLINE_IMAGES;
337	// the common code path below is the fast cached diff.
338	curHasImage := false
339	curHasKittyImage := false
340	for _, l := range frame {
341		if containsImageEscape(l) {
342			curHasImage = true
343			if strings.Contains(l, "\x1b_G") {
344				curHasKittyImage = true
345			}
346		}
347	}
348	forceAll := curHasImage || r.prevHadImage
349	if forceAll {
350		// No-home variant: the per-row MoveTo(i+1, 1) writes in the
351		// loop below position the cursor for every painted row, so
352		// the embedded \x1b[H would only serve to make VS Code snap
353		// its scrollbar to the top of the viewport on every image or
354		// selection-highlight frame.
355		w.WriteString(SeqClearScreenNoHome)
356		if curHasKittyImage {
357			// Delete previously placed kitty images once per frame,
358			// before rewriting all rows. Doing this inside each image
359			// escape makes only the last image in the frame survive.
360			w.WriteString("\x1b_Ga=d\x1b\\")
361		}
362	}
363
364	// Detect selection highlights: if the current OR previous frame
365	// has selection-background rows, force full repaint. VS Code's
366	// terminal doesn't reliably clear background colors on row
367	// overwrites, leaving ghost highlights behind.
368	hasSelection := false
369	if r.theme.Background == nil {
370		selectionBG := sgrBG(r.theme.SelectionBG)
371		for _, l := range frame {
372			if selectionBG != "" && strings.Contains(l, selectionBG) {
373				hasSelection = true
374				break
375			}
376		}
377		if !hasSelection && r.prev != nil {
378			for _, l := range r.prev {
379				if selectionBG != "" && strings.Contains(l, selectionBG) {
380					hasSelection = true
381					break
382				}
383			}
384		}
385	}
386
387	full := r.prev == nil || len(r.prev) != r.rows
388	for i := 0; i < r.rows; i++ {
389		if full || forceAll || hasSelection || r.prev[i] != frame[i] {
390			w.WriteString(MoveTo(i+1, 1))
391			w.WriteString("\x1b[0m") // reset all attributes first
392			w.WriteString(SeqClearLine)
393			w.WriteString(frame[i])
394		}
395	}
396
397	if cursorRow >= 0 {
398		absRow := top + cursorRow + 1
399		absCol := cursorCol + 1
400		if absRow >= 1 && absRow <= r.rows {
401			w.WriteString(MoveTo(absRow, absCol))
402			w.WriteString(SeqShowCursor)
403		}
404	}
405	w.WriteString(SeqSynchronizedOff)
406
407	_, _ = io.WriteString(r.out, w.String())
408
409	r.prev = frame
410	r.prevHadImage = curHasImage
411	r.cursorRow = cursorRow
412	r.cursorCol = cursorCol
413}
414
415// DrawLog renders zot in the terminal's main screen as normal terminal
416// flow rather than a fixed full-screen frame. Chat lines are emitted once
417// into the host terminal scrollback; the current bottom block (dialogs,
418// slash popup, status, editor) is erased and redrawn in place at the end.
419//
420// cursorBottomRow/cursorCol are offsets into bottom, not the full frame.
421func (r *Renderer) DrawLog(chat, bottom []string, cursorBottomRow, cursorCol int) {
422	if r.cols == 0 || r.rows == 0 {
423		return
424	}
425	if len(bottom) == 0 {
426		bottom = []string{""}
427	}
428	chatFrame := make([]string, len(chat))
429	for i, line := range chat {
430		chatFrame[i] = paintBackgroundRow(truncateToWidth(line, r.cols), r.cols, r.theme)
431	}
432	bottomFrame := make([]string, len(bottom))
433	for i, line := range bottom {
434		bottomFrame[i] = paintBackgroundRow(truncateToWidth(line, r.cols), r.cols, r.theme)
435	}
436
437	// Always reserve one real row below the editor/status band. This is
438	// renderer-owned (not a best-effort trailing blank in the caller's
439	// bottom block), so the logical-buffer diff keeps it visible and cursor
440	// placement remains relative to the editor itself.
441	const bottomMarginRows = 1
442	lines := make([]string, 0, len(chatFrame)+len(bottomFrame)+bottomMarginRows)
443	lines = append(lines, chatFrame...)
444	lines = append(lines, bottomFrame...)
445	for range bottomMarginRows {
446		lines = append(lines, paintBackgroundRow("", r.cols, r.theme))
447	}
448	// In main-screen flow mode zot normally emits only its logical
449	// content rows and leaves the rest of the terminal viewport alone.
450	// When a theme background is configured, fill that otherwise-idle
451	// space with painted blank rows so the full window is tinted while
452	// keeping the scrollback-oriented renderer model unchanged for the
453	// default transparent case.
454	if r.theme.Background != nil {
455		for len(lines) < r.rows {
456			lines = append(lines, paintBackgroundRow("", r.cols, r.theme))
457		}
458	}
459	if len(lines) == 0 {
460		lines = []string{""}
461	}
462
463	cursorTargetRow := -1
464	if cursorBottomRow >= 0 && cursorBottomRow < len(bottomFrame) {
465		cursorTargetRow = len(chatFrame) + cursorBottomRow
466	}
467
468	// Idle no-op fast path. When the buffer AND the cursor position
469	// haven't changed since the last DrawLog, emit nothing. The
470	// alternative — always writing SeqHideCursor + cursor-position +
471	// SeqShowCursor — resets the terminal's cursor blink timer on
472	// every tick. At our 120ms animation cadence that means the
473	// caret in an idle dialog editor (e.g. an open swarm transcript
474	// for an agent that's currently idle) appears as a solid block
475	// that never blinks, because we keep "showing" it before the
476	// terminal can blink it off. Bailing out here lets the OS run
477	// its blink cycle.
478	if r.logInit && cursorBottomRow == r.cursorRow && cursorCol == r.cursorCol && sameLines(lines, r.logLines) {
479		return
480	}
481
482	var w strings.Builder
483	w.WriteString(SeqSynchronizedOn)
484	w.WriteString(SeqHideCursor)
485
486	writeFull := func(clear bool) {
487		if clear {
488			w.WriteString(SeqDeleteKittyImages)
489			if r.keepScrollback {
490				// VS Code's xterm.js scrolls the visible content up into
491				// scrollback on \x1b[2J, which duplicates the frame (the
492				// old paint stays above the new one). Home to the
493				// viewport top and erase-to-end (\x1b[0J) instead: that
494				// clears the visible screen in place without pushing the
495				// previous frame into scrollback. We still cannot drop
496				// existing scrollback (\x1b[3J snaps the viewport there),
497				// but a full repaint no longer stacks a fresh copy below
498				// the old one.
499				w.WriteString(SeqCursorHome)
500				w.WriteString(SeqClearToEnd)
501			} else {
502				w.WriteString(SeqClearScreenNoHome)
503				w.WriteString(r.clearScrollbackSeq())
504				w.WriteString(MoveTo(1, 1))
505			}
506		}
507		for idx, line := range lines {
508			if idx > 0 {
509				w.WriteString("\r\n")
510			}
511			w.WriteString("\x1b[0m")
512			w.WriteString(SeqClearLine)
513			w.WriteString(line)
514		}
515		r.logHardwareRow = len(lines) - 1
516		r.logViewportTop = len(lines) - r.rows
517		if r.logViewportTop < 0 {
518			r.logViewportTop = 0
519		}
520	}
521
522	moveToLogicalRow := func(targetRow int) {
523		if targetRow < 0 {
524			targetRow = 0
525		}
526		if targetRow >= len(lines) {
527			targetRow = len(lines) - 1
528		}
529		viewportBottom := r.logViewportTop + r.rows - 1
530		if targetRow > viewportBottom {
531			currentScreenRow := r.logHardwareRow - r.logViewportTop
532			if currentScreenRow < 0 {
533				currentScreenRow = 0
534			}
535			if currentScreenRow >= r.rows {
536				currentScreenRow = r.rows - 1
537			}
538			moveToBottom := r.rows - 1 - currentScreenRow
539			if moveToBottom > 0 {
540				w.WriteString("\x1b[" + itoa(moveToBottom) + "B")
541			}
542			scroll := targetRow - viewportBottom
543			for s := 0; s < scroll; s++ {
544				w.WriteString("\r\n")
545			}
546			r.logViewportTop += scroll
547			r.logHardwareRow = targetRow
548			return
549		}
550		currentScreenRow := r.logHardwareRow - r.logViewportTop
551		targetScreenRow := targetRow - r.logViewportTop
552		lineDiff := targetScreenRow - currentScreenRow
553		if lineDiff > 0 {
554			w.WriteString("\x1b[" + itoa(lineDiff) + "B")
555		} else if lineDiff < 0 {
556			w.WriteString("\x1b[" + itoa(-lineDiff) + "A")
557		}
558		r.logHardwareRow = targetRow
559	}
560
561	positionCursor := func() {
562		if cursorTargetRow < 0 || cursorTargetRow >= len(lines) {
563			return
564		}
565		moveToLogicalRow(cursorTargetRow)
566		w.WriteString("\r")
567		if cursorCol > 0 {
568			w.WriteString("\x1b[" + itoa(cursorCol) + "C")
569		}
570		w.WriteString(SeqShowCursor)
571	}
572
573	// Selection-highlight workaround removed: it could mis-invalidate
574	// user-bubble padding rows whose colored bg made botHasHL trip,
575	// causing the next diff pass to leave those rows visually thinned
576	// because the cached entry was the \x00 sentinel rather than the
577	// real previous bg-colored row.
578
579	full := !r.logInit || len(r.logLines) == 0
580	if full {
581		writeFull(true)
582		r.logInit = true
583	} else {
584		firstChanged := -1
585		lastChanged := -1
586		maxLines := len(lines)
587		if len(r.logLines) > maxLines {
588			maxLines = len(r.logLines)
589		}
590		for idx := 0; idx < maxLines; idx++ {
591			oldLine := ""
592			if idx < len(r.logLines) {
593				oldLine = r.logLines[idx]
594			}
595			newLine := ""
596			if idx < len(lines) {
597				newLine = lines[idx]
598			}
599			if oldLine != newLine {
600				if firstChanged == -1 {
601					firstChanged = idx
602				}
603				lastChanged = idx
604			}
605		}
606		// Buffer grew but the appended rows were empty (or otherwise
607		// equal to the implicit "" past the old end). The diff above
608		// won't flag those rows, yet the renderer still needs to
609		// advance its hardware cursor / viewport tracking past them so
610		// the next render starts from the correct position. Treat the
611		// extension as changed.
612		if len(lines) > len(r.logLines) {
613			if firstChanged == -1 {
614				firstChanged = len(r.logLines)
615			}
616			if lastChanged < len(lines)-1 {
617				lastChanged = len(lines) - 1
618			}
619		}
620
621		if firstChanged == -1 {
622			// No content changes; the final cursor positioning below may still
623			// move the hardware cursor if the editor cursor changed.
624		} else if firstChanged < r.logViewportTop {
625			// Changes above the visible viewport cannot be patched safely.
626			writeFull(true)
627		} else {
628			prevViewportTop := r.logViewportTop
629			viewportTop := prevViewportTop
630			hardwareRow := r.logHardwareRow
631			prevViewportBottom := prevViewportTop + r.rows - 1
632			appendStart := len(lines) > len(r.logLines) && firstChanged == len(r.logLines) && firstChanged > 0
633			moveTarget := firstChanged
634			if appendStart {
635				moveTarget = firstChanged - 1
636			}
637
638			if moveTarget > prevViewportBottom {
639				currentScreenRow := hardwareRow - prevViewportTop
640				if currentScreenRow < 0 {
641					currentScreenRow = 0
642				}
643				if currentScreenRow >= r.rows {
644					currentScreenRow = r.rows - 1
645				}
646				moveToBottom := r.rows - 1 - currentScreenRow
647				if moveToBottom > 0 {
648					w.WriteString("\x1b[" + itoa(moveToBottom) + "B")
649				}
650				scroll := moveTarget - prevViewportBottom
651				for s := 0; s < scroll; s++ {
652					w.WriteString("\r\n")
653				}
654				prevViewportTop += scroll
655				viewportTop += scroll
656				hardwareRow = moveTarget
657			}
658
659			currentScreenRow := hardwareRow - prevViewportTop
660			targetScreenRow := moveTarget - viewportTop
661			lineDiff := targetScreenRow - currentScreenRow
662			if lineDiff > 0 {
663				w.WriteString("\x1b[" + itoa(lineDiff) + "B")
664			} else if lineDiff < 0 {
665				w.WriteString("\x1b[" + itoa(-lineDiff) + "A")
666			}
667			if appendStart {
668				w.WriteString("\r\n")
669			} else {
670				w.WriteString("\r")
671			}
672
673			renderEnd := lastChanged
674			if renderEnd >= len(lines) {
675				renderEnd = len(lines) - 1
676			}
677			for idx := firstChanged; idx <= renderEnd; idx++ {
678				if idx > firstChanged {
679					w.WriteString("\r\n")
680				}
681				w.WriteString("\x1b[0m")
682				w.WriteString(SeqClearLine)
683				w.WriteString(lines[idx])
684			}
685			finalRow := renderEnd
686			if len(r.logLines) > len(lines) {
687				extra := len(r.logLines) - len(lines)
688				if extra > r.rows {
689					writeFull(true)
690				} else {
691					for e := 0; e < extra; e++ {
692						w.WriteString("\x1b[1B")
693						w.WriteString("\r")
694						w.WriteString("\x1b[0m")
695						w.WriteString(SeqClearLine)
696						finalRow++
697					}
698					if extra > 0 {
699						w.WriteString("\x1b[" + itoa(extra) + "A")
700						finalRow -= extra
701					}
702				}
703			}
704			r.logHardwareRow = finalRow
705			r.logViewportTop = viewportTop
706			if minTop := r.logHardwareRow - r.rows + 1; minTop > r.logViewportTop {
707				r.logViewportTop = minTop
708			}
709			if r.logViewportTop < 0 {
710				r.logViewportTop = 0
711			}
712		}
713	}
714
715	positionCursor()
716	w.WriteString(SeqSynchronizedOff)
717	_, _ = io.WriteString(r.out, w.String())
718
719	r.logChat = append(r.logChat[:0], chatFrame...)
720	r.logBottom = append(r.logBottom[:0], bottomFrame...)
721	r.logLines = append(r.logLines[:0], lines...)
722	r.cursorRow = cursorBottomRow
723	r.cursorCol = cursorCol
724}
725
726// sameLines reports whether two []string have the exact same
727// length and per-row contents. Used by DrawLog's idle no-op fast
728// path; cheap enough at our frame rates and far simpler than
729// hashing every byte.
730func sameLines(a, b []string) bool {
731	if len(a) != len(b) {
732		return false
733	}
734	for i := range a {
735		if a[i] != b[i] {
736			return false
737		}
738	}
739	return true
740}
741
742func writeBlock(w *strings.Builder, lines []string) {
743	for i, line := range lines {
744		w.WriteString("\x1b[0m")
745		w.WriteString(SeqClearLine)
746		w.WriteString(line)
747		if i < len(lines)-1 {
748			w.WriteString("\r\n")
749		}
750	}
751}
752
753func tailTruncated(lines []string, maxRows, cols int) []string {
754	if maxRows <= 0 {
755		return nil
756	}
757	if len(lines) > maxRows {
758		lines = lines[len(lines)-maxRows:]
759	}
760	out := make([]string, len(lines))
761	for i, line := range lines {
762		out[i] = truncateToWidth(line, cols)
763	}
764	return out
765}

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 476

↑↓ moveenter openesc close