ratatui_ruby 0.5.0 → 0.6.0

data/examples/app_all_events/model/events.rb

@@ -1,180 +0,0 @@
-# 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

@@ -1,57 +0,0 @@
-# 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/test/snapshots/after_focus_lost.txt

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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

@@ -1,24 +0,0 @@
-┌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                                                         │
-└──────────────────────────────────────────────────────────────────────────────┘

data/examples/app_all_events/view_state.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-# Encapsulates all data required to render the application view.
-#
-# Views need access to models, global settings, and calculated styles.
-# Passing dozens of individual parameters to view components is messy and unmaintainable.
-#
-# This class provides a single, structured object containing all state necessary for rendering.
-#
-# Use it to shuttle data from the main application to the various view components.
-#
-# === Examples
-#
-#   state = ViewState.build(events, true, tui, nil)
-#   puts state.focused #=> true
-#   app_view.call(state, tui, frame, area)
-class ViewState < Data.define(:events, :focused, :hotkey_style, :dimmed_style, :lit_style, :border_color, :area)
-  # Builds a new ViewState with calculated styles.
-  #
-  # [events] Events model instance.
-  # [focused] Boolean indicating if the app has focus.
-  # [tui] RatatuiRuby instance for style creation.
-  # [_resize_sub_counter] Unused parameter (reserved for future use).
-  #
-  # === Example
-  #
-  #   ViewState.build(events, true, tui, nil) #=> #<ViewState ...>
-  def self.build(events, focused, tui, _resize_sub_counter)
-    new(
-      events:,
-      focused:,
-      hotkey_style: tui.style(modifiers: [:bold, :underlined]),
-      dimmed_style: tui.style(fg: :dark_gray),
-      lit_style: tui.style(fg: :green, modifiers: [:bold]),
-      border_color: focused ? :green : :gray,
-      area: nil
-    )
-  end
-end