Skip to main content

iced_code_editor/canvas_editor/input/update/
dispatch.rs

1//! Top-level message dispatcher: routes every [`Message`] variant to its handler.
2
3use iced::Task;
4
5use crate::canvas_editor::{CodeEditor, Message};
6
7impl CodeEditor {
8    /// Updates the editor state based on messages and returns scroll commands.
9    ///
10    /// # Arguments
11    ///
12    /// * `message` - The message to process for updating the editor state
13    ///
14    /// # Returns
15    /// A `Task<Message>` for any asynchronous operations, such as scrolling to keep the cursor visible after state updates
16    ///
17    /// # Example
18    ///
19    /// ```
20    /// use iced_code_editor::{CodeEditor, Message};
21    ///
22    /// let mut editor = CodeEditor::new("hello", "rs");
23    ///
24    /// // Forward the messages the editor emits, and send your own to drive
25    /// // commands from a menu or toolbar.
26    /// let _task = editor.update(&Message::Paste(" world".to_string()));
27    /// assert_eq!(editor.content(), " worldhello");
28    ///
29    /// let _task = editor.update(&Message::Undo);
30    /// assert_eq!(editor.content(), "hello");
31    /// ```
32    pub fn update(&mut self, message: &Message) -> Task<Message> {
33        // Capture the topmost active line before any edit mutates the buffer,
34        // so `finish_edit_operation` can truncate the highlight cache precisely.
35        self.pre_edit_line = self.min_active_line();
36        self.pre_edit_last_line = self.max_active_line();
37        self.capture_lsp_edit_snapshot(message);
38        match message {
39            // Text input operations
40            Message::CharacterInput(ch) if self.vim_accepts_insert_input() => {
41                self.handle_character_input_msg(*ch)
42            },
43            Message::CharacterInput(_) => Task::none(),
44            Message::VimKey(ch) => self.handle_vim_key_msg(*ch),
45            Message::ToggleVimMode => {
46                self.set_vim_enabled(!self.vim_enabled);
47                Task::none()
48            },
49            Message::Tab if self.vim_accepts_insert_input() => self.handle_tab(),
50            Message::Enter if self.vim_accepts_insert_input() => self.handle_enter(),
51            Message::Tab | Message::Enter => Task::none(),
52
53            // Deletion operations
54            Message::Backspace if self.vim_accepts_insert_input() => self.handle_backspace(),
55            Message::Delete if self.vim_accepts_insert_input() => self.handle_delete(),
56            Message::Backspace | Message::Delete => Task::none(),
57            Message::DeleteSelection => self.handle_delete_selection(),
58
59            // Navigation operations
60            Message::ArrowKey(direction, shift) => self.handle_arrow_key(*direction, *shift),
61            Message::Home(shift) => self.handle_home(*shift),
62            Message::End(shift) => self.handle_end(*shift),
63            Message::CtrlHome => self.handle_ctrl_home(),
64            Message::CtrlEnd => self.handle_ctrl_end(),
65            Message::GotoPosition(line, col) => self.handle_goto_position(*line, *col),
66            Message::OpenGotoLine => self.handle_open_goto_line_msg(),
67            Message::CloseGotoLine => self.handle_close_goto_line_msg(),
68            Message::GotoLineChanged(query) => self.handle_goto_line_changed_msg(query),
69            Message::SubmitGotoLine => self.handle_submit_goto_line_msg(),
70            Message::OpenCommandPalette => self.handle_open_command_palette_msg(),
71            Message::CloseCommandPalette => self.handle_close_command_palette_msg(),
72            Message::CommandPaletteChanged(query) => self.handle_command_palette_changed_msg(query),
73            Message::CommandPaletteNavigate(forward) => {
74                self.handle_command_palette_navigate_msg(*forward)
75            },
76            Message::CommandPaletteSelected(index) => {
77                self.handle_command_palette_selected_msg(*index)
78            },
79            Message::SubmitCommandPalette => self.handle_submit_command_palette_msg(),
80            Message::PageUp => self.handle_page_up(),
81            Message::PageDown => self.handle_page_down(),
82
83            // Mouse and selection operations
84            Message::MouseClick(point) => self.handle_mouse_click_msg(*point),
85            Message::MouseDrag(point) => self.handle_mouse_drag_msg(*point),
86            Message::MouseHover(point) => self.handle_mouse_drag_msg(*point),
87            Message::MouseRelease => self.handle_mouse_release_msg(),
88            Message::DoubleClick(point) => self.handle_double_click_msg(*point),
89            Message::TripleClick(point) => self.handle_triple_click_msg(*point),
90            Message::ContextMenuRequested(point) => self.handle_context_menu_requested_msg(*point),
91            Message::WriteRequested
92            | Message::CustomContextMenuAction(_)
93            | Message::CommandPaletteAction(_)
94            | Message::RevealInFileManager => Task::none(),
95
96            // Clipboard operations
97            Message::Cut => self.handle_cut_msg(),
98            Message::Copy => self.copy_selection(),
99            Message::Paste(text) => self.handle_paste_msg(text),
100            Message::SelectAll => self.handle_select_all_msg(),
101
102            // History operations
103            Message::Undo => self.handle_undo_msg(),
104            Message::Redo => self.handle_redo_msg(),
105
106            // Search and replace operations
107            Message::OpenSearch => self.handle_open_search(false),
108            Message::OpenSearchReplace => self.handle_open_search(true),
109            Message::CloseSearch => self.handle_close_search_msg(),
110            Message::SearchQueryChanged(query) => self.handle_search_query_changed_msg(query),
111            Message::ReplaceQueryChanged(text) => self.handle_replace_query_changed_msg(text),
112            Message::ToggleCaseSensitive => self.handle_toggle_case_sensitive_msg(),
113            Message::FindNext => self.handle_find_match(true),
114            Message::FindPrevious => self.handle_find_match(false),
115            Message::ReplaceNext => self.handle_replace_next_msg(),
116            Message::ReplaceAll => self.handle_replace_all_msg(),
117            Message::SearchDialogTab => self.handle_search_dialog_tab(true),
118            Message::SearchDialogShiftTab => self.handle_search_dialog_tab(false),
119            Message::FocusNavigationShiftTab => self.handle_focus_navigation(),
120
121            // Focus and IME operations
122            Message::CanvasFocusGained => self.handle_canvas_focus_gained_msg(),
123            Message::CanvasFocusLost => self.handle_canvas_focus_lost_msg(),
124            Message::ImeOpened if self.vim_accepts_insert_input() => self.handle_ime_opened_msg(),
125            Message::ImeOpened => Task::none(),
126            Message::ImePreedit(content, selection) => {
127                if self.vim_accepts_insert_input() {
128                    self.handle_ime_preedit_msg(content, selection)
129                } else {
130                    Task::none()
131                }
132            },
133            Message::ImeCommit(text) => self.handle_ime_commit_msg(text),
134            Message::ImeClosed => self.handle_ime_closed_msg(),
135
136            // UI update operations
137            Message::Tick => self.handle_tick_msg(),
138            Message::Scrolled(viewport) => self.handle_scrolled_msg(*viewport),
139            Message::HorizontalScrolled(viewport) => self.handle_horizontal_scrolled_msg(*viewport),
140
141            // Handle the "Jump to Definition" action triggered by Ctrl+Click.
142            // Currently, this returns `Task::none()` as the actual navigation logic
143            // is delegated to the `LspClient` implementation or handled elsewhere.
144            Message::JumpClick(_point) => Task::none(),
145
146            // Multi-cursor operations
147            Message::AltClick(point) => self.handle_alt_click_msg(*point),
148            Message::AddCursorAbove => self.handle_add_cursor_above_msg(),
149            Message::AddCursorBelow => self.handle_add_cursor_below_msg(),
150            Message::SelectNextOccurrence => self.handle_select_next_occurrence_msg(),
151            Message::ToggleFold(header_line) => {
152                self.toggle_fold(*header_line);
153                Task::none()
154            },
155            Message::ToggleFoldAtCursor => {
156                self.toggle_fold_at(self.cursors.primary_position().0);
157                Task::none()
158            },
159            Message::FoldAll => {
160                self.fold_all();
161                Task::none()
162            },
163            Message::UnfoldAll => {
164                self.unfold_all();
165                Task::none()
166            },
167
168            // Line manipulation operations
169            Message::MoveLineUp => self.move_lines(false),
170            Message::MoveLineDown => self.move_lines(true),
171            Message::DuplicateLineUp => self.duplicate_lines(false),
172            Message::DuplicateLineDown => self.duplicate_lines(true),
173            Message::ToggleComment => self.toggle_comment(),
174        }
175    }
176}
177
178#[cfg(test)]
179mod tests {
180    use super::*;
181
182    #[test]
183    fn test_escape_collapses_multi_cursor() {
184        let mut editor = CodeEditor::new("line0\nline1", "rs");
185        editor.cursors.primary_mut().position = (0, 0);
186        editor.cursors.add_cursor((1, 0));
187        assert!(editor.cursors.is_multi());
188
189        let _ = editor.update(&Message::CloseSearch);
190
191        assert!(!editor.cursors.is_multi());
192    }
193}