ratatui_ruby 0.4.0 → 0.5.0

data/examples/app_all_events/model/events.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "timestamp"
+require_relative "event_color_cycle"
+require_relative "event_entry"
+
+# Manages the history and state of all application events.
+#
+# Applications need to track, count, and display event history for debugging and feedback.
+# Direct management of event arrays and counters across the app leads to scattered state.
+#
+# This class centralizes event storage. It records new events, maintains counts, and manages temporary highlights.
+#
+# Use it to store key presses, mouse clicks, and window resizes for display in a log or counter.
+#
+# === Examples
+#
+#   events = Events.new
+#   events.record(key_event)
+#   puts events.count(:key) #=> 1
+#
+#   if events.lit?(:key)
+#     puts "Key event just happened!"
+#   end
+class Events
+  # Duration in milliseconds for an event to remain highlighted in the UI.
+  HIGHLIGHT_DURATION_MS = 300
+
+  # Creates a new Events manager.
+  def initialize
+    @entries = []
+    @color_cycle = EventColorCycle.new
+    @none_count = 0
+    @lit_type = nil
+    @lit_until = Timestamp.now
+    @live = {}
+  end
+
+  # Records a new event.
+  #
+  # [event] RatatuiRuby::Event object.
+  # [context] Hash of additional context (e.g., last_dimensions).
+  #
+  # === Example
+  #
+  #   events.record(mouse_event)
+  def record(event, context: {})
+    if event.is_a?(RatatuiRuby::Event::None) || event == :none
+      @none_count += 1
+      return
+    end
+
+    color = @color_cycle.next_color
+    timestamp = Timestamp.now
+    entry = EventEntry.create(event, color, timestamp)
+    @entries << entry
+    update_lit_type(entry)
+
+    display_type = live_type_for(entry.type)
+    @live[display_type] = { time: Time.now, description: entry.description }
+  end
+
+  private def live_type_for(type)
+    case type
+    when :focus_gained, :focus_lost
+      :focus
+    else
+      type
+    end
+  end
+
+  # Returns the most recent live event data for a type.
+  #
+  # [type] Symbol event type to look up.
+  #
+  # === Example
+  #
+  #   events.live_event(:key) #=> { time: ..., description: "..." }
+  def live_event(type)
+    @live[type]
+  end
+
+  # Returns all recorded live event data.
+  #
+  # === Example
+  #
+  #   events.live_events #=> { key: { ... }, mouse: { ... } }
+  def live_events
+    @live
+  end
+
+  # Returns the most recent entries up to the given limit.
+  #
+  # [max_entries] Integer maximum number of entries to return.
+  #
+  # === Example
+  #
+  #   events.visible(10) #=> [#<EventEntry ...>, ...]
+  def visible(max_entries)
+    @entries.last(max_entries)
+  end
+
+  # Checks if any events have been recorded.
+  #
+  # === Example
+  #
+  #   events.empty? #=> true
+  def empty?
+    @entries.empty?
+  end
+
+  # Returns the count of events for a type.
+  #
+  # [type] Symbol event type.
+  #
+  # === Example
+  #
+  #   events.count(:key) #=> 5
+  def count(type)
+    return @none_count if type == :none
+
+    @entries.count { |e| e.matches_type?(type) }
+  end
+
+  # Returns counts grouped by subtype (kind or modifier status).
+  #
+  # [type] Symbol event type.
+  #
+  # === Example
+  #
+  #   events.sub_counts(:mouse) #=> { "down" => 1, "up" => 2 }
+  def sub_counts(type)
+    return {} if type == :none
+
+    entries = @entries.select { |e| e.matches_type?(type) }
+
+    defaults = { key: %w[unmodified modified], focus: %w[gained lost], mouse: %w[down up drag moved scroll_up scroll_down] }
+    entries.each_with_object(defaults.fetch(type, []).to_h { |k| [k, 0] }) do |entry, counts|
+      group = if entry.event.respond_to?(:kind)
+        entry.event.kind.to_s
+      elsif entry.event.respond_to?(:modifiers)
+        entry.event.modifiers.empty? ? "unmodified" : "modified"
+      elsif type == :focus
+        entry.type.to_s.sub("focus_", "")
+      end
+
+      counts[group] += 1 if group
+    end
+  end
+
+  # Checks if a type should be highlighted.
+  #
+  # [type] Symbol event type.
+  #
+  # === Example
+  #
+  #   events.lit?(:key) #=> true
+  def lit?(type)
+    return false if Timestamp.now.milliseconds >= @lit_until.milliseconds
+
+    @lit_type == type
+  end
+
+  # Returns all event entries.
+  #
+  # === Example
+  #
+  #   events.entries #=> [#<EventEntry ...>, ...]
+  def entries
+    @entries
+  end
+
+  private def update_lit_type(entry)
+    @lit_type = live_type_for(entry.type)
+    @lit_until = Timestamp.new(milliseconds: Timestamp.now.milliseconds + HIGHLIGHT_DURATION_MS)
+  end
+end

data/examples/app_all_events/model/highlight.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "timestamp"
+
+# Manages temporary visual highlights for different event types.
+#
+# Users need visual feedback when an event occurs, but highlights should fade.
+# Manually tracking timers for every highlightable element is complex.
+#
+# This class manages the "lit" state of multiple keys with a consistent duration.
+#
+# Use it to trigger and check for temporary UI highlights.
+#
+# === Examples
+#
+#   highlight = Highlight.new
+#   highlight.light_up(:key)
+#   highlight.lit?(:key) #=> true
+#   sleep(0.4)
+#   highlight.lit?(:key) #=> false
+class Highlight
+  # Duration in milliseconds that a highlight remains active.
+  DURATION_MS = 300
+
+  # Creates a new Highlight manager.
+  def initialize
+    @lit_types = {}
+  end
+
+  # Triggers a highlight for the given type.
+  #
+  # [type] Symbol to highlight.
+  #
+  # === Example
+  #
+  #   highlight.light_up(:mouse)
+  def light_up(type)
+    @lit_types[type] = Timestamp.now
+  end
+
+  # Checks if a highlight is currently active for the given type.
+  #
+  # [type] Symbol to check.
+  #
+  # === Example
+  #
+  #   highlight.lit?(:mouse) #=> true
+  def lit?(type)
+    timestamp = @lit_types[type]
+    return false unless timestamp
+
+    !timestamp.elapsed?(DURATION_MS)
+  end
+end

data/examples/app_all_events/model/timestamp.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# Represents a high-resolution point in time.
+#
+# Comparing events and calculating durations requires consistent time measurement.
+# Standard Time objects are often too granular or complex for simple millisecond offsets.
+#
+# This class provides a millisecond-precision timestamp for event measurement.
+#
+# Use it to track event timing, calculate elapsed time, or trigger debouncing.
+#
+# === Examples
+#
+#   timestamp = Timestamp.now
+#   puts timestamp.milliseconds
+#
+#   if timestamp.elapsed?(300)
+#     puts "More than 300ms have passed."
+#   end
+class Timestamp < Data.define(:milliseconds)
+  # Returns a new Timestamp representing the current time.
+  #
+  # === Example
+  #
+  #   Timestamp.now #=> #<struct Timestamp milliseconds=123456789>
+  def self.now
+    new(milliseconds: (Time.now.to_f * 1000).to_i)
+  end
+
+  # Checks if a duration has passed since this timestamp.
+  #
+  # [duration_ms] Integer duration in milliseconds.
+  #
+  # === Example
+  #
+  #   timestamp = Timestamp.now
+  #   sleep(0.5)
+  #   timestamp.elapsed?(300) #=> true
+  def elapsed?(duration_ms)
+    Timestamp.now.milliseconds >= milliseconds + duration_ms
+  end
+
+  # Returns the current time in milliseconds.
+  #
+  # === Example
+  #
+  #   Timestamp.current #=> 123456789
+  def self.current
+    now.milliseconds
+  end
+end

data/examples/app_all_events/test/snapshots/after_focus_lost.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    XX:XX:XX  #<RatatuiRuby::Event::FocusLost:0xXXXXXX│
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::FocusLost:0xXXXXXX>      │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │                                                         │
+│Focus: 1          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 1         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_focus_regained.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    XX:XX:XX  #<RatatuiRuby::Event::FocusGained:0xXXXXXX│
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::FocusLost:0xXXXXXX>      │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │#<RatatuiRuby::Event::FocusGained:0xXXXXXX>    │
+│Focus: 2          │ │                                                         │
+│  Gained: 1       │ │                                                         │
+│  Lost: 1         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_horizontal_resize.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   XX:XX:XX  #<RatatuiRuby::Event::Resize:0xXXXXXX│
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Resize:0xXXXXXX          │
+│Resize: 1         │ │@width=100, @height=24>                                  │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_key_a.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 1            │ │Type     Time      Description                           │
+│  Unmodified: 1   │ │Key      XX:XX:XX  #<RatatuiRuby::Event::Key code="a" mod│
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Key code="a" modifiers=[]>         │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_key_ctrl_x.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 1            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      XX:XX:XX  #<RatatuiRuby::Event::Key code="x" mod│
+│  Modified: 1     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Key code="x" modifiers=["ctrl"]>   │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_mouse_click.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    XX:XX:XX  #<RatatuiRuby::Event::Mouse:0xXXXXXX│
+│Mouse: 1          │ │Resize   —         —                                     │
+│  Down: 1         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Mouse:0xXXXXXX           │
+│Resize: 0         │ │@kind="down", @x=40, @y=12, @button="left",              │
+│Paste: 0          │ │@modifiers=[]>                                           │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_mouse_drag.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    XX:XX:XX  #<RatatuiRuby::Event::Mouse:0xXXXXXX│
+│Mouse: 1          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 1         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Mouse:0xXXXXXX           │
+│Resize: 0         │ │@kind="drag", @x=25, @y=8, @button="left", @modifiers=[]>│
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_multiple_events.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 3            │ │Type     Time      Description                           │
+│  Unmodified: 3   │ │Key      XX:XX:XX  #<RatatuiRuby::Event::Key code="c" mod│
+│  Modified: 0     │ │Mouse    XX:XX:XX  #<RatatuiRuby::Event::Mouse:0xXXXXXX│
+│Mouse: 1          │ │Resize   —         —                                     │
+│  Down: 1         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Key code="a" modifiers=[]>         │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │#<RatatuiRuby::Event::Key code="b" modifiers=[]>         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │#<RatatuiRuby::Event::Key code="c" modifiers=[]>         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │#<RatatuiRuby::Event::Mouse:0xXXXXXX           │
+│                  │ │@kind="down", @x=10, @y=5, @button="left", @modifiers=[]>│
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_paste.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    XX:XX:XX  #<RatatuiRuby::Event::Paste:0xXXXXXX│
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Paste:0xXXXXXX           │
+│Resize: 0         │ │@content="Hello World">                                  │
+│Paste: 1          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_resize.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   XX:XX:XX  #<RatatuiRuby::Event::Resize:0xXXXXXX│
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Resize:0xXXXXXX          │
+│Resize: 1         │ │@width=100, @height=30>                                  │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_right_click.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    XX:XX:XX  #<RatatuiRuby::Event::Mouse:0xXXXXXX│
+│Mouse: 1          │ │Resize   —         —                                     │
+│  Down: 1         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Mouse:0xXXXXXX           │
+│Resize: 0         │ │@kind="down", @x=50, @y=10, @button="right",             │
+│Paste: 0          │ │@modifiers=[]>                                           │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/after_vertical_resize.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   XX:XX:XX  #<RatatuiRuby::Event::Resize:0xXXXXXX│
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │#<RatatuiRuby::Event::Resize:0xXXXXXX          │
+│Resize: 1         │ │@width=80, @height=30>                                   │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/test/snapshots/initial_state.txt

@@ -0,0 +1,24 @@
+┌Event Counts──────┐ ┌Live Display─────────────────────────────────────────────┐
+│Key: 0            │ │Type     Time      Description                           │
+│  Unmodified: 0   │ │Key      —         —                                     │
+│  Modified: 0     │ │Mouse    —         —                                     │
+│Mouse: 0          │ │Resize   —         —                                     │
+│  Down: 0         │ │Paste    —         —                                     │
+│  Up: 0           │ │Focus    —         —                                     │
+│  Drag: 0         │ │                                                         │
+│  Moved: 0        │ └─────────────────────────────────────────────────────────┘
+│  Scroll_up: 0    │ ┌Event Log────────────────────────────────────────────────┐
+│  Scroll_down: 0  │ │No events yet...                                         │
+│Resize: 0         │ │                                                         │
+│Paste: 0          │ │                                                         │
+│Focus: 0          │ │                                                         │
+│  Gained: 0       │ │                                                         │
+│  Lost: 0         │ │                                                         │
+│None: 0           │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+│                  │ │                                                         │
+└──────────────────┘ └─────────────────────────────────────────────────────────┘
+┌Controls──────────────────────────────────────────────────────────────────────┐
+│q: Quit  Ctrl+C: Quit                                                         │
+└──────────────────────────────────────────────────────────────────────────────┘