common

type AppController interface {
	RefreshCurrentView()
	ActivateCmd(initial string)
	SwitchTo(viewName string)
	ExecuteCmd(cmd string)

	// Accessors
	GetPages() *tview.Pages
	GetTviewApp() *tview.Application
	GetScreen() tcell.Screen
	GetDocker() *dao.DockerClient
	GetConfig() *config.Config

	// Actions
	PerformAction(action func(id string) error, actionName string, color tcell.Color)
	GetActionState(viewName string, id string) (string, tcell.Color, bool)
	InspectCurrentSelection()

	// State
	IsReadOnly() bool
	GetActiveScope() *Scope
	SetActiveScope(scope *Scope)
	SetFilter(filter string)
	SetFlashText(text string)
	SetFlashMessage(text string, duration time.Duration)
	SetFlashError(text string)
	SetFlashPending(text string)
	SetFlashSuccess(text string)
	AppendFlash(text string, duration ...time.Duration)
	AppendFlashError(text string, duration ...time.Duration)
	AppendFlashPending(text string, duration ...time.Duration)
	AppendFlashSuccess(text string, duration ...time.Duration)
	RestoreFocus()

	// Direct access for command component (needed for handlers)
	GetActiveFilter() string
	SetActiveFilter(filter string)

	// Layout management
	SetCmdLineVisible(visible bool)
	SetFullscreen(enabled bool)
	UpdateShortcuts()

	ScheduleViewHighlight(viewName string, match func(dao.Resource) bool, bg, fg tcell.Color, duration time.Duration)

	// Inspector Management
	OpenInspector(inspector Inspector)
	CloseInspector()

	// Async Task Management
	RunInBackground(task func())
	SetPaused(paused bool)

	// Context Management
	SetDefaultContext(contextName string)
	ReloadContext(contextName string)

	// Port-Forward Management
	GetPortForwardManager() *portforward.Manager

	// Refactoring: Auto Refresh Control
	StartAutoRefresh()
	StopAutoRefresh()
}

type Inspector interface {
	// GetPrimitive returns the tview component to be displayed
	GetPrimitive() tview.Primitive

	// GetID returns a unique ID for this inspector instance (usually "inspect")
	GetID() string

	// InputHandler handles keyboard events. Returns nil if handled.
	InputHandler(event *tcell.EventKey) *tcell.EventKey

	// Helpers for the App to display info
	GetTitle() string
	GetShortcuts() []string

	// Lifecycle
	OnMount(app AppController)
	OnUnmount()

	// ApplyFilter applies a search/filter to the inspector view
	ApplyFilter(filter string)
}

type Scope struct {
	Type       string // e.g. "compose"
	Value      string // e.g. "project-name"
	Label      string // e.g. "~/docker-compose.yml"
	OriginView string // View which initiated this scope
	Parent     *Scope // Previous scope in the stack
}