core

type App struct {

	// Reconfigure is the wiring layer's hook for a config hot-reload: given the
	// fresh config it re-registers config-derived sections and returns the new
	// tab order plus the section IDs whose cached instances must be rebuilt
	// (their config may have changed). Nil disables structural reloads — the
	// App still swaps ctx.Config so value-only settings (refresh interval)
	// apply.
	Reconfigure func(ctx *ProgramContext, registry *Registry, cfg *config.Config) (order, invalidate []SectionID)
	// contains filtered or unexported fields
}

type ConfigReloadedMsg struct{ Config *config.Config }

type Counter interface {
	Count() (n int, ok bool)
}

type ErrorMsg struct{ Err error }

type Lens struct {
	Name string
	JQL  string
}

type PreviewPosition string

type ProgramContext struct {
	// Terminal geometry.
	ScreenWidth  int
	ScreenHeight int

	// Computed body regions. MainWidth/Height is the list area; Preview* is the
	// sidebar. Preview dimensions are zero when the sidebar is closed.
	// BodyHeight is the full region between the chrome (the whole list+sidebar
	// area), used by full-body views like the issue detail.
	MainWidth     int
	MainHeight    int
	PreviewWidth  int
	PreviewHeight int
	BodyHeight    int

	// SidebarOpen toggles the issue preview pane.
	SidebarOpen bool

	Styles Styles
	Keys   keys.Map
	// Lenses are the config-supplied quick-filters for the issues section
	// ([[tui.lenses]]); empty means the section's built-ins apply.
	// DefaultLens names the landing lens by title (case-insensitive).
	Lenses      []Lens
	DefaultLens string
	// Recent is the app-wide recently-viewed issue jumplist (ctrl+o).
	Recent *RecentList
	// Activity is the app-wide record of user-facing mutations, surfaced in the
	// footer status slot and the operation-log overlay. Sections write to it
	// (Start/Finish/Fail); only the footer and log read it back.
	Activity *activity.Registry
	Config   *config.Config
	View     SectionID
	Err      error
	Services Services

	// Profile context for the footer chrome: which profile/project/board the
	// dashboard is pointed at. All optional; empty fields are omitted.
	ProfileName string
	Project     string
	Board       string
	// Version is the build version shown right of the tab bar.
	// Empty hides the brand label.
	Version string
	// ConfigPath is the loaded config file's location, used by the settings
	// section to display it and to watch it for hot-reload. Empty disables
	// reloading.
	ConfigPath string
	// BaseURL is the Jira site root (e.g. https://acme.atlassian.net), used to
	// build issue links for "open in browser" and "copy url".
	BaseURL string
	// DefaultIssueType is the profile's issue type for creates ("" means the
	// caller picks a fallback).
	DefaultIssueType string
	// WorkdaySeconds is the active profile's working-day length, used to parse
	// relative worklog durations like "1d". Zero falls back to 8 hours.
	WorkdaySeconds int

	// Base is the program's root context, used to cancel in-flight Jira calls
	// launched from sections when the app shuts down.
	Base context.Context //nolint:containedctx // sections launch async Jira calls from Update, which has no context parameter; the program's root context is shared state by design

	// StartTask is wired by the App so any Section can launch async work that
	// flows back as a TaskFinishedMsg with generation tracking.
	StartTask func(TaskSpec) tea.Cmd
	// contains filtered or unexported fields
}

type RecentIssue struct {
	Key     string
	Summary string
}

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

type RefreshTickMsg struct{}

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

type RestyleMsg struct{}

type Section interface {
	// ID is the stable identifier used for tab routing and the registry.
	ID() SectionID
	// Title is the human label shown in the tab bar.
	Title() string
	// Init wires the shared context and returns any startup command
	// (typically the first data fetch).
	Init(ctx *ProgramContext) tea.Cmd
	// Update handles a message and returns the (possibly new) Section value
	// plus a command. Value semantics keep Sections cheap to copy and easy
	// to test.
	Update(msg tea.Msg) (Section, tea.Cmd)
	// View renders the section body. The App owns the surrounding chrome
	// (tab bar, footer) and the sidebar split lives in ProgramContext.
	View() string
	// HelpBindings returns the bindings shown in the contextual help bar for
	// this section in its current state.
	HelpBindings() []key.Binding
	// CapturesInput reports whether the section is currently consuming raw key
	// input (e.g. a filter or editor is focused). When true, the App routes
	// keys to the section before applying global shortcuts, so typing a query
	// containing "q" or "tab" does not quit or switch views.
	CapturesInput() bool
}

type SectionFactory func(ctx *ProgramContext) Section

type SectionID string

type SectionMsg interface {
	Section() SectionID
}

type Services interface {
	Issues() jira.IssueService
	Search() jira.SearchService
	JQL() jira.JQLService
	Users() jira.UserService
	Worklogs() jira.WorklogService
	// Projects backs the create form's issue-type list (ListIssueTypes).
	Projects() jira.ProjectService
	// Labels backs the create form's label suggestions.
	Labels() jira.LabelService
}

type Styles struct {
	Header             lipgloss.Style
	HeaderRule         lipgloss.Style // wraps the tab row, drawing the bottom divider
	TabActive          lipgloss.Style // selected section pill
	TabInactive        lipgloss.Style // unselected section pill
	Brand              lipgloss.Style // product label right of the tab row
	Footer             lipgloss.Style
	FooterRule         lipgloss.Style // dim style for the labeled-border dashes
	HintKey            lipgloss.Style // key glyphs in the footer hint line
	HintDesc           lipgloss.Style // descriptions in the footer hint line
	Error              lipgloss.Style
	Sidebar            lipgloss.Style
	SidebarBorder      lipgloss.Style // left-edge divider (sidebar docked right)
	SidebarBorderRight lipgloss.Style // right-edge divider (sidebar docked left)
	SidebarBorderTop   lipgloss.Style // top-edge divider (sidebar docked bottom)
	Overlay            lipgloss.Style // bordered modal box for the action controller
	HelpBox            lipgloss.Style // bordered box for the full-keymap help sheet
}

type TaskFinishedMsg = task.FinishedMsg

type TaskManager = task.Manager

type TaskScope = task.Scope

type TaskSpec = task.Spec

type ThemePreviewMsg struct{ Name string }