ratatui_ruby 1.2.0 → 1.2.2

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

@@ -1,200 +0,0 @@
-<!--
-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 unfinished items; [the other has the finished items](./api_completeness_audit-finished.md).
-
-## Terminal & Initialization Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| try_init | ratatui/src/init.rs:330 | ❌ |
-| try_init_with_options | ratatui/src/init.rs:425 | ❌ |
-| try_restore | ratatui/src/init.rs:487 | ❌ |
-| Viewport::Fixed(Rect) | ratatui-core/src/terminal/viewport.rs:30 | ❌ |
-| Terminal struct | ratatui-core/src/terminal/terminal.rs:76 | ⚠️ |
-| Terminal::hide_cursor | ratatui-core/src/terminal/terminal.rs:495 | ❌ |
-| Terminal::show_cursor | ratatui-core/src/terminal/terminal.rs:502 | ❌ |
-| Terminal::get_cursor | ratatui-core/src/terminal/terminal.rs:513 | ❌ |
-| Terminal::set_cursor | ratatui-core/src/terminal/terminal.rs:520 | ❌ |
-| Terminal::get_cursor_position | ratatui-core/src/terminal/terminal.rs:527 | ⚠️ |
-| Terminal::set_cursor_position | ratatui-core/src/terminal/terminal.rs:532 | ⚠️ |
-| Terminal::clear | ratatui-core/src/terminal/terminal.rs:540 | ❌ |
-| Terminal::swap_buffers | ratatui-core/src/terminal/terminal.rs:562 | ❌ |
-| CompletedFrame struct | ratatui-core/src/terminal/frame.rs:40 | ❌ |
-
-**Notes:**
-- **Terminal struct**: No direct Terminal object; abstracted behind `RatatuiRuby` module methods
-- **Terminal::get_cursor_position/set_cursor_position**: Only available via [Frame](../../../../lib/ratatui_ruby/frame.rb#72-257) during draw, not on Terminal
-
-## Layout Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Spacing enum | ratatui-core/src/layout/layout.rs:80 | ❌ |
-| Offset struct | ratatui-core/src/layout/offset.rs:10 | ❌ |
-| Margin struct | ratatui-core/src/layout/margin.rs:38 | ❌ |
-
-## Style Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Styled trait | ratatui-core/src/style/stylize.rs:15 | ❌ |
-| Stylize trait | ratatui-core/src/style/stylize.rs:* | ❌ |
-
-## Text Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------| -------|
-| Masked struct | ratatui-core/src/text/masked.rs:26 | ❌ |
-| ToText trait | ratatui-core/src/text/text.rs:721 | ❌ |
-| ToSpan trait | ratatui-core/src/text/span.rs:481 | ❌ |
-| StyledGrapheme struct | ratatui-core/src/text/grapheme.rs:12 | ❌ |
-| ToLine trait | ratatui-core/src/text/line.rs:810 | ❌ |
-
-## Widgets
-
-### Block Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| BorderType::LightDoubleDashed | ratatui-widgets/src/borders.rs:89 | ❌ |
-| BorderType::HeavyDoubleDashed | ratatui-widgets/src/borders.rs:97 | ❌ |
-| BorderType::LightTripleDashed | ratatui-widgets/src/borders.rs:105 | ❌ |
-| BorderType::HeavyTripleDashed | ratatui-widgets/src/borders.rs:113 | ❌ |
-| BorderType::LightQuadrupleDashed | ratatui-widgets/src/borders.rs:121 | ❌ |
-| BorderType::HeavyQuadrupleDashed | ratatui-widgets/src/borders.rs:129 | ❌ |
-
-### Table Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| TableState struct | ratatui-widgets/src/table/state.rs:55 | ⚠️ |
-| TableState::new | ratatui-widgets/src/table/state.rs:62 | ⚠️ |
-| TableState::with_offset | ratatui-widgets/src/table/state.rs:79 | ❌ |
-| TableState::with_selected | ratatui-widgets/src/table/state.rs:96 | ❌ |
-| TableState::with_selected_column | ratatui-widgets/src/table/state.rs:116 | ❌ |
-| TableState::with_selected_cell | ratatui-widgets/src/table/state.rs:135 | ❌ |
-| TableState::offset | ratatui-widgets/src/table/state.rs:161 | ⚠️ |
-| TableState::offset_mut | ratatui-widgets/src/table/state.rs:175 | ❌ |
-| TableState::selected | ratatui-widgets/src/table/state.rs:189 | ⚠️ |
-|  TableState::selected_column | ratatui-widgets/src/table/state.rs:205 | ⚠️ |
-| TableState::selected_cell | ratatui-widgets/src/table/state.rs:220 | ❌ |
-| TableState::selected_mut | ratatui-widgets/src/table/state.rs:238 | ❌ |
-| TableState::select | ratatui-widgets/src/table/state.rs:269 | ⚠️ |
-| TableState::select_next | ratatui-widgets/src/table/state.rs:336 | ❌ |
-| TableState::select_previous | ratatui-widgets/src/table/state.rs:371 | ❌ |
-| TableState::select_next_column | ratatui-widgets/src/table/state.rs:353 | ❌ |
-| TableState::select_previous_column | ratatui-widgets/src/table/state.rs:388 | ❌ |
-| TableState::scroll_down_by | ratatui-widgets/src/table/state.rs:475 | ❌ |
-| TableState::scroll_up_by | ratatui-widgets/src/table/state.rs:494 | ❌ |
-
-**Notes:**
-- **TableState**: Implemented as Data.define attributes on Table widget itself (selected_row, selected_column, offset) instead of separate state object
-
-### List Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| ListState struct | ratatui-widgets/src/list/state.rs:45 | ⚠️ |
-| ListState::with_offset | ratatui-widgets/src/list/state.rs:51 | ❌ |
-| ListState::with_selected | ratatui-widgets/src/list/state.rs:68 | ❌ |
-| ListState::offset | ratatui-widgets/src/list/state.rs:85 | ⚠️ |
-| ListState::offset_mut | ratatui-widgets/src/list/state.rs:99 | ❌ |
-| ListState::selected | ratatui-widgets/src/list/state.rs:113 | ⚠️ |
-| ListState::selected_mut | ratatui-widgets/src/list/state.rs:129 | ❌ |
-| ListState::select | ratatui-widgets/src/list/state.rs:145 | ⚠️ |
-| ListState::select_next | ratatui-widgets/src/list/state.rs:177 | ❌ |
-| ListState::select_previous | ratatui-widgets/src/list/state.rs:195 | ❌ |
-| ListState::select_first | ratatui-widgets/src/list/state.rs:200 | ❌ |
-| ListState::select_last | ratatui-widgets/src/list/state.rs:217 | ❌ |
-
-**Notes:**
-- **ListState**: Implemented as Data.define attributes on List widget itself (selected_index, offset) instead of separate state object
-| ListState::scroll_down_by | ratatui-widgets/src/list/state.rs:248 | ❌ |
-| ListState::scroll_up_by | ratatui-widgets/src/list/state.rs:267 | ❌ |
-
-### Sparkline Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| SparklineBar struct | ratatui-widgets/src/sparkline.rs:253 | ❌ |
-
-### Scrollbar Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| ScrollbarState struct | ratatui-widgets/src/scrollbar.rs:149 | ⚠️ |
-| ScrollDirection::Forward | ratatui-widgets/src/scrollbar.rs:169 | ❌ |
-| ScrollDirection::Backward | ratatui-widgets/src/scrollbar.rs:172 | ❌ |
-
-**Notes:**
-- **ScrollbarState**: Implemented as Data.define attributes on Scrollbar widget itself (content_length, position) instead of separate state object
-
-### Calendar Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| CalendarEventStore struct | ratatui-widgets/src/calendar.rs:258 | ❌ |
-
-### Canvas Widget
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Context struct | ratatui-widgets/src/canvas.rs:515 | ❌ |
-| Painter struct | ratatui-widgets/src/canvas.rs:403 | ❌ |
-| Label struct | ratatui-widgets/src/canvas.rs:61 | ❌ |
-| Points shape | ratatui-widgets/src/canvas/points.rs:7 | ❌ |
-
-## Buffer Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Buffer::empty | ratatui-core/src/buffer/buffer.rs:77 | ❌ |
-| Buffer::filled | ratatui-core/src/buffer/buffer.rs:83 | ❌ |
-| Buffer::with_lines | ratatui-core/src/buffer/buffer.rs:91 | ❌ |
-| Buffer::get_mut | ratatui-core/src/buffer/buffer.rs:150 | ❌ |
-| Buffer::index_of | ratatui-core/src/buffer/buffer.rs:248 | ❌ |
-| Buffer::set_string | ratatui-core/src/buffer/buffer.rs:323 | ❌ |
-| Buffer::set_stringn | ratatui-core/src/buffer/buffer.rs:335 | ❌ |
-| Buffer::set_line | ratatui-core/src/buffer/buffer.rs:372 | ❌ |
-| Buffer::set_span | ratatui-core/src/buffer/buffer.rs:394 | ❌ |
-| Buffer::set_style | ratatui-core/src/buffer/buffer.rs:404 | ❌ |
-| Buffer::reset | ratatui-core/src/buffer/buffer.rs:427 | ❌ |
-| Cell::set_style | ratatui-core/src/buffer/cell.rs:153 | ❌ |
-| Cell::reset | ratatui-core/src/buffer/cell.rs:193 | ❌ |
-
-**Notes:**
-- **Buffer**: Read-only access implemented via `RatatuiRuby.get_cell_at`. Direct mutation methods not exposed in Ruby API
-
-## Widget Traits
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Widget trait | ratatui-core/src/widgets/widget.rs:70 | ⚠️ |
-| StatefulWidget trait | ratatui-core/src/widgets/stateful_widget.rs:124 | ⚠️ |
-
-**Notes:**
-- **Widget/StatefulWidget traits**: Not exposed as Ruby traits. Widgets implement `CoerceableWidget` mixin and rendering handled via FFI
-
-## Backend Features
-
-| Feature Name | File/Line | Status |
-|--------------|-----------|--------|
-| Backend trait | ratatui-core/src/backend.rs:148 | ⚠️ |
-| ClearType::All | ratatui-core/src/backend.rs:117 | ❌ |
-| ClearType::AfterCursor | ratatui-core/src/backend.rs:119 | ❌ |
-| ClearType::BeforeCursor | ratatui-core/src/backend.rs:121 | ❌ |
-| ClearType::CurrentLine | ratatui-core/src/backend.rs:123 | ❌ |
-| ClearType::UntilNewLine | ratatui-core/src/backend.rs:125 | ❌ |
-| WindowSize struct | ratatui-core/src/backend.rs:130 | ❌ |
-| TermionBackend | ratatui-termion/src/lib.rs:* | ❌ |
-| TermwizBackend | ratatui-termwiz/src/lib.rs:* | ❌ |
-
-**Notes:**
-- **Backend trait**: Abstracted away. Terminal uses Crossterm backend internally, not exposed to Ruby API
-- **ClearType**: Not exposed. Clearing handled via `Clear` widget

data/doc/contributors/todo/align/term.md

@@ -1,351 +0,0 @@
-<!--
-SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-SPDX-License-Identifier: CC-BY-SA-4.0
--->
-
-# TERM Environment Variable Respect
-
-Expose terminal capability detection so applications can degrade gracefully.
-
----
-
-## Crossterm Audit (2026-01-17)
-
-What crossterm actually exposes that we can wrap:
-
-### Available Public APIs
-
-| Function | Location | Notes |
-|----------|----------|-------|
-| `available_color_count()` | `src/style.rs:163` | Returns `u16`: 8, 256, or `u16::MAX` (truecolor). Checks `COLORTERM`, `TERM` env vars. |
-| `force_color_output(bool)` | `src/style.rs:191` | Override `NO_COLOR` check globally. |
-| `supports_keyboard_enhancement()` | `src/terminal/sys/unix.rs:188` | Requires `events` feature. Queries terminal via escape sequence. |
-| `window_size()` | `src/terminal.rs:148` | Returns `WindowSize { columns, rows, width, height }` including **pixel dimensions**. |
-| `supports_ansi()` | `src/ansi_support.rs:33` | **Windows only**. Checks VT processing + `TERM != "dumb"`. |
-
-### Internal Logic (Not Exposed, But Informs Design)
-
-From `src/style.rs:174-180`:
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```rust
-env::var("COLORTERM")
-    .or_else(|_| env::var("TERM"))
-    .map_or(DEFAULT, |x| match x {
-        _ if x.contains("24bit") || x.contains("truecolor") => u16::MAX,
-        _ if x.contains("256") => 256,
-        _ => DEFAULT,  // 8 colors
-    })
-```
-<!-- SPDX-SnippetEnd -->
-
-From `src/ansi_support.rs:39-40` (Windows):
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```rust
-let supported = enable_vt_processing().is_ok()
-    || std::env::var("TERM").map_or(false, |term| term != "dumb");
-```
-<!-- SPDX-SnippetEnd -->
-
-### What Ratatui Exposes
-
-The `Backend` trait in `ratatui-core/src/backend.rs` exposes:
-- `size()` → `Result<Size>` (columns/rows)
-- `window_size()` → `Result<WindowSize>` (columns/rows + pixels)
-
-**No capability detection is exposed through ratatui itself.** We must call crossterm directly.
-
-### Audit Summary
-
-| Proposed API | Implementation | Source |
-|--------------|----------------|--------|
-| `tty?` | Pure Ruby | `$stdout.tty?` |
-| `dumb?` | Pure Ruby | `ENV["TERM"]` |
-| `no_color?` | Pure Ruby | `ENV.key?("NO_COLOR")` |
-| `force_color?` | Pure Ruby | `ENV.key?("FORCE_COLOR")` |
-| `color_support` | **Wrap crossterm** | `crossterm::style::available_color_count()` |
-| `supports_keyboard_enhancement?` | **Wrap crossterm** | `crossterm::terminal::supports_keyboard_enhancement()` |
-| `size_pixels` | **Wrap crossterm** | `crossterm::terminal::window_size().{width,height}` |
-| `interactive?` | Pure Ruby | Combines `tty?` + `dumb?` |
-| `suggested_style` | Pure Ruby | Derives from `color_support` |
-
----
-
-## Problem Statement
-
-Rust-based CLI libraries often ignore the `TERM` environment variable and assume modern terminal features. This causes issues in:
-
-- **CI environments** — `TERM=dumb` or missing entirely
-- **Piped output** — stdout isn't a TTY
-- **Legacy terminals** — SSH to old systems, embedded devices
-- **Accessibility** — Screen readers need simpler output
-- **`NO_COLOR` movement** — Users explicitly disable color
-
-RatatuiRuby currently provides no capability detection APIs. Applications cannot query terminal support before rendering.
-
----
-
-## Proposed API
-
-> [!NOTE]
-> These capability detection methods integrate with the `Terminal` class design from [terminal.md](terminal.md).
-> They are **class methods** on `RatatuiRuby::Terminal`, not a separate module.
-
-### Phase 1: Environment Detection (Ruby-side)
-
-Pure Ruby class methods using environment variables and standard library.
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-# lib/ratatui_ruby/terminal.rb (additions to existing Terminal class)
-module RatatuiRuby
-  class Terminal
-    class << self
-      # Is stdout connected to a terminal?
-      def tty? = $stdout.tty?
-
-      # Is this a dumb terminal with no capabilities?
-      def dumb? = ENV["TERM"] == "dumb" || ENV["TERM"].to_s.empty?
-
-      # Should color be disabled? (NO_COLOR standard)
-      def no_color? = ENV.key?("NO_COLOR")
-
-      # Should color be forced? (overrides tty? check)
-      def force_color? = ENV.key?("FORCE_COLOR")
-
-      # Detected color support level
-      # :none    - No color (dumb terminal, NO_COLOR set, not a tty)
-      # :basic   - 16 colors (standard ANSI)
-      # :ansi256 - 256 colors
-      # :truecolor - 24-bit RGB
-      def color_support
-        return :none if no_color? || dumb?
-        return detect_color_level if tty? || force_color?
-        :none
-      end
-
-      private
-
-      def detect_color_level
-        colorterm = ENV["COLORTERM"]
-        return :truecolor if colorterm == "truecolor" || colorterm == "24bit"
-
-        term = ENV["TERM"].to_s
-        return :truecolor if term.include?("truecolor") || term.include?("24bit")
-        return :ansi256 if term.include?("256color")
-        return :basic if term.start_with?("xterm", "screen", "vt100", "linux")
-
-        :basic # Conservative default for unknown terminals
-      end
-    end
-  end
-end
-```
-<!-- SPDX-SnippetEnd -->
-
-### Phase 2: Crossterm Capability Queries (Rust-side)
-
-Expose crossterm's runtime detection through Magnus bindings.
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```rust
-// ext/ratatui_ruby/src/terminal_capabilities.rs
-
-use crossterm::terminal;
-use magnus::{function, Error, Module, Object};
-
-/// Query if the terminal supports the Kitty keyboard protocol
-pub fn supports_keyboard_enhancement() -> Result<bool, Error> {
-    Ok(terminal::supports_keyboard_enhancement()
-        .map_err(|e| Error::new(magnus::exception::runtime_error(), e.to_string()))?)
-}
-
-/// Query terminal size in pixels (if supported)
-pub fn terminal_size_pixels() -> Result<Option<(u16, u16)>, Error> {
-    match crossterm::terminal::window_size() {
-        Ok(size) => Ok(Some((size.width, size.height))),
-        Err(_) => Ok(None),
-    }
-}
-
-pub fn register(ruby: &magnus::Ruby, module: &magnus::RModule) -> Result<(), Error> {
-    module.define_module_function("_supports_keyboard_enhancement", 
-        function!(supports_keyboard_enhancement, 0))?;
-    module.define_module_function("_terminal_size_pixels",
-        function!(terminal_size_pixels, 0))?;
-    Ok(())
-}
-```
-<!-- SPDX-SnippetEnd -->
-
-Ruby wrapper (class methods on Terminal):
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-# lib/ratatui_ruby/terminal.rb (continued)
-module RatatuiRuby
-  class Terminal
-    class << self
-      # Does the terminal support the Kitty keyboard protocol?
-      def supports_keyboard_enhancement?
-        RatatuiRuby._supports_keyboard_enhancement
-      rescue
-        false
-      end
-
-      # Terminal size in pixels (for graphics protocols)
-      # Returns { width:, height: } or nil if unsupported
-      def size_pixels
-        result = RatatuiRuby._terminal_size_pixels
-        result ? { width: result[0], height: result[1] } : nil
-      rescue
-        nil
-      end
-    end
-  end
-end
-```
-<!-- SPDX-SnippetEnd -->
-
-### Phase 3: Graceful Degradation Helpers
-
-Convenience class methods for common patterns.
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```ruby
-# lib/ratatui_ruby/terminal.rb (continued)
-module RatatuiRuby
-  class Terminal
-    class << self
-      # Should the application use TUI mode?
-      # Returns false for dumb terminals, piped output, etc.
-      def interactive?
-        tty? && !dumb?
-      end
-
-      # Suggested style based on terminal capabilities
-      def suggested_style
-        case color_support
-        when :none then :plain
-        when :basic then :ansi16
-        when :ansi256 then :ansi256
-        when :truecolor then :truecolor
-        end
-      end
-    end
-  end
-end
-```
-<!-- SPDX-SnippetEnd -->
-
----
-
-## Implementation Plan
-
-### Phase 1: Environment Detection
-
-| File | Change |
-|------|--------|
-| [NEW] `lib/ratatui_ruby/terminal.rb` | `Terminal` module with `tty?`, `dumb?`, `no_color?`, `force_color?`, `color_support` |
-| [NEW] `sig/ratatui_ruby/terminal.rbs` | RBS type declarations |
-| [NEW] `test/test_terminal_capabilities.rb` | Unit tests with mocked ENV |
-| [MODIFY] `lib/ratatui_ruby.rb` | Require the new module |
-
-### Phase 2: Crossterm Queries
-
-| File | Change |
-|------|--------|
-| [NEW] `ext/ratatui_ruby/src/terminal_capabilities.rs` | `supports_keyboard_enhancement`, `terminal_size_pixels` |
-| [MODIFY] `ext/ratatui_ruby/src/lib.rs` | Register new module |
-| [MODIFY] `lib/ratatui_ruby/terminal.rb` | Add `supports_keyboard_enhancement?`, `size_pixels` |
-| [MODIFY] `sig/ratatui_ruby/terminal.rbs` | Add new method types |
-| [MODIFY] `test/test_terminal_capabilities.rb` | Add integration tests |
-
-### Phase 3: Convenience Methods
-
-| File | Change |
-|------|--------|
-| [MODIFY] `lib/ratatui_ruby/terminal.rb` | Add `interactive?`, `suggested_style` |
-| [MODIFY] `sig/ratatui_ruby/terminal.rbs` | Add new method types |
-| [MODIFY] `test/test_terminal_capabilities.rb` | Add convenience method tests |
-
----
-
-## Documentation Updates
-
-| File | Change |
-|------|--------|
-| [NEW] `doc/concepts/terminal_capabilities.md` | Guide for capability detection |
-| [MODIFY] `doc/troubleshooting/terminal_limitations.md` | Reference new detection APIs |
-| [MODIFY] `CHANGELOG.md` | Document new feature |
-
----
-
-## Verification Plan
-
-### Automated Tests
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-bundle exec rake test TEST=test/test_terminal_capabilities.rb
-bundle exec steep check
-```
-<!-- SPDX-SnippetEnd -->
-
-### Manual Verification
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
-  SPDX-License-Identifier: MIT-0
--->
-```bash
-# Test NO_COLOR respect
-NO_COLOR=1 bundle exec ruby -e "require 'ratatui_ruby'; p RatatuiRuby::Terminal.color_support"
-# Expected: :none
-
-# Test dumb terminal
-TERM=dumb bundle exec ruby -e "require 'ratatui_ruby'; p RatatuiRuby::Terminal.dumb?"
-# Expected: true
-
-# Test truecolor detection
-COLORTERM=truecolor bundle exec ruby -e "require 'ratatui_ruby'; p RatatuiRuby::Terminal.color_support"
-# Expected: :truecolor
-```
-<!-- SPDX-SnippetEnd -->
-
----
-
-## References
-
-- [NO_COLOR Standard](https://no-color.org/)
-- [Crossterm Terminal Queries](https://docs.rs/crossterm/latest/crossterm/terminal/index.html)
-- [Kitty Keyboard Protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/)
-- [terminfo(5)](https://man7.org/linux/man-pages/man5/terminfo.5.html)