entity

type ConfigKeyInfo struct {
	// Key is the full dotted path to the config key (e.g., "appearance.color_scheme")
	Key string `json:"key"`

	// Type is the Go type name (e.g., "string", "int", "bool", "float64")
	Type string `json:"type"`

	// Default is the default value as a string representation
	Default string `json:"default"`

	// Description explains the purpose of this config key
	Description string `json:"description"`

	// Values contains valid enum values (for string enums)
	// Empty if not an enum type
	Values []string `json:"values,omitempty"`

	// Range describes numeric constraints (e.g., "1-72", "0.1-5.0")
	// Empty if no range constraint
	Range string `json:"range,omitempty"`

	// Section groups related keys (e.g., "Appearance", "Logging")
	Section string `json:"section"`
}

type DailyVisitCount struct {
	Day     string `json:"day"`
	Entries int64  `json:"entries"`
	Visits  int64  `json:"visits"`
}

type DomainStat struct {
	Domain      string    `json:"domain"`
	PageCount   int64     `json:"page_count"`
	TotalVisits int64     `json:"total_visits"`
	LastVisit   time.Time `json:"last_visit"`
}

type Favorite struct {
	ID          FavoriteID `json:"id"`
	URL         string     `json:"url"`
	Title       string     `json:"title"`
	FaviconURL  string     `json:"favicon_url"`
	FolderID    *FolderID  `json:"folder_id"`    // nil = root level
	ShortcutKey *int       `json:"shortcut_key"` // 1-9 for quick access (Alt+1 through Alt+9)
	Position    int        `json:"position"`     // Order within folder
	Tags        []Tag      `json:"tags,omitempty"`
	CreatedAt   time.Time  `json:"created_at"`
	UpdatedAt   time.Time  `json:"updated_at"`
}

type FavoriteID int64

type FavoriteTree struct {
	RootFolders    []*Folder
	RootFavorites  []*Favorite
	FolderMap      map[FolderID]*Folder     // Quick lookup
	ChildFolders   map[FolderID][]*Folder   // Children of each folder
	ChildFavorites map[FolderID][]*Favorite // Favorites in each folder
}

type Folder struct {
	ID        FolderID  `json:"id"`
	Name      string    `json:"name"`
	Icon      string    `json:"icon"`      // Optional icon identifier
	ParentID  *FolderID `json:"parent_id"` // nil = root level
	Position  int       `json:"position"`  // Order within parent
	CreatedAt time.Time `json:"created_at"`
}

type FolderID int64

type HistoryAnalytics struct {
	TotalEntries       int64                 `json:"total_entries"`
	TotalVisits        int64                 `json:"total_visits"`
	UniqueDays         int64                 `json:"unique_days"`
	TopDomains         []*DomainStat         `json:"top_domains"`
	DailyVisits        []*DailyVisitCount    `json:"daily_visits"`
	HourlyDistribution []*HourlyDistribution `json:"hourly_distribution"`
}

type HistoryEntry struct {
	ID          int64     `json:"id"`
	URL         string    `json:"url"`
	Title       string    `json:"title"`
	FaviconURL  string    `json:"favicon_url"`
	VisitCount  int64     `json:"visit_count"`
	LastVisited time.Time `json:"last_visited"`
	CreatedAt   time.Time `json:"created_at"`
}

type HistoryMatch struct {
	Entry *HistoryEntry
	Score float64 // Match score (higher is better)
}

type HistoryStats struct {
	TotalEntries int64 `json:"total_entries"`
	TotalVisits  int64 `json:"total_visits"`
	UniqueDays   int64 `json:"unique_days"`
}

type HourlyDistribution struct {
	Hour       int   `json:"hour"`
	VisitCount int64 `json:"visit_count"`
}

type IDGenerator func() string

type Pane struct {
	ID         PaneID
	URI        string
	Title      string
	FaviconURL string
	WindowType WindowType
	ZoomFactor float64
	CanGoBack  bool
	CanForward bool
	IsLoading  bool
	CreatedAt  time.Time

	// Popup-specific fields
	IsRelated    bool    // Shares context with parent
	ParentPaneID *PaneID // Parent pane if this is a related popup
	AutoClose    bool    // Auto-close on OAuth success
	RequestID    string  // Request ID for popup tracking
}

type PaneID string

type PaneNode struct {
	ID       string
	Pane     *Pane     // Non-nil for leaf nodes
	Parent   *PaneNode // nil for root
	Children []*PaneNode

	// Layout
	SplitDir   SplitDirection
	SplitRatio float64 // 0.0-1.0, position of divider

	// Stacked panes (alternative to split)
	IsStacked        bool
	ActiveStackIndex int
}

type PaneNodeSnapshot struct {
	ID               string              `json:"id"`
	Pane             *PaneSnapshot       `json:"pane,omitempty"`     // Non-nil for leaf nodes
	Children         []*PaneNodeSnapshot `json:"children,omitempty"` // Non-nil for containers
	SplitDir         SplitDirection      `json:"split_dir"`
	SplitRatio       float64             `json:"split_ratio"`
	IsStacked        bool                `json:"is_stacked"`
	ActiveStackIndex int                 `json:"active_stack_index"`
}

type PaneRect struct {
	PaneID PaneID
	X, Y   int // Top-left position relative to workspace container
	W, H   int // Width and height
}

type PaneSnapshot struct {
	ID         PaneID  `json:"id"`
	URI        string  `json:"uri"`
	Title      string  `json:"title"`
	ZoomFactor float64 `json:"zoom_factor"`
}

type PurgeResult struct {
	Target  PurgeTarget
	Success bool
	Error   error
}

type PurgeTarget struct {
	Type        PurgeTargetType
	Path        string
	Description string
	Size        int64
	Exists      bool
}

type PurgeTargetType int

type Session struct {
	ID        SessionID
	Type      SessionType
	StartedAt time.Time
	EndedAt   *time.Time
}

type SessionID string

type SessionInfo struct {
	Session   *Session
	State     *SessionState
	TabCount  int
	PaneCount int
	IsActive  bool      // Has active lock file
	IsCurrent bool      // Is the current session
	UpdatedAt time.Time // When the state was last saved
}

type SessionPurgeItem struct {
	Info     SessionInfo
	Selected bool
}

type SessionState struct {
	Version        int           `json:"version"`
	SessionID      SessionID     `json:"session_id"`
	Tabs           []TabSnapshot `json:"tabs"`
	ActiveTabIndex int           `json:"active_tab_index"`
	SavedAt        time.Time     `json:"saved_at"`
}

type SessionType string

type SplitDirection int

type Tab struct {
	ID        TabID
	Name      string     // Display name (often derived from active pane title)
	Workspace *Workspace // The workspace this tab contains
	Position  int        // Position in the tab bar (0-indexed)
	IsPinned  bool       // Pinned tabs stay at the left
	CreatedAt time.Time
}

type TabID string

type TabList struct {
	Tabs                []*Tab
	ActiveTabID         TabID
	PreviousActiveTabID TabID // Tracks last active tab for Alt+Tab style switching
}

type TabSnapshot struct {
	ID        TabID             `json:"id"`
	Name      string            `json:"name"`
	Position  int               `json:"position"`
	IsPinned  bool              `json:"is_pinned"`
	Workspace WorkspaceSnapshot `json:"workspace"`
}

type Tag struct {
	ID        TagID     `json:"id"`
	Name      string    `json:"name"`
	Color     string    `json:"color"` // Hex color code (e.g., "#FF5733")
	CreatedAt time.Time `json:"created_at"`
}

type TagID int64

type UpdateInfo struct {
	// CurrentVersion is the version of the running binary.
	CurrentVersion string
	// LatestVersion is the latest available version from GitHub.
	LatestVersion string
	// IsNewer is true if LatestVersion is newer than CurrentVersion.
	IsNewer bool
	// ReleaseURL is the URL to the GitHub release page.
	ReleaseURL string
	// DownloadURL is the direct download URL for the binary archive.
	DownloadURL string
	// PublishedAt is when the release was published.
	PublishedAt time.Time
	// ReleaseNotes contains the release changelog (optional).
	ReleaseNotes string
}

type UpdateStatus int

type WindowType int

type Workspace struct {
	ID           WorkspaceID
	Name         string
	Root         *PaneNode // Root of the pane tree
	ActivePaneID PaneID    // Currently focused pane
	CreatedAt    time.Time
}

type WorkspaceID string

type WorkspaceSnapshot struct {
	ID           WorkspaceID       `json:"id"`
	Root         *PaneNodeSnapshot `json:"root"`
	ActivePaneID PaneID            `json:"active_pane_id"`
}

type ZoomLevel struct {
	Domain     string  // Domain name (e.g., "github.com")
	ZoomFactor float64 // Zoom factor (1.0 = 100%, 1.5 = 150%)
	UpdatedAt  time.Time
}