view

type Allowance struct {
	// Write is set when state-changing requests are permitted at all: row edits,
	// inserts, deletes. Cleared by read_only.
	Write bool
	// Console is set when arbitrary SQL is permitted — the SQL console and SQL
	// import. Cleared by allow_console = false, and by read_only, which refuses
	// them along with everything else that changes state.
	Console bool
	// DDL is set when schema and access-control changes are permitted: the
	// structure editor, table and database operations, stored programs, accounts
	// and grants. Cleared by allow_ddl = false, and by read_only.
	DDL bool
}

type Crumb struct {
	Label  string
	URL    string
	Icon   string
	Active bool
}

type Flash struct {
	Kind    string // success | error | info | warning
	Message string
	Detail  string // optional secondary text (e.g. the offending SQL)
}

type NavNode struct {
	Kind       string // database | schema | table | view
	Name       string
	Label      string
	Icon       string
	Href       string // navigation target (browse/structure)
	LoadURL    string // htmx URL to load children lazily
	Expandable bool
	Expanded   bool
	Active     bool
	IsSystem   bool
	IsError    bool // a non-navigable leaf shown when children couldn't be loaded
	Children   []NavNode
}

type NavView struct {
	Databases []NavNode
}

type Page struct {
	Title    string
	BodyID   string // <body id> echoing phpMyAdmin's page ids
	LoggedIn bool
	CSRF     string
	Theme    string // "light" | "dark"

	// NavWidthStyle is a pre-validated `--tx-nav-width:<n>px` custom-property
	// declaration rendered inline on <html> so the persisted sidebar width is in
	// effect on the first paint (no flash of the default width before JS runs).
	// It is template.CSS (trusted) only after server-side validation; empty
	// otherwise.
	NavWidthStyle template.CSS

	// Current connection identity (when logged in).
	ServerName string
	Info       driver.ServerInfo
	Caps       driver.Capabilities

	// Allow mirrors the [restrict] policy so a template does not OFFER what the
	// middleware would refuse. It reads alongside Caps and for the same reason:
	// Caps says what the engine can do, Allow says what this deployment permits.
	//
	// It is not the enforcement and must never be treated as such — every
	// restriction is applied to the request in internal/server/restrict.go, and
	// stays applied whether or not a template consulted this. What it buys is
	// only that a user is not shown a button that answers 403.
	Allow Allowance

	// Chrome.
	Breadcrumb []Crumb
	Tabs       []Tab
	Nav        *NavView
	Flashes    []Flash

	// NeedsEditor makes the layout load CodeMirror up front. It is 242 KB —
	// well over a third of the whole asset payload — and only the SQL console
	// and the import form carry a `textarea.tx-sql-editor`, so every other page
	// paid for it. An htmx navigation ONTO one of those pages swaps only
	// #page_content and never re-runs <head>, so app.js injects the assets on
	// demand there; this flag covers the full-page render (and a no-JS client,
	// which then gets a plain textarea either way).
	NeedsEditor bool

	// Page-specific payload.
	Body any
}

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

type Tab struct {
	Key    string
	Label  string
	URL    string
	Icon   string
	Active bool
}