feat: introduce ModeReportMsg for terminal mode reports

Author: aymanbagabas

go.mod

@@ -8,7 +8,7 @@ toolchain go1.24.4
 
 require (
 	github.com/charmbracelet/colorprofile v0.3.3
-	github.com/charmbracelet/ultraviolet v0.0.0-20251112162901-46098fed0961
+	github.com/charmbracelet/ultraviolet v0.0.0-20251113184013-02308a8418b9
 	github.com/charmbracelet/x/ansi v0.11.1-0.20251110210702-903592506081
 	github.com/charmbracelet/x/exp/golden v0.0.0-20241212170349-ad4b7ae0f25f
 	github.com/charmbracelet/x/term v0.2.2

go.sum

@@ -2,8 +2,8 @@ github.com/aymanbagabas/go-udiff v0.2.0 h1:TK0fH4MteXUDspT88n8CKzvK0X9O2xu9yQjWp
 github.com/aymanbagabas/go-udiff v0.2.0/go.mod h1:RE4Ex0qsGkTAJoQdQQCA0uG+nAzJO/pI/QwceO5fgrA=
 github.com/charmbracelet/colorprofile v0.3.3 h1:DjJzJtLP6/NZ8p7Cgjno0CKGr7wwRJGxWUwh2IyhfAI=
 github.com/charmbracelet/colorprofile v0.3.3/go.mod h1:nB1FugsAbzq284eJcjfah2nhdSLppN2NqvfotkfRYP4=
-github.com/charmbracelet/ultraviolet v0.0.0-20251112162901-46098fed0961 h1:qneAb6lrvZEaliI3g91vFDYf4kCpotKU0bRXijfHRqA=
-github.com/charmbracelet/ultraviolet v0.0.0-20251112162901-46098fed0961/go.mod h1:ung4G52QJm6rlFYPYqPelzBHWWy966P9VMonX7UGT5g=
+github.com/charmbracelet/ultraviolet v0.0.0-20251113184013-02308a8418b9 h1:KxC15SbpWXFliFwrOKgE5DjUuQ/BAzpkuVL/ZYimwlE=
+github.com/charmbracelet/ultraviolet v0.0.0-20251113184013-02308a8418b9/go.mod h1:ung4G52QJm6rlFYPYqPelzBHWWy966P9VMonX7UGT5g=
 github.com/charmbracelet/x/ansi v0.11.1-0.20251110210702-903592506081 h1:gWeRo2N77OeiZAL47lzvIot9VPpTzxT5ahdzQIyHEDY=
 github.com/charmbracelet/x/ansi v0.11.1-0.20251110210702-903592506081/go.mod h1:M49wjzpIujwPceJ+t5w3qh2i87+HRtHohgb5iTyepL0=
 github.com/charmbracelet/x/exp/golden v0.0.0-20241212170349-ad4b7ae0f25f h1:UytXHv0UxnsDFmL/7Z9Q5SBYPwSuRLXHbwx+6LycZ2w=

input.go

@@ -47,6 +47,8 @@ func (p *Program) translateInputEvent(e uv.Event) Msg {
 		return TerminalVersionMsg(e)
 	case uv.KeyboardEnhancementsEvent:
 		return KeyboardEnhancementsMsg(e)
+	case uv.ModeReportEvent:
+		return ModeReportMsg(e)
 	}
 	return e
 }

screen.go

@@ -1,5 +1,7 @@
 package tea
 
+import "github.com/charmbracelet/x/ansi"
+
 // WindowSizeMsg is used to report the terminal size. It's sent to Update once
 // initially and then on every terminal resize. Note that Windows does not
 // have support for reporting when resizes occur as it does not support the
@@ -31,3 +33,45 @@ type LayerHitMsg struct {
 	ID    string
 	Mouse MouseMsg
 }
+
+// ModeReportMsg is a message that represents a mode report event (DECRPM).
+//
+// This is sent by the terminal in response to a request for a terminal mode
+// report (DECRQM). It indicates the current setting of a specific terminal
+// mode like cursor visibility, mouse tracking, etc.
+//
+// Example:
+//
+//		```go
+//	 func (m model) Init() tea.Cmd {
+//	   // Does my terminal support reporting focus events?
+//	   return tea.Raw(ansi.RequestModeFocusEvent)
+//	 }
+//
+//	 func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
+//	   switch msg := msg.(type) {
+//	   case tea.ModeReportMsg:
+//	     if msg.Mode == ansi.ModeFocusEvent && !msg.Value.IsNotRecognized() {
+//	       // Terminal supports focus events
+//	       m.supportsFocus = true
+//	     }
+//	   }
+//	   return m, nil
+//	 }
+//
+//	 func (m model) View() tea.View {
+//	   var view tea.View
+//	   view.ReportFocus = m.supportsFocus
+//	   view.SetContent(fmt.Sprintf("Terminal supports focus events: %v", m.supportsFocus))
+//	   return view
+//	 }
+//		```
+//
+// See: https://vt100.net/docs/vt510-rm/DECRPM.html
+type ModeReportMsg struct {
+	// Mode is the mode number.
+	Mode ansi.Mode
+
+	// Value is the mode value.
+	Value ansi.ModeSetting
+}