tui-textarea/CHANGELOG.md

v0.2.1 - 01 Oct 2023

• ratatui crate is supported in addition to tui-rs. The ratatui crate is a community fork of inactive tui-rs crate. (#12)
  • The latest version of ratatui v0.23 is supported.
  • tui-textarea still uses tui-rs by default to keep the compatibility at this moment. ratatui users explicitly need to set features for it. See the installation document for the features matrix. For example, when you want to use ratatui and crossterm, write the following in your Cargo.toml:

    [dependencies]
    ratatui = "*"
    tui-textarea = { version = "*", features = ["ratatui-crossterm"], default-features = false }
    

  • tui-rs is no longer maintained and the repository was archived. At the next minor version bump, tui-textarea will switch the default features from tui-rs to ratatui. If you use tui-rs, I recommend to switch your dependency to ratatui and to prepare for the version bump.
  • Examples with ratatui are added to the examples directory. For example, the following command runs ratatui version of editor example:

    cargo run --example ratatui_editor --no-default-features --features=ratatui-crossterm,search file.txt
    

• Add support for the placeholder text which is rendered when no text is input in the textarea. (#16, thanks @pm100)
  • Use TextArea::set_placeholder_text to set the text. To change the text style, use TextArea::set_placeholder_style. See the documentation for more details.
  • popup_placeholder example was added to show the usage.

    cargo run --example popup_placeholder
    

• Derive Debug trait for TextArea struct. (#23)
• Fix a key input is received twice on Windows. (#17, thanks @pm100)

Changes

v0.2.0 - 18 Oct 2022

• Add Scrolling enum to provide more flexible scrolling via TextArea::scroll method. It has the following enum variants.
  • BREAKING Scrolling::Delta scrolls the textarea by given rows and cols. This variant can be converted from (i16, i16) so migrating from v0.1.6 is very easy.

    let rows: i16 = ...;
    let cols: i16 = ...;
    
    // Until v0.1.6
    textarea.scroll(rows, cols);
    
    // Since v0.2.0
    textarea.scroll((rows, cols));
    

  • Scrolling::PageDown and Scrolling::PageUp scroll the textarea by page.
  • Scrolling::HalfPageDown and Scrolling::HalfPageUp scroll the textarea by half-page.
• Update default key mappings handled by TextArea::input method.
  • BREAKING Change PageDown and PageUp keys to scroll down/up the textarea by page since v0.2.0. Until v0.1.6, it moved the cursor down/up by one paragraph.
  • Add Ctrl+V and Alt+V keys to scroll down/up the textarea by page as Emacs-like key mappings.
  • Add Alt+] and Alt+[ keys to move the cursor down/up by one paragraph as Emacs-like key mappings.
• BREAKING Add #[non_exhaustive] attribute to CursorMove enum. This is because more cursor move variations may be added in the future.
• Fix panic when the max history size is zero (which means the edit history is disabled). (#4)

Changes

v0.1.6 - 28 Sep 2022

• Support mouse scroll. (#2)
  • Handle mouse events for both crossterm and termion backends.
  • TextArea::scroll method was added.
  • Key::MouseScrollUp and Key::MouseScrollDown virtual keys are added to Key enum so that custom backends can support mouse scrolling.
  • CursorMove::InViewport variant was added to CursorMove enum, which ensures the cursor to be within the viewport.
• Add TextArea::alignment and TextArea::set_alignment to set the text alignment of textarea. Note that right and center alignments don't work well with line number so calling TextArea::set_alignment with them automatically disables it. (#3, thanks @Volkalex28)
• Set rust-version to 1.56.1 in Cargo.toml to show MSRV explicitly.

Changes

v0.1.5 - 18 Jul 2022

• Improve performance to render a textarea widget. When number of lines increases, now rendering lines is about 2~8x faster according to our benchmark suites. See the commit for more details of the benchmark results. This was archived by managing a vertical scroll position by ourselves instead of scroll handling by Paragraph. Previously, a cost of rendering lines was O(n) where n was number of all lines. Now the cost is O(1).
• Implement Clone for TextArea so that textarea instances can be copied easily. It is useful when you create multiple textarea instances with the same configuration. Create a first TextArea instance with configuring blocks and styles, then simply clone it.
• Add arbitrary feature which is disabled by default. By enabling it, Input, Key and CursorMove can be randomly generated via arbitrary crate. This feature aims to be used by fuzzing tests.
• Add many benchmark suites to track performance; insert/delete lines/characters, text search, moving a cursor.
• Improve fuzzing tests to include rendering a textarea to a dummy terminal backend and moving a cursor randomly.
• Refactor TextArea implementation. The implementation of text search was separated to src/search.rs. The implementation of highlighting was separated to src/highlight.rs. And the implementation of widget rendered by tui-rs was separated to src/widget.rs. These refactorings changed no public API.

Changes

v0.1.4 - 10 Jul 2022

• Fix the cursor line style was not applied when a cursor is at the end of line.
• Fix the cursor position after undoing the modification by 'delete until head of line' (^J by default).

Changes

v0.1.3 - 08 Jul 2022

• Text search was implemented. Text search is gated behind search feature flag to avoid depending on regex crate until it is necessary. See the usage document, the API document, and the working example for more details.
  • TextArea::set_search_pattern sets a search pattern in regular expression. This updates highlights at matches in textarea, but does not move the cursor.
  • TextArea::search_forward moves cursor to the next match of the text search based on current cursor position.
  • TextArea::search_back moves cursor to the previous match of the text search based on current cursor position.
  • TextArea::set_search_style sets the text style for highlighting matches of text search.

Changes

v0.1.2 - 25 Jun 2022

• Indent with hard tab is now supported. TextArea::set_hard_tab_indent method enables indentation with a hard tab on hitting a tab key.

  let mut textarea = TextArea::default();
  
  textarea.set_hard_tab_indent(true);
  textarea.insert_tab();
  assert_eq!(textarea.lines(), ["\t"]);
  

  Demo with cargo run --example editor:
• Add TextArea::indent method to get an indent string of textarea.

  let mut textarea = TextArea::default();
  
  assert_eq!(textarea.indent(), "    ");
  textarea.set_tab_length(2);
  assert_eq!(textarea.indent(), "  ");
  textarea.set_hard_tab_indent(true);
  assert_eq!(textarea.indent(), "\t");
  

Changes

v0.1.1 - 21 Jun 2022

• Add TextArea::yank_text and TextArea::set_yank_text to set/get yanked text of the textarea.

  let mut textarea = TextArea::default();
  textarea.set_yank_text("hello, world");
  assert_eq!(textarea.yank_text(), "hello, world");
  textarea.paste();
  assert_eq!(textarea.lines(), ["hello, world"]);
  

• Add CursorMove::Jump(row, col) variant to move cursor to arbitrary (row, col) position with TextArea::move_cursor.

  let mut textarea = TextArea::from(["aaaa", "bbbb"]);
  textarea.move_cursor(CursorMove::Jump(1, 2));
  assert_eq!(textarea.cursor(), (1, 2));
  

• Fix hard tabs are not rendered (#1)

Changes

v0.1.0 - 19 Jun 2022

First release 🎉

• GitHub repository: https://github.com/rhysd/tui-textarea
• crates.io: https://crates.io/crates/tui-textarea
• docs.rs: https://docs.rs/tui-textarea/latest/tui_textarea/

Changes