// Each component declares it's own size constraints and gets fitted based on it's parent. // Q: how does this work with popups? // cursive does compositor.screen_mut().add_layer_at(pos::absolute(x, y), ) use helix_core::Position; use helix_view::graphics::{CursorKind, Rect}; #[cfg(feature = "integration")] use tui::backend::TestBackend; use tui::buffer::Buffer as Surface; pub type Callback = Box; // Cursive-inspired pub enum EventResult { Ignored(Option), Consumed(Option), } use crate::job::Jobs; use helix_view::Editor; pub use helix_view::input::Event; pub struct Context<'a> { pub editor: &'a mut Editor, pub scroll: Option, pub jobs: &'a mut Jobs, } impl<'a> Context<'a> { /// Waits on all pending jobs, and then tries to flush all pending write /// operations for all documents. pub fn block_try_flush_writes(&mut self) -> anyhow::Result<()> { tokio::task::block_in_place(|| helix_lsp::block_on(self.jobs.finish(self.editor, None)))?; tokio::task::block_in_place(|| helix_lsp::block_on(self.editor.flush_writes()))?; Ok(()) } } pub trait Component: Any + AnyComponent { /// Process input events, return true if handled. fn handle_event(&mut self, _event: &Event, _ctx: &mut Context) -> EventResult { EventResult::Ignored(None) } // , args: () /// Should redraw? Useful for saving redraw cycles if we know component didn't change. fn should_update(&self) -> bool { true } /// Render the component onto the provided surface. fn render(&mut self, area: Rect, frame: &mut Surface, ctx: &mut Context); /// Get cursor position and cursor kind. fn cursor(&self, _area: Rect, _ctx: &Editor) -> (Option, CursorKind) { (None, CursorKind::Hidden) } /// May be used by the parent component to compute the child area. /// viewport is the maximum allowed area, and the child should stay within those bounds. /// /// The returned size might be larger than the viewport if the child is too big to fit. /// In this case the parent can use the values to calculate scroll. fn required_size(&mut self, _viewport: (u16, u16)) -> Option<(u16, u16)> { None } fn type_name(&self) -> &'static str { std::any::type_name::() } fn id(&self) -> Option<&'static str> { None } } use anyhow::Context as AnyhowContext; use tui::backend::Backend; #[cfg(not(feature = "integration"))] use tui::backend::CrosstermBackend; #[cfg(not(feature = "integration"))] use std::io::stdout; #[cfg(not(feature = "integration"))] type Terminal = tui::terminal::Terminal>; #[cfg(feature = "integration")] type Terminal = tui::terminal::Terminal; pub struct Compositor { layers: Vec>, terminal: Terminal, area: Rect, pub(crate) last_picker: Option>, } impl Compositor { pub fn new() -> anyhow::Result { #[cfg(not(feature = "integration"))] let backend = CrosstermBackend::new(stdout()); #[cfg(feature = "integration")] let backend = TestBackend::new(120, 150); let terminal = Terminal::new(backend).context("build terminal")?; let area = terminal.size().expect("couldn't get terminal size"); Ok(Self { layers: Vec::new(), area, terminal, last_picker: None, }) } pub fn size(&self) -> Rect { self.area } pub fn resize(&mut self, width: u16, height: u16) { self.terminal .resize(Rect::new(0, 0, width, height)) .expect("Unable to resize terminal"); self.area = self.terminal.size().expect("couldn't get terminal size"); } pub fn save_cursor(&mut self) { if self.terminal.cursor_kind() == CursorKind::Hidden { self.terminal .backend_mut() .show_cursor(CursorKind::Block) .ok(); } } pub fn load_cursor(&mut self) { if self.terminal.cursor_kind() == CursorKind::Hidden { self.terminal.backend_mut().hide_cursor().ok(); } } pub fn push(&mut self, mut layer: Box) { let size = self.size(); // trigger required_size on init layer.required_size((size.width, size.height)); self.layers.push(layer); } /// Replace a component that has the given `id` with the new layer and if /// no component is found, push the layer normally. pub fn replace_or_push(&mut self, id: &'static str, layer: T) { if let Some(component) = self.find_id(id) { *component = layer; } else { self.push(Box::new(layer)) } } pub fn pop(&mut self) -> Option> { self.layers.pop() } pub fn remove(&mut self, id: &'static str) -> Option> { let idx = self .layers .iter() .position(|layer| layer.id() == Some(id))?; Some(self.layers.remove(idx)) } pub fn handle_event(&mut self, event: &Event, cx: &mut Context) -> bool { // If it is a key event and a macro is being recorded, push the key event to the recording. if let (Event::Key(key), Some((_, keys))) = (event, &mut cx.editor.macro_recording) { keys.push(*key); } let mut callbacks = Vec::new(); let mut consumed = false; // propagate events through the layers until we either find a layer that consumes it or we // run out of layers (event bubbling) for layer in self.layers.iter_mut().rev() { match layer.handle_event(event, cx) { EventResult::Consumed(Some(callback)) => { callbacks.push(callback); consumed = true; break; } EventResult::Consumed(None) => { consumed = true; break; } EventResult::Ignored(Some(callback)) => { callbacks.push(callback); } EventResult::Ignored(None) => {} }; } for callback in callbacks { callback(self, cx) } consumed } pub fn render(&mut self, cx: &mut Context) { self.terminal .autoresize() .expect("Unable to determine terminal size"); // TODO: need to recalculate view tree if necessary let surface = self.terminal.current_buffer_mut(); let area = *surface.area(); for layer in &mut self.layers { layer.render(area, surface, cx); } let (pos, kind) = self.cursor(area, cx.editor); let pos = pos.map(|pos| (pos.col as u16, pos.row as u16)); self.terminal.draw(pos, kind).unwrap(); } pub fn cursor(&self, area: Rect, editor: &Editor) -> (Option, CursorKind) { for layer in self.layers.iter().rev() { if let (Some(pos), kind) = layer.cursor(area, editor) { return (Some(pos), kind); } } (None, CursorKind::Hidden) } pub fn has_component(&self, type_name: &str) -> bool { self.layers .iter() .any(|component| component.type_name() == type_name) } pub fn find(&mut self) -> Option<&mut T> { let type_name = std::any::type_name::(); self.layers .iter_mut() .find(|component| component.type_name() == type_name) .and_then(|component| component.as_any_mut().downcast_mut()) } pub fn find_id(&mut self, id: &'static str) -> Option<&mut T> { self.layers .iter_mut() .find(|component| component.id() == Some(id)) .and_then(|component| component.as_any_mut().downcast_mut()) } } // View casting, taken straight from Cursive use std::any::Any; /// A view that can be downcasted to its concrete type. /// /// This trait is automatically implemented for any `T: Component`. pub trait AnyComponent { /// Downcast self to a `Any`. fn as_any(&self) -> &dyn Any; /// Downcast self to a mutable `Any`. fn as_any_mut(&mut self) -> &mut dyn Any; /// Returns a boxed any from a boxed self. /// /// Can be used before `Box::downcast()`. /// /// # Examples /// /// ```rust /// use helix_term::{ui::Text, compositor::Component}; /// let boxed: Box = Box::new(Text::new("text".to_string())); /// let text: Box = boxed.as_boxed_any().downcast().unwrap(); /// ``` fn as_boxed_any(self: Box) -> Box; } impl AnyComponent for T { /// Downcast self to a `Any`. fn as_any(&self) -> &dyn Any { self } /// Downcast self to a mutable `Any`. fn as_any_mut(&mut self) -> &mut dyn Any { self } fn as_boxed_any(self: Box) -> Box { self } } impl dyn AnyComponent { /// Attempts to downcast `self` to a concrete type. pub fn downcast_ref(&self) -> Option<&T> { self.as_any().downcast_ref() } /// Attempts to downcast `self` to a concrete type. pub fn downcast_mut(&mut self) -> Option<&mut T> { self.as_any_mut().downcast_mut() } /// Attempts to downcast `Box` to a concrete type. pub fn downcast(self: Box) -> Result, Box> { // Do the check here + unwrap, so the error // value is `Self` and not `dyn Any`. if self.as_any().is::() { Ok(self.as_boxed_any().downcast().unwrap()) } else { Err(self) } } /// Checks if this view is of type `T`. pub fn is(&mut self) -> bool { self.as_any().is::() } }