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->meta.data on the selected line during the
34  * minibuffer lifecycle.
35  */
36 typedef const char *(complfn)(void **, void **);
37 
38 struct ministate {
39 	char		*curmesg;
40 
41 	char		 prompt[64];
42 	void		 (*donefn)(void);
43 	void		 (*abortfn)(void);
44 
45 	char		 buf[1025];
46 	struct line	 line;
47 	struct vline	 vline;
48 	struct buffer	 buffer;
49 
50 	struct histhead	*history;
51 	struct hist	*hist_cur;
52 	size_t		 hist_off;
53 
54 	struct {
55 		struct buffer	 buffer;
56 		complfn		*fn;
57 		void		*data;
58 	} compl;
59 };
60 extern struct ministate ministate;
61 
62 extern struct buffer minibufferwin;
63 
64 void	 recompute_completions(int);
65 
66 void	 minibuffer_taint_hist(void);
67 void	 minibuffer_self_insert(void);
68 void	 sensible_self_insert(void);
69 void	 eecmd_self_insert(void);
70 void	 eecmd_select(void);
71 void	 ir_self_insert(void);
72 void	 ir_select(void);
73 void	 lu_select(void);
74 void	 bp_select(void);
75 void	 ts_select(void);
76 void	 ls_select(void);
77 void	 swiper_select(void);
78 void	 toc_select(void);
79 
80 void	 enter_minibuffer(void(*)(void), void(*)(void), void(*)(void),
81     struct histhead *,
82     complfn *, void *);
83 
84 void	 exit_minibuffer(void);
85 void	 yornp(const char *, void (*)(int, struct tab *), struct tab *);
86 
87 /*
88  * completing_read asks the user for something using the minibuffer.
89  * The first argument is the string prompt.  The second and third are
90  * the callback to call when done and the data; the callback function
91  * can't be NULL.
92  */
93 void	 completing_read(const char *,
94     void (*)(const char *, struct tab *), struct tab *);
95 
96 #endif