ratatui_ruby 0.1.0 → 0.2.0

data/examples/chart_demo.rb

@@ -0,0 +1,84 @@
+# 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"
+
+# Chart Demo
+# Demonstrates Scatter and Line datasets in a single Chart.
+class ChartDemoApp
+  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
+    # Scatter data: Random points
+    scatter_data = Array.new(20) { [rand(0.0..10.0), rand(-1.0..1.0)] }
+
+    # Line data: Sine wave
+    line_data = (0..100).map do |i|
+      x = i / 10.0
+      [x, Math.sin(x)]
+    end
+
+    datasets = [
+      RatatuiRuby::Dataset.new(
+        name: "Scatter",
+        data: scatter_data,
+        color: "red",
+        marker: :dot,
+        graph_type: :scatter,
+      ),
+      RatatuiRuby::Dataset.new(
+        name: "Line",
+        data: line_data,
+        color: "green",
+        marker: :braille,
+        graph_type: :line,
+      ),
+    ]
+
+    chart = RatatuiRuby::Chart.new(
+      datasets:,
+      x_axis: RatatuiRuby::Axis.new(
+        title: "Time",
+        bounds: [0.0, 10.0],
+        labels: %w[0 5 10],
+        style: RatatuiRuby::Style.new(fg: :yellow),
+      ),
+      y_axis: RatatuiRuby::Axis.new(
+        title: "Amplitude",
+        bounds: [-1.0, 1.0],
+        labels: %w[-1 0 1],
+        style: RatatuiRuby::Style.new(fg: :cyan),
+      ),
+      block: RatatuiRuby::Block.new(
+        title: "Chart Demo (Q to quit)",
+        borders: [:all],
+      ),
+    )
+
+    RatatuiRuby.draw(chart)
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    return nil unless event
+
+    return :quit if event[:type] == :key && event[:code] == "q"
+    nil
+  end
+end
+
+ChartDemoApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/list_styles.rb

@@ -0,0 +1,66 @@
+# 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"
+
+# Styled List Example
+# Demonstrates advanced styling options for the List widget.
+class ListStylesApp
+  attr_reader :selected_index
+
+  def initialize
+    @items = ["Item 1", "Item 2", "Item 3"]
+    @selected_index = 0
+  end
+
+  def run
+    RatatuiRuby.init_terminal
+    begin
+      loop do
+        render
+        break if handle_input == :quit
+        sleep 0.05
+      end
+    ensure
+      RatatuiRuby.restore_terminal
+    end
+  end
+
+  def render
+    RatatuiRuby.draw(
+      RatatuiRuby::List.new(
+        items: @items,
+        selected_index: @selected_index,
+        style: RatatuiRuby::Style.new(fg: :white, bg: :black),
+        highlight_style: RatatuiRuby::Style.new(fg: :blue, bg: :white, modifiers: [:bold]),
+        highlight_symbol: ">> ",
+        block: RatatuiRuby::Block.new(
+          title: "Styled List (Up/Down to move, Q to quit)",
+          borders: [:all]
+        )
+      )
+    )
+  end
+
+  def handle_input
+    event = RatatuiRuby.poll_event
+    return nil unless event
+
+    if event[:type] == :key
+      case event[:code]
+      when "up"
+        @selected_index = (@selected_index - 1) % @items.size
+      when "down"
+        @selected_index = (@selected_index + 1) % @items.size
+      when "q"
+        return :quit
+      end
+    end
+    nil
+  end
+end
+
+ListStylesApp.new.run if __FILE__ == $PROGRAM_NAME

data/examples/login_form.rb

@@ -3,7 +3,8 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "../lib/ratatui_ruby"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ratatui_ruby"
 
 class LoginFormApp
   PREFIX = "Enter Username: [ "

data/examples/quickstart_dsl.rb

@@ -0,0 +1,30 @@
+# 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"
+
+# 1. Initialize the terminal, start the main loop, and ensure the terminal is restored.
+RatatuiRuby.main_loop do |tui|
+  # 2. Create your UI with methods instead of classes.
+  view = tui.paragraph(
+    text: "Hello, Ratatui! Press 'q' to quit.",
+    align: :center,
+    block: tui.block(
+      title: "My Ruby TUI App",
+      borders: [:all],
+      border_color: "cyan"
+    )
+  )
+
+  # 3. Use RatatuiRuby methods, too.
+  tui.draw(view)
+  event = tui.poll_event
+
+  if event && event[:type] == :key && event[:code] == "q"
+    break
+  end
+end

data/examples/quickstart_lifecycle.rb

@@ -0,0 +1,40 @@
+# 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"
+
+# 1. Initialize the terminal
+RatatuiRuby.init_terminal
+
+begin
+  # The Main Loop
+  loop do
+    # 2. Create your UI (Immediate Mode)
+    # We define a Paragraph widget inside a Block with a title and borders.
+    view = RatatuiRuby::Paragraph.new(
+      text: "Hello, Ratatui! Press 'q' to quit.",
+      align: :center,
+      block: RatatuiRuby::Block.new(
+        title: "My Ruby TUI App",
+        borders: [:all],
+        border_color: "cyan"
+      )
+    )
+
+    # 3. Draw the UI
+    RatatuiRuby.draw(view)
+
+    # 4. Poll for events
+    event = RatatuiRuby.poll_event
+    if event && event[:type] == :key && event[:code] == "q"
+      break
+    end
+  end
+ensure
+  # 5. Restore the terminal to its original state
+  RatatuiRuby.restore_terminal
+end

data/examples/readme_usage.rb

@@ -0,0 +1,21 @@
+# 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"
+RatatuiRuby.main_loop do |tui|
+  tui.draw \
+    tui.paragraph \
+      text: "Hello, Ratatui! Press 'q' to quit.",
+      align: :center,
+      block: tui.block(
+        title: "My Ruby TUI App",
+        borders: [:all],
+        border_color: "cyan"
+      )
+  event = tui.poll_event
+  break if event && event[:type] == :key && event[:code] == "q"
+end

data/examples/stock_ticker.rb

@@ -3,7 +3,8 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "../lib/ratatui_ruby"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ratatui_ruby"
 
 # Simulate a stock ticker
 class StockTickerApp
@@ -58,14 +59,21 @@ class StockTickerApp
           style: RatatuiRuby::Style.new(fg: :cyan),
           block: RatatuiRuby::Block.new(title: "Network Activity", borders: :all)
         ),
-        RatatuiRuby::LineChart.new(
+        RatatuiRuby::Chart.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],
+          x_axis: RatatuiRuby::Axis.new(
+            title: "Time",
+            bounds: [((@counter > 100) ? @counter - 100.0 : 0.0), @counter.to_f],
+            labels: [@counter.to_s]
+          ),
+          y_axis: RatatuiRuby::Axis.new(
+            title: "Price",
+            bounds: [0.0, 100.0],
+            labels: %w[0 50 100]
+          ),
           block: RatatuiRuby::Block.new(title: "Stock Ticker", borders: :all),
         ),
       ]

data/examples/system_monitor.rb

@@ -3,7 +3,8 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "../lib/ratatui_ruby"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "ratatui_ruby"
 
 class SystemMonitorApp
   def initialize

data/examples/test_calendar_demo.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require "minitest/autorun"
+require "ratatui_ruby"
+
+module CalendarDemo
+  class TestCalendarDemo < Minitest::Test
+    def setup
+      RatatuiRuby.init_test_terminal(40, 20)
+    end
+
+    def test_demo_renders
+      # We can't easily test the loop in run, but we can test the rendering logic
+      now = Time.now
+      calendar = RatatuiRuby::Calendar.new(
+        year: now.year,
+        month: now.month,
+        header_style: RatatuiRuby::Style.new(fg: "yellow", modifiers: [:bold]),
+        block: RatatuiRuby::Block.new(title: " Calendar (q = quit) ", borders: [:all]),
+      )
+
+      # Constrain the calendar to 24x10 characters
+      view = RatatuiRuby::Layout.new(
+        direction: :vertical,
+        constraints: [
+          RatatuiRuby::Constraint.length(10),
+          RatatuiRuby::Constraint.min(0),
+        ],
+        children: [
+          RatatuiRuby::Layout.new(
+            direction: :horizontal,
+            constraints: [
+              RatatuiRuby::Constraint.length(24),
+              RatatuiRuby::Constraint.min(0),
+            ],
+            children: [calendar, nil],
+          ),
+          nil,
+        ],
+      )
+
+      RatatuiRuby.draw(view)
+      content = RatatuiRuby.get_buffer_content
+
+      assert_match(/Calendar \(q = quit\)/, content)
+      assert_match(/#{now.year}/, content)
+
+      # Verify the size constraint: the terminal is 40x20
+      # But the layout should be constrained to 24x10.
+      lines = content.split("\n")
+
+      # First 10 rows: first 24 chars can have content, 24..39 should be empty
+      10.times do |i|
+        assert_equal " " * 16, lines[i][24..39], "Row #{i} should be empty after column 24"
+      end
+
+      # Rows 10..19 should be completely empty
+      (10..19).each do |i|
+        assert_equal " " * 40, lines[i], "Row #{i} should be completely empty"
+      end
+    end
+  end
+end

data/examples/test_list_styles.rb

@@ -0,0 +1,61 @@
+# 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 "list_styles"
+
+class Minitest::Test
+  include RatatuiRuby::TestHelper
+end
+
+class TestListStyles < Minitest::Test
+  def setup
+    @app = ListStylesApp.new
+  end
+
+  def test_render_initial_state
+    with_test_terminal(50, 20) do
+      @app.render
+
+      assert buffer_content.any? { |line| line.include?(">> Item 1") }
+      assert buffer_content.any? { |line| line.include?("   Item 2") }
+    end
+  end
+
+  def test_navigation_down
+    inject_event("key", { code: "down" })
+    @app.handle_input
+
+    with_test_terminal(50, 20) do
+      @app.render
+      assert buffer_content.any? { |line| line.include?("   Item 1") }
+      assert buffer_content.any? { |line| line.include?(">> Item 2") }
+    end
+  end
+
+  def test_navigation_up
+    # Move down to Item 2
+    inject_event("key", { code: "down" })
+    @app.handle_input
+
+    # Move up back to Item 1
+    inject_event("key", { code: "up" })
+    @app.handle_input
+
+    with_test_terminal(50, 20) do
+      @app.render
+      assert buffer_content.any? { |line| line.include?(">> Item 1") }
+    end
+  end
+
+  def test_quit
+    inject_event("key", { code: "q" })
+    status = @app.handle_input
+    assert_equal :quit, status
+  end
+end

data/ext/ratatui_ruby/.cargo/config.toml

@@ -6,3 +6,8 @@ rustflags = ["-C", "link-arg=-undefined", "-C", "link-arg=dynamic_lookup"]
 
 [target.x86_64-apple-darwin]
 rustflags = ["-C", "link-arg=-undefined", "-C", "link-arg=dynamic_lookup"]
+
+# Force dynamic linking on Alpine (musl) to fix "Dynamic loading not supported"
+# errors when bindgen tries to load libclang.
+[target.'cfg(target_env = "musl")']
+rustflags = ["-C", "target-feature=-crt-static"]

data/ext/ratatui_ruby/Cargo.lock

@@ -122,6 +122,15 @@ dependencies = [
  "winapi",
 ]
 
+[[package]]
+name = "deranged"
+version = "0.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ececcb659e7ba858fb4f10388c250a7252eb0a27373f1a72b8748afdd248e587"
+dependencies = [
+ "powerfmt",
+]
+
 [[package]]
 name = "either"
 version = "1.15.0"
@@ -296,6 +305,21 @@ dependencies = [
  "minimal-lexical",
 ]
 
+[[package]]
+name = "num-conv"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
+
+[[package]]
+name = "num_threads"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c7398b9c8b70908f6371f47ed36737907c87c52af34c268fed0bf0ceb92ead9"
+dependencies = [
+ "libc",
+]
+
 [[package]]
 name = "parking_lot"
 version = "0.12.5"
@@ -325,6 +349,12 @@ version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
 
+[[package]]
+name = "powerfmt"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
+
 [[package]]
 name = "proc-macro2"
 version = "1.0.103"
@@ -358,6 +388,7 @@ dependencies = [
  "paste",
  "stability",
  "strum",
+ "time",
  "unicode-segmentation",
  "unicode-truncate",
  "unicode-width",
@@ -365,12 +396,13 @@ dependencies = [
 
 [[package]]
 name = "ratatui_ruby"
-version = "0.1.0"
+version = "0.2.0"
 dependencies = [
  "crossterm",
  "lazy_static",
  "magnus",
  "ratatui",
+ "time",
 ]
 
 [[package]]
@@ -471,6 +503,35 @@ version = "0.3.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc"
 
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
 [[package]]
 name = "shell-words"
 version = "1.1.1"
@@ -568,6 +629,38 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "time"
+version = "0.3.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91e7d9e3bb61134e77bde20dd4825b97c010155709965fedf0f49bb138e52a9d"
+dependencies = [
+ "deranged",
+ "libc",
+ "num-conv",
+ "num_threads",
+ "powerfmt",
+ "serde",
+ "time-core",
+ "time-macros",
+]
+
+[[package]]
+name = "time-core"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40868e7c1d2f0b8d73e4a8c7f0ff63af4f6d19be117e90bd73eb1d62cf831c6b"
+
+[[package]]
+name = "time-macros"
+version = "0.2.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "30cfb0125f12d9c277f35663a0a33f8c30190f4e4574868a330595412d34ebf3"
+dependencies = [
+ "num-conv",
+ "time-core",
+]
+
 [[package]]
 name = "unicode-ident"
 version = "1.0.22"

data/ext/ratatui_ruby/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "ratatui_ruby"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2021"
 
 [lib]
@@ -11,6 +11,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 magnus = "0.6"
-ratatui = "0.26"
+ratatui = { version = "0.26", features = ["widget-calendar"] }
 crossterm = "0.27"
 lazy_static = "1.4"
+time = { version = "0.3", features = ["macros"] }

data/ext/ratatui_ruby/extconf.rb

@@ -7,6 +7,6 @@ require "mkmf"
 require "rb_sys/mkmf"
 
 create_rust_makefile("ratatui_ruby/ratatui_ruby") do |r|
-  # Optional: Force release profile if needed, but defaults are usually good
+  # Optional: Force release profile if needed
   # r.profile = ENV.fetch("RB_SYS_CARGO_PROFILE", :release).to_sym
 end

data/ext/ratatui_ruby/src/events.rs

@@ -142,7 +142,10 @@ pub fn poll_event() -> Result<Value, Error> {
     // Check if we are in test mode. If so, don't poll crossterm.
     let is_test_mode = {
         let term_lock = crate::terminal::TERMINAL.lock().unwrap();
-        matches!(term_lock.as_ref(), Some(crate::terminal::TerminalWrapper::Test(_)))
+        matches!(
+            term_lock.as_ref(),
+            Some(crate::terminal::TerminalWrapper::Test(_))
+        )
     };
 
     if is_test_mode {

data/ext/ratatui_ruby/src/rendering.rs

@@ -23,8 +23,11 @@ pub fn render_node(frame: &mut Frame, area: Rect, node: Value) -> Result<(), Err
         "RatatuiRuby::Scrollbar" => widgets::scrollbar::render(frame, area, node)?,
         "RatatuiRuby::BarChart" => widgets::barchart::render(frame, area, node)?,
         "RatatuiRuby::Canvas" => widgets::canvas::render(frame, area, node)?,
+        "RatatuiRuby::Calendar" => widgets::calendar::render(frame, area, node)?,
         "RatatuiRuby::Sparkline" => widgets::sparkline::render(frame, area, node)?,
-        "RatatuiRuby::LineChart" => widgets::linechart::render(frame, area, node)?,
+        "RatatuiRuby::Chart" | "RatatuiRuby::LineChart" => {
+            widgets::chart::render(frame, area, node)?
+        }
         _ => {}
     }
     Ok(())

data/ext/ratatui_ruby/src/terminal.rs

@@ -40,12 +40,10 @@ pub fn init_terminal() -> Result<(), Error> {
 
 pub fn init_test_terminal(width: u16, height: u16) -> Result<(), Error> {
     let mut term_lock = TERMINAL.lock().unwrap();
-    if term_lock.is_none() {
-        let backend = TestBackend::new(width, height);
-        let terminal = Terminal::new(backend)
-            .map_err(|e| Error::new(magnus::exception::runtime_error(), e.to_string()))?;
-        *term_lock = Some(TerminalWrapper::Test(terminal));
-    }
+    let backend = TestBackend::new(width, height);
+    let terminal = Terminal::new(backend)
+        .map_err(|e| Error::new(magnus::exception::runtime_error(), e.to_string()))?;
+    *term_lock = Some(TerminalWrapper::Test(terminal));
     Ok(())
 }