ratatui_ruby 0.1.0 → 0.2.0

data/tasks/website/website.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "version"
+require_relative "versioned_documentation"
+require_relative "index_page"
+require "fileutils"
+
+class Website
+  def initialize(at: "public", project_name:, globs:, assets: [])
+    @destination = at
+    @project_name = project_name
+    @globs = globs
+    @assets = assets
+  end
+
+  def build
+    clean
+    
+    versions.each do |version|
+      VersionedDocumentation.new(version).publish_to(
+        join(version.slug), 
+        project_name: @project_name, 
+        globs: @globs,
+        assets: @assets
+      )
+    end
+
+    IndexPage.new(versions).publish_to(join("index.html"), project_name: @project_name)
+
+    puts "Website built in #{@destination}/"
+  end
+
+  def versions
+    @versions ||= Version.all
+  end
+
+  private
+
+  def join(path)
+    File.join(@destination, path)
+  end
+
+  def clean
+    FileUtils.rm_rf(@destination)
+    FileUtils.mkdir_p(@destination)
+  end
+end

data/tasks/website.rake

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require "erb"
+require "fileutils"
+require "tmpdir"
+require_relative "rdoc_config"
+
+namespace :website do
+  desc "Build documentation for main (current dir) and all git tags"
+  task :build do
+    require_relative "website/website"
+    
+    spec = Gem::Specification.load(Dir["*.gemspec"].first)
+    globs = RDocConfig::RDOC_FILES + ["*.gemspec", "docs/images/**/*"]
+    
+    Website.new(
+      at: "public",
+      project_name: spec.name,
+      globs: globs,
+      assets: ["docs/images"] # directories to copy
+    ).build
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kerrick Long
@@ -46,10 +46,12 @@ extensions:
 - ext/ratatui_ruby/extconf.rb
 extra_rdoc_files: []
 files:
-- ".build.yml"
+- ".builds/ruby-3.2.yml"
+- ".builds/ruby-3.3.yml"
+- ".builds/ruby-3.4.yml"
+- ".builds/ruby-4.0.0-preview3.yml"
 - ".pre-commit-config.yaml"
 - ".rubocop.yml"
-- ".ruby-version"
 - AGENTS.md
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -70,10 +72,14 @@ files:
 - docs/contributors/index.md
 - docs/images/examples-analytics.rb.png
 - docs/images/examples-box_demo.rb.png
+- docs/images/examples-calendar_demo.rb.png
+- docs/images/examples-chart_demo.rb.png
 - docs/images/examples-dashboard.rb.png
+- docs/images/examples-list_styles.rb.png
 - docs/images/examples-login_form.rb.png
 - docs/images/examples-map_demo.rb.png
 - docs/images/examples-mouse_events.rb.png
+- docs/images/examples-quickstart_lifecycle.rb.png
 - docs/images/examples-scrollbar_demo.rb.png
 - docs/images/examples-stock_ticker.rb.png
 - docs/images/examples-system_monitor.rb.png
@@ -81,16 +87,24 @@ files:
 - docs/quickstart.md
 - examples/analytics.rb
 - examples/box_demo.rb
+- examples/calendar_demo.rb
+- examples/chart_demo.rb
 - examples/dashboard.rb
+- examples/list_styles.rb
 - examples/login_form.rb
 - examples/map_demo.rb
 - examples/mouse_events.rb
+- examples/quickstart_dsl.rb
+- examples/quickstart_lifecycle.rb
+- examples/readme_usage.rb
 - examples/scrollbar_demo.rb
 - examples/stock_ticker.rb
 - examples/system_monitor.rb
 - examples/test_analytics.rb
 - examples/test_box_demo.rb
+- examples/test_calendar_demo.rb
 - examples/test_dashboard.rb
+- examples/test_list_styles.rb
 - examples/test_login_form.rb
 - examples/test_map_demo.rb
 - examples/test_stock_ticker.rb
@@ -107,12 +121,13 @@ files:
 - ext/ratatui_ruby/src/terminal.rs
 - ext/ratatui_ruby/src/widgets/barchart.rs
 - ext/ratatui_ruby/src/widgets/block.rs
+- ext/ratatui_ruby/src/widgets/calendar.rs
 - ext/ratatui_ruby/src/widgets/canvas.rs
 - ext/ratatui_ruby/src/widgets/center.rs
+- ext/ratatui_ruby/src/widgets/chart.rs
 - ext/ratatui_ruby/src/widgets/cursor.rs
 - ext/ratatui_ruby/src/widgets/gauge.rs
 - ext/ratatui_ruby/src/widgets/layout.rs
-- ext/ratatui_ruby/src/widgets/linechart.rs
 - ext/ratatui_ruby/src/widgets/list.rs
 - ext/ratatui_ruby/src/widgets/mod.rs
 - ext/ratatui_ruby/src/widgets/overlay.rs
@@ -122,16 +137,18 @@ files:
 - ext/ratatui_ruby/src/widgets/table.rs
 - ext/ratatui_ruby/src/widgets/tabs.rs
 - lib/ratatui_ruby.rb
+- lib/ratatui_ruby/dsl.rb
 - lib/ratatui_ruby/output.rb
 - lib/ratatui_ruby/schema/bar_chart.rb
 - lib/ratatui_ruby/schema/block.rb
+- lib/ratatui_ruby/schema/calendar.rb
 - lib/ratatui_ruby/schema/canvas.rb
 - lib/ratatui_ruby/schema/center.rb
+- lib/ratatui_ruby/schema/chart.rb
 - lib/ratatui_ruby/schema/constraint.rb
 - lib/ratatui_ruby/schema/cursor.rb
 - lib/ratatui_ruby/schema/gauge.rb
 - lib/ratatui_ruby/schema/layout.rb
-- lib/ratatui_ruby/schema/line_chart.rb
 - lib/ratatui_ruby/schema/list.rb
 - lib/ratatui_ruby/schema/overlay.rb
 - lib/ratatui_ruby/schema/paragraph.rb
@@ -142,16 +159,18 @@ files:
 - lib/ratatui_ruby/schema/tabs.rb
 - lib/ratatui_ruby/test_helper.rb
 - lib/ratatui_ruby/version.rb
+- mise.toml
 - sig/ratatui_ruby/ratatui_ruby.rbs
 - sig/ratatui_ruby/schema/bar_chart.rbs
 - sig/ratatui_ruby/schema/block.rbs
+- sig/ratatui_ruby/schema/calendar.rbs
 - sig/ratatui_ruby/schema/canvas.rbs
 - sig/ratatui_ruby/schema/center.rbs
+- sig/ratatui_ruby/schema/chart.rbs
 - sig/ratatui_ruby/schema/constraint.rbs
 - sig/ratatui_ruby/schema/cursor.rbs
 - sig/ratatui_ruby/schema/gauge.rbs
 - sig/ratatui_ruby/schema/layout.rbs
-- sig/ratatui_ruby/schema/line_chart.rbs
 - sig/ratatui_ruby/schema/list.rbs
 - sig/ratatui_ruby/schema/overlay.rbs
 - sig/ratatui_ruby/schema/paragraph.rbs
@@ -162,6 +181,25 @@ files:
 - sig/ratatui_ruby/schema/tabs.rbs
 - sig/ratatui_ruby/test_helper.rbs
 - sig/ratatui_ruby/version.rbs
+- tasks/bump.rake
+- tasks/bump/cargo_lockfile.rb
+- tasks/bump/manifest.rb
+- tasks/bump/ruby_gem.rb
+- tasks/bump/sem_ver.rb
+- tasks/doc.rake
+- tasks/extension.rake
+- tasks/lint.rake
+- tasks/rdoc_config.rb
+- tasks/resources/build.yml.erb
+- tasks/resources/index.html.erb
+- tasks/resources/rubies.yml
+- tasks/sourcehut.rake
+- tasks/test.rake
+- tasks/website.rake
+- tasks/website/index_page.rb
+- tasks/website/version.rb
+- tasks/website/versioned_documentation.rb
+- tasks/website/website.rb
 - vendor/goodcop/base.yml
 homepage: https://sr.ht/~kerrick/ratatui_ruby/
 licenses:
@@ -173,17 +211,20 @@ metadata:
   changelog_uri: https://git.sr.ht/~kerrick/ratatui_ruby/tree/main/item/CHANGELOG.md
   mailing_list_uri: https://lists.sr.ht/~kerrick/ratatui_ruby-discuss
   source_code_uri: https://git.sr.ht/~kerrick/ratatui_ruby
-  documentation_uri: https://man.sr.ht/~kerrick/ratatui_ruby/docs/
-  wiki_uri: https://man.sr.ht/~kerrick/ratatui_ruby/docs/contributors/
+  documentation_uri: https://git.sr.ht/~kerrick/ratatui_ruby/tree/HEAD/docs/index.md
+  wiki_uri: https://man.sr.ht/~kerrick/ratatui_ruby/
   funding_uri: https://opencollective.com/ratatui
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '='
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.9
+  - - "<"
     - !ruby/object:Gem::Version
-      version: 3.4.7
+      version: '5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.build.yml

@@ -1,34 +0,0 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-image: archlinux
-packages:
-  - ruby
-  - rust
-  - cargo
-  - make
-  - gcc
-  - clang
-sources:
-  - https://git.sr.ht/~kerrick/ratatui_ruby
-tasks:
-  - setup: |
-      cd ratatui_ruby
-      export PATH="$PATH:$(ruby -e 'puts Gem.user_dir')/bin"
-      gem install --user-install bundler -v 2.6.9
-      bundle config set --local path 'vendor/bundle'
-      bundle install
-  - test: |
-      cd ratatui_ruby
-      export PATH="$PATH:$(ruby -e 'puts Gem.user_dir')/bin"
-      bundle config set --local path 'vendor/bundle'
-      # Compile the extension before running tests
-      bundle exec rake compile
-      # Run the test suite (Headless)
-      bundle exec rake test
-  - package: |
-      cd ratatui_ruby
-      export PATH="$PATH:$(ruby -e 'puts Gem.user_dir')/bin"
-      bundle config set --local path 'vendor/bundle'
-      # Verify packaging works
-      gem build ratatui_ruby.gemspec

data/.ruby-version

@@ -1 +0,0 @@
-3.4.7

data/ext/ratatui_ruby/src/widgets/linechart.rs

@@ -1,154 +0,0 @@
-// SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-use crate::style::{parse_block, parse_color};
-use magnus::{prelude::*, Error, Value};
-use ratatui::{
-    layout::Rect,
-    style::{Color, Style},
-    symbols,
-    widgets::{Chart, Dataset},
-    Frame,
-};
-
-pub fn render(frame: &mut Frame, area: Rect, node: Value) -> Result<(), Error> {
-    let datasets_val: magnus::RArray = node.funcall("datasets", ())?;
-    let x_labels_val: magnus::RArray = node.funcall("x_labels", ())?;
-    let y_labels_val: magnus::RArray = node.funcall("y_labels", ())?;
-    let y_bounds_val: magnus::RArray = node.funcall("y_bounds", ())?;
-    let block_val: Value = node.funcall("block", ())?;
-
-    let mut datasets = Vec::new();
-    // We need to keep the data alive until the chart is rendered
-    let mut data_storage: Vec<Vec<(f64, f64)>> = Vec::new();
-    let mut name_storage: Vec<String> = Vec::new();
-
-    for i in 0..datasets_val.len() {
-        let ds_val: Value = datasets_val.entry(i as isize)?;
-        let name: String = ds_val.funcall("name", ())?;
-        let data_array: magnus::RArray = ds_val.funcall("data", ())?;
-
-        let mut points = Vec::new();
-        for j in 0..data_array.len() {
-            let point_array_val: Value = data_array.entry(j as isize)?;
-            let point_array = magnus::RArray::from_value(point_array_val).ok_or_else(|| {
-                Error::new(magnus::exception::type_error(), "expected array for point")
-            })?;
-            let x_val: Value = point_array.entry(0)?;
-            let y_val: Value = point_array.entry(1)?;
-
-            let x: f64 = x_val.funcall("to_f", ())?;
-            let y: f64 = y_val.funcall("to_f", ())?;
-            points.push((x, y));
-        }
-
-        data_storage.push(points);
-        name_storage.push(name);
-    }
-
-    for i in 0..data_storage.len() {
-        let ds_val: Value = datasets_val.entry(i as isize)?;
-        let color_val: Value = ds_val.funcall("color", ())?;
-        let color_str: String = color_val.funcall("to_s", ())?;
-        let color = parse_color(&color_str).unwrap_or(Color::White);
-
-        let ds = Dataset::default()
-            .name(name_storage[i].clone())
-            .marker(symbols::Marker::Braille)
-            .style(Style::default().fg(color))
-            .data(&data_storage[i]);
-        datasets.push(ds);
-    }
-
-    let mut x_labels = Vec::new();
-    for i in 0..x_labels_val.len() {
-        let label: String = x_labels_val.entry(i as isize)?;
-        x_labels.push(ratatui::text::Span::from(label));
-    }
-
-    let mut y_labels = Vec::new();
-    for i in 0..y_labels_val.len() {
-        let label: String = y_labels_val.entry(i as isize)?;
-        y_labels.push(ratatui::text::Span::from(label));
-    }
-
-    let y_bounds: [f64; 2] = [y_bounds_val.entry(0)?, y_bounds_val.entry(1)?];
-
-    // Calculate x_bounds based on datasets if possible
-    let mut min_x = 0.0;
-    let mut max_x = 0.0;
-    let mut first = true;
-    for ds_data in &data_storage {
-        for (x, _) in ds_data {
-            if first {
-                min_x = *x;
-                max_x = *x;
-                first = false;
-            } else {
-                if *x < min_x {
-                    min_x = *x;
-                }
-                if *x > max_x {
-                    max_x = *x;
-                }
-            }
-        }
-    }
-
-    // Ensure there's some range
-    if min_x == max_x {
-        max_x = min_x + 1.0;
-    }
-
-    let x_axis = ratatui::widgets::Axis::default()
-        .labels(x_labels)
-        .bounds([min_x, max_x]);
-
-    let y_axis = ratatui::widgets::Axis::default()
-        .labels(y_labels)
-        .bounds(y_bounds);
-
-    let mut chart = Chart::new(datasets).x_axis(x_axis).y_axis(y_axis);
-
-    if !block_val.is_nil() {
-        chart = chart.block(parse_block(block_val)?);
-    }
-
-    frame.render_widget(chart, area);
-    Ok(())
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use ratatui::buffer::Buffer;
-    use ratatui::widgets::{Axis, Chart, Dataset, Widget};
-
-    #[test]
-    fn test_linechart_rendering() {
-        let data = vec![(0.0, 0.0), (1.0, 1.0)];
-        let datasets = vec![Dataset::default().name("TestDS").data(&data)];
-        let chart = Chart::new(datasets)
-            .x_axis(
-                Axis::default()
-                    .bounds([0.0, 1.0])
-                    .labels(vec!["XMIN".into(), "XMAX".into()]),
-            )
-            .y_axis(
-                Axis::default()
-                    .bounds([0.0, 1.0])
-                    .labels(vec!["YMIN".into(), "YMAX".into()]),
-            );
-        let mut buf = Buffer::empty(Rect::new(0, 0, 40, 20)); // Larger buffer
-        chart.render(Rect::new(0, 0, 40, 20), &mut buf);
-        // Should have chart rendered (braille characters)
-        assert!(buf.content().iter().any(|c| c.symbol() != " "));
-        // Should have labels
-        let content = buf.content().iter().map(|c| c.symbol()).collect::<String>();
-        assert!(content.contains("XMIN"));
-        assert!(content.contains("XMAX"));
-        assert!(content.contains("YMIN"));
-        assert!(content.contains("YMAX"));
-        assert!(content.contains("TestDS"));
-    }
-}

data/lib/ratatui_ruby/schema/line_chart.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
-
-module RatatuiRuby
-  # A single line on a chart.
-  #
-  # [name] The name of the dataset.
-  # [data] Array of arrays [[x, y], [x, y]] (Floats).
-  # [color] The color of the line.
-  class Dataset < Data.define(:name, :data, :color)
-    # Creates a new Dataset.
-    # [name] The name of the dataset.
-    # [data] Array of arrays [[x, y], [x, y]] (Floats).
-    # [color] The color of the line.
-    def initialize(name:, data:, color: "white")
-      super
-    end
-  end
-
-  # A complex chart widget.
-  #
-  # [datasets] Array of Dataset objects.
-  # [x_labels] Array of Strings for the X-axis labels.
-  # [y_labels] Array of Strings for the Y-axis labels.
-  # [y_bounds] Array of two Floats [min, max] for the Y-axis.
-  # [block] Optional block widget to wrap the chart.
-  class LineChart < Data.define(:datasets, :x_labels, :y_labels, :y_bounds, :block)
-    # Creates a new LineChart widget.
-    #
-    # [datasets] Array of Dataset objects.
-    # [x_labels] Array of Strings for the X-axis labels.
-    # [y_labels] Array of Strings for the Y-axis labels.
-    # [y_bounds] Array of two Floats [min, max] for the Y-axis.
-    # [block] Optional block widget to wrap the chart.
-    def initialize(datasets:, x_labels: [], y_labels: [], y_bounds: [0.0, 100.0], block: nil)
-      super
-    end
-  end
-end