summaryrefslogtreecommitdiff
path: root/internal/tui/common/keys.go
blob: 62899977448fa070fd92f2af07a061549bfa19c0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
package common

import "charm.land/bubbles/v2/key"

// HelpSection groups related key bindings under a shared heading.
type HelpSection struct {
	Title    string
	Bindings []key.Binding
}

// KeyMap groups all key bindings shared by TUI screens.
type KeyMap struct {
	Tab        key.Binding
	ShiftTab   key.Binding
	One        key.Binding
	Two        key.Binding
	Three      key.Binding
	Four       key.Binding
	Five       key.Binding
	Six        key.Binding
	Seven      key.Binding
	Visualize  key.Binding
	Metric     key.Binding
	DirGroup   key.Binding
	SelectPID  key.Binding
	SelectTID  key.Binding
	Probes     key.Binding
	Filter     key.Binding
	FilterUndo key.Binding
	Export     key.Binding
	Quit       key.Binding
	Enter      key.Binding
	Esc        key.Binding
	Refresh    key.Binding
}

// Keys contains the default shared key map.
var Keys = DefaultKeyMap()

// DefaultKeyMap builds the default key bindings used by models.
func DefaultKeyMap() KeyMap {
	return KeyMap{
		Tab:        key.NewBinding(key.WithKeys("tab"), key.WithHelp("tab", "next tab")),
		ShiftTab:   key.NewBinding(key.WithKeys("shift+tab"), key.WithHelp("shift+tab", "prev tab")),
		One:        key.NewBinding(key.WithKeys("1"), key.WithHelp("1", "flame")),
		Two:        key.NewBinding(key.WithKeys("2"), key.WithHelp("2", "overview")),
		Three:      key.NewBinding(key.WithKeys("3"), key.WithHelp("3", "syscalls")),
		Four:       key.NewBinding(key.WithKeys("4"), key.WithHelp("4", "files")),
		Five:       key.NewBinding(key.WithKeys("5"), key.WithHelp("5", "processes")),
		Six:        key.NewBinding(key.WithKeys("6"), key.WithHelp("6", "lat+gaps")),
		Seven:      key.NewBinding(key.WithKeys("7"), key.WithHelp("7", "stream")),
		Visualize:  key.NewBinding(key.WithKeys("v"), key.WithHelp("v", "viz")),
		Metric:     key.NewBinding(key.WithKeys("b"), key.WithHelp("b", "metric")),
		DirGroup:   key.NewBinding(key.WithKeys("d"), key.WithHelp("d", "dir group")),
		SelectPID:  key.NewBinding(key.WithKeys("p"), key.WithHelp("p", "select pid")),
		SelectTID:  key.NewBinding(key.WithKeys("t"), key.WithHelp("t", "select tid")),
		Probes:     key.NewBinding(key.WithKeys("o"), key.WithHelp("o", "probes")),
		Filter:     key.NewBinding(key.WithKeys("f"), key.WithHelp("f", "filter")),
		FilterUndo: key.NewBinding(key.WithKeys("F"), key.WithHelp("F", "undo filter")),
		Export:     key.NewBinding(key.WithKeys("e"), key.WithHelp("e", "snapshot export")),
		Quit:       key.NewBinding(key.WithKeys("q", "ctrl+c"), key.WithHelp("q", "quit")),
		Enter:      key.NewBinding(key.WithKeys("enter"), key.WithHelp("enter", "select")),
		Esc:        key.NewBinding(key.WithKeys("esc"), key.WithHelp("esc", "back")),
		Refresh:    key.NewBinding(key.WithKeys("r"), key.WithHelp("r", "reset baseline")),
	}
}

// DashboardStatusHelp returns expanded bindings for dashboard status bars.
func (k KeyMap) DashboardStatusHelp() []key.Binding {
	sections := k.DashboardStatusHelpSections()
	total := 0
	for _, section := range sections {
		total += len(section.Bindings)
	}
	bindings := make([]key.Binding, 0, total)
	for _, section := range sections {
		bindings = append(bindings, section.Bindings...)
	}
	return bindings
}

// DashboardStatusHelpSections returns grouped bindings for dashboard status bars.
func (k KeyMap) DashboardStatusHelpSections() []HelpSection {
	global := []key.Binding{
		helpTextBinding("H", "toggle help"),
		k.Tab,
		k.ShiftTab,
		k.One,
		k.Two,
		k.Three,
		k.Four,
		k.Five,
		k.Six,
		k.Seven,
		k.Visualize,
		k.Metric,
		k.Filter,
		k.FilterUndo,
		k.SelectPID,
		k.SelectTID,
		k.Probes,
		k.Refresh,
		k.Quit,
	}
	if help := k.Export.Help(); help.Key != "" || help.Desc != "" {
		global = append(global, k.Export)
	}
	dashboard := []key.Binding{
		k.DirGroup,
		k.Visualize,
		k.Metric,
		helpTextBinding("space", "stream pause"),
		helpTextBinding("enter", "selected filter"),
		helpTextBinding("esc", "stream undo filter"),
		helpTextBinding("g/G", "table top/bottom"),
		helpTextBinding("left/right", "table col"),
		helpTextBinding("h/l", "table col"),
		helpTextBinding("j/k", "table row"),
		helpTextBinding("up/down", "table row"),
		helpTextBinding("pgup/down", "table page"),
		helpTextBinding("/,?", "stream regex search"),
		helpTextBinding("n/N", "stream search next/prev"),
		helpTextBinding("x", "stream export"),
		helpTextBinding("X", "stream export as"),
		helpTextBinding("E", "stream open last"),
	}

	return []HelpSection{
		{Title: "Global", Bindings: global},
		{Title: "Dashboard", Bindings: dashboard},
	}
}

// DashboardFullHelp returns grouped bindings for dashboard overlays.
func (k KeyMap) DashboardFullHelp() [][]key.Binding {
	controls := []key.Binding{k.Tab, k.ShiftTab}
	if help := k.Export.Help(); help.Key != "" || help.Desc != "" {
		controls = append(controls, k.Export)
	}
	controls = append(controls, k.DirGroup, k.SelectPID, k.SelectTID, k.Probes, k.Refresh, k.Quit)
	controls = append(controls, k.Visualize, k.Metric, k.Filter, k.FilterUndo)

	return [][]key.Binding{
		{k.One, k.Two, k.Three, k.Four, k.Five, k.Six, k.Seven},
		controls,
		{
			helpTextBinding("space", "stream pause"),
			helpTextBinding("enter", "selected filter"),
			helpTextBinding("esc", "stream undo filter"),
			helpTextBinding("g/G", "table top/bottom"),
			helpTextBinding("left/right", "table col"),
			helpTextBinding("h/l", "table col"),
			helpTextBinding("j/k", "table row"),
			helpTextBinding("up/down", "table row"),
			helpTextBinding("pgup/down", "table page"),
			helpTextBinding("x", "stream export"),
			helpTextBinding("X", "stream export as"),
			helpTextBinding("E", "stream open last"),
			helpTextBinding("/,?", "stream regex search"),
			helpTextBinding("n/N", "stream search next/prev"),
		},
	}
}

// PickerShortHelp returns compact bindings for the PID picker.
func (k KeyMap) PickerShortHelp() []key.Binding {
	return []key.Binding{k.Enter, k.Refresh, k.Esc}
}

func helpTextBinding(keyText, desc string) key.Binding {
	return key.NewBinding(key.WithHelp(keyText, desc))
}