ratatui_ruby 0.1.0

data/examples/box_demo.rb

@@ -0,0 +1,71 @@
+# 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"
+
+class BoxDemoApp
+  def initialize
+    @color = "green"
+    @text = "Press Arrow Keys (q to quit)"
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    # 1. State/View
+    block = RatatuiRuby::Block.new(
+      title: "Box Demo",
+      borders: [:all],
+      border_color: @color
+    )
+
+    view_tree = RatatuiRuby::Paragraph.new(
+      text: @text,
+      fg: @color,
+      block:
+    )
+
+    # 2. Render
+    RatatuiRuby.draw(view_tree)
+  end
+
+  def handle_input
+    # 3. Events
+    event = RatatuiRuby.poll_event
+    return unless event
+
+    if event[:type] == :key
+      case event[:code]
+      when "q"
+        :quit
+      when "up"
+        @color = "red"
+        @text = "Up Pressed!"
+      when "down"
+        @color = "blue"
+        @text = "Down Pressed!"
+      when "left"
+        @color = "yellow"
+        @text = "Left Pressed!"
+      when "right"
+        @color = "magenta"
+        @text = "Right Pressed!"
+      end
+    end
+  end
+end
+
+BoxDemoApp.new.run if __FILE__ == $0

data/examples/dashboard.rb

@@ -0,0 +1,72 @@
+# 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"
+
+include RatatuiRuby
+
+class DashboardApp
+  include RatatuiRuby
+
+  def initialize
+    @items = ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"]
+    @selected_index = 0
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    selected_item = @items[@selected_index]
+
+    sidebar = List.new(
+      items: @items,
+      selected_index: @selected_index,
+      block: Block.new(title: "Files", borders: [:all])
+    )
+
+    main_content = Paragraph.new(
+      text: "You selected: #{selected_item}",
+      block: Block.new(title: "Content", borders: [:all])
+    )
+
+    layout = Layout.new(
+      direction: :horizontal,
+      constraints: [
+        Constraint.percentage(30),
+        Constraint.min(0),
+      ],
+      children: [sidebar, main_content]
+    )
+
+    RatatuiRuby.draw(layout)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    if event
+      case event[:code]
+      when "q", "esc"
+        :quit
+      when "up"
+        @selected_index = (@selected_index - 1) % @items.length
+      when "down"
+        @selected_index = (@selected_index + 1) % @items.length
+      end
+    end
+  end
+end
+
+DashboardApp.new.run if __FILE__ == $0

data/examples/login_form.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "../lib/ratatui_ruby"
+
+class LoginFormApp
+  PREFIX = "Enter Username: [ "
+  SUFFIX = " ]"
+
+  def initialize
+    @username = ""
+    @show_popup = false
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    # 1. Base Layer Construction
+    # We want a cursor relative to the paragraph.
+    # So we wrap Paragraph and Cursor in an Overlay, and put that Overlay in a Center.
+
+    # Calculate cursor position
+    # Border takes 1 cell.
+    # Cursor X = 1 (border) + PREFIX.length + username.length
+    # Cursor Y = 1 (border + line 0)
+    cursor_x = 1 + PREFIX.length + @username.length
+    cursor_y = 1
+
+    # The content of the base form
+    form_content = RatatuiRuby::Overlay.new(layers: [
+      RatatuiRuby::Paragraph.new(
+        text: "#{PREFIX}#{@username}#{SUFFIX}",
+        block: RatatuiRuby::Block.new(borders: :all, title: "Login Form"),
+        align: :left
+      ),
+      RatatuiRuby::Cursor.new(x: cursor_x, y: cursor_y),
+    ])
+
+    # Center the form on screen
+    base_layer = RatatuiRuby::Center.new(
+      child: form_content,
+      width_percent: 50,
+      height_percent: 20
+    )
+
+    # 2. Popup Layer Construction
+    final_view = if @show_popup
+      popup_message = RatatuiRuby::Center.new(
+        child: RatatuiRuby::Paragraph.new(
+          text: "Login Successful!\nPress 'q' to quit.",
+          style: RatatuiRuby::Style.new(fg: :green, bg: :black),
+          block: RatatuiRuby::Block.new(borders: :all),
+          align: :center,
+          wrap: true
+        ),
+        width_percent: 30,
+        height_percent: 20
+      )
+
+      # Render Base Layer (background) THEN Popup Layer
+      RatatuiRuby::Overlay.new(layers: [base_layer, popup_message])
+    else
+      base_layer
+    end
+
+    # 3. Draw
+    RatatuiRuby.draw(final_view)
+  end
+
+  def handle_input
+    # 4. Event Handling
+    event = RatatuiRuby.poll_event
+    return unless event
+
+    if event[:type] == :key
+      if @show_popup
+        # If popup is shown, any key (or specifically q) quits?
+        # "The Center widget contains a Green Box saying 'Login Successful! Press q.'"
+        if event[:code] == "q"
+          :quit
+        end
+      else
+        # Login Form Input
+        case event[:code]
+        when "enter"
+          @show_popup = true
+        when "backspace"
+          @username.chop!
+        when "esc"
+          :quit
+        else
+          # Simple text input
+          if event[:code].length == 1
+            @username += event[:code]
+          end
+        end
+      end
+    end
+  end
+end
+
+LoginFormApp.new.run if __FILE__ == $0

data/examples/map_demo.rb

@@ -0,0 +1,58 @@
+# 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"
+
+# An example of the Canvas widget showing a world map and animated shapes.
+module MapDemo
+  include RatatuiRuby
+
+  # Returns a Canvas view for the map demo with the given circle radius.
+  #
+  # +radius+:: The radius of the animated circle.
+  def self.view(radius)
+    Canvas.new(
+      shapes: [
+        Map.new(color: :green, resolution: :high),
+        Circle.new(x: 0.0, y: 0.0, radius:, color: :red),
+        Line.new(x1: 0.0, y1: 0.0, x2: 50.0, y2: 25.0, color: :yellow),
+      ],
+      x_bounds: [-180.0, 180.0],
+      y_bounds: [-90.0, 90.0],
+      marker: :braille,
+      block: Block.new(title: "World Map Canvas", borders: :all)
+    )
+  end
+
+  # Runs the map demo loop.
+  def self.run
+    RatatuiRuby.init_terminal
+    radius = 0.0
+    direction = 1
+
+    loop do
+      # Animate the circle radius
+      radius += 0.5 * direction
+      if radius > 10.0 || radius < 0.0
+        direction *= -1
+      end
+
+      # Define the view
+      view = view(radius)
+
+      RatatuiRuby.draw(view)
+
+      event = RatatuiRuby.poll_event
+      break if event && event[:type] == :key && event[:code] == "q"
+
+      sleep 0.05
+    end
+  ensure
+    RatatuiRuby.restore_terminal
+  end
+end
+
+MapDemo.run if __FILE__ == $PROGRAM_NAME

data/examples/mouse_events.rb

@@ -0,0 +1,95 @@
+# 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"
+
+class MouseEventsApp
+  def initialize
+    @message = "Waiting for Mouse... (q to quit)"
+    @details = ""
+    @color = "white"
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    # Create a centered block with the mouse event details
+    block = RatatuiRuby::Block.new(
+      title: "Mouse Event Plumbing",
+      borders: [:all],
+      border_color: @color
+    )
+
+    content = RatatuiRuby::Paragraph.new(
+      text: "#{@message}\n#{@details}",
+      align: :center,
+      block:
+    )
+
+    # Use a layout to center the content
+    layout = RatatuiRuby::Layout.new(
+      direction: :vertical,
+      constraints: [
+        RatatuiRuby::Constraint.percentage(25),
+        RatatuiRuby::Constraint.percentage(50),
+        RatatuiRuby::Constraint.percentage(25),
+      ],
+      children: [
+        RatatuiRuby::Paragraph.new(text: ""),
+        content,
+        RatatuiRuby::Paragraph.new(text: ""),
+      ]
+    )
+
+    RatatuiRuby.draw(layout)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    return unless event
+
+    if event[:type] == :key && event[:code] == "q"
+      return :quit
+    end
+
+    if event[:type] == :mouse
+      @color = "green"
+      case event[:kind]
+      when :down
+        @message = "#{event[:button].to_s.capitalize} Click at [#{event[:x]}, #{event[:y]}]"
+        @details = "Modifiers: #{event[:modifiers].join(', ')}"
+      when :up
+        @message = "#{event[:button].to_s.capitalize} Release at [#{event[:x]}, #{event[:y]}]"
+        @details = "Modifiers: #{event[:modifiers].join(', ')}"
+      when :drag
+        @message = "Dragging #{event[:button].to_s.capitalize} Button at [#{event[:x]}, #{event[:y]}]"
+        @details = "Modifiers: #{event[:modifiers].join(', ')}"
+      when :moved
+        @message = "Mouse Moved to [#{event[:x]}, #{event[:y]}]"
+        @details = "Modifiers: #{event[:modifiers].join(', ')}"
+      when :scroll_down
+        @message = "Scrolled Down"
+        @details = "Position: [#{event[:x]}, #{event[:y]}]"
+      when :scroll_up
+        @message = "Scrolled Up"
+        @details = "Position: [#{event[:x]}, #{event[:y]}]"
+      end
+    end
+    nil
+  end
+end
+
+MouseEventsApp.new.run if __FILE__ == $0

data/examples/scrollbar_demo.rb

@@ -0,0 +1,75 @@
+# 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"
+
+# Simple Scrollbar Demo
+class ScrollbarDemo
+  def initialize
+    @scroll_position = 0
+    @content_length = 50
+    @lines = (1..@content_length).map { |i| "Line #{i}" }
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        draw
+        event = RatatuiRuby.poll_event
+        break if event && event[:type] == :key && event[:code] == "q"
+
+        handle_event(event)
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  private def handle_event(event)
+    return unless event && event[:type] == :mouse
+
+    case event[:kind]
+    when :scroll_up
+      @scroll_position = [@scroll_position - 1, 0].max
+    when :scroll_down
+      @scroll_position = [@scroll_position + 1, @content_length].min
+    end
+  end
+
+  private def draw
+    # Calculate visible lines based on scroll position
+    # In a real app, you'd want to know the height of the available area.
+    # For this demo, we'll just show all lines but offset the text.
+    visible_lines = @lines[@scroll_position..-1] || []
+
+    # Paragraph with content
+    p = RatatuiRuby::Paragraph.new(
+      text: visible_lines.join("\n"),
+      block: RatatuiRuby::Block.new(title: "Scroll with Mouse Wheel", borders: [:all])
+    )
+
+    # Scrollbar on the right
+    s = RatatuiRuby::Scrollbar.new(
+      content_length: @content_length,
+      position: @scroll_position
+    )
+
+    # Use a Layout to place scrollbar on the right
+    layout = RatatuiRuby::Layout.new(
+      direction: :horizontal,
+      constraints: [
+        RatatuiRuby::Constraint.percentage(95),
+        RatatuiRuby::Constraint.percentage(5),
+      ],
+      children: [p, s]
+    )
+
+    RatatuiRuby.draw(layout)
+  end
+end
+
+ScrollbarDemo.new.run if __FILE__ == $PROGRAM_NAME

data/examples/stock_ticker.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "../lib/ratatui_ruby"
+
+# Simulate a stock ticker
+class StockTickerApp
+  def initialize
+    @network_data = Array.new(50) { rand(0..10) }
+    @ruby_stock = []
+    @rust_stock = []
+    @counter = 0
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+        sleep 0.1
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    # Update data
+    @counter += 1
+    @network_data.shift
+    @network_data << rand(0..10)
+
+    ruby_val = 50.0 + (Math.sin(@counter * 0.1) * 20.0) + (rand * 5.0)
+    rust_val = 40.0 + (Math.cos(@counter * 0.2) * 15.0) + (rand * 10.0)
+
+    @ruby_stock << [@counter.to_f, ruby_val]
+    @rust_stock << [@counter.to_f, rust_val]
+
+    # Keep only last 100 points
+    if @ruby_stock.length > 100
+      @ruby_stock.shift
+      @rust_stock.shift
+    end
+
+    # Define UI
+    ui = RatatuiRuby::Layout.new(
+      direction: :vertical,
+      constraints: [
+        RatatuiRuby::Constraint.new(type: :percentage, value: 20),
+        RatatuiRuby::Constraint.new(type: :percentage, value: 80),
+      ],
+      children: [
+        RatatuiRuby::Sparkline.new(
+          data: @network_data,
+          style: RatatuiRuby::Style.new(fg: :cyan),
+          block: RatatuiRuby::Block.new(title: "Network Activity", borders: :all)
+        ),
+        RatatuiRuby::LineChart.new(
+          datasets: [
+            RatatuiRuby::Dataset.new(name: "RBY", data: @ruby_stock, color: :green),
+            RatatuiRuby::Dataset.new(name: "RST", data: @rust_stock, color: :red),
+          ],
+          x_labels: [@counter.to_s],
+          y_labels: %w[0 50 100],
+          y_bounds: [0.0, 100.0],
+          block: RatatuiRuby::Block.new(title: "Stock Ticker", borders: :all),
+        ),
+      ]
+    )
+
+    RatatuiRuby.draw(ui)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    if event && event[:code] == "q"
+      :quit
+    end
+  end
+end
+
+StockTickerApp.new.run if __FILE__ == $0

data/examples/system_monitor.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "../lib/ratatui_ruby"
+
+class SystemMonitorApp
+  def initialize
+    @percentage = 50
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    # System Monitor Layout
+    # Top: Table (50%)
+    # Bottom: Gauge (50%)
+
+    header_style = RatatuiRuby::Style.new(fg: :blue, modifiers: [:bold])
+
+    header = [
+      RatatuiRuby::Paragraph.new(text: "PID", style: header_style),
+      RatatuiRuby::Paragraph.new(text: "Name", style: header_style),
+      RatatuiRuby::Paragraph.new(text: "CPU%", style: header_style),
+      RatatuiRuby::Paragraph.new(text: "Mem%", style: header_style),
+    ]
+
+    rows = [
+      ["1234", "ruby", "0.5", "1.2"],
+      ["5678", "rust", "10.2", "4.5"],
+      ["9012", "system", "1.1", "0.8"],
+    ]
+
+    widths = [
+      RatatuiRuby::Constraint.length(10),
+      RatatuiRuby::Constraint.min(20),
+      RatatuiRuby::Constraint.length(10),
+      RatatuiRuby::Constraint.length(10),
+    ]
+
+    table = RatatuiRuby::Table.new(
+      header:,
+      rows:,
+      widths:,
+      block: RatatuiRuby::Block.new(title: "Processes", borders: [:all])
+    )
+
+    gauge = RatatuiRuby::Gauge.new(
+      ratio: @percentage / 100.0,
+      label: "#{@percentage}%",
+      style: RatatuiRuby::Style.new(fg: :green),
+      block: RatatuiRuby::Block.new(title: "Memory Usage", borders: [:all])
+    )
+
+    layout = RatatuiRuby::Layout.new(
+      direction: :vertical,
+      children: [table, gauge],
+      constraints: [
+        RatatuiRuby::Constraint.percentage(50),
+        RatatuiRuby::Constraint.percentage(50),
+      ]
+    )
+
+    RatatuiRuby.draw(layout)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    if event
+      case event[:code]
+      when "q"
+        :quit
+      when "up"
+        @percentage = [@percentage + 5, 100].min
+      when "down"
+        @percentage = [@percentage - 5, 0].max
+      end
+    end
+  end
+end
+
+SystemMonitorApp.new.run if __FILE__ == $0