view

type ActivityRow struct {
	Time, Actor, Action, Target string
	Result                      Status
	ResultText                  string
}

type CertRow struct {
	ID, CommonName, Preset, CA string
	Serial                     string
	Expires, ExpiresRel        string
	Status                     Status
	StatusText                 string
}

type Chart struct {
	// ID is a constant of the calling page, not data: it builds the element
	// ids of the title and description (characters outside a-z, 0-9 and "-"
	// are dropped).
	ID   string
	Kind ChartKind
	// Title is the caption; Summary is the one sentence that tells what the
	// chart says (also the description for screen readers).
	Title, Summary string
	// Empty is shown instead of the chart when every value is zero.
	Empty string
	// CategoryHeader and ValueHeader head the numbers table (the value
	// column of the stacked kinds is one column per series, plus "Total").
	CategoryHeader, ValueHeader string
	// SeriesHeader adds a column to the table of the non-stacked kinds that
	// names the series of every category ("Window"): the same fact the color
	// shows, as text.
	SeriesHeader string
	// Legend draws the series as swatch plus text below the plot.
	Legend     bool
	Series     []ChartSeries
	Categories []ChartCategory
}

type ChartCategory struct {
	// Label is the short text on the axis; Name the longer text for the
	// numbers table and the tooltip (defaults to Label).
	Label, Name string
	// Series is the index of the series that colors a category of the
	// kinds ChartColumns and ChartBars; the stacked kinds ignore it.
	Series int
	// Values: one value for ChartColumns and ChartBars, one per series for
	// the stacked kinds. Negative values count as zero.
	Values []int64
}

type ChartClass string

type ChartKind string

type ChartSeries struct {
	Label string
	Class ChartClass
}

type Crumb struct {
	Label, Href string
}

type Density string

type KV struct {
	Key, Value string
	Href       string
	Mono       bool
}

type Layout string

type Message struct {
	Kind     MessageKind
	Text     string
	Href     string
	LinkText string
}

type MessageKind string

type Option struct {
	Value, Label string
	Selected     bool
}

type Page struct {
	Title       string
	Description string // optional one-line description under the title
	Status      Status // optional status next to the title
	StatusText  string
	Actions     templ.Component // optional command groups right of the title
	Section     string          // key of the active navigation entry
	Crumbs      []Crumb         // breadcrumb trail, without the current page
	Prefs       Prefs
	Dev         bool // show the DEV MODE banner
	Tenant      string
	Tenants     []string
	User        string
	Search      string // current value of the header search box

	// Session is the signed-in user of the real UI (phase 1 step 14); nil
	// in the prototype, which shows its placeholder user menu.
	Session *Session
	// Notices are shown above the page header on every page: the demo
	// warning and "signing is off" while sealed.
	Notices []Message
	// BuiltOnly hides navigation entries that don't exist yet.
	BuiltOnly bool

	// RefreshSeconds and RefreshURL make the page load RefreshURL after that
	// many seconds: a <meta http-equiv="refresh"> in the head, no script (the
	// UI ships none). RefreshURL is a local path; RefreshContent leaves the tag
	// out for anything else.
	RefreshSeconds int
	RefreshURL     string
}

type Prefs struct {
	Layout  Layout
	Theme   Theme
	Density Density
}

type Session struct {
	Username string
	Roles    string // "admin of tenant default", for the user menu
	CSRF     string // token for the forms of the user menu
	CanSeal  bool   // instance admin: offer "Seal now"
	// CanIssue: the user may issue at one CA at least – otherwise "Issue
	// certificate" is not offered anywhere (no dead links, owner 2026-10-18).
	CanIssue bool
	// Hidden are navigation entries the user may not use (step 19).
	Hidden []string
}

type Status string

type Tab struct {
	Label, Href string
	Active      bool
}

type Theme string