From 97b10466d83d488ad2cb9e084159a445af74c845 Mon Sep 17 00:00:00 2001
From: t <t@tjp.lol>
Date: Tue, 9 Jun 2026 00:00:56 -0600
Subject: event lifecycle

---
 src/tui_terminal.zig | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'src/tui_terminal.zig')

diff --git a/src/tui_terminal.zig b/src/tui_terminal.zig
index 0b00bb4..aa0c2c0 100644
--- a/src/tui_terminal.zig
+++ b/src/tui_terminal.zig
@@ -46,6 +46,13 @@ pub const seq = struct {
 
     /// Carriage return (column 0, same row).
     pub const carriage_return = "\r";
+    /// Cursor-forward (CUF). The full escape `\x1b[<n>C` is built at use
+    /// sites via `std.fmt` because `n` varies; documented here so the
+    /// sequence is centralized conceptually. `\x1b[<n>C` moves the cursor
+    /// RIGHT by `n` columns WITHOUT writing glyphs, so it never overwrites
+    /// existing content (unlike printing spaces). Used to place the hardware
+    /// cursor at the virtual-cursor column for IME anchoring (see
+    /// `Engine.positionHardwareCursor`).
     /// Clear from cursor to end of line.
     pub const clear_line = "\x1b[K";
     /// Clear from cursor to end of screen.
-- 
cgit v1.3