keys

type BackupKeys struct {
	// Navigate is help-only, like Files.Scroll: the list owns navigation.
	Navigate key.Binding
	// Restore writes the selected .bak back over the live file. enter or r;
	// r is chosen so it never collides with the service panel's lowercase r
	// (restart) - the Backups page is the only context this binding is live.
	Restore key.Binding
}

type Context struct {
	Page string
	// ListEmpty reports whether the body list has any rows to act on. An
	// empty list offers no selection-dependent verbs.
	ListEmpty bool
	// Selected reports whether the panel has a subject to act on - a chosen
	// group on Home, a chosen service on Services. Without one, the action
	// keys do nothing and are not offered.
	Selected bool
	// ReadOnlyGroup is true when the selected group is the reserved
	// apptypes.UngroupedGroup row. Its membership is derived and it has no
	// profile tag, so the list-management verbs are not offered on it - the
	// docker verbs still are.
	ReadOnlyGroup bool
	// UngroupedMaterialized is true when the reserved ungrouped row is backed
	// by a written profile tag rather than derived. It decides whether the
	// ungrouped row's 'A' verb is adopt or release.
	UngroupedMaterialized bool
	// Editing is true when the service details panel is in inline edit mode.
	// The editor owns the keyboard, so the panel's action keys and the page
	// digits are dead; the footer shows the editor-specific keys instead.
	Editing bool
	// PendingAction is true when a docker action is running. Action keys are
	// disabled and a spinner is shown in the panel.
	PendingAction bool
	// Filter is the focused list's filter state. Its zero value is
	// list.Unfiltered, so a caller that has no list to report about gets the
	// ordinary keys.
	Filter list.FilterState
}

type DetailsKeys struct {
	Start       key.Binding
	Stop        key.Binding
	Restart     key.Binding
	Pull        key.Binding
	Remove      key.Binding
	Logs        key.Binding
	EditService key.Binding
	EditFile    key.Binding
	Save        key.Binding
	OpenEditor  key.Binding
	// CopyURL exists only on the service panel, alongside EditService and
	// EditFile - the group panel has no single URL to copy.
	CopyURL key.Binding
	// Healthcheck opens the template picker (docs/plans/healthcheck-insertion.md).
	Healthcheck key.Binding
	// Boot cycles the service's restart: policy (no -> on-failure ->
	// unless-stopped -> always -> no). Uppercase, alongside Healthcheck's
	// uppercase H, to leave b free for Files.Browse - the same shape as
	// EditFile's E next to EditService's e.
	Boot key.Binding
}

type EditorKeys struct {
	NewLine key.Binding
	Indent  key.Binding
	Outdent key.Binding
}

type Entry struct {
	Binding   key.Binding
	Available bool
}

type FilesKeys struct {
	Scroll key.Binding
	Browse key.Binding
}

type GlobalKeys struct {
	NextPanel key.Binding
	PrevPanel key.Binding
	// Quit is q, and it is the one global key that yields: a modal or a
	// filtering list needs the letter for typing. ForceQuit is separate from it
	// precisely so that ctrl+c yields to nothing.
	Quit      key.Binding
	ForceQuit key.Binding
	// Back is esc away from everything that has a stronger claim on it: a
	// modal, a filter being typed, a filter standing on a focused list. What
	// is left is the details panel, so esc there means "back to the list" -
	// which is why the footer offers it in the details contexts and nowhere
	// else. See model.AppModel.escKept.
	Back key.Binding
	// Help opens the help overlay. The overlay renders from this package, so
	// what it says is what the handlers do.
	Help key.Binding
	// About opens the About modal: the brand mark, version, license and repo
	// link. A read-only overlay like Help, closed by the same three keys.
	About key.Binding
	// Theme opens the theme picker: a list of registered themes with live
	// preview on cursor movement and persist-on-confirm. T (shift+t) so it
	// does not collide with the details panel's lowercase t (stop).
	Theme key.Binding
	// Usage opens the usage overlay: disk and memory usage bars.
	Usage key.Binding
	// EditEnv opens the env modal: the .env variable table, editor, and
	// raw edit, all inside one modal. v (mnemonic: variables), free at the
	// global tier now that the old Env page's v was only its reveal key.
	EditEnv key.Binding
	// Page is advertised but not matched: the digits are recognised by their
	// key code and the alt+<letter> alias by its modifier, so that 1 as filter
	// text and alt+shift+g are both left alone. See model.pageForNavKey. The
	// bracket pair steps through the pages in order; it is not in the footer's
	// global group for width, but lives here so the help overlay renders it
	// from the same place as everything else.
	Page     key.Binding
	NextPage key.Binding
	PrevPage key.Binding
}

type ListKeys struct {
	Navigate key.Binding
	New      key.Binding
	Edit     key.Binding
	Delete   key.Binding
	// R renames the highlighted group. Uppercase so it does not collide with
	// the details panel's lowercase r (restart); the same shape as E next to e
	// on the services panel.
	Rename key.Binding
	// A on the reserved ungrouped row toggles its materialization: adopt
	// writes profiles: [ungrouped] onto every profile-less service, release
	// removes it. One key, two faces - the footer shows the state-appropriate
	// one (see Context.UngroupedMaterialized), the handler matches both.
	AdoptUngrouped   key.Binding
	ReleaseUngrouped key.Binding
	Filter           key.Binding
	ClearFilter      key.Binding
	ApplyFilter      key.Binding
	CancelFilter     key.Binding
	GoToStart        key.Binding
	GoToEnd          key.Binding
}

type OverlayKeys struct {
	Submit    key.Binding
	Cancel    key.Binding
	NextField key.Binding
	Toggle    key.Binding
	Yes       key.Binding
	No        key.Binding
	Follow    key.Binding
	// Navigation is the help overlay's own scroll keys - the arrows every
	// overlay already means "move within me" with, matched directly since
	// the overlay has no list to hand the keystrokes to.
	Navigation key.Binding
}

type Scope struct {
	Title   string
	Entries []Entry
}