ratatui_ruby 0.10.1 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e12255e203dd3005db171f1c2062095644a5602b3384a1a820252f84f926abe
-  data.tar.gz: eefb8e9f9e5c4549eff00c36c4789ab7e13dbb508f7fb3edae86977eacdc17f5
+  metadata.gz: 8a44249eb77ada15e7b0705c6fc4367241584f68271d932bc76b1b2dc1ee7d98
+  data.tar.gz: 4758da71c5a93dd47d0f6b1929e8980ff70c9f4de49d09c70948546266b91def
 SHA512:
-  metadata.gz: 5cb1c1695d98e23db66e938e2f8525d148d2a0076520312d62f17aacfe437c116b35477dc9c670b8e0a452831ca2e6a34684feac38d928a988430f49795f4534
-  data.tar.gz: e3c222831be6b4812f41bfbffe15024508a587769df0cbf5f1b5a65f7ac19c0010dbab7ffcafe7d669c41817a6bb2475d2437522d587f13f8f79c07338d6ba9d
+  metadata.gz: bb685f50e374810635686659567feeca0bf0f47760718b84586226585e417c6bfb51a75720bc4ec563f49e80f46382a74283a22d523f38ff5b140cfe0e849cd8
+  data.tar.gz: 0e56b7c647489c2ef550575b6666317c9d93be3a911f386e2f113e3cb4a55eb0fc654623525d0117139466323496421770e487b4f547bddeac22df4024bf6de3

data/.builds/ruby-3.2.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-0.10.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-0.10.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.3.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-0.10.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-0.10.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.4.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-0.10.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-0.10.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-4.0.0.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-0.10.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-0.10.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/CHANGELOG.md

@@ -18,6 +18,29 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Removed
 
+## [0.10.2] - 2026-01-14
+
+### Added
+
+- **Experimental Labs System**: New `RatatuiRuby::Labs` module for opt-in experimental features via `RR_LABS` environment variable. Check with `Labs.enabled?(:a11y)` or enable programmatically with `Labs.enable!(:a11y)`. _Labs are subject to change even between patch releases._
+- **A11Y Widget Tree Export (Lab)**: When `RR_LABS=A11Y` is set, the widget tree is serialized to XML and written to `Dir.tmpdir/ratatui_a11y.xml` every frame. This exports semantic structure (`<Paragraph>`, `<List>`, etc.) for accessibility tooling integration. Access is through `RatatuiRuby::Labs::A11y.dump_widget_tree(widget)` or automatic via `RatatuiRuby.draw`.
+- **Inline Viewport**: New `viewport:` parameter for `init_terminal` and `run` accepts `:inline` or `:fullscreen` (default). Inline viewports occupy a fixed number of lines at the terminal bottom, preserving scrollback history above. Pass `height:` to specify inline viewport height (default: 8 lines). Fullscreen viewports use the alternate screen as before.
+- **Insert Before**: New `insert_before(height, widget)` method inserts content above an inline viewport into scrollback without disrupting the running TUI. Essential for logging status updates, progress messages, or diagnostic output while your inline TUI continues running. Only works with inline viewports; raises `Error::Invariant` in fullscreen mode.
+- **Terminal Area Accessors**: New methods to query terminal and viewport dimensions:
+  - `terminal_area` / `get_terminal_size` — full terminal backend size (always full dimensions)
+  - `viewport_area` / `get_viewport_area` — current viewport rendering area (inline viewport height or full terminal in fullscreen)
+  - Aliases: `terminal_size`, `viewport_size`, `get_terminal_area`, `get_viewport_size`
+- **Cursor Position Accessors**: New methods for querying and setting cursor position:
+  - `cursor_position` / `get_cursor_position` — returns current cursor position as `Layout::Position` or `[x, y]` array
+  - `cursor_position=` / `set_cursor_position` — sets cursor position from `Layout::Position`, array, or separate x/y arguments
+- **Error::Internal Exception**: New exception class for framework bugs, distinct from user errors. If you encounter this, please report it as a framework bug.
+
+### Changed
+
+### Fixed
+
+### Removed
+
 ## [0.10.1] - 2026-01-11
 
 ### Added
@@ -624,6 +647,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - **Testing Support**: Included `RatatuiRuby::TestHelper` and RSpec integration to make testing your TUI applications possible.
 
 [Unreleased]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/HEAD
+[0.10.2]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.2
 [0.10.1]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.1
 [0.10.1]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.1
 [0.10.1]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.1

data/doc/concepts/application_architecture.md

@@ -297,7 +297,7 @@ We provide these reference architectures to inspire you:
 
 ### Model-View-Update
 
-**Source:** [examples/app_all_events](../examples/app_all_events/README.md)
+**Source:** [examples/app_all_events](../../examples/app_all_events/README.md)
 
 This pattern implements unidirectional data flow inspired by The Elm Architecture:
 *   **Model:** A single immutable `Data.define` object holding all application state.
@@ -309,7 +309,7 @@ Use this when you want predictable state management and easy-to-test logic.
 
 ### Component-Based
 
-**Source:** [examples/app_color_picker](../examples/app_color_picker/README.md)
+**Source:** [examples/app_color_picker](../../examples/app_color_picker/README.md)
 
 This pattern addresses the difficulty of mouse interaction and complex UI orchestration:
 *   **Component Contract:** Every UI element implements `render(tui, frame, area)` and `handle_event(event)`.

data/doc/concepts/application_testing.md

@@ -190,4 +190,4 @@ See [RatatuiRuby::TestHelper::TestDoubles](../lib/ratatui_ruby/test_helper/test_
 
 ## Example
 
-Check out the [examples directory](../examples/) for fully tested applications showcasing these patterns.
+Check out the [examples directory](../../examples/) for fully tested applications showcasing these patterns.

data/doc/concepts/custom_widgets.md

@@ -242,6 +242,6 @@ The interface uses structural typing. Any class with a matching `render` signatu
 
 ## Related Resources
 
-- [Custom Render Example](../examples/widget_render/README.md) — Full working example
-- [Cell Example](../examples/widget_cell/README.md) — Low-level cell drawing
+- [Custom Render Example](../../examples/widget_render/README.md) — Full working example
+- [Cell Example](../../examples/widget_cell/README.md) — Low-level cell drawing
 - [Application Testing](./application_testing.md) — Test helper reference

data/doc/contributors/todo/align/api_completeness_audit-finished.md

@@ -0,0 +1,375 @@
+<!--
+SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+
+SPDX-License-Identifier: CC-BY-SA-4.0
+-->
+
+# Ratatui Features Audit - Complete Comprehensive Catalog
+
+These documents catalog EVERY public feature, method, function, enum variant, and constructor in the Ratatui Rust library with precise file/line references. This has the finished items; [the other has the unfinished items](./api_completeness_audit-unfinished.md).
+
+## Terminal & Initialization Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| run | ratatui/src/init.rs:251 | ✅ |
+| init | ratatui/src/init.rs:298 | ✅ |
+| init_with_options | ratatui/src/init.rs:382 | ✅ |
+| restore | ratatui/src/init.rs:457 | ✅ |
+| Viewport::Fullscreen | ratatui-core/src/terminal/viewport.rs:22 | ✅ |
+| Viewport::Inline(u16) | ratatui-core/src/terminal/viewport.rs:28 | ✅ |
+| Terminal::draw | ratatui-core/src/terminal/terminal.rs:373 | ✅ |
+| Terminal::size | ratatui-core/src/terminal/terminal.rs:568 | ✅ |
+| Terminal::insert_before | ratatui-core/src/terminal/terminal.rs:648 | ✅ |
+| TerminalOptions struct | ratatui-core/src/terminal/terminal.rs:104 | ✅ |
+| Frame struct | ratatui-core/src/terminal/frame.rs:17 | ✅ |
+| Frame::render_widget | ratatui-core/src/terminal/frame.rs:93 | ✅ |
+| Frame::render_stateful_widget | ratatui-core/src/terminal/frame.rs:124 | ✅ |
+| Frame::set_cursor_position | ratatui-core/src/terminal/frame.rs:141 | ✅ |
+
+
+## Layout Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Layout struct | ratatui-core/src/layout/layout.rs:193 | ✅ |
+| Layout::horizontal | ratatui-core/src/layout/layout.rs:285 | ✅ |
+| Layout::vertical | ratatui-core/src/layout/layout.rs:265 | ✅ |
+| Layout::constraints | ratatui-core/src/layout/layout.rs:377 | ✅ |
+| Layout::spacing | ratatui-core/src/layout/layout.rs:521 | ✅ |
+| Layout::split | ratatui-core/src/layout/layout.rs:663 | ✅ |
+| Layout::split_with_spacers | ratatui-core/src/layout/layout.rs:713 | ✅ |
+| Constraint::Min(u16) | ratatui-core/src/layout/constraint.rs:94 | ✅ |
+| Constraint::Max(u16) | ratatui-core/src/layout/constraint.rs:117 | ✅ |
+| Constraint::Length(u16) | ratatui-core/src/layout/constraint.rs:140 | ✅ |
+| Constraint::Percentage(u16) | ratatui-core/src/layout/constraint.rs:168 | ✅ |
+|  Constraint::Ratio(u32, u32) | ratatui-core/src/layout/constraint.rs:192 | ✅ |
+| Constraint::Fill(u16) | ratatui-core/src/layout/constraint.rs:218 | ✅ |
+| Constraint::from_lengths | ratatui-core/src/layout/constraint.rs:230 | ✅ |
+| Constraint::from_ratios | ratatui-core/src/layout/constraint.rs:254 | ✅ |
+| Constraint::from_percentages | ratatui-core/src/layout/constraint.rs:277 | ✅ |
+| Constraint::from_maxes | ratatui-core/src/layout/constraint.rs:300 | ✅ |
+| Constraint::from_mins | ratatui-core/src/layout/constraint.rs:320 | ✅ |
+| Constraint::from_fills | ratatui-core/src/layout/constraint.rs:341 | ✅ |
+| Flex::Legacy | ratatui-core/src/layout/flex.rs:75 | ✅ |
+| Flex::Start | ratatui-core/src/layout/flex.rs:98 | ✅ |
+| Flex::End | ratatui-core/src/layout/flex.rs:120 | ✅ |
+| Flex::Center | ratatui-core/src/layout/flex.rs:142 | ✅ |
+| Flex::SpaceBetween | ratatui-core/src/layout/flex.rs:164 | ✅ |
+| Flex::SpaceEvenly | ratatui-core/src/layout/flex.rs:187 | ✅ |
+| Flex::SpaceAround | ratatui-core/src/layout/flex.rs:209 | ✅ |
+| Direction::Horizontal | ratatui-core/src/layout/direction.rs:16 | ✅ |
+| Direction::Vertical | ratatui-core/src/layout/direction.rs:20 | ✅ |
+| Position struct | ratatui-core/src/layout/position.rs:57 | ✅ |
+| Size struct | ratatui-core/src/layout/size.rs:46 | ✅ |
+| Rect struct | ratatui-core/src/layout/rect.rs:134 | ✅ |
+| Rect::new | ratatui-core/src/layout/rect.rs:166 | ✅ |
+| Rect::area | ratatui-core/src/layout/rect.rs:190 | ✅ |
+| Rect::is_empty | ratatui-core/src/layout/rect.rs:195 | ✅ |
+| Rect::left | ratatui-core/src/layout/rect.rs:200 | ✅ |
+| Rect::right | ratatui-core/src/layout/rect.rs:205 | ✅ |
+| Rect::top | ratatui-core/src/layout/rect.rs:214 | ✅ |
+| Rect::bottom | ratatui-core/src/layout/rect.rs:219 | ✅ |
+| Rect::inner | ratatui-core/src/layout/rect.rs:228 | ✅ |
+| Rect::outer | ratatui-core/src/layout/rect.rs:248 | ✅ |
+| Rect::offset | ratatui-core/src/layout/rect.rs:276 | ✅ |
+| Rect::resize | ratatui-core/src/layout/rect.rs:289 | ✅ |
+| Rect::union | ratatui-core/src/layout/rect.rs:305 | ✅ |
+| Rect::intersection | ratatui-core/src/layout/rect.rs:322 | ✅ |
+| Rect::clamp | ratatui-core/src/layout/rect.rs:387 | ✅ |
+| Rect::rows | ratatui-core/src/layout/rect/iter.rs:4 | ✅ |
+| Rect::columns | ratatui-core/src/layout/rect/iter.rs:66 | ✅ |
+| Rect::positions | ratatui-core/src/layout/rect/iter.rs:130 | ✅ |
+
+## Style Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Color::Reset | ratatui-core/src/style/color.rs:30 | ✅ |
+| Color::Black | ratatui-core/src/style/color.rs:32 | ✅ |
+| Color::Red | ratatui-core/src/style/color.rs:34 | ✅ |
+| Color::Green | ratatui-core/src/style/color.rs:36 | ✅ |
+| Color::Yellow | ratatui-core/src/style/color.rs:38 | ✅ |
+| Color::Blue | ratatui-core/src/style/color.rs:40 | ✅ |
+| Color::Magenta | ratatui-core/src/style/color.rs:42 | ✅ |
+| Color::Cyan | ratatui-core/src/style/color.rs:44 | ✅ |
+| Color::Gray | ratatui-core/src/style/color.rs:46 | ✅ |
+| Color::DarkGray | ratatui-core/src/style/color.rs:48 | ✅ |
+| Color::LightRed | ratatui-core/src/style/color.rs:50 | ✅ |
+| Color::LightGreen | ratatui-core/src/style/color.rs:52 | ✅ |
+| Color::LightYellow | ratatui-core/src/style/color.rs:54 | ✅ |
+| Color::LightBlue | ratatui-core/src/style/color.rs:56 | ✅ |
+| Color::LightMagenta | ratatui-core/src/style/color.rs:58 | ✅ |
+| Color::LightCyan | ratatui-core/src/style/color.rs:60 | ✅ |
+| Color::White | ratatui-core/src/style/color.rs:62 | ✅ |
+| Color::Rgb(u8, u8, u8) | ratatui-core/src/style/color.rs:64 | ✅ |
+| Color::Indexed(u8) | ratatui-core/src/style/color.rs:66 | ✅ |
+| Color::from_u32 | ratatui-core/src/style/color.rs:133 | ✅ |
+| Color::from_hsl | ratatui-core/src/style/color.rs:416 | ✅ |
+| Color::from_hsluv | ratatui-core/src/style/color.rs:469 | ✅ |
+| Style struct | ratatui-core/src/style.rs:239 | ✅ |
+| Style::fg | ratatui-core/src/style.rs:335 | ✅ |
+| Style::bg | ratatui-core/src/style.rs:352 | ✅ |
+| Style::underline_color | ratatui-core/src/style.rs:387 | ✅ |
+| Style::add_modifier | ratatui-core/src/style.rs:408 | ✅ |
+| Style::remove_modifier | ratatui-core/src/style.rs:430 | ✅ |
+| Modifier::BOLD | ratatui-core/src/style.rs:105 | ✅ |
+| Modifier::DIM | ratatui-core/src/style.rs:106 | ✅ |
+| Modifier::ITALIC | ratatui-core/src/style.rs:107 | ✅ |
+| Modifier::UNDERLINED | ratatui-core/src/style.rs:108 | ✅ |
+| Modifier::SLOW_BLINK | ratatui-core/src/style.rs:109 | ✅ |
+| Modifier::RAPID_BLINK | ratatui-core/src/style.rs:110 | ✅ |
+| Modifier::REVERSED | ratatui-core/src/style.rs:111 | ✅ |
+| Modifier::HIDDEN | ratatui-core/src/style.rs:112 | ✅ |
+| Modifier::CROSSED_OUT | ratatui-core/src/style.rs:113 | ✅ |
+
+## Text Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------| -------|
+| Text struct | ratatui-core/src/text/text.rs:196 | ✅ |
+| Span struct | ratatui-core/src/text/span.rs:99 | ✅ |
+| Line struct | ratatui-core/src/text/line.rs:183 | ✅ |
+
+## Symbol Sets
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| half_block::UPPER | ratatui-core/src/symbols/half_block.rs:1 | ✅ |
+| half_block::LOWER | ratatui-core/src/symbols/half_block.rs:3 | ✅ |
+| half_block::FULL | ratatui-core/src/symbols/half_block.rs:5 | ✅ |
+| Marker::Dot | ratatui-core/src/symbols/marker.rs:11 | ✅ |
+| Marker::Block | ratatui-core/src/symbols/marker.rs:13 | ✅ |
+| Marker::Bar | ratatui-core/src/symbols/marker.rs:17 | ✅ |
+| Marker::Braille | ratatui-core/src/symbols/marker.rs:21 | ✅ |
+| Marker::HalfBlock | ratatui-core/src/symbols/marker.rs:25 | ✅ |
+| bar::Set struct | ratatui-core/src/symbols/bar.rs:8 | ✅ |
+| bar::THREE_LEVELS | ratatui-core/src/symbols/bar.rs:29 | ✅ |
+| bar::NINE_LEVELS | ratatui-core/src/symbols/bar.rs:41 | ✅ |
+| border::Set struct | ratatui-core/src/symbols/border.rs:12 | ✅ |
+| border::PLAIN | ratatui-core/src/symbols/border.rs:43 | ✅ |
+| border::ROUNDED | ratatui-core/src/symbols/border.rs:62 | ✅ |
+| border::DOUBLE | ratatui-core/src/symbols/border.rs:81 | ✅ |
+| border::THICK | ratatui-core/src/symbols/border.rs:100 | ✅ |
+| border::QUADRANT_OUTSIDE | ratatui-core/src/symbols/border.rs:195 | ✅ |
+| border::QUADRANT_INSIDE | ratatui-core/src/symbols/border.rs:214 | ✅ |
+| line::Set struct | ratatui-core/src/symbols/line.rs:62 | ✅ |
+| line::NORMAL | ratatui-core/src/symbols/line.rs:82 | ✅ |
+| line::DOUBLE | ratatui-core/src/symbols/line.rs:104 | ✅ |
+| line::THICK | ratatui-core/src/symbols/line.rs:118 | ✅ |
+
+## Widgets
+
+### Paragraph Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Paragraph struct | ratatui-widgets/src/paragraph.rs:80 | ✅ |
+| Paragraph::block | ratatui-widgets/src/paragraph.rs:174 | ✅ |
+| Paragraph::style | ratatui-widgets/src/paragraph.rs:198 | ✅ |
+| Paragraph::wrap | ratatui-widgets/src/paragraph.rs:115 | ✅ |
+| Paragraph::scroll | ratatui-widgets/src/paragraph.rs:161 | ✅ |
+| Paragraph::alignment | ratatui-widgets/src/paragraph.rs:199 | ✅ |
+| Wrap struct | ratatui-widgets/src/paragraph.rs:240 | ✅ |
+| Wrap::trim | ratatui-widgets/src/paragraph.rs:242 | ✅ |
+
+### Block Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Block struct | ratatui-widgets/src/block.rs:75 | ✅ |
+| Block::borders | ratatui-widgets/src/block.rs:85 | ✅ |
+| Block::border_style | ratatui-widgets/src/block.rs:89 | ✅ |
+| Block::border_set | ratatui-widgets/src/block.rs:91 | ✅ |
+| Block::padding | ratatui-widgets/src/block.rs:97 | ✅ |
+| Padding struct | ratatui-widgets/src/block/padding.rs:27 | ✅ |
+| Padding::ZERO | ratatui-widgets/src/block/padding.rs:40 | ✅ |
+| Padding::new | ratatui-widgets/src/block/padding.rs:50 | ✅ |
+| Padding::horizontal | ratatui-widgets/src/block/padding.rs:66 | ✅ |
+| Padding::vertical | ratatui-widgets/src/block/padding.rs:76 | ✅ |
+| Padding::uniform | ratatui-widgets/src/block/padding.rs:86 | ✅ |
+| Padding::proportional | ratatui-widgets/src/block/padding.rs:99 | ✅ |
+|  Padding::symmetric | ratatui-widgets/src/block/padding.rs:112 | ✅ |
+| Padding::left | ratatui-widgets/src/block/padding.rs:122 | ✅ |
+| Padding::right | ratatui-widgets/src/block/padding.rs:132 | ✅ |
+| Padding::top | ratatui-widgets/src/block/padding.rs:142 | ✅ |
+| Padding::bottom | ratatui-widgets/src/block/padding.rs:152 | ✅ |
+| Borders::TOP | ratatui-widgets/src/borders.rs:33 | ✅ |
+| Borders::RIGHT | ratatui-widgets/src/borders.rs:35 | ✅ |
+| Borders::BOTTOM | ratatui-widgets/src/borders.rs:37 | ✅ |
+| Borders::LEFT | ratatui-widgets/src/borders.rs:39 | ✅ |
+| Borders::ALL | ratatui-widgets/src/borders.rs:41 | ✅ |
+| Borders::NONE | ratatui-widgets/src/borders.rs:43 | ✅ |
+| BorderType::Plain | ratatui-widgets/src/borders.rs:64 | ✅ |
+| BorderType::Rounded | ratatui-widgets/src/borders.rs:66 | ✅ |
+| BorderType::Double | ratatui-widgets/src/borders.rs:71 | ✅ |
+| BorderType::Thick | ratatui-widgets/src/borders.rs:81 | ✅ |
+| BorderType::QuadrantInside | ratatui-widgets/src/borders.rs:139 | ✅ |
+| BorderType::QuadrantOutside | ratatui-widgets/src/borders.rs:144 | ✅ |
+| TitlePosition::Top | ratatui-widgets/src/block.rs:49 | ✅ |
+| TitlePosition::Bottom | ratatui-widgets/src/block.rs:51 | ✅ |
+
+### Table Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Table struct | ratatui-widgets/src/table.rs:233 | ✅ |
+| Table::rows | ratatui-widgets/src/table.rs:235 | ✅ |
+| Table::header | ratatui-widgets/src/table.rs:238 | ✅ |
+| Table::footer | ratatui-widgets/src/table.rs:241 | ✅ |
+| Table::widths | ratatui-widgets/src/table.rs:244 | ✅ |
+| Table::column_spacing | ratatui-widgets/src/table.rs:247 | ✅ |
+| Table::row_highlight_style | ratatui-widgets/src/table.rs:256 | ✅ |
+| Table::column_highlight_style | ratatui-widgets/src/table.rs:259 | ✅ |
+| Table::cell_highlight_style | ratatui-widgets/src/table.rs:262 | ✅ |
+|  Table::highlight_symbol | ratatui-widgets/src/table.rs:265 | ✅ |
+| Table::highlight_spacing | ratatui-widgets/src/table.rs:268 | ✅ |
+| Table::flex | ratatui-widgets/src/table.rs:271 | ✅ |
+| Row struct | ratatui-widgets/src/table/row.rs:75 | ✅ |
+| Cell struct | ratatui-widgets/src/table/cell.rs:51 | ✅ |
+| HighlightSpacing::Always | ratatui-widgets/src/table/highlight_spacing.rs:10 | ✅ |
+| HighlightSpacing::WhenSelected | ratatui-widgets/src/table/highlight_spacing.rs:14 | ✅ |
+| HighlightSpacing::Never | ratatui-widgets/src/table/highlight_spacing.rs:18 | ✅ |
+
+
+### List Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| List struct | ratatui-widgets/src/list.rs:109 | ✅ |
+| List::items | ratatui-widgets/src/list.rs:113 | ✅ |
+| List::direction | ratatui-widgets/src/list.rs:117 | ✅ |
+| List::highlight_style | ratatui-widgets/src/list.rs:119 | ✅ |
+| List::highlight_symbol | ratatui-widgets/src/list.rs:121 | ✅ |
+| List::repeat_highlight_symbol | ratatui-widgets/src/list.rs:123 | ✅ |
+| List::highlight_spacing | ratatui-widgets/src/list.rs:125 | ✅ |
+| List::scroll_padding | ratatui-widgets/src/list.rs:127 | ✅ |
+| ListDirection::TopToBottom | ratatui-widgets/src/list.rs:140 | ✅ |
+| ListDirection::BottomToTop | ratatui-widgets/src/list.rs:142 | ✅ |
+| ListItem struct | ratatui-widgets/src/list/item.rs:73 | ✅ |
+
+
+### BarChart Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| BarChart struct | ratatui-widgets/src/barchart.rs:83 | ✅ |
+| BarChart::bar_width | ratatui-widgets/src/barchart.rs:87 | ✅ |
+| BarChart::bar_gap | ratatui-widgets/src/barchart.rs:89 | ✅ |
+| BarChart::group_gap | ratatui-widgets/src/barchart.rs:91 | ✅ |
+| BarChart::bar_set | ratatui-widgets/src/barchart.rs:93 | ✅ |
+| BarChart::max | ratatui-widgets/src/barchart.rs:106 | ✅ |
+| BarChart::direction | ratatui-widgets/src/barchart.rs:108 | ✅ |
+| Bar struct | ratatui-widgets/src/barchart/bar.rs:34 | ✅ |
+| BarGroup struct | ratatui-widgets/src/barchart/bar_group.rs:21 | ✅ |
+
+### Chart Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Chart struct | ratatui-widgets/src/chart.rs:510 | ✅ |
+| Axis struct | ratatui-widgets/src/chart.rs:40 | ✅ |
+| Axis::bounds | ratatui-widgets/src/chart.rs:44 | ✅ |
+| Axis::labels | ratatui-widgets/src/chart.rs:46 | ✅ |
+| Axis::labels_alignment | ratatui-widgets/src/chart.rs:50 | ✅ |
+| Dataset struct | ratatui-widgets/src/chart.rs:320 | ✅ |
+| Dataset::marker | ratatui-widgets/src/chart.rs:326 | ✅ |
+| Dataset::graph_type | ratatui-widgets/src/chart.rs:328 | ✅ |
+| GraphType::Scatter | ratatui-widgets/src/chart.rs:161 | ✅ |
+| GraphType::Line | ratatui-widgets/src/chart.rs:167 | ✅ |
+| GraphType::Bar | ratatui-widgets/src/chart.rs:170 | ✅ |
+| LegendPosition::TopLeft | ratatui-widgets/src/chart.rs:184 | ✅ |
+| LegendPosition::Top | ratatui-widgets/src/chart.rs:179 | ✅ |
+| LegendPosition::TopRight | ratatui-widgets/src/chart.rs:182 | ✅ |
+| LegendPosition::Left | ratatui-widgets/src/chart.rs:186 | ✅ |
+| LegendPosition::Right | ratatui-widgets/src/chart.rs:187 | ✅ |
+| LegendPosition::BottomLeft | ratatui-widgets/src/chart.rs:194 | ✅ |
+| LegendPosition::Bottom | ratatui-widgets/src/chart.rs:190 | ✅ |
+| LegendPosition::BottomRight | ratatui-widgets/src/chart.rs:192 | ✅ |
+
+### Gauge Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Gauge struct | ratatui-widgets/src/gauge.rs:45 | ✅ |
+| Gauge::ratio | ratatui-widgets/src/gauge.rs:47 | ✅ |
+| Gauge::label | ratatui-widgets/src/gauge.rs:48 | ✅ |
+| Gauge::use_unicode | ratatui-widgets/src/gauge.rs:49 | ✅ |
+| Gauge::gauge_style | ratatui-widgets/src/gauge.rs:51 | ✅ |
+| LineGauge struct | ratatui-widgets/src/gauge.rs:269 | ✅ |
+| LineGauge::filled_symbol | ratatui-widgets/src/gauge.rs:274 | ✅ |
+| LineGauge::unfilled_symbol | ratatui-widgets/src/gauge.rs:275 | ✅ |
+| LineGauge::filled_style | ratatui-widgets/src/gauge.rs:276 | ✅ |
+| LineGauge::unfilled_style | ratatui-widgets/src/gauge.rs:277 | ✅ |
+
+### Sparkline Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Sparkline struct | ratatui-widgets/src/sparkline.rs:66 | ✅ |
+| RenderDirection::LeftToRight | ratatui-widgets/src/sparkline.rs:93 | ✅ |
+| RenderDirection::RightToLeft | ratatui-widgets/src/sparkline.rs:96 | ✅ |
+
+### Scrollbar Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Scrollbar struct | ratatui-widgets/src/scrollbar.rs:87 | ✅ |
+| ScrollbarOrientation::VerticalRight | ratatui-widgets/src/scrollbar.rs:112 | ✅ |
+| ScrollbarOrientation::VerticalLeft | ratatui-widgets/src/scrollbar.rs:115 | ✅ |
+| ScrollbarOrientation::HorizontalBottom | ratatui-widgets/src/scrollbar.rs:118 | ✅ |
+| ScrollbarOrientation::HorizontalTop | ratatui-widgets/src/scrollbar.rs:121 | ✅ |
+
+
+### Calendar Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Monthly struct | ratatui-widgets/src/calendar.rs:26 | ✅ |
+
+### Canvas Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Canvas struct | ratatui-widgets/src/canvas.rs:721 | ✅ |
+| Line shape | ratatui-widgets/src/canvas/line.rs:8 | ✅ |
+| Circle shape | ratatui-widgets/src/canvas/circle.rs:9 | ✅ |
+| Rectangle shape | ratatui-widgets/src/canvas/rectangle.rs:10 | ✅ |
+| Map struct | ratatui-widgets/src/canvas/map.rs:38 | ✅ |
+| MapResolution::Low | ratatui-widgets/src/canvas/map.rs:13 | ✅ |
+| MapResolution::High | ratatui-widgets/src/canvas/map.rs:16 | ✅ |
+
+### Tabs Widget
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Tabs struct | ratatui-widgets/src/tabs.rs:51 | ✅ |
+
+### Other Widgets
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Clear widget | ratatui-widgets/src/clear.rs:30 | ✅ |
+| RatatuiLogo widget | ratatui-widgets/src/logo.rs:59 | ✅ |
+| RatatuiLogo Size::Tiny | ratatui-widgets/src/logo.rs:68 | ✅ |
+| RatatuiLogo Size::Small | ratatui-widgets/src/logo.rs:71 | ✅ |
+| RatatuiLogo Size::Medium | ratatui-widgets/src/logo.rs:74 | ✅ |
+| RatatuiLogo Size::Large | ratatui-widgets/src/logo.rs:77 | ✅ |
+
+## Buffer Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| Buffer struct | ratatui-core/src/buffer/buffer.rs:66 | ✅ |
+| Buffer::content | ratatui-core/src/buffer/buffer.rs:107 | ✅ |
+| Buffer::get | ratatui-core/src/buffer/buffer.rs:130 | ✅ |
+| Cell struct | ratatui-core/src/buffer/cell.rs:9 | ✅ |
+
+
+
+## Backend Features
+
+| Feature Name | File/Line | Status |
+|--------------|-----------|--------|
+| TestBackend | ratatui-core/src/backend/test.rs:* | ✅ |
+| CrosstermBackend | ratatui-crossterm/src/lib.rs:* | ✅ |