monitor

type ActivityItem struct {
	Timestamp  time.Time
	SessionID  string
	Type       string // "log", "action", "comment"
	IssueID    string
	IssueTitle string // title of the associated issue
	Message    string
	LogType    models.LogType    // for logs
	Action     models.ActionType // for actions
}

type BoardEditorDeleteResultMsg struct {
	BoardID string
	Error   error
}

type BoardEditorQueryPreviewMsg struct {
	Query  string // Query that was executed (for staleness check)
	Count  int
	Titles []string // First 5 issue titles
	Error  error
}

type BoardEditorSaveResultMsg struct {
	Board *models.Board
	IsNew bool // true if newly created, false if updated
	Error error
}

type BoardIssuesMsg struct {
	BoardID     string
	Issues      []models.BoardIssueView
	RejectedIDs map[string]bool // pre-computed to avoid sync query in Update
	Error       error
}

type BoardMode struct {
	Board        *models.Board           // Currently active board
	Issues       []models.BoardIssueView // Issues in the board (for backlog view)
	Cursor       int                     // Selected issue index (backlog view)
	ScrollOffset int                     // Scroll offset for long lists (backlog view)
	StatusFilter map[models.Status]bool  // Status filter (true = visible)

	// View mode toggle (swimlanes vs backlog)
	ViewMode BoardViewMode // Current view mode

	// Swimlanes view state (separate cursor/scroll from backlog)
	SwimlaneData   TaskListData  // Categorized data for swimlanes view
	SwimlaneRows   []TaskListRow // Flattened rows for swimlanes view
	SwimlaneCursor int           // Cursor position in swimlanes view
	SwimlaneScroll int           // Scroll offset in swimlanes view

	// Selection restoration after move operations
	PendingSelectionID string // Issue ID to select after refresh (cleared after use)
}

type BoardViewMode int

type BoardsDataMsg struct {
	Boards []models.Board
	Error  error
}

type ClearStatusMsg struct{}

type EditorField int

type EditorFinishedMsg struct {
	Field   EditorField
	Content string
	Error   error
}

type EmbeddedOptions struct {
	BaseDir       string        // Base directory for database and config
	Interval      time.Duration // Refresh interval
	Version       string        // Version string for display
	PanelRenderer PanelRenderer // Custom panel border renderer (nil = default lipgloss)
	ModalRenderer ModalRenderer // Custom modal border renderer (nil = default lipgloss)

	// MarkdownTheme configures markdown rendering to share themes with embedder.
	// Pass colors from your theme to get consistent syntax highlighting.
	// If nil, uses td's default ANSI 256 color palette.
	MarkdownTheme *MarkdownThemeConfig
}

type FirstRunCheckMsg struct {
	IsFirstRun      bool   // true if should show getting started modal
	AgentFilePath   string // detected file path (may be empty)
	HasInstructions bool   // true if agent file already has td instructions
}

type FormMode string

type FormState struct {
	Mode     FormMode
	Form     *huh.Form
	IssueID  string // For edit mode - the issue being edited
	ParentID string // For create mode - auto-populated parent epic

	// Bound form values (standard fields)
	Title       string
	Type        string
	Priority    string
	Description string
	Labels      string // Comma-separated

	// Extended fields (toggled with Tab)
	ShowExtended bool
	Parent       string // Parent epic ID
	Points       string // String for select options
	Acceptance   string
	Minor        bool
	Dependencies string // Comma-separated issue IDs

	// Button focus: -1 = form fields focused, 0 = submit, 1 = cancel
	ButtonFocus int
	ButtonHover int // 0 = none, 1 = submit, 2 = cancel

	// Width for form fields (set from modal dimensions, reapplied on rebuild)
	Width int
}

type HandoffsDataMsg struct {
	Data  []models.Handoff
	Error error
}

type InstallInstructionsResultMsg struct {
	Success bool
	Message string // e.g. "Added td instructions to AGENTS.md"
}

type IssueDetailsMsg struct {
	IssueID    string
	Issue      *models.Issue
	Handoff    *models.Handoff
	Logs       []models.Log
	Comments   []models.Comment
	BlockedBy  []models.Issue // Dependencies (issues blocking this one)
	Blocks     []models.Issue // Dependents (issues blocked by this one)
	EpicTasks  []models.Issue // Child tasks (when issue is an epic)
	ParentEpic *models.Issue  // Parent epic (when issue.ParentID is set)
	Error      error
}

type MarkdownColorPalette struct {
	Primary   string // Keywords, functions, links - e.g., "#7C3AED"
	Secondary string // Strings, secondary headers - e.g., "#3B82F6"
	Success   string // Comments - e.g., "#10B981"
	Warning   string // Numbers, literals, inline code - e.g., "#F59E0B"
	Error     string // Errors, deleted - e.g., "#EF4444"
	Muted     string // Punctuation, subtle text - e.g., "#6B7280"
	Text      string // Primary text - e.g., "#F9FAFB"
	BgCode    string // Code block background - e.g., "#374151"
}

type MarkdownRenderedMsg struct {
	IssueID      string
	DescRender   string
	AcceptRender string
}

type MarkdownThemeConfig struct {
	// SyntaxTheme is a Chroma theme name (e.g., "monokai", "dracula", "github-dark").
	// When set, uses glamour's built-in style with this syntax theme.
	// See https://xyproto.github.io/splash/docs/ for available themes.
	SyntaxTheme string

	// MarkdownTheme is a glamour base theme ("dark" or "light").
	// Only used when SyntaxTheme is set.
	MarkdownTheme string

	// Colors provides explicit hex colors for custom styling.
	// When set (Primary != ""), builds a custom style from these colors.
	// Takes precedence over SyntaxTheme/MarkdownTheme.
	Colors *MarkdownColorPalette
}

type ModalEntry struct {
	// Core
	IssueID     string
	SourcePanel Panel // Only meaningful for base entry (depth 1)

	// Display
	Scroll       int
	ContentLines int // Cached content line count for scroll clamping

	// Async data
	Loading      bool
	Error        error
	Issue        *models.Issue
	Handoff      *models.Handoff
	Logs         []models.Log
	Comments     []models.Comment
	BlockedBy    []models.Issue
	Blocks       []models.Issue
	DescRender   string
	AcceptRender string

	// Epic-specific (when Issue.Type == "epic")
	EpicTasks          []models.Issue
	EpicTasksCursor    int
	TaskSectionFocused bool

	// Parent epic (when issue has ParentID pointing to an epic)
	ParentEpic        *models.Issue
	ParentEpicFocused bool

	// Navigation scope - when set, l/r navigates within this list instead of source panel
	// Used when opening issues from within an epic to scope navigation to siblings
	NavigationScope []models.Issue

	// Blocked-by section (dependencies blocking this issue)
	BlockedBySectionFocused bool
	BlockedByCursor         int

	// Blocks section (issues blocked by this one)
	BlocksSectionFocused bool
	BlocksCursor         int

	// Line tracking for mouse click support (set during render)
	BlockedByStartLine int // Line index where blocked-by section starts
	BlockedByEndLine   int // Line index where blocked-by section ends
	BlocksStartLine    int // Line index where blocks section starts
	BlocksEndLine      int // Line index where blocks section ends
}

type ModalRenderer func(content string, width, height int, modalType ModalType, depth int) string

type ModalType int

type Model struct {
	// Database and session
	DB        *db.DB
	SessionID string

	// Window dimensions
	Width  int
	Height int

	// Panel data
	FocusedIssue   *models.Issue
	InProgress     []models.Issue
	Activity       []ActivityItem
	TaskList       TaskListData
	RecentHandoffs []RecentHandoff // Handoffs since monitor started
	ActiveSessions []string        // Sessions with recent activity

	// UI state
	ActivePanel         Panel
	ScrollOffset        map[Panel]int
	Cursor              map[Panel]int    // Per-panel cursor position (selected row)
	SelectedID          map[Panel]string // Per-panel selected issue ID (preserved across refresh)
	ScrollIndependent   map[Panel]bool   // True when user scrolled viewport away from cursor
	HelpOpen            bool             // Whether help modal is open
	HelpScroll          int              // Current scroll position in help
	HelpTotalLines      int              // Cached total line count in help
	ShowTDQHelp         bool             // Show TDQ query syntax help (when in search mode)
	TDQHelpModal        *modal.Modal     // Declarative modal instance for TDQ help
	TDQHelpMouseHandler *mouse.Handler   // Mouse handler for TDQ help modal
	LastRefresh         time.Time
	StartedAt           time.Time // When monitor started, to track new handoffs
	Err                 error     // Last error, if any
	Embedded            bool      // When true, skip footer (embedded in sidecar)

	// Flattened rows for selection
	TaskListRows    []TaskListRow // Flattened task list for selection
	CurrentWorkRows []string      // Issue IDs for current work panel (focused + in-progress)

	// Modal stack for stacking modals (empty = no modal open)
	ModalStack []ModalEntry

	// Search state
	SearchMode     bool            // Whether search mode is active
	SearchQuery    string          // Current search query
	SearchInput    textinput.Model // Text input for search (cursor support)
	IncludeClosed  bool            // Whether to include closed tasks
	SortMode       SortMode        // Task list sort order
	TypeFilterMode TypeFilterMode  // Type filter (epic, task, bug, etc.)

	// Confirmation dialog state (delete confirmation)
	ConfirmOpen        bool
	ConfirmAction      string // "delete"
	ConfirmIssueID     string
	ConfirmTitle       string
	ConfirmButtonFocus int // 0=Yes, 1=No (for delete confirmation) - legacy, kept for compatibility
	ConfirmButtonHover int // 0=none, 1=Yes, 2=No - legacy, kept for compatibility

	// Declarative delete confirmation modal
	DeleteConfirmModal        *modal.Modal   // Declarative modal instance
	DeleteConfirmMouseHandler *mouse.Handler // Mouse handler for delete confirmation modal

	// Close confirmation dialog state
	CloseConfirmOpen        bool
	CloseConfirmIssueID     string
	CloseConfirmTitle       string
	CloseConfirmInput       textinput.Model
	CloseConfirmButtonFocus int // 0=input, 1=Confirm, 2=Cancel - legacy, kept for compatibility
	CloseConfirmButtonHover int // 0=none, 1=Confirm, 2=Cancel - legacy, kept for compatibility

	// Declarative close confirmation modal
	CloseConfirmModal        *modal.Modal   // Declarative modal instance
	CloseConfirmMouseHandler *mouse.Handler // Mouse handler for close confirmation modal

	// Stats modal state
	StatsOpen         bool
	StatsLoading      bool
	StatsData         *StatsData
	StatsScroll       int
	StatsError        error
	StatsModal        *modal.Modal   // Declarative modal instance
	StatsMouseHandler *mouse.Handler // Mouse handler for stats modal

	// Handoffs modal state
	HandoffsOpen         bool
	HandoffsLoading      bool
	HandoffsData         []models.Handoff
	HandoffsCursor       int
	HandoffsScroll       int
	HandoffsError        error
	HandoffsModal        *modal.Modal   // Declarative modal instance
	HandoffsMouseHandler *mouse.Handler // Mouse handler for handoffs modal

	// Form modal state
	FormOpen  bool
	FormState *FormState

	// Getting Started modal state
	GettingStartedOpen         bool           // Whether getting started modal is open
	GettingStartedModal        *modal.Modal   // Declarative modal instance
	GettingStartedMouseHandler *mouse.Handler // Mouse handler for getting started modal
	AgentFilePath              string         // Detected agent file path (may be empty)
	AgentFileHasTD             bool           // Whether agent file already has td instructions

	// Board picker state
	BoardPickerOpen         bool
	BoardPickerCursor       int
	BoardPickerHover        int // -1=none, 0+=hovered board index (legacy, used by modal)
	AllBoards               []models.Board
	BoardPickerModal        *modal.Modal   // Declarative modal instance
	BoardPickerMouseHandler *mouse.Handler // Mouse handler for board picker modal

	// Board editor modal state (edit/create/info overlay on board picker)
	BoardEditorOpen          bool
	BoardEditorMode          string        // "edit", "create", "info" (builtin read-only)
	BoardEditorBoard         *models.Board // Board being edited (nil for create)
	BoardEditorNameInput     *textinput.Model
	BoardEditorQueryInput    *textarea.Model
	BoardEditorModal         *modal.Modal            // Declarative modal instance
	BoardEditorMouseHandler  *mouse.Handler          // Mouse handler
	BoardEditorPreview       *boardEditorPreviewData // Shared pointer: survives stale closure captures
	BoardEditorDeleteConfirm bool                    // Whether delete confirmation is active

	// Board mode state
	TaskListMode      TaskListMode       // Whether Task List shows categorized or board view
	BoardMode         BoardMode          // Active board mode state
	BoardStatusPreset StatusFilterPreset // Current status filter preset for cycling

	// Configuration
	RefreshInterval time.Duration

	// Keymap registry for keyboard shortcuts
	Keymap *keymap.Registry

	// Status message (temporary feedback, e.g., "Copied to clipboard")
	StatusMessage string
	StatusIsError bool // true for error messages, false for success

	// Version checking
	Version     string // Current version
	UpdateAvail *version.UpdateAvailableMsg

	// Mouse support - panel bounds for hit-testing
	PanelBounds    map[Panel]Rect
	HoverPanel     Panel     // Panel currently under mouse cursor (-1 for none)
	LastClickTime  time.Time // For double-click detection
	LastClickPanel Panel     // Panel of last click
	LastClickRow   int       // Row of last click

	// Pane resizing (drag-to-resize)
	PaneHeights      [3]float64 // Height ratios (sum=1.0)
	DividerBounds    [2]Rect    // Hit regions for the 2 dividers between 3 panes
	DraggingDivider  int        // -1 = not dragging, 0 = first divider, 1 = second
	DividerHover     int        // -1 = none, 0 or 1 = which divider is hovered
	DragStartY       int        // Y position when drag started
	DragStartHeights [3]float64 // Pane heights when drag started
	BaseDir          string     // Base directory for config persistence

	// Clipboard function (nil = real system clipboard)
	ClipboardFn func(string) error

	// Custom renderers (for embedding with custom theming)
	PanelRenderer PanelRenderer // Custom panel border renderer (nil = default lipgloss)
	ModalRenderer ModalRenderer // Custom modal border renderer (nil = default lipgloss)

	// Markdown theme (for embedding with shared theme)
	MarkdownTheme *MarkdownThemeConfig // Custom markdown/syntax theme (nil = default td colors)
}

type OpenIssueByIDMsg struct {
	IssueID string
}

type PaneHeightsSavedMsg struct {
	Error error
}

type Panel int

type PanelRenderer func(content string, width, height int, state PanelState) string

type PanelState int

type RecentHandoff struct {
	IssueID   string
	SessionID string
	Timestamp time.Time
}

type Rect struct {
	X, Y, W, H int
}

type RefreshDataMsg struct {
	FocusedIssue   *models.Issue
	InProgress     []models.Issue
	Activity       []ActivityItem
	TaskList       TaskListData
	RecentHandoffs []RecentHandoff
	ActiveSessions []string
	Timestamp      time.Time
}

type RestoreFilterMsg struct {
	SearchQuery    string
	SortMode       SortMode
	TypeFilterMode TypeFilterMode
	IncludeClosed  bool
}

type RestoreLastBoardMsg struct {
	Board *models.Board
}

type SendTaskToWorktreeMsg struct {
	TaskID    string
	TaskTitle string
}

type SortMode int

type StatsData struct {
	ExtendedStats *models.ExtendedStats
	Error         error
}

type StatsDataMsg struct {
	Data  *StatsData
	Error error
}

type StatusFilterPreset int

type TaskListCategory string

type TaskListData struct {
	Ready       []models.Issue
	Reviewable  []models.Issue
	NeedsRework []models.Issue
	Blocked     []models.Issue
	Closed      []models.Issue
}

type TaskListMode int

type TaskListRow struct {
	Issue    models.Issue
	Category TaskListCategory
}

type TickMsg time.Time

type TypeFilterMode int