xref: /openbsd-src/usr.bin/tmux/cmd-display-menu.c (revision 5a38ef86d0b61900239c7913d24a05e7b88a58f0)
1 /* $OpenBSD: cmd-display-menu.c,v 1.37 2021/10/25 09:38:36 nicm Exp $ */
2 
3 /*
4  * Copyright (c) 2019 Nicholas Marriott <nicholas.marriott@gmail.com>
5  *
6  * Permission to use, copy, modify, and distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
15  * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
16  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 #include <sys/types.h>
20 
21 #include <paths.h>
22 #include <stdlib.h>
23 #include <string.h>
24 
25 #include "tmux.h"
26 
27 /*
28  * Display a menu on a client.
29  */
30 
31 static enum args_parse_type	cmd_display_menu_args_parse(struct args *,
32 				    u_int, char **);
33 static enum cmd_retval		cmd_display_menu_exec(struct cmd *,
34 				    struct cmdq_item *);
35 static enum cmd_retval		cmd_display_popup_exec(struct cmd *,
36 				    struct cmdq_item *);
37 
38 const struct cmd_entry cmd_display_menu_entry = {
39 	.name = "display-menu",
40 	.alias = "menu",
41 
42 	.args = { "c:t:OT:x:y:", 1, -1, cmd_display_menu_args_parse },
43 	.usage = "[-O] [-c target-client] " CMD_TARGET_PANE_USAGE " [-T title] "
44 		 "[-x position] [-y position] name key command ...",
45 
46 	.target = { 't', CMD_FIND_PANE, 0 },
47 
48 	.flags = CMD_AFTERHOOK|CMD_CLIENT_CFLAG,
49 	.exec = cmd_display_menu_exec
50 };
51 
52 const struct cmd_entry cmd_display_popup_entry = {
53 	.name = "display-popup",
54 	.alias = "popup",
55 
56 	.args = { "Bb:Cc:d:e:Eh:s:S:t:T:w:x:y:", 0, -1, NULL },
57 	.usage = "[-BCE] [-b border-lines] [-c target-client] "
58 		 "[-d start-directory] [-e environment] [-h height] "
59 		 "[-s style] [-S border-style] " CMD_TARGET_PANE_USAGE
60 		 "[-T title] [-w width] [-x position] [-y position] "
61 		 "[shell-command]",
62 
63 	.target = { 't', CMD_FIND_PANE, 0 },
64 
65 	.flags = CMD_AFTERHOOK|CMD_CLIENT_CFLAG,
66 	.exec = cmd_display_popup_exec
67 };
68 
69 static enum args_parse_type
70 cmd_display_menu_args_parse(struct args *args, u_int idx, __unused char **cause)
71 {
72 	u_int			 i = 0;
73 	enum args_parse_type	 type = ARGS_PARSE_STRING;
74 
75 	for (;;) {
76 		type = ARGS_PARSE_STRING;
77 		if (i == idx)
78 			break;
79 		if (*args_string(args, i++) == '\0')
80 			continue;
81 
82 		type = ARGS_PARSE_STRING;
83 		if (i++ == idx)
84 			break;
85 
86 		type = ARGS_PARSE_COMMANDS_OR_STRING;
87 		if (i++ == idx)
88 			break;
89 	}
90 	return (type);
91 }
92 
93 static int
94 cmd_display_menu_get_position(struct client *tc, struct cmdq_item *item,
95     struct args *args, u_int *px, u_int *py, u_int w, u_int h)
96 {
97 	struct tty		*tty = &tc->tty;
98 	struct cmd_find_state	*target = cmdq_get_target(item);
99 	struct key_event	*event = cmdq_get_event(item);
100 	struct session		*s = tc->session;
101 	struct winlink		*wl = target->wl;
102 	struct window_pane	*wp = target->wp;
103 	struct style_ranges	*ranges = NULL;
104 	struct style_range	*sr = NULL;
105 	const char		*xp, *yp;
106 	char			*p;
107 	int			 top;
108 	u_int			 line, ox, oy, sx, sy, lines, position;
109 	long			 n;
110 	struct format_tree	*ft;
111 
112 	/*
113 	 * Work out the position from the -x and -y arguments. This is the
114 	 * bottom-left position.
115 	 */
116 
117 	/* If the popup is too big, stop now. */
118 	if (w > tty->sx || h > tty->sy)
119 		return (0);
120 
121 	/* Create format with mouse position if any. */
122 	ft = format_create_from_target(item);
123 	if (event->m.valid) {
124 		format_add(ft, "popup_mouse_x", "%u", event->m.x);
125 		format_add(ft, "popup_mouse_y", "%u", event->m.y);
126 	}
127 
128 	/*
129 	 * If there are any status lines, add this window position and the
130 	 * status line position.
131 	 */
132 	top = status_at_line(tc);
133 	if (top != -1) {
134 		lines = status_line_size(tc);
135 		if (top == 0)
136 			top = lines;
137 		else
138 			top = 0;
139 		position = options_get_number(s->options, "status-position");
140 
141 		for (line = 0; line < lines; line++) {
142 			ranges = &tc->status.entries[line].ranges;
143 			TAILQ_FOREACH(sr, ranges, entry) {
144 				if (sr->type != STYLE_RANGE_WINDOW)
145 					continue;
146 				if (sr->argument == (u_int)wl->idx)
147 					break;
148 			}
149 			if (sr != NULL)
150 				break;
151 		}
152 
153 		if (sr != NULL) {
154 			format_add(ft, "popup_window_status_line_x", "%u",
155 			    sr->start);
156 			if (position == 0) {
157 				format_add(ft, "popup_window_status_line_y",
158 				    "%u", line + 1 + h);
159 			} else {
160 				format_add(ft, "popup_window_status_line_y",
161 				    "%u", tty->sy - lines + line);
162 			}
163 		}
164 
165 		if (position == 0)
166 			format_add(ft, "popup_status_line_y", "%u", lines + h);
167 		else {
168 			format_add(ft, "popup_status_line_y", "%u",
169 			    tty->sy - lines);
170 		}
171 	} else
172 		top = 0;
173 
174 	/* Popup width and height. */
175 	format_add(ft, "popup_width", "%u", w);
176 	format_add(ft, "popup_height", "%u", h);
177 
178 	/* Position so popup is in the centre. */
179 	n = (long)(tty->sx - 1) / 2 - w / 2;
180 	if (n < 0)
181 		format_add(ft, "popup_centre_x", "%u", 0);
182 	else
183 		format_add(ft, "popup_centre_x", "%ld", n);
184 	n = (tty->sy - 1) / 2 + h / 2;
185 	if (n >= tty->sy)
186 		format_add(ft, "popup_centre_y", "%u", tty->sy - h);
187 	else
188 		format_add(ft, "popup_centre_y", "%ld", n);
189 
190 	/* Position of popup relative to mouse. */
191 	if (event->m.valid) {
192 		n = (long)event->m.x - w / 2;
193 		if (n < 0)
194 			format_add(ft, "popup_mouse_centre_x", "%u", 0);
195 		else
196 			format_add(ft, "popup_mouse_centre_x", "%ld", n);
197 		n = event->m.y - h / 2;
198 		if (n + h >= tty->sy) {
199 			format_add(ft, "popup_mouse_centre_y", "%u",
200 			    tty->sy - h);
201 		} else
202 			format_add(ft, "popup_mouse_centre_y", "%ld", n);
203 		n = (long)event->m.y + h;
204 		if (n >= tty->sy)
205 			format_add(ft, "popup_mouse_top", "%u", tty->sy - 1);
206 		else
207 			format_add(ft, "popup_mouse_top", "%ld", n);
208 		n = event->m.y - h;
209 		if (n < 0)
210 			format_add(ft, "popup_mouse_bottom", "%u", 0);
211 		else
212 			format_add(ft, "popup_mouse_bottom", "%ld", n);
213 	}
214 
215 	/* Position in pane. */
216 	tty_window_offset(&tc->tty, &ox, &oy, &sx, &sy);
217 	n = top + wp->yoff - oy + h;
218 	if (n >= tty->sy)
219 		format_add(ft, "popup_pane_top", "%u", tty->sy - h);
220 	else
221 		format_add(ft, "popup_pane_top", "%ld", n);
222 	format_add(ft, "popup_pane_bottom", "%u", top + wp->yoff + wp->sy - oy);
223 	format_add(ft, "popup_pane_left", "%u", wp->xoff - ox);
224 	n = (long)wp->xoff + wp->sx - ox - w;
225 	if (n < 0)
226 		format_add(ft, "popup_pane_right", "%u", 0);
227 	else
228 		format_add(ft, "popup_pane_right", "%ld", n);
229 
230 	/* Expand horizontal position. */
231 	xp = args_get(args, 'x');
232 	if (xp == NULL || strcmp(xp, "C") == 0)
233 		xp = "#{popup_centre_x}";
234 	else if (strcmp(xp, "R") == 0)
235 		xp = "#{popup_pane_right}";
236 	else if (strcmp(xp, "P") == 0)
237 		xp = "#{popup_pane_left}";
238 	else if (strcmp(xp, "M") == 0)
239 		xp = "#{popup_mouse_centre_x}";
240 	else if (strcmp(xp, "W") == 0)
241 		xp = "#{popup_window_status_line_x}";
242 	p = format_expand(ft, xp);
243 	n = strtol(p, NULL, 10);
244 	if (n + w >= tty->sx)
245 		n = tty->sx - w;
246 	else if (n < 0)
247 		n = 0;
248 	*px = n;
249 	log_debug("%s: -x: %s = %s = %u (-w %u)", __func__, xp, p, *px, w);
250 	free(p);
251 
252 	/* Expand vertical position  */
253 	yp = args_get(args, 'y');
254 	if (yp == NULL || strcmp(yp, "C") == 0)
255 		yp = "#{popup_centre_y}";
256 	else if (strcmp(yp, "P") == 0)
257 		yp = "#{popup_pane_bottom}";
258 	else if (strcmp(yp, "M") == 0)
259 		yp = "#{popup_mouse_top}";
260 	else if (strcmp(yp, "S") == 0)
261 		yp = "#{popup_status_line_y}";
262 	else if (strcmp(yp, "W") == 0)
263 		yp = "#{popup_window_status_line_y}";
264 	p = format_expand(ft, yp);
265 	n = strtol(p, NULL, 10);
266 	if (n < h)
267 		n = 0;
268 	else
269 		n -= h;
270 	if (n + h >= tty->sy)
271 		n = tty->sy - h;
272 	else if (n < 0)
273 		n = 0;
274 	*py = n;
275 	log_debug("%s: -y: %s = %s = %u (-h %u)", __func__, yp, p, *py, h);
276 	free(p);
277 
278 	return (1);
279 }
280 
281 static enum cmd_retval
282 cmd_display_menu_exec(struct cmd *self, struct cmdq_item *item)
283 {
284 	struct args		*args = cmd_get_args(self);
285 	struct cmd_find_state	*target = cmdq_get_target(item);
286 	struct key_event	*event = cmdq_get_event(item);
287 	struct client		*tc = cmdq_get_target_client(item);
288 	struct menu		*menu = NULL;
289 	struct menu_item	 menu_item;
290 	const char		*key, *name;
291 	char			*title;
292 	int			 flags = 0;
293 	u_int			 px, py, i, count = args_count(args);
294 
295 	if (tc->overlay_draw != NULL)
296 		return (CMD_RETURN_NORMAL);
297 
298 	if (args_has(args, 'T'))
299 		title = format_single_from_target(item, args_get(args, 'T'));
300 	else
301 		title = xstrdup("");
302 	menu = menu_create(title);
303 
304 	for (i = 0; i != count; /* nothing */) {
305 		name = args_string(args, i++);
306 		if (*name == '\0') {
307 			menu_add_item(menu, NULL, item, tc, target);
308 			continue;
309 		}
310 
311 		if (count - i < 2) {
312 			cmdq_error(item, "not enough arguments");
313 			free(title);
314 			menu_free(menu);
315 			return (CMD_RETURN_ERROR);
316 		}
317 		key = args_string(args, i++);
318 
319 		menu_item.name = name;
320 		menu_item.key = key_string_lookup_string(key);
321 		menu_item.command = args_string(args, i++);
322 
323 		menu_add_item(menu, &menu_item, item, tc, target);
324 	}
325 	free(title);
326 	if (menu == NULL) {
327 		cmdq_error(item, "invalid menu arguments");
328 		return (CMD_RETURN_ERROR);
329 	}
330 	if (menu->count == 0) {
331 		menu_free(menu);
332 		return (CMD_RETURN_NORMAL);
333 	}
334 	if (!cmd_display_menu_get_position(tc, item, args, &px, &py,
335 	    menu->width + 4, menu->count + 2)) {
336 		menu_free(menu);
337 		return (CMD_RETURN_NORMAL);
338 	}
339 
340 	if (args_has(args, 'O'))
341 		flags |= MENU_STAYOPEN;
342 	if (!event->m.valid)
343 		flags |= MENU_NOMOUSE;
344 	if (menu_display(menu, flags, item, px, py, tc, target, NULL,
345 	    NULL) != 0)
346 		return (CMD_RETURN_NORMAL);
347 	return (CMD_RETURN_WAIT);
348 }
349 
350 static enum cmd_retval
351 cmd_display_popup_exec(struct cmd *self, struct cmdq_item *item)
352 {
353 	struct args		*args = cmd_get_args(self);
354 	struct cmd_find_state	*target = cmdq_get_target(item);
355 	struct session		*s = target->s;
356 	struct client		*tc = cmdq_get_target_client(item);
357 	struct tty		*tty = &tc->tty;
358 	const char		*value, *shell, *shellcmd = NULL;
359 	const char		*style = args_get(args, 's');
360 	const char		*border_style = args_get(args, 'S');
361 	char			*cwd, *cause = NULL, **argv = NULL, *title;
362 	int			 flags = 0, argc = 0;
363 	enum box_lines		 lines = BOX_LINES_DEFAULT;
364 	u_int			 px, py, w, h, count = args_count(args);
365 	struct args_value	*av;
366 	struct environ		*env = NULL;
367 	struct options		*o = s->curw->window->options;
368 	struct options_entry	*oe;
369 
370 	if (args_has(args, 'C')) {
371 		server_client_clear_overlay(tc);
372 		return (CMD_RETURN_NORMAL);
373 	}
374 	if (tc->overlay_draw != NULL)
375 		return (CMD_RETURN_NORMAL);
376 
377 	h = tty->sy / 2;
378 	if (args_has(args, 'h')) {
379 		h = args_percentage(args, 'h', 1, tty->sy, tty->sy, &cause);
380 		if (cause != NULL) {
381 			cmdq_error(item, "height %s", cause);
382 			free(cause);
383 			return (CMD_RETURN_ERROR);
384 		}
385 	}
386 
387 	w = tty->sx / 2;
388 	if (args_has(args, 'w')) {
389 		w = args_percentage(args, 'w', 1, tty->sx, tty->sx, &cause);
390 		if (cause != NULL) {
391 			cmdq_error(item, "width %s", cause);
392 			free(cause);
393 			return (CMD_RETURN_ERROR);
394 		}
395 	}
396 
397 	if (w > tty->sx)
398 		w = tty->sx;
399 	if (h > tty->sy)
400 		h = tty->sy;
401 	if (!cmd_display_menu_get_position(tc, item, args, &px, &py, w, h))
402 		return (CMD_RETURN_NORMAL);
403 
404 	value = args_get(args, 'b');
405 	if (args_has(args, 'B'))
406 		lines = BOX_LINES_NONE;
407 	else if (value != NULL) {
408 		oe = options_get(o, "popup-border-lines");
409 		lines = options_find_choice(options_table_entry(oe), value,
410 		    &cause);
411 		if (cause != NULL) {
412 			cmdq_error(item, "popup-border-lines %s", cause);
413 			free(cause);
414 			return (CMD_RETURN_ERROR);
415 		}
416 	}
417 
418 	value = args_get(args, 'd');
419 	if (value != NULL)
420 		cwd = format_single_from_target(item, value);
421 	else
422 		cwd = xstrdup(server_client_get_cwd(tc, s));
423 	if (count == 0)
424 		shellcmd = options_get_string(s->options, "default-command");
425 	else if (count == 1)
426 		shellcmd = args_string(args, 0);
427 	if (count <= 1 && (shellcmd == NULL || *shellcmd == '\0')) {
428 		shellcmd = NULL;
429 		shell = options_get_string(s->options, "default-shell");
430 		if (!checkshell(shell))
431 			shell = _PATH_BSHELL;
432 		cmd_append_argv(&argc, &argv, shell);
433 	} else
434 		args_to_vector(args, &argc, &argv);
435 
436 	if (args_has(args, 'e') >= 1) {
437 		env = environ_create();
438 		av = args_first_value(args, 'e');
439 		while (av != NULL) {
440 			environ_put(env, av->string, 0);
441 			av = args_next_value(av);
442 		}
443 	}
444 
445 	if (args_has(args, 'T'))
446 		title = format_single_from_target(item, args_get(args, 'T'));
447 	else
448 		title = xstrdup("");
449 	if (args_has(args, 'E') > 1)
450 		flags |= POPUP_CLOSEEXITZERO;
451 	else if (args_has(args, 'E'))
452 		flags |= POPUP_CLOSEEXIT;
453 	if (popup_display(flags, lines, item, px, py, w, h, env, shellcmd, argc,
454 	    argv, cwd, title, tc, s, style, border_style, NULL, NULL) != 0) {
455 		cmd_free_argv(argc, argv);
456 		if (env != NULL)
457 			environ_free(env);
458 		free(title);
459 		return (CMD_RETURN_NORMAL);
460 	}
461 	if (env != NULL)
462 		environ_free(env);
463 	free(title);
464 	cmd_free_argv(argc, argv);
465 	return (CMD_RETURN_WAIT);
466 }
467