ratatui_ruby 0.3.1 → 0.4.0

data/doc/quickstart.md

@@ -14,18 +14,21 @@ Add this line to your application's Gemfile:
 gem "ratatui_ruby"
 ```
 
+
 And then execute:
 
 ```bash
 bundle install
 ```
 
+
 Or install it yourself as:
 
 ```bash
 gem install ratatui_ruby
 ```
 
+
 ## Basic Application
 
 Here is a "Hello World" application that demonstrates the core lifecycle of a **ratatui_ruby** app.
@@ -41,13 +44,16 @@ begin
   loop do
     # 2. Create your UI (Immediate Mode)
     # We define a Paragraph widget inside a Block with a title and borders.
+    # Other widgets include RatatuiRuby::RatatuiMascot, RatatuiRuby::RatatuiLogo, etc.
     view = RatatuiRuby::Paragraph.new(
       text: "Hello, Ratatui! Press 'q' to quit.",
-      align: :center,
+      alignment: :center,
       block: RatatuiRuby::Block.new(
         title: "My Ruby TUI App",
+        title_alignment: :center,
         borders: [:all],
-        border_color: "cyan"
+        border_color: "cyan",
+        style: { fg: "white" }
       )
     )
  
@@ -56,9 +62,7 @@ begin
  
     # 4. Poll for events
     event = RatatuiRuby.poll_event
-    if event && event[:type] == :key && event[:code] == "q"
-      break
-    end
+    break if event == "q" || event == :ctrl_c
   end
 ensure
   # 5. Restore the terminal to its original state
@@ -66,7 +70,7 @@ ensure
 end
 ```
 
-![Basic Application Screenshot](./images/examples-quickstart_lifecycle.rb.png)
+![quickstart_lifecycle](./images/quickstart_lifecycle.png)
 
 ### How it works
 
@@ -76,121 +80,192 @@ end
 4.  **`RatatuiRuby.poll_event`**: Checks for keyboard, mouse, or resize events.
 5.  **`RatatuiRuby.restore_terminal`**: Crucial for leaving raw mode and returning the user to their shell properly. Always wrap your loop in a `begin...ensure` block to guarantee this runs.
 
-### DSL
+### Idiomatic Session
 
-A small DSL is provided for convenience when writing scripts.
+You can simplify your code by using `RatatuiRuby.run`. This method handles the terminal lifecycle for you, yielding a `Session` object with factory methods for widgets.
 
 ```rb
 require "ratatui_ruby"
 
-# 1. Initialize the terminal, start the main loop, and ensure the terminal is restored.
-RatatuiRuby.main_loop do |tui|
-  # 2. Create your UI with methods instead of classes.
-  view = tui.paragraph(
-    text: "Hello, Ratatui! Press 'q' to quit.",
-    align: :center,
-    block: tui.block(
-      title: "My Ruby TUI App",
-      borders: [:all],
-      border_color: "cyan"
+# 1. Initialize the terminal and ensure it is restored.
+RatatuiRuby.run do |tui|
+  loop do
+    # 2. Create your UI with methods instead of classes.
+    view = tui.paragraph(
+      text: "Hello, Ratatui! Press 'q' to quit.",
+      alignment: :center,
+      block: tui.block(
+        title: "My Ruby TUI App",
+        title_alignment: :center,
+        borders: [:all],
+        border_color: "cyan",
+        style: { fg: "white" }
+      )
     )
-  )
-
-  # 3. Use RatatuiRuby methods, too.
-  tui.draw(view)
-  event = tui.poll_event
-  
-  if event && event[:type] == :key && event[:code] == "q"
-    break
+
+    # 3. Use RatatuiRuby methods, too.
+    tui.draw(view)
+    event = tui.poll_event
+    
+    break if event == "q" || event == :ctrl_c
   end
 end
-```
+
 
 #### How it works
 
-1.  **`RatatuiRuby.main_loop`**: This helper method manages the entire terminal lifecycle for you. It initializes the terminal before the block starts and ensures `restore_terminal` is called when the block exits (even if an error occurs).
-2.  **Widget Shorthand**: The block yields a special DSL object (here named `tui`). This object provides factory methods for every widget, allowing you to write `tui.paragraph(...)` instead of the more verbose `RatatuiRuby::Paragraph.new(...)`.
-3.  **Method SHorthand**: The DSL object also provides aliases for module functions of `RatatuiRuby`, allowing you to write `tui.draw(...)` instead of the more verbose `RatatuiRuby::draw(...)`.
+1.  **`RatatuiRuby.run`**: This context manager initializes the terminal before the block starts and ensures `restore_terminal` is called when the block exits (even if an error occurs).
+2.  **Widget Shorthand**: The block yields a `Session` object (here named `tui`). This object provides factory methods for every widget, allowing you to write `tui.paragraph(...)` instead of the more verbose `RatatuiRuby::Paragraph.new(...)`.
+3.  **Method Shorthand**: The session object also provides aliases for module functions of `RatatuiRuby`, allowing you to write `tui.draw(...)` instead of the more verbose `RatatuiRuby::draw(...)`.
+
+For a deeper dive into the available application architectures (Manual vs Managed), see [Application Architecture](./application_architecture.md).
 
 ## Examples
 
 To see more complex layouts and widget usage, check out the `examples/` directory in the repository.
 
-### [Analytics](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/analytics.rb)
-Demonstrates the use of `Tabs` and `BarChart` widgets with a simple data-switching mechanism.
+### [Analytics](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/analytics/app.rb)
+
+Demonstrates the use of `Tabs` and `BarChart` widgets. Features custom highlight styles, base styles, dividers for the tabs, and dynamic width calculation. The `BarChart` showcases both standard and grouped bars (Quarterly view), highlighting features like `group_gap` spacing, toggling `BarChart::direction`, customizing label/value styles, cycling custom `BarChart::bar_set` characters, and switching between Full and Mini height modes.
+
+![analytics](./images/analytics.png)
 
-![Analytics Screenshot](./images/examples-analytics.rb.png)
+### [All Events](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/all_events/app.rb)
 
-### [Box Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/box_demo.rb)
-A simple demonstration of `Block` and `Paragraph` widgets, reacting to arrow key presses to change colors.
+A comprehensive demonstration of every event type supported by **ratatui_ruby**: Key, Mouse, Resize, Paste, and Focus events.
 
-![Box Demo Screenshot](./images/examples-box_demo.rb.png)
+![all_events](./images/all_events.png)
 
-### [Calendar Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/calendar_demo.rb)
-A simple demo application for the `Calendar` widget.
+### [Block Padding](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/block_padding/app.rb)
 
-![Calendar Screenshot](./images/examples-calendar_demo.rb.png)
+Demonstrates the `padding` property of the `Block` widget, supporting both uniform and directional padding.
 
-### [Chart Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/chart_demo.rb)
-Demonstrates the `Chart` widget with both scatter and line datasets, including custom axes.
+![block_padding](./images/block_padding.png)
 
-![Chart Screenshot](./images/examples-chart_demo.rb.png)
+### [Block Titles](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/block_titles/app.rb)
+
+Demonstrates the `Block` widget's ability to render multiple titles with individual alignment and positioning (top/bottom).
+
+![block_titles](./images/block_titles.png)
+
+### [Box Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/box_demo/app.rb)
+
+A simple demonstration of `Block` and `Paragraph` widgets, reacting to key presses to change colors, border types, border styles, and title styling. Features the new `border_style` parameter for applying colors and modifiers (bold, italic) to borders independently of the content background.
+
+![box_demo](./images/box_demo.png)
+
+### [Calendar Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/calendar_demo/app.rb)
+
+Demonstrates the `Calendar` widget with interactive attribute cycling. Features event highlighting (dates with specific styles), toggleable month/weekday headers, and surrounding month visibility (with custom styling) via keyboard shortcuts. Press `h` to toggle month header, `w` to toggle weekday header, `s` to toggle surrounding month dates, and `e` to toggle events.
+
+![calendar_demo](./images/calendar_demo.png)
+
+### [Chart Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/chart_demo/app.rb)
+
+Demonstrates the `Chart` widget with both scatter and line datasets, including custom axes. Features customizable axis label alignment and legend positioning.
+
+![chart_demo](./images/chart_demo.png)
+
+### [Custom Widget (Escape Hatch)](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/custom_widget/app.rb)
 
-### [Custom Widget (Escape Hatch)](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/custom_widget.rb)
 Demonstrates how to define a custom widget in pure Ruby using the `render(area, buffer)` escape hatch for low-level drawing.
 
-![Custom Widget Screenshot](./images/examples-custom_widget.rb.png)
+![custom_widget](./images/custom_widget.png)
+
+### [Flex Layout](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/flex_layout/app.rb)
 
-### [Dashboard](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/dashboard.rb)
-Uses `Layout`, `List`, and `Paragraph` to create a classic sidebar-and-content interface.
+Demonstrates modern layout features including `Constraint.fill` and `Constraint.ratio` for proportional space distribution and `flex: :space_between` for evenly distributing fixed-size elements.
 
-![Dashboard Screenshot](./images/examples-dashboard.rb.png)
+![flex_layout](./images/flex_layout.png)
 
-### [List Styles](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/list_styles.rb)
-Showcases advanced styling options for the `List` widget, including selection highlighting.
+### [LineGauge Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/line_gauge_demo/app.rb)
+
+Demonstrates the `LineGauge` widget with customizable filled and unfilled symbols, base style support via the `style` parameter, independent styling for filled/unfilled portions, and interactive ratio cycling with arrow keys.
+
+![line_gauge_demo](./images/line_gauge_demo.png)
+
+### [List Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/list_demo/app.rb)
+
+Demonstrates the `List` widget with interactive attribute cycling. Features multiple item sets to browse, customizable highlight styles and symbols, and exploration of all List options including direction, highlight spacing, repeat symbol mode, scroll padding, and base styling. The sidebar provides hotkey documentation for discovering all List features, including the new `p` key to adjust scroll padding.
+
+![list_demo](./images/list_demo.png)
+
+### [Login Form](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/login_form/app.rb)
 
-### [Login Form](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/login_form.rb)
 Shows how to use `Overlay`, `Center`, and `Cursor` to build a modal login form with text input.
 
-![Login Form Screenshot](./images/examples-login_form.rb.png)
+![login_form](./images/login_form.png)
+
+### [Map Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/map_demo/app.rb)
 
-### [Map Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/map_demo.rb)
-Exhibits the `Canvas` widget's power, rendering a world map along with animated circles and lines.
+Exhibits the `Canvas` widget's power, rendering a world map with city labels, animated circles, and lines.
 
-![Map Demo Screenshot](./images/examples-map_demo.rb.png)
+![map_demo](./images/map_demo.png)
+
+### [Mouse Events](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/mouse_events/app.rb)
 
-### [Mouse Events](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/mouse_events.rb)
 Detailed plumbing of mouse events, including clicks, drags, and movement tracking.
 
-![Mouse Events Screenshot](./images/examples-mouse_events.rb.png)
+![mouse_events](./images/mouse_events.png)
+
+### [Popup Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/popup_demo/app.rb)
 
-### [Popup Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/popup_demo.rb)
 Demonstrates the `Clear` widget and how to prevent "style bleed" when rendering opaque popups over colored backgrounds.
 
-![Popup Demo Screenshot](./images/examples-popup_demo.rb.gif)
+![popup_demo](./images/popup_demo.png)
+
+### [Ratatui Logo Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/ratatui_logo_demo/app.rb)
+
+Demonstrates the `RatatuiLogo` widget.
+
+
+![ratatui_logo_demo](./images/ratatui_logo_demo.png)
+
+### [Rich Text](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/rich_text/app.rb)
 
-### [Scrollbar Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/scrollbar_demo.rb)
-A simple example of integrating the `Scrollbar` widget and handling mouse wheel events for scrolling.
+Demonstrates `Text::Span` and `Text::Line` for creating styled text with inline formatting, enabling word-level control over colors and text modifiers.
 
-![Scrollbar Demo Screenshot](./images/examples-scrollbar_demo.rb.png)
+![rich_text](./images/rich_text.png)
+
+### [Scrollbar Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/scrollbar_demo/app.rb)
+
+A demonstration of the `Scrollbar` widget, featuring mouse wheel scrolling and extensive customization of symbols and styles.
+
+![scrollbar_demo](./images/scrollbar_demo.png)
+
+### [Scroll Text](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/scroll_text/app.rb)
 
-### [Scroll Text](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/scroll_text.rb)
 Demonstrates the `Paragraph` widget's scroll functionality, allowing navigation through long text content using arrow keys for both horizontal and vertical scrolling.
 
-![Scroll Text Screenshot](./images/examples-scroll_text.rb.png)
+![scroll_text](./images/scroll_text.png)
+
+### [Sparkline Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/sparkline_demo/app.rb)
+
+Demonstrates the `Sparkline` widget with interactive attribute cycling. Features multiple data sets with different patterns (steady growth, gaps, random, sawtooth, peaks), and explores all `Sparkline` options including direction, color, the new `absent_value_symbol` and `absent_value_style` parameters for distinguishing zero/absent values from low data, and the new `bar_set` parameter for custom bar characters.
+
+![sparkline_demo](./images/sparkline_demo.png)
+
+### [Gauge Demo](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/gauge_demo/app.rb)
+
+Demonstrates the `Gauge` widget with interactive attribute cycling. Features multiple gauge instances with customizable ratio, gauge color, background style, Unicode toggle, and label modes. The sidebar provides hotkey documentation for exploring all Gauge options, including the distinction between `style` (background) and `gauge_style` (filled bar).
+
+![gauge_demo](./images/gauge_demo.png)
+
+### [Table Select](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/table_select/app.rb)
+
+Demonstrates interactive row selection in the `Table` widget with keyboard navigation, highlighting selected rows with custom styles and symbols, applying a base style, and dynamically adjusting `column_spacing`. Also demonstrates `column_highlight_style` and the new `cell_highlight_style` for precise selection visualization.
+
+![table_select](./images/table_select.png)
 
-### [Stock Ticker](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/stock_ticker.rb)
-Utilizes `Sparkline` and `Chart` widgets to visualize real-time (simulated) data.
+### [Table Flex](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/table_flex/app.rb)
 
-![Stock Ticker Screenshot](./images/examples-stock_ticker.rb.png)
+Demonstrates different flex modes in the `Table` widget, such as `:space_between` and `:space_around`, allowing for modern, responsive table layouts.
 
-### [System Monitor](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/system_monitor.rb)
-Combines `Table` and `Gauge` widgets in a vertical layout to create a functional system overview.
+![table_flex](./images/table_flex.png)
 
-![System Monitor Screenshot](./images/examples-system_monitor.rb.png)
+### [Widget Style Colors](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/widget_style_colors/app.rb)
 
-### [Table Select](https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/examples/table_select.rb)
-Demonstrates interactive row selection in the `Table` widget with keyboard navigation, highlighting selected rows with custom styles and symbols.
+Demonstrates hexadecimal color code support in Style parameters. Renders an 80x24 color gradient using HSL-to-RGB conversion and #RRGGBB hex codes, showcasing 24-bit true color rendering on capable terminals.
 
-![Table Select Screenshot](./images/examples-table_select.rb.png)
+![widget_style_colors](./images/widget_style_colors.png)
 

data/examples/all_events/app.rb

@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+require "ratatui_ruby"
+
+# All Events Demo
+# Demonstrates every event type: Key, Mouse, Resize, Paste, Focus.
+class AllEventsApp
+  attr_reader :key_info, :mouse_info, :resize_info, :special_info, :focused
+
+  def initialize
+    @key_info = "Press any key..."
+    @mouse_info = "Click or scroll..."
+    @resize_info = "Resize the terminal..."
+    @special_info = "Paste text or change focus..."
+    @focused = true
+  end
+
+  def run
+    RatatuiRuby.run do
+      # Capture initial terminal size
+      @resize_info = "#{terminal_width}×#{terminal_height}"
+      loop do
+        render
+        break if handle_input == :quit
+        sleep 0.016
+      end
+    end
+  end
+
+  private
+
+  def terminal_width
+    80 # Approximation; actual size comes from Resize events
+  end
+
+  def terminal_height
+    24
+  end
+
+  def render
+    border_color = @focused ? "green" : "gray"
+
+    key_panel = RatatuiRuby::Paragraph.new(
+      text: @key_info,
+      alignment: :center,
+      block: RatatuiRuby::Block.new(
+        title: "⌨️  Key Events",
+        borders: [:all],
+        border_color: border_color
+      )
+    )
+
+    mouse_panel = RatatuiRuby::Paragraph.new(
+      text: @mouse_info,
+      alignment: :center,
+      block: RatatuiRuby::Block.new(
+        title: "🖱️  Mouse Events",
+        borders: [:all],
+        border_color: border_color
+      )
+    )
+
+    resize_panel = RatatuiRuby::Paragraph.new(
+      text: @resize_info,
+      alignment: :center,
+      block: RatatuiRuby::Block.new(
+        title: "📐 Resize Events",
+        borders: [:all],
+        border_color: border_color
+      )
+    )
+
+    special_panel = RatatuiRuby::Paragraph.new(
+      text: @special_info,
+      alignment: :center,
+      block: RatatuiRuby::Block.new(
+        title: "✨ Paste & Focus Events",
+        borders: [:all],
+        border_color: border_color
+      )
+    )
+
+    # 2x2 grid layout
+    top_row = RatatuiRuby::Layout.new(
+      direction: :horizontal,
+      constraints: [
+        RatatuiRuby::Constraint.percentage(50),
+        RatatuiRuby::Constraint.percentage(50)
+      ],
+      children: [key_panel, mouse_panel]
+    )
+
+    bottom_row = RatatuiRuby::Layout.new(
+      direction: :horizontal,
+      constraints: [
+        RatatuiRuby::Constraint.percentage(50),
+        RatatuiRuby::Constraint.percentage(50)
+      ],
+      children: [resize_panel, special_panel]
+    )
+
+    # Header with instructions
+    header = RatatuiRuby::Paragraph.new(
+      text: "All Event Types Demo — Press 'q' or Ctrl+C to quit",
+      alignment: :center,
+      style: { fg: :cyan, modifiers: [:bold] }
+    )
+
+    layout = RatatuiRuby::Layout.new(
+      direction: :vertical,
+      constraints: [
+        RatatuiRuby::Constraint.length(1),
+        RatatuiRuby::Constraint.percentage(50),
+        RatatuiRuby::Constraint.percentage(50)
+      ],
+      children: [header, top_row, bottom_row]
+    )
+
+    RatatuiRuby.draw(layout)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    return unless event
+
+    case event
+    # Quit
+    in {type: :key, code: "q"} | {type: :key, code: "c", modifiers: ["ctrl"]}
+      return :quit
+
+    # Key events
+    in type: :key, code:, modifiers:
+      mods = modifiers.empty? ? "" : " [#{modifiers.join('+')}]"
+      @key_info = "Key: #{code}#{mods}"
+
+    # Mouse events
+    in type: :mouse, kind:, button:, x:, y:
+      @mouse_info = "#{kind}: #{button} at (#{x}, #{y})"
+
+    # Resize events
+    in type: :resize, width:, height:
+      @resize_info = "#{width}×#{height}"
+
+    # Paste events
+    in type: :paste, content:
+      display_content = content.length > 30 ? "#{content[0..27]}..." : content
+      @special_info = "Pasted: #{display_content.inspect}"
+
+    # Focus events
+    in type: :focus_gained
+      @focused = true
+      @special_info = "Focus gained! ✓"
+
+    in type: :focus_lost
+      @focused = false
+      @special_info = "Focus lost..."
+    else
+      nil
+    end
+
+    nil
+  end
+end
+
+AllEventsApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/all_events/app.rbs

@@ -0,0 +1,7 @@
+class AllEventsApp
+  # @public
+  def self.new: () -> AllEventsApp
+
+  # @public
+  def run: () -> void
+end

data/examples/all_events/test_app.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+require "ratatui_ruby"
+require "ratatui_ruby/test_helper"
+require "minitest/autorun"
+require_relative "app"
+
+class TestAllEvents < Minitest::Test
+  include RatatuiRuby::TestHelper
+
+  def setup
+    @app = AllEventsApp.new
+  end
+
+  def test_initial_state
+    with_test_terminal do
+      # Queue quit event
+      inject_key(:q)
+      
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Press any key..."
+      assert_includes content, "Click or scroll..."
+      assert_includes content, "80×24"
+      assert_includes content, "Paste text or change focus..."
+    end
+  end
+
+  def test_key_event_updates_panel
+    with_test_terminal do
+      inject_keys(:a, :q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "Key: a"
+    end
+  end
+
+  def test_key_event_with_modifiers
+    with_test_terminal do
+      inject_keys(:ctrl_s, :q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "Key: s [ctrl]"
+    end
+  end
+
+  def test_mouse_event_updates_panel
+    with_test_terminal do
+      inject_event(RatatuiRuby::Event::Mouse.new(kind: "down", button: "left", x: 10, y: 5))
+      inject_key(:q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "down: left at (10, 5)"
+    end
+  end
+
+  def test_resize_event_updates_panel
+    with_test_terminal do
+      inject_event(RatatuiRuby::Event::Resize.new(width: 120, height: 40))
+      inject_key(:q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "120×40"
+    end
+  end
+
+  def test_paste_event_updates_panel
+    with_test_terminal do
+      inject_event(RatatuiRuby::Event::Paste.new(content: "Hello, World!"))
+      inject_key(:q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), 'Pasted: "Hello, World!"'
+    end
+  end
+
+  def test_paste_event_truncates_long_content
+    with_test_terminal do
+      inject_event(RatatuiRuby::Event::Paste.new(content: "This is a very long string that should be truncated"))
+      inject_key(:q)
+      
+      @app.run
+
+      content = buffer_content.join("\n")
+      assert_includes content, "Pasted: "
+      assert_includes content, "..."
+    end
+  end
+
+  def test_focus_gained_updates_panel
+    with_test_terminal do
+      # Initial state is focused, so we lose then gain
+      @app.instance_variable_set(:@focused, false)
+      inject_event(RatatuiRuby::Event::FocusGained.new)
+      inject_key(:q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "Focus gained! ✓"
+    end
+  end
+
+  def test_focus_lost_updates_panel
+    with_test_terminal do
+      inject_event(RatatuiRuby::Event::FocusLost.new)
+      inject_key(:q)
+      
+      @app.run
+
+      assert_includes buffer_content.join("\n"), "Focus lost..."
+    end
+  end
+
+  def test_quit_on_q
+    with_test_terminal do
+      inject_key(:q)
+      # Wait... run should just return normally
+      @app.run
+      # If it returns, the test passes (no timeout/hang)
+    end
+  end
+
+  def test_quit_on_ctrl_c
+    with_test_terminal do
+      inject_key(:ctrl_c)
+      @app.run
+    end
+  end
+end