ratatui_ruby 0.4.0 → 0.5.0

data/examples/all_events/app.rb

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

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

data/examples/all_events/test_app.rb

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

data/examples/analytics/app.rb

@@ -1,258 +0,0 @@
-# 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"
-
-# Analytics Dashboard Example
-# Demonstrates Tabs and BarChart widgets.
-
-class AnalyticsApp
-  def initialize
-    @selected_tab = 0
-    @tabs = ["Revenue", "Traffic", "Errors", "Quarterly"]
-    @styles = [
-      { name: "Yellow Bold", style: RatatuiRuby::Style.new(fg: :yellow, modifiers: [:bold]) },
-      { name: "Italic Blue on White", style: RatatuiRuby::Style.new(fg: :blue, bg: :white, modifiers: [:italic]) },
-      { name: "Underlined Red", style: RatatuiRuby::Style.new(fg: :red, modifiers: [:underlined]) },
-      { name: "Reversed", style: RatatuiRuby::Style.new(modifiers: [:reversed]) }
-    ]
-    @style_index = 0
-    @divider_index = 0
-    @dividers = [" | ", " • ", " > ", " / "]
-    @base_styles = [
-      { name: "Default", style: nil },
-      { name: "White on Gray", style: RatatuiRuby::Style.new(fg: :white, bg: :dark_gray) },
-      { name: "White on Blue", style: RatatuiRuby::Style.new(fg: :white, bg: :blue) },
-      { name: "Italic", style: RatatuiRuby::Style.new(modifiers: [:italic]) }
-    ]
-    @base_style_index = 0
-    @padding_left = 0
-    @padding_right = 0
-    @direction = :vertical
-    @label_style_index = 0
-    @value_style_index = 0
-    @bar_sets = [
-      { name: "Default", set: nil },
-      { name: "Numbers (Short)", set: { 8 => "8", 7 => "7", 6 => "6", 5 => "5", 4 => "4", 3 => "3", 2 => "2", 1 => "1", 0 => "0" } },
-      { name: "Letters (Long)", set: { full: "H", seven_eighths: "G", three_quarters: "F", five_eighths: "E", half: "D", three_eighths: "C", one_quarter: "B", one_eighth: "A", empty: " " } },
-      { name: "ASCII (Heights)", set: [" ", "_", ".", "-", "=", "+", "*", "#", "@"] }
-    ]
-    @bar_set_index = 0
-    @height_mode = :full # :full or :mini
-    @group_gap = 0
-
-    @hotkey_style = RatatuiRuby::Style.new(modifiers: [:bold, :underlined])
-  end
-
-  def run
-    RatatuiRuby.run do
-      loop do
-        render
-        break if handle_input == :quit
-      end
-    end
-  end
-
-  private
-
-  def render
-    # Data for different tabs
-    data = case @selected_tab
-           when 0 # Revenue
-             {
-               "Q1" => 50, "Q2" => 80, "Q3" => 45, "Q4" => 60,
-               "Q1'" => 55, "Q2'" => 85, "Q3'" => 50, "Q4'" => 65
-             }
-           when 1 # Traffic
-             [
-               ["Mon", 120], ["Tue", 150], ["Wed", 130], ["Thu", 160],
-               ["Fri", 140],
-               ["Sat", 110, RatatuiRuby::Style.new(fg: :red)],
-               ["Sun", 100, RatatuiRuby::Style.new(fg: :red)]
-             ]
-           when 2 # Errors
-             { DB: 5, UI: 2, API: 8, Auth: 3, Net: 4, "I/O": 1, Mem: 6, CPU: 7 }
-           when 3 # Quarterly
-             [
-               RatatuiRuby::BarChart::BarGroup.new(label: "2024", bars: [
-                 RatatuiRuby::BarChart::Bar.new(value: 40, label: "Q1"),
-                 RatatuiRuby::BarChart::Bar.new(value: 45, label: "Q2"),
-                 RatatuiRuby::BarChart::Bar.new(value: 50, label: "Q3"),
-                 RatatuiRuby::BarChart::Bar.new(value: 55, label: "Q4")
-               ]),
-               RatatuiRuby::BarChart::BarGroup.new(label: "2025", bars: [
-                 RatatuiRuby::BarChart::Bar.new(value: 60, label: "Q1", style: RatatuiRuby::Style.new(fg: :yellow)),
-                 RatatuiRuby::BarChart::Bar.new(value: 65, label: "Q2", style: RatatuiRuby::Style.new(fg: :yellow)),
-                 RatatuiRuby::BarChart::Bar.new(value: 70, label: "Q3", style: RatatuiRuby::Style.new(fg: :yellow)),
-                 RatatuiRuby::BarChart::Bar.new(value: 75, label: "Q4", style: RatatuiRuby::Style.new(fg: :yellow))
-               ])
-             ]
-    end
-
-    bar_style = case @selected_tab
-                when 0 then RatatuiRuby::Style.new(fg: "green")
-                when 1 then RatatuiRuby::Style.new(fg: "blue")
-                when 2 then RatatuiRuby::Style.new(fg: "red")
-                when 3 then RatatuiRuby::Style.new(fg: "cyan")
-    end
-
-    # Define the BarChart widget
-    bar_chart = RatatuiRuby::BarChart.new(
-      data:,
-      bar_width: @direction == :vertical ? 8 : 1,
-      style: bar_style,
-      bar_gap: 1,
-      group_gap: @group_gap,
-      direction: @direction,
-      label_style: @styles[@label_style_index][:style],
-      value_style: @styles[@value_style_index][:style],
-      bar_set: @bar_sets[@bar_set_index][:set],
-      block: RatatuiRuby::Block.new(
-        title: "Analytics: #{@tabs[@selected_tab]}",
-        borders: [:all]
-      )
-    )
-
-    # Wrap chart in a layout to control height if in mini mode
-    chart_area = if @height_mode == :mini
-       # Height 3: 1 row content + 2 borders
-       RatatuiRuby::Layout.new(
-         direction: :vertical,
-         constraints: [RatatuiRuby::Constraint.length(3), RatatuiRuby::Constraint.fill(1)],
-         children: [bar_chart, RatatuiRuby::Block.new] # Empty block to fill rest
-       )
-    else
-      bar_chart
-    end
-
-    # Build the UI
-    ui = RatatuiRuby::Layout.new(
-      direction: :vertical,
-      constraints: [
-        RatatuiRuby::Constraint.fill(1),
-        RatatuiRuby::Constraint.length(6),
-      ],
-      children: [
-        # Main Area
-        RatatuiRuby::Layout.new(
-          direction: :vertical,
-          constraints: [
-            RatatuiRuby::Constraint.new(type: :length, value: 3),
-            RatatuiRuby::Constraint.new(type: :min, value: 0),
-          ],
-          children: [
-            tabs = RatatuiRuby::Tabs.new(
-              titles: @tabs,
-              selected_index: @selected_tab,
-              block: RatatuiRuby::Block.new(title: "Views", borders: [:all]),
-              divider: @dividers[@divider_index],
-              highlight_style: @styles[@style_index][:style],
-              style: @base_styles[@base_style_index][:style],
-              padding_left: @padding_left,
-              padding_right: @padding_right
-            ),
-            chart_area
-          ]
-        ),
-        # Bottom control panel
-        RatatuiRuby::Block.new(
-          title: "Controls",
-          borders: [:all],
-          children: [
-            RatatuiRuby::Paragraph.new(
-              text: [
-                # Line 1: Navigation & General
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "←/→", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Navigate Tab  "),
-                  RatatuiRuby::Text::Span.new(content: "v", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Direction (#{@direction})  "),
-                  RatatuiRuby::Text::Span.new(content: "q", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Quit")
-                ]),
-                # Line 2: Padding & Divider
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "h/l", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Pad Left (#{@padding_left})  "),
-                  RatatuiRuby::Text::Span.new(content: "j/k", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Pad Right (#{@padding_right})  "),
-                  RatatuiRuby::Text::Span.new(content: "d", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Divider (#{@dividers[@divider_index]})  "),
-                  RatatuiRuby::Text::Span.new(content: "Width: #{tabs.width}")
-                ]),
-                # Line 3: Styles
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "space", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Highlight (#{@styles[@style_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "x", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Label (#{@styles[@label_style_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "space", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Highlight (#{@styles[@style_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "x", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Label (#{@styles[@label_style_index][:name]})")
-                ]),
-                # Line 4: More Styles
-                RatatuiRuby::Text::Line.new(spans: [
-                  RatatuiRuby::Text::Span.new(content: "z", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Value (#{@styles[@value_style_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "b", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Bar Set (#{@bar_sets[@bar_set_index][:name]})  "),
-                  RatatuiRuby::Text::Span.new(content: "m", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Mode (#{@height_mode == :full ? 'Full' : 'Mini'})  "),
-                  RatatuiRuby::Text::Span.new(content: "g", style: @hotkey_style),
-                  RatatuiRuby::Text::Span.new(content: ": Group Gap (#{@group_gap})")
-                ])
-              ]
-            )
-          ]
-        )
-      ]
-    )
-
-    RatatuiRuby.draw(ui)
-  end
-
-  def handle_input
-    case RatatuiRuby.poll_event
-    in {type: :key, code: "q"} | {type: :key, code: "c", modifiers: ["ctrl"]}
-      :quit
-    in type: :key, code: "right"
-      @selected_tab = (@selected_tab + 1) % @tabs.size
-    in type: :key, code: "left"
-      @selected_tab = (@selected_tab - 1) % @tabs.size
-    in type: :key, code: " "
-      @style_index = (@style_index + 1) % @styles.size
-    in type: :key, code: "d"
-      @divider_index = (@divider_index + 1) % @dividers.size
-    in type: :key, code: "s"
-      @base_style_index = (@base_style_index + 1) % @base_styles.size
-    in type: :key, code: "h"
-      @padding_left = [@padding_left - 1, 0].max
-    in type: :key, code: "l"
-      @padding_left += 1
-    in type: :key, code: "v"
-      @direction = @direction == :vertical ? :horizontal : :vertical
-    in type: :key, code: "j"
-      @padding_right = [@padding_right - 1, 0].max
-    in type: :key, code: "k"
-      @padding_right += 1
-    in type: :key, code: "x"
-      @label_style_index = (@label_style_index + 1) % @styles.size
-    in type: :key, code: "z"
-      @value_style_index = (@value_style_index + 1) % @styles.size
-    in type: :key, code: "b"
-      @bar_set_index = (@bar_set_index + 1) % @bar_sets.size
-    in type: :key, code: "m"
-      @height_mode = @height_mode == :full ? :mini : :full
-    in type: :key, code: "g"
-      @group_gap = (@group_gap + 1) % 4
-    else
-      # Ignore other events
-    end
-  end
-end
-
-AnalyticsApp.new.run if __FILE__ == $0

data/examples/analytics/app.rbs

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