app

type Model struct {
	Theme theme.Theme
	Tier  theme.Tier

	Opts Options

	// Width and Height are the live terminal size. Bubble Tea sends a
	// WindowSizeMsg on startup and on every resize, so these are the one
	// source of truth for layout; nothing in the tree may assume 80x24.
	Width  int
	Height int
	// contains filtered or unexported fields
}

type MouseCaptureMsg struct{ On bool }

type Options struct {
	// Mouse reports whether the cockpit captures the mouse. Rule 6.5
	// makes capture opt-out: mouse capture is the most common friction
	// point over SSH and inside tmux, because it kills copy-on-select.
	Mouse bool

	// FullRepaint forces a complete redraw on resize. Windows Terminal
	// and ConPTY coalesce positioned writes wrongly and leave stale
	// cells (cockpit-research.md section 4), and a full redraw is the
	// recovery. The effect on a real terminal cannot be tested here;
	// the decision function and the ClearScreen Cmd are.
	FullRepaint bool
}

type OwnsQuit interface {
	OwnsQuit() bool
}

type PopScreenMsg struct{}

type PushScreenMsg struct{ Screen Screen }

type Screen interface {
	Init() tea.Cmd
	Update(tea.Msg) (Screen, tea.Cmd)
	View() string
	// ViewFlags reports the terminal modes this screen needs on the ONE
	// tea.View the router assembles. A Screen cannot return a tea.View,
	// so the modes it depends on - today, whether the alternate screen
	// is held - travel through this method instead.
	ViewFlags() ViewFlags
}

type ScreenResumedMsg struct{}

type ThemeChangedMsg struct {
	Theme theme.Theme
	Tier  theme.Tier
}

type ThemeSelectedMsg struct{ Name string }

type ViewFlags struct {
	// AltScreen reports whether the screen holds the terminal's whole
	// drawing surface. The transcript pager clears it while the
	// conversation is handed back to native scrollback
	// (cockpit-research.md rule 6.3): one key writes the transcript into
	// the scrollback and the terminal must be able to show it.
	AltScreen bool
}