tui

type Choice struct {
	Label       string
	Description string
	Value       string
}

type DashboardAction string

type DashboardData struct {
	ProviderLabel string // "GitHub Personal"
	ProviderType  string // "GitHub"
	Host          string
	User          *domain.User
	Summary       *domain.AccountSummary
	Err           error
}

type DashboardOptions struct {
	// PRTerm labels the pull request count ("Open MRs"); PRLabel names the
	// menu entry ("Merge Requests").
	PRTerm  string
	PRLabel string
	// Hidden actions are omitted (e.g. Issues for a provider without issues).
	Hidden map[DashboardAction]bool
	// RepoHint describes which repository per-repository actions use, e.g.
	// "acme/api" when run inside a checkout.
	RepoHint string
}

type Document struct {
	Title    string
	Subtitle string      // e.g. "#12 · open · by alice · 2d ago"
	Fields   [][2]string // label/value pairs shown under the title
	Body     string      // Markdown-ish text; rendered with light formatting
	Context  string      // right-aligned context, e.g. "◆ GitHub Personal"
}

type Facet struct {
	Key     string // key in Item.Facets
	Label   string // "Namespace"
	Binding string // single key, e.g. "f"
}

type InputOptions struct {
	Label       string
	Placeholder string
	Default     string
	Help        string
	Secret      bool // mask input; the value is never rendered
	Validate    func(string) error
}

type Item struct {
	ID       string
	Title    string
	Subtitle string            // muted secondary text (description, host)
	Badges   []string          // short tags such as "private", "archived"
	Facets   map[string]string // filterable attributes, e.g. namespace/provider
	Value    any
}

type ListOptions struct {
	Title       string
	Context     string // right-aligned context, e.g. "◆ GitHub Personal"
	Noun        string // plural noun for counts, e.g. "repositories"
	Multi       bool
	Items       []Item
	Facets      []Facet
	Preselected map[string]bool
	// ProtocolToggle shows the clone protocol and lets "t" switch it.
	ProtocolToggle bool
	Protocol       domain.GitProtocol
	// ConfirmLabel names the Enter action ("Clone", "Open", "Select").
	ConfirmLabel string
	// EscBack is set when the picker was opened from another screen (the
	// dashboard): esc then means "back" while q still quits Trove.
	EscBack bool
	// SearchHint is shown while typing a search, e.g. "author:name".
	SearchHint string
	// InitialID places the cursor on this item (e.g. when returning to a
	// list after reading one of its entries).
	InitialID string
}

type ListResult struct {
	Selected []Item
	Protocol domain.GitProtocol
}