feat(render): add option to show render time in the view

cursed_renderer.go

@@ -6,8 +6,10 @@
 	"image/color"
 	"io"
 	"runtime"
+	"strconv"
 	"strings"
 	"sync"
+	"time"
 
 	"github.com/charmbracelet/colorprofile"
 	uv "github.com/charmbracelet/ultraviolet"
@@ -16,24 +18,26 @@
 )
 
 type cursedRenderer struct {
-	w             io.Writer
-	buf           bytes.Buffer // updates buffer to be flushed to [w]
-	scr           *uv.TerminalRenderer
-	cellbuf       uv.ScreenBuffer
-	lastView      *View
-	env           []string
-	term          string // the terminal type $TERM
-	width, height int
-	mu            sync.Mutex
-	profile       colorprofile.Profile
-	logger        uv.Logger
-	view          View
-	hardTabs      bool // whether to use hard tabs to optimize cursor movements
-	backspace     bool // whether to use backspace to optimize cursor movements
-	mapnl         bool
-	syncdUpdates  bool // whether to use synchronized output mode for updates
-	prependLines  []string
-	starting      bool // indicates whether the renderer is starting after being stopped
+	w               io.Writer
+	buf             bytes.Buffer // updates buffer to be flushed to [w]
+	scr             *uv.TerminalRenderer
+	cellbuf         uv.ScreenBuffer
+	lastView        *View
+	env             []string
+	term            string // the terminal type $TERM
+	width, height   int
+	mu              sync.Mutex
+	profile         colorprofile.Profile
+	logger          uv.Logger
+	view            View
+	hardTabs        bool // whether to use hard tabs to optimize cursor movements
+	backspace       bool // whether to use backspace to optimize cursor movements
+	mapnl           bool
+	syncdUpdates    bool // whether to use synchronized output mode for updates
+	prependLines    []string
+	starting        bool // indicates whether the renderer is starting after being stopped
+	showRenderDebug bool
+	lastRenderTime  time.Duration
 }
 
 var _ renderer = &cursedRenderer{}
@@ -45,6 +49,7 @@
 	s.term = uv.Environ(env).Getenv("TERM")
 	s.width, s.height = width, height // This needs to happen before [cursedRenderer.reset].
 	s.cellbuf = uv.NewScreenBuffer(s.width, s.height)
+	s.showRenderDebug, _ = strconv.ParseBool(uv.Environ(env).Getenv("TEA_RENDER_DEBUG"))
 	reset(s)
 	return
 }
@@ -248,6 +253,8 @@
 	s.mu.Lock()
 	defer s.mu.Unlock()
 
+	startTime := time.Now()
+
 	view := s.view
 	frameArea := uv.Rect(0, 0, s.width, s.height)
 	if len(view.Content) == 0 {
@@ -449,6 +456,13 @@
 		setProgressBar(s, view.ProgressBar)
 	}
 
+	if s.showRenderDebug {
+		renderTime := uv.NewStyledString(fmt.Sprintf("%s", s.lastRenderTime))
+		if len(content.Text) > 0 && !frameArea.Empty() {
+			renderTime.Draw(s.cellbuf, renderTime.Bounds())
+		}
+	}
+
 	// Render and queue changes to the screen buffer.
 	s.scr.Render(s.cellbuf.Buffer)
 
@@ -563,6 +577,9 @@
 
 	s.lastView = &view
 
+	endTime := time.Now()
+	s.lastRenderTime = endTime.Sub(startTime)
+
 	return nil
 }