app

type App struct {
	// contains filtered or unexported fields
}

type Binding struct {
	Keys    []string
	Command string
	Help    string
	// Global bindings are always checked, even when an overlay is open.
	Global bool
}

type Command struct {
	// ID is a stable command identifier (e.g. "app.quit").
	ID string
	// Title is a short human label for help / palettes.
	Title string
	// Run executes the command. May return a tea.Cmd.
	// The App pointer is the host shell.
	Run func(a *App) tea.Cmd
}

type CommandRegistry struct {
	// contains filtered or unexported fields
}

type Content interface {
	Init() tea.Cmd
	Update(msg tea.Msg) (Content, tea.Cmd)
	View(ctx Context) string
}

type ContentFunc struct {
	OnInit   func() tea.Cmd
	OnUpdate func(msg tea.Msg) (Content, tea.Cmd)
	OnView   func(ctx Context) string
}

type Context struct {
	// Width and Height are the full terminal dimensions.
	Width  int
	Height int
	// MainHeight is the rows available to Content after header/footer chrome.
	MainHeight int
	// OverlayOpen reports whether a modal overlay currently captures input.
	OverlayOpen bool
	// Chrome holds the measured header/main/footer regions.
	Chrome Region
}

type FuncOverlay struct {
	Name string
	// OnInit optional.
	OnInit func() tea.Cmd
	// OnUpdate required. Return next=nil to close.
	OnUpdate func(msg tea.Msg) (next Overlay, cmd tea.Cmd)
	// OnView required; receives the terminal size.
	OnView func(width, height int) string
}

type Harness struct {
	App *App
}

type Host interface {
	Size() (width, height int)
	Commands() *CommandRegistry
	Keys() *KeyMap
	Status() string
	SetStatus(s string)
	Content() Content
	SetContent(c Content)
	SwapContent(c Content) tea.Cmd
	PushOverlay(o Overlay) tea.Cmd
	PopOverlay()
	OverlayOpen() bool
	RunCommand(id string) tea.Cmd
	RegisterCommand(c Command, keys ...string)
}

type KeyMap struct {
	// contains filtered or unexported fields
}

type Options struct {
	// Content is the main screen (required for a useful app).
	Content Content
	// Header renders above the main content each frame (optional).
	Header func(ctx Context) string
	// Footer renders below the main content each frame (optional).
	Footer func(ctx Context) string
	// WindowTitle sets the terminal window title when non-empty.
	WindowTitle string
	// WindowTitleFunc overrides WindowTitle each frame when set.
	WindowTitleFunc func(ctx Context) string
	// QuitKeys binds extra keys to the quit command (ctrl+c is always bound
	// unless DisableDefaultKeys is set).
	QuitKeys []string
	// DisableDefaultKeys skips the default ctrl+c quit binding.
	DisableDefaultKeys bool
	// Bindings are extra key bindings.
	Bindings []Binding
	// FullscreenOverlay when true (default) replaces the entire view with the
	// top overlay. When false, the overlay replaces only the main region and
	// the header/footer chrome stays visible.
	FullscreenOverlay *bool
	// AltScreen enables the alternate screen buffer (default true).
	AltScreen *bool
	// Mouse enables cell-motion mouse when true.
	Mouse bool
}

type Overlay interface {
	// Init is called once when the overlay is pushed.
	Init() tea.Cmd
	// Update handles a message. Returning a nil overlay closes it.
	// Prefer Emit(result) for outcomes instead of getters after close.
	Update(msg tea.Msg) (next Overlay, cmd tea.Cmd)
	// View renders the overlay for the given terminal size (full screen).
	View(width, height int) string
	// ID optionally names the overlay for debugging; may be empty.
	ID() string
}

type OverlayStack struct {
	// contains filtered or unexported fields
}

type Region struct {
	Header int
	Main   int
	Footer int
	Width  int
	Height int
}

type SizePropagator interface {
	PropagateSize(width, height int)
}

type Sizeable interface {
	SetSize(width, height int)
}

type StaticContent struct {
	Text string
}