1 /*
2  * Copyright (c) 2021 Omar Polo <op@omarpolo.com>
3  *
4  * Permission to use, copy, modify, and distribute this software for any
5  * purpose with or without fee is hereby granted, provided that the above
6  * copyright notice and this permission notice appear in all copies.
7  *
8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15  */
16 
17 #ifndef MINIBUFFER_H
18 #define MINIBUFFER_H
19 
20 #include "telescope.h"
21 
22 /* need to be true-ish */
23 #define MB_READ		1
24 #define MB_COMPREAD	2
25 
26 /*
27  * Completion provider function.  These functions are called
28  * asynchronously.  The function should compute the next completion
29  * using the given parameter `state' and modify it eventually.  To
30  * signal the end of the completions, complfn should return NULL: the
31  * value of state will then be discarded and the function never called
32  * again.  The second parameter is some extra metadata per-line; it'll
33  * be available as line->data on the selected line during the
34  * minibuffer lifecycle.  The third parameter is an extra description
35  * field for the current item.
36  */
37 typedef const char *(complfn)(void **, void **, const char **);
38 
39 extern struct histhead eecmd_history,
40 	ir_history,
41 	lu_history,
42 	read_history;
43 
44 struct ministate {
45 	char		*curmesg;
46 
47 	char		 prompt[64];
48 	void		 (*donefn)(void);
49 	void		 (*abortfn)(void);
50 
51 	char		 buf[1025];
52 	struct line	 line;
53 	struct vline	 vline;
54 	struct buffer	 buffer;
55 
56 	struct histhead	*history;
57 	struct hist	*hist_cur;
58 	size_t		 hist_off;
59 
60 	struct {
61 		struct buffer	 buffer;
62 		complfn		*fn;
63 		void		*data;
64 		int		 must_select;
65 	} compl;
66 };
67 extern struct ministate	 ministate;
68 
69 extern struct buffer	 minibufferwin;
70 extern int		 in_minibuffer;
71 
72 void	 recompute_completions(int);
73 int	 minibuffer_insert_current_candidate(void);
74 void	 minibuffer_taint_hist(void);
75 void	 minibuffer_self_insert(void);
76 void	 sensible_self_insert(void);
77 void	 eecmd_select(void);
78 void	 ir_select_gemini(void);
79 void	 ir_select_reply(void);
80 void	 ir_select_gopher(void);
81 void	 lu_select(void);
82 void	 bp_select(void);
83 void	 ts_select(void);
84 void	 ls_select(void);
85 void	 swiper_select(void);
86 void	 toc_select(void);
87 
88 void	 enter_minibuffer(void(*)(void), void(*)(void), void(*)(void),
89     struct histhead *, complfn *, void *, int);
90 
91 void	 exit_minibuffer(void);
92 void	 yornp(const char *, void (*)(int, struct tab *), struct tab *);
93 
94 /*
95  * minibuffer_read asks the user for something using the minibuffer.
96  * The first argument is the string prompt.  The second and third are
97  * the callback to call when done and the data; the callback function
98  * can't be NULL.
99  */
100 void	 minibuffer_read(const char *,
101     void (*)(const char *, struct tab *), struct tab *);
102 
103 void	 vmessage(const char *, va_list);
104 void	 message(const char *, ...) __attribute__((format(printf, 1, 2)));
105 void	 minibuffer_init(void);
106 
107 #endif