tui

type AgentGroup struct {
	AgentID    string
	AgentName  string
	IsSubagent bool
	Calls      []ToolCall
	Active     bool // whether this agent is currently running
}

type BashRow struct {
	Time     string    // "14:32:08" — short time-of-day
	Command  string    // "go test ./auth/..."
	Duration string    // "12s" / "<1s" / "" when running
	State    CallState // CallDone / CallActive / CallFailed
}

type BootScreen struct {
	// Active is true while the splash is on screen. The model gates the
	// regular View() pipeline on this and routes the next FrameMsg into
	// Advance(). Cleared by Dismiss() (any key) or auto-finish.
	Active bool
	// Tick counts FrameMsg ticks since the splash was triggered.
	Tick int
}

type Breakpoint int

type CacheStatsView struct {
	HitRatio          float64
	FromCache         int64
	Recomputed        int64
	BiggestMissTokens int64
	BiggestMissAt     string // formatted "HH:MM"
	Trend             []float64
	TurnCount         int
}

type CallState int

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

type Column struct {
	Content string
	Width   int
}

type CompactionState int

type Config struct {
	Layout   LayoutConfig               `toml:"layout"`
	Panels   PanelsConfig               `toml:"panels"`
	Projects map[string]ProjectOverride `toml:"projects,omitempty"`

	// AutoSwitchToAllOnNewSession controls what happens when a brand-new
	// claude code session appears in the same cwd while clyde is running.
	// When true (default), clyde flips the focused tab to Σ all so the
	// user sees both sessions at a glance and can pick. When false, the
	// user's currently-focused tab is preserved — useful if they're
	// concentrating on one session and don't want their cursor stolen.
	AutoSwitchToAllOnNewSession bool `toml:"auto_switch_to_all_on_new_session"`

	// RememberLayout controls whether runtime panel-layout changes
	// (collapse toggles via space, manual height resize via +/-) are
	// written back to the config so the next session restores the same
	// layout. When false, runtime changes stay in-session and panels
	// fall back to PanelConfig.DefaultCollapsed on next launch.
	RememberLayout bool `toml:"remember_layout"`

	// NotificationStyle chooses the visual treatment for live hook
	// prompts and compaction warnings. Defaults to fullscreen so the
	// signal is impossible to miss; the user can downgrade to banner
	// or disable entirely from the settings overlay.
	NotificationStyle NotificationStyle `toml:"notification_style"`

	// NotifyCostThresholdUSD fires a quota notification when the
	// current session's accumulated cost crosses this dollar amount.
	// Zero (default) disables cost-based alerts — plan-quota %
	// notifications still fire on their own thresholds.
	NotifyCostThresholdUSD float64 `toml:"notify_cost_threshold_usd"`

	// Theme picks the active color palette. See theme.go for the registry
	// of supported themes; defaults to ThemeTokyoNight. Cycled live from
	// the settings overlay; the choice persists in config.toml so the
	// next launch starts in the same theme.
	Theme Theme `toml:"theme"`

	// MascotPersona picks which character drives the now-panel mascot. The
	// default ("meowl") is the cat shipped in v23+; "bowl" reverts to the
	// v9–v22 rabbit; "off" hides the mascot block entirely for users who'd
	// rather see the now panel as a flat status line. The legacy "kitten" /
	// "bunny" values are still accepted on read and normalized to
	// "meowl" / "bowl" (see MascotPersona.Normalize).
	MascotPersona MascotPersona `toml:"mascot_persona"`

	// BootScreenEnabled toggles the animated splash screen shown for
	// ~1.5s on launch. Enabled by default; users who launch clyde a lot
	// in CI scripts or back-to-back can flip it off from the settings
	// overlay.
	BootScreenEnabled bool `toml:"boot_screen_enabled"`
}

type DiffKind int

type DiffLine struct {
	Kind   DiffKind
	LineNo string
	Text   string
}

type DiffSource interface {
	// Diff returns parsed unified-diff hunks for the given file in cwd.
	// If file is empty, all changed files are included.
	// Returns (nil, nil) when cwd is not a git repo or git is unavailable.
	Diff(cwd, file string) ([]livesession.DiffHunk, error)
}

type ExplorerRow struct {
	// DisplayName is the rendered node name (▼ src, Sidebar.tsx, etc.)
	DisplayName string
	// Path is the full relative path for files, dir-name for dirs.
	Path string
	// IsDir signals whether this row is a directory.
	IsDir bool
	// IsAct flags the currently active file.
	IsAct bool
	// Mark is "M", "+", or "".
	Mark string
	// Indent prefix (│ characters).
	Indent string
	// DirKey is the canonical dir name used to look up collapse state.
	DirKey string
}

type ExplorerSearch struct {
	Active  bool
	Query   string
	Matches []ExplorerSearchMatch
	Idx     int
}

type ExplorerSearchMatch struct {
	Path    string
	Display string
	IsMod   bool
}

type ExplorerSection int

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

type FileIcon struct {
	Glyph string
	Color color.Color
}

type FrameMsg struct {
	Gen uint64
}

type FrameState struct {
	Tick uint64

	// Bunny FSM — drives all mascot states and transitions.
	Mascot MascotFSM

	// Derived phases — recomputed on each tick.
	SpinnerFrame  int  // 0-3  (~333ms per frame)
	LiveDotDim    bool // alternates every 0.8s
	CursorVisible bool // alternates every 0.4s
	ChevronDim    bool // alternates every 0.7s
}

type HookNotification struct {
	// Active is true when an unanswered hook event is in flight.
	Active bool

	// Tool is the tool name, e.g. "Bash", "Edit".
	Tool string

	// KeyArg is the main argument for the tool (command, path, etc.).
	KeyArg string

	// Cwd is the working directory context for the call.
	Cwd string
}

type KeyMap struct {
	Quit      key.Binding
	Tab       key.Binding
	ShiftTab  key.Binding
	Space     key.Binding
	Up        key.Binding
	Down      key.Binding
	Left      key.Binding
	Right     key.Binding
	Enter     key.Binding
	Backspace key.Binding
	Esc       key.Binding

	// ⌃-prefixed chords dispatched by handleCtrl.
	CycleMode     key.Binding // ⌃l — cycle layout mode
	CollapseAll   key.Binding // ⌃0 — collapse every panel except the focused one
	FocusExplorer key.Binding // ⌃e — focus explorer
	FocusCalls    key.Binding // ⌃a — focus activity/calls
	FocusDiff     key.Binding // ⌃d — focus diff

	// Resize bindings — grow/shrink the focused expanded panel
	PanelGrow   key.Binding // + or = → increase panel height by 1
	PanelShrink key.Binding // - → decrease panel height by 1

	// Session cycling across the footer session-tab strip ([ / ]).
	SessionPrev key.Binding // [ — previous session tab
	SessionNext key.Binding // ] — next session tab

	// PanelJump documents the plain-letter panel jumps dispatched by
	// handlePanelJumpKey (e/a/d/u/s/b/c).
	PanelJump key.Binding

	// Overlays.
	Help     key.Binding // h — per-panel help cheat-sheet
	Settings key.Binding // ? — settings overlay (also cycles layout)

	// Numeric tab jumps for tabs mode (1..N).
	Jump1 key.Binding
	Jump2 key.Binding
	Jump3 key.Binding
	Jump4 key.Binding
}

type Layout struct {
	// Mode + breakpoint + width snapshot.
	Mode  LayoutMode
	BP    Breakpoint
	Width int

	// Chrome rows. NotifH only takes height when an actual hook or
	// compaction warning is active; StatusH grows when help is open.
	TitleH  int
	NotifH  int
	StatusH int

	// Vertical budget for panels = Height - TitleH - NotifH - StatusH,
	// floored at a per-mode minimum so degenerate window sizes don't
	// produce negative dimensions downstream.
	GridH int

	// ── 2-col (BreakpointMedium with stack mode) ────────────────────
	// LeftW + RightW = Width. ExplorerH and ServersH split the left
	// column vertically; the right column uses panelStackHeight per
	// panel (collapse spring or panelHeight()).
	LeftW     int
	RightW    int
	ExplorerH int
	ServersH  int

	// ── Multi-col (3 columns) ───────────────────────────────────────
	// MultiExplorerW takes the full GridH on the left. The middle
	// column stacks Now → Calls → optional Diff. The right column
	// stacks Usage → Servers → optional Bash → optional Cache.
	MultiExplorerW int
	MultiMiddleW   int
	MultiRightW    int
	MultiNowH      int
	MultiCallsH    int
	MultiDiffH     int
	MultiUsageH    int
	MultiServersH  int
	MultiBashH     int
	MultiCacheH    int
}

type LayoutConfig struct {
	DefaultMode         LayoutMode `toml:"default_mode"`
	AutoSwitchThreshold int        `toml:"auto_switch_threshold"`
	CycleHotkey         string     `toml:"cycle_hotkey"`
}

type LayoutMode string

type MascotBaseState int

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

type MascotPersona string

type MockData struct {
	// Title bar
	ProjectPath string
	ProjectName string
	Duration    string
	Tokens      string
	Cost        string

	// Explorer
	ModifiedFiles []ModifiedFile
	Tree          []TreeNode

	// Now panel
	NowMode    string // "writing · 47 t/s"
	NowOp      string // "edit auth.ts"
	NowMeta    string // "14 lines staged · line 46"
	NowTS      bool   // ts done
	NowLint    bool   // lint done
	NowCompile bool   // compile active (not done)

	// Calls panel (replaces tasks panel in v13)
	AgentGroups []AgentGroup

	// Diff panel
	DiffFile  string // "auth.ts · +14 −3"
	DiffLines []DiffLine
	IsGitRepo bool // true when cwd contains a .git directory

	// Usage panel
	Tokens200k int    // used out of 200k
	TokenPct   int    // 23
	Cost142    string // "$1.42"
	Turns      string // "38"
	Model      string // "opus 4.7"
	Errors     string
	Warnings   string
	Tests      string

	// Multi-window usage rows with per-token-type breakdown.
	// Each row shows label · in · out · cache · cost for one time window.
	UsageSession UsageWindowRow // this session
	Usage5h      UsageWindowRow // rolling last 5 hours
	UsageWeek    UsageWindowRow // rolling last 7 days

	// BurnRate is a derived display string shown below the usage rows:
	// e.g. "~3.2k tok/min · $0.18/hr". Empty when there is too little data.
	BurnRate string

	// PlanTier is the human-readable subscription plan tier
	// (e.g. "Max 5x", "Pro"). Empty when unknown OR when the user is
	// on API auth (in which case IsAPIUser is true and renderers show
	// "api" via that flag instead of trying to fake a tier here).
	PlanTier string

	// IsAPIUser is true when the plan-usage source returned
	// ErrPlanUsageUnavailable — the user has no subscription and is
	// paying per-token via API. Used to gate the cost-threshold
	// notification (subscribers' "cost" is mostly cosmetic) and to
	// display "api" as the tier label so the user can see at a glance
	// what mode they're in.
	IsAPIUser bool

	// PlanUsageOffline is true when the plan-usage API is unreachable or
	// the credentials are present but the request failed. Distinct from
	// IsAPIUser — offline means "we expected data and didn't get it",
	// API means "no subscription credentials by design".
	PlanUsageOffline bool

	// Servers panel
	ServersOn    int // 5
	ServersTotal int // 7
	MCPs         []Server
	LSPs         []Server

	// Bash audit panel (v22+, opt-in via settings)
	BashLog []BashRow

	// Cache efficiency panel (v22+, opt-in via settings)
	Cache CacheStatsView

	// Multi-session tab strip — one entry per session in the current cwd
	// (Σ aggregate first when populated). Populated from
	// livesession.View.SessionStats; empty in demo mode and when only a
	// single session is recently active.
	Sessions []SessionTab

	// SessionTabIndex is the index of the active tab in Sessions. -1 means
	// the Σ aggregate tab is active; 0..len(Sessions)-1 selects a specific
	// session. Default 0 (most-recently-active session).
	SessionTabIndex int

	// SessionLeaderboard mirrors Sessions for the usage panel: top sessions
	// by ContextPct desc, used to render per-session ctx bars when the Σ
	// tab is active. Empty when the panel should render its single-session
	// fallback bar.
	SessionLeaderboard []SessionTab
}

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

type ModifiedFile struct {
	Mark  string // "M" or "+"
	Path  string
	Stats string // "+14 −3" etc.
}

type NotificationStyle string

type NowStatus struct {
	// Op is the concise action string shown on line 1:
	// "edit auth.ts", "read main.go", "bash 'go test'", "thinking…", etc.
	Op string

	// Meta is the secondary detail string shown on line 2:
	// elapsed time for bash, token rate for thinking, path tail for reads.
	Meta string

	// ModeText is the header badge text (top-right of panel border):
	// "writing · NN t/s" during streaming, tool name or "idle" otherwise.
	ModeText string

	// MascotTrigger is the mascot event to fire on this status update.
	// Valid trigger values are eventHappy, eventSurprised, eventSleep.
	MascotTrigger mascotEventKind

	// HasTrigger is true when MascotTrigger should be applied.
	// Separates "no trigger" from eventBlink (index 0).
	HasTrigger bool
}

type Palette struct {
	// Surface
	Bg         color.Color // terminal surface
	Surface    color.Color // panel bg
	SurfaceAcc color.Color // focused panel interior tint

	// Borders
	BorderDim color.Color // default panel border
	BorderAcc color.Color // active/focused panel border

	// Foreground
	Text     color.Color // primary text
	TextMid  color.Color // secondary text
	TextDim  color.Color // metadata, labels
	TextFade color.Color // gutters, disabled

	// Accents
	Purple  color.Color // clyde brand, active substate
	Pink    color.Color // mascot, claude voice ONLY
	Magenta color.Color // expanded-active panel borders
	Cyan    color.Color // paths, info
	Green   color.Color // live, done, success
	Amber   color.Color // modified, warnings
	Red     color.Color // removed, errors, current file
	Orange  color.Color // grep / find tags
}

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

type PanelConfig struct {
	Enabled          bool `toml:"enabled"`
	DefaultCollapsed bool `toml:"default_collapsed"`
	Position         int  `toml:"position"`
	Height           int  `toml:"height,omitempty"`
}

type PanelID int

type PanelLayout struct {
	Height           int  `toml:"height,omitempty"`
	DefaultCollapsed bool `toml:"default_collapsed,omitempty"`
}

type PanelState int

type PanelsConfig struct {
	Now      PanelConfig `toml:"now"`
	Calls    PanelConfig `toml:"calls"` // v13: replaces tasks
	Tasks    PanelConfig `toml:"tasks"` // legacy alias — copied onto Calls in LoadConfig when [panels.calls] is absent
	Diff     PanelConfig `toml:"diff"`
	Usage    PanelConfig `toml:"usage"`
	Explorer PanelConfig `toml:"explorer"`
	Servers  PanelConfig `toml:"servers"`
	Bash     PanelConfig `toml:"bash"`  // v22+: session-wide bash command ledger
	Cache    PanelConfig `toml:"cache"` // v22+: prompt-cache efficiency dashboard
}

type ProjectOverride struct {
	Panels       map[string]bool        `toml:"panels,omitempty"`
	PanelLayouts map[string]PanelLayout `toml:"panel_layouts,omitempty"`
}

type QuotaNotification struct {
	Active   bool
	Headline string
	Detail   string
	Severity QuotaSeverity
}

type QuotaSeverity int

type Server struct {
	Status ServerStatus
	Name   string
	Count  string // tool count for MCPs; empty for LSPs
}

type ServerStatus int

type SessionTab struct {
	// ID is the session identifier; empty for the synthetic Σ aggregate
	// tab (which represents "all sessions in this cwd").
	ID session.ID

	// Label is the short text rendered inside the tab (e.g. "fix auth"
	// or a 6-char session-ID prefix). For the Σ tab this is "Σ all".
	Label string

	// Active is true for the currently-focused tab.
	Active bool

	// IsAggregate is true for the leftmost Σ tab.
	IsAggregate bool

	// ContextPct is the model-context fill percent for this session's
	// most recent assistant turn. Zero for the Σ tab.
	ContextPct int

	// Warning is true when the session is close to compaction
	// (ContextPct > sessionCtxWarnThreshold). Drives the ⚠ glyph on
	// inactive tabs so users notice the danger even when not focused on
	// that session.
	Warning bool

	// Live is true when the session was written to recently (claude code
	// still has it open). Drives the bullet glyph on the tab — orthogonal
	// to Active (which is the user's focused tab in clyde). A closed /
	// idle session that the user happens to have selected reads as
	// "[ resume ]" without a bullet; a running session that is not the
	// current tab still gets "[● label]" so the user can spot it.
	Live bool

	// Tokens is the total session token count (formatted in the panel
	// when needed). Mostly used by the Σ leaderboard view.
	Tokens int64
}

type SettingsPanelToggle struct {
	PanelID         PanelID
	Label           string
	Enabled         bool
	StartsCollapsed bool
	IsOverride      bool // true when the project layer differs from the global layer
}

type SettingsScope int

type Styles struct {
	// Panel chrome (normal border)
	Panel       lipgloss.Style
	PanelFocus  lipgloss.Style // Expanded-Passive: purple border
	PanelActive lipgloss.Style // Expanded-Active: pink double border

	// Panel label / metadata riding the border
	PanelLabel       lipgloss.Style
	PanelLabelFocus  lipgloss.Style // purple when focused (passive)
	PanelLabelActive lipgloss.Style // pink when in active mode
	PanelMeta        lipgloss.Style
	PanelModeBadge   lipgloss.Style // active-mode badge text (pink)

	// Collapsed panel one-liner summary
	PanelCollapsedLabel      lipgloss.Style // dim when blurred
	PanelCollapsedLabelFocus lipgloss.Style // purple when focused

	// Title bar
	TitleBar    lipgloss.Style
	TitleBrand  lipgloss.Style // "clyde" in purple
	TitlePath   lipgloss.Style // dim path
	TitleProjct lipgloss.Style // cyan project name
	TitleLive   lipgloss.Style // green "claude · live"
	TitleMeta   lipgloss.Style // dim meta labels
	TitleValue  lipgloss.Style // white values

	// Explorer
	SectionHeader lipgloss.Style // dim section label
	SectionCount  lipgloss.Style // fade count on right
	FileModMark   lipgloss.Style // M amber
	FileAddMark   lipgloss.Style // + green
	FileName      lipgloss.Style // mid text
	FileNameAct   lipgloss.Style // red — active file
	FileStats     lipgloss.Style // dim +/- counts
	TreeDir       lipgloss.Style // blue-ish dir color
	TreeIndent    lipgloss.Style // fade
	HintKey       lipgloss.Style // purple kbd hints
	HintText      lipgloss.Style // dim hint text

	// Now panel
	Mascot      lipgloss.Style // pink — bunny body
	MascotZZ    lipgloss.Style // dim — sleep zZ annotation
	NowOp       lipgloss.Style // purple operation line
	NowMeta     lipgloss.Style // dim meta
	NowCode     lipgloss.Style // cyan inline code
	NowDetail   lipgloss.Style // dim detail (e.g. · line 46)
	StatusGreen lipgloss.Style // green status dot
	StatusPurpl lipgloss.Style // purple status dot/chevron

	// Tasks panel
	TaskDoneIcon    lipgloss.Style // green ✓
	TaskDoneName    lipgloss.Style // muted strikethrough-ish
	TaskDur         lipgloss.Style // dim duration
	TaskSubtitle    lipgloss.Style // small dim subtitle
	TaskActBorder   lipgloss.Style // active task outer box
	TaskActName     lipgloss.Style // text active task name
	TaskActDur      lipgloss.Style // purple duration
	TaskActOp       lipgloss.Style // spinner+code line
	TaskActCode     lipgloss.Style // cyan code ref
	TaskSubDoneIcon lipgloss.Style
	TaskSubDoneName lipgloss.Style
	TaskSubActIcon  lipgloss.Style // purple
	TaskSubActName  lipgloss.Style
	TaskSubPenIcon  lipgloss.Style // fade
	TaskSubPenName  lipgloss.Style // dim
	TaskPenIcon     lipgloss.Style // fade □
	TaskPenName     lipgloss.Style // dim
	ProgPct         lipgloss.Style // purple %
	ProgLeft        lipgloss.Style // dim "N left"
	ProgBarBg       lipgloss.Style // dark bar bg

	// Diff panel
	DiffHunk    lipgloss.Style // dim italic @@ line
	DiffLineNum lipgloss.Style // fade line number
	DiffCtx     lipgloss.Style // mid context text
	DiffAdd     lipgloss.Style // green added text
	DiffRem     lipgloss.Style // red removed text

	// Usage panel
	UsageLabel   lipgloss.Style
	UsageValue   lipgloss.Style
	UsageModel   lipgloss.Style // purple model name
	UsageDivider lipgloss.Style
	IssueDot     lipgloss.Style // base
	IssueName    lipgloss.Style
	IssueValue   lipgloss.Style

	// Servers panel
	SrvSubHeader lipgloss.Style
	SrvName      lipgloss.Style
	SrvCount     lipgloss.Style
	SrvOff       lipgloss.Style // dim name when off

	// Semantic color shortcuts (for inline dot/accent usage)
	TextFade lipgloss.Style // #3b4261 gutters/disabled
	Amber    lipgloss.Style // #e0af68 warnings

	// Notification banner
	NotifIcon lipgloss.Style // purple ◆
	NotifWho  lipgloss.Style // pink "claude" — ONLY place pink is used on text
	NotifText lipgloss.Style
	NotifCmd  lipgloss.Style // amber code
	NotifPath lipgloss.Style // cyan path
	KbdChip   lipgloss.Style // keyboard chip [y]

	// Status bar
	StatusBar   lipgloss.Style
	StatusKey   lipgloss.Style // purple keybind
	StatusSep   lipgloss.Style // fade ·
	StatusVer   lipgloss.Style // dim version
	StatusReady lipgloss.Style // green "ready"

	// Tab strip (Mode B)
	TabActive   lipgloss.Style // active tab — purple text
	TabInactive lipgloss.Style // inactive tab — dim
	TabBorder   lipgloss.Style // tab separator
}

type SubStep struct {
	Done   bool
	Active bool
	Name   string
	Dur    string // "0:08"
}

type Task struct {
	Status   TaskStatus
	Icon     string // "✓", "▸", "□"
	Name     string
	Duration string
	Subtitle string    // shown for done tasks
	SubSteps []SubStep // only for active task
}

type TaskStatus int

type TerminalGraphics int

type Theme string

type ToolCall struct {
	AgentID    string
	AgentName  string
	IsSubagent bool
	Tool       string    // "Read", "Edit", "Bash", "Grep", etc.
	KeyArg     string    // first/main argument (path, command, pattern)
	Duration   string    // "12s", "1.4m"
	State      CallState // CallDone, CallActive, CallFailed
}

type TreeNode struct {
	Indent   string // indentation prefix using │ characters
	Mark     string // "M", "+", " "
	IsDir    bool   // renders with dir color
	IsAct    bool   // currently active file (red highlight)
	Name     string
	FullPath string // optional full relative path (used by viewer for mock lookup)
}

type UsageWindowRow struct {
	// Label is the window name shown in the left column: "session ctx", "5h usage", "weekly usage".
	Label string

	// Percent is the 0-100 fill ratio for this row's progress bar.
	//   - session row: % of model context window used (compaction risk).
	//   - 5h / weekly rows: % of plan quota consumed (when IsPlanQuota=true)
	//     OR % of time elapsed in window (when IsPlanQuota=false fallback).
	Percent int

	// IsPlanQuota is true when Percent comes from the Anthropic plan-usage
	// API (real plan-quota %), false when it's a time-elapsed approximation
	// derived from JSONL timestamps. Used by the panel to decide whether
	// to show the "(plan offline)" badge.
	IsPlanQuota bool

	// Input is the formatted input-token count, e.g. "12k".
	Input string

	// Output is the formatted output-token count, e.g. "5k".
	Output string

	// Cache is the formatted cache-read token count, e.g. "30k".
	Cache string

	// Cost is the formatted USD cost, e.g. "$0.42".
	Cost string

	// TotalUsed is the formatted total token count for the window, e.g. "3.4M".
	// Used in the two-line per-window display as the "total used" line.
	TotalUsed string

	// CurrentCtx is the "Nk / 1M (N%)" string for the current context window.
	// Only populated for the session row (LatestUsage context, not TotalUsage).
	// Empty for 5h and 7d rows.
	CurrentCtx string

	// ResetsIn is the human-readable countdown until the window resets,
	// e.g. "3h 57m" for the 5h window, "4d 14h" for the 7d window.
	// Empty when the reset time is unknown or has already passed.
	ResetsIn string

	// ResetAt is the wall-clock time when this window resets. Zero when
	// unknown (e.g. hand-authored demo rows). Used to pick the SOONEST
	// reset for the synthetic "next reset" row.
	ResetAt time.Time

	// ResetElapsedPct is the 0-100 percentage of TIME elapsed in this
	// window (0 = just reset, 100 = about to reset). This — not Percent,
	// which may hold the plan-quota % — feeds the "next reset" bar so its
	// fill always matches the countdown headline.
	ResetElapsedPct int

	// Empty is true when all token counts are zero (nothing to display).
	Empty bool

	// SessionCount is the number of sessions that contributed to this row.
	// Zero means "not available" (single-project fallback or this session row).
	// Positive values are formatted as "(N sessions)" in the display.
	SessionCount int
}

type ViewerMode int

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