types

type Binding struct {
	Key         Key
	Modifier    gocui.Modifier
	Handler     func() error
	Description string
	Tag         string // e.g. "navigation", used for grouping in help views
}

type ConfirmOpts struct {
	Title         string
	Prompt        string
	HandleConfirm func() error
	HandleClose   func() error
}

type Context interface {
	IBaseContext

	HandleFocus(opts OnFocusOpts)
	HandleFocusLost(opts OnFocusLostOpts)
	HandleRender()
}

type ContextKey string

type ContextKind int

type IBaseContext interface {
	GetKey() ContextKey
	GetKind() ContextKind
	GetViewName() string
	GetView() *gocui.View
	IsFocusable() bool
	Title() string
}

type IController interface {
	GetKeybindings() []*Binding
	Context() Context
}

type IControllerHost interface {
	IGuiCommon

	// Command lifecycle
	TryStartCommand(name string) bool
	LogCommandBlocked(name string)
	FinishCommand()

	// Full refresh with callbacks
	RefreshAll(onComplete ...func()) bool
	RefreshPanels()
}

type IGuiCommon interface {
	IPopupHandler

	// LogAction logs a user-visible action to the output panel.
	LogAction(action string, detail ...string)
	// Refresh triggers a data refresh and re-render of all contexts.
	Refresh()
	// OnUIThread schedules a function to run on the UI thread.
	OnUIThread(f func() error)
	// GetTranslationSet returns the current translation set.
	GetTranslationSet() *i18n.TranslationSet
}

type IListContext interface {
	Context

	GetSelectedIdx() int
	GetItemCount() int
	SelectNext()
	SelectPrev()
}

type IPopupHandler interface {
	// Alert shows a simple notification popup.
	Alert(title string, message string)
	// Confirm shows a yes/no confirmation popup.
	Confirm(opts ConfirmOpts)
	// Prompt shows a text-input popup.
	Prompt(opts PromptOpts)
	// Menu shows a list of selectable options.
	Menu(opts MenuOpts) error
	// Toast shows a brief, non-blocking message.
	Toast(message string)
	// ErrorHandler is the global error handler for gocui.
	ErrorHandler(err error) error
}

type IScrollableContext interface {
	Context

	ScrollUp()
	ScrollDown()
	ScrollToTop()
	ScrollToBottom()
}

type ITabbedContext interface {
	Context

	NextTab()
	PrevTab()
	GetCurrentTab() string
}

type Key = any

type KeybindingsFn func() []*Binding

type MenuItem struct {
	Label       string
	OnPress     func() error
	Description string
}

type MenuOpts struct {
	Title string
	Items []*MenuItem
}

type OnFocusLostOpts struct {
	NewContextKey ContextKey
}

type OnFocusOpts struct {
	ClickedViewLineIdx int
}

type PromptOpts struct {
	Title            string
	InitialContent   string
	HandleConfirm    func(string) error
	Required         bool
	Subtitle         string
	OnValidationFail func(string)
}