ratatui_ruby 0.1.0 → 0.3.0

data/tasks/website/version_menu.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class VersionMenu
+  def initialize(root:, versions:)
+    @root = root
+    @versions = versions
+  end
+
+  def run
+    puts "Injecting version menu into generated HTML..."
+    
+    # Process all HTML files in the output directory
+    Dir.glob(File.join(@root, "**/*.html")).each do |file|
+      inject_menu(file)
+    end
+  end
+
+  private
+
+  def inject_menu(file)
+    content = File.read(file)
+    
+    # Find the injection point (before the theme toggle button)
+    pattern = /(<button[^>]*id="theme-toggle"[^>]*>)/mi
+    
+    unless content.match?(pattern)
+      # warn "Could not find theme-toggle in #{file}"
+      return
+    end
+
+    # Calculate relative path to root from this file
+    file_dir = File.dirname(file)
+    relative_path_to_root = Pathname.new(@root).relative_path_from(Pathname.new(file_dir)).to_s
+    relative_path_to_root += "/" unless relative_path_to_root.end_with?("/")
+    
+    # Determine current version from file path
+    relative_path_from_root = Pathname.new(file).relative_path_from(Pathname.new(@root)).to_s
+    current_version_slug = relative_path_from_root.split("/").first
+    
+    # Build options
+    options = @versions.map do |version|
+      value = "#{relative_path_to_root}#{version.slug}/index.html"
+      selected = (version.slug == current_version_slug) ? "selected" : ""
+      display_name = version.name
+      display_name += " (latest)" if version.respond_to?(:latest?) && version.latest?
+      display_name += " (dev)" if version.edge?
+      
+      %Q{<option value="#{value}" #{selected}>#{display_name}</option>}
+    end.join("\n")
+    
+    # margin-left: auto pushes it to the right
+    # margin-right: 1rem spacing from the theme toggle
+    switcher_html = <<~HTML
+      <select class="version-menu" onchange="window.location.href=this.value" style="margin-left: auto; padding: 0.25rem; border-radius: 4px; border: 1px solid #ccc; margin-right: 1rem;">
+        #{options}
+        <option value="#{relative_path_to_root}index.html">All Versions</option>
+      </select>
+    HTML
+    
+    # Inject before the button
+    new_content = content.sub(pattern, "#{switcher_html}\n\\1")
+    
+    File.write(file, new_content)
+  end
+end

data/tasks/website/versioned_documentation.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+require_relative "../rdoc_config"
+
+class VersionedDocumentation
+  def initialize(version)
+    @version = version
+  end
+
+  def publish_to(path, project_name:, globs:, assets: [])
+    puts "Building documentation for #{@version.name}..."
+    
+    absolute_path = File.absolute_path(path)
+    gemfile_path = File.absolute_path("Gemfile")
+    custom_css_path = File.absolute_path("doc/custom.css")
+
+    @version.checkout(globs: globs) do |source_path|
+      Dir.chdir(source_path) do
+        title = "#{project_name} #{@version.name}"
+        title = "#{project_name} (main)" if @version.edge?
+        
+        # We need to expand globs relative to the source path
+        files = globs.flat_map { |glob| Dir[glob] }.uniq
+        
+        system(
+          { "BUNDLE_GEMFILE" => gemfile_path },
+          "bundle exec rdoc -o #{absolute_path} --main #{RDocConfig::MAIN} --title '#{title}' --template-stylesheets \"#{custom_css_path}\" #{files.join(' ')}"
+        )
+
+        copy_assets_to(absolute_path, assets)
+      end
+    end
+  end
+
+  private
+
+  def copy_assets_to(path, assets)
+    assets.each do |asset_dir|
+       if Dir.exist?(asset_dir)
+         destination = File.join(path, asset_dir)
+         FileUtils.mkdir_p(destination)
+         FileUtils.cp_r Dir["#{asset_dir}/*"], destination
+       end
+    end
+  end
+end

data/tasks/website/website.rb

@@ -0,0 +1,53 @@
+# 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_relative "version_menu"
+require "fileutils"
+
+class Website
+  def initialize(at: "www", 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)
+
+    VersionMenu.new(root: @destination, versions: versions).run
+
+    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", "doc/images/**/*"]
+    
+    Website.new(
+      at: "www",
+      project_name: spec.name,
+      globs: globs,
+      assets: ["doc/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.3.0
 platform: ruby
 authors:
 - Kerrick Long
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
@@ -37,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
 description: ratatui_ruby is a wrapper for the Ratatui Rust crate <https://ratatui.rs>.
   It allows you to cook up Terminal User Interfaces in Ruby.
 email:
@@ -46,14 +74,14 @@ 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.yml"
 - ".pre-commit-config.yaml"
 - ".rubocop.yml"
-- ".ruby-version"
 - AGENTS.md
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - LICENSE
 - LICENSES/AGPL-3.0-or-later.txt
 - LICENSES/BSD-2-Clause.txt
@@ -63,43 +91,68 @@ files:
 - README.md
 - REUSE.toml
 - Rakefile
-- docs/application_testing.md
-- docs/contributors/design.md
-- docs/contributors/design/ruby_frontend.md
-- docs/contributors/design/rust_backend.md
-- docs/contributors/index.md
-- docs/images/examples-analytics.rb.png
-- docs/images/examples-box_demo.rb.png
-- docs/images/examples-dashboard.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-scrollbar_demo.rb.png
-- docs/images/examples-stock_ticker.rb.png
-- docs/images/examples-system_monitor.rb.png
-- docs/index.md
-- docs/quickstart.md
+- doc/application_testing.md
+- doc/contributors/design.md
+- doc/contributors/design/ruby_frontend.md
+- doc/contributors/design/rust_backend.md
+- doc/contributors/index.md
+- doc/custom.css
+- doc/images/examples-analytics.rb.png
+- doc/images/examples-box_demo.rb.png
+- doc/images/examples-calendar_demo.rb.png
+- doc/images/examples-chart_demo.rb.png
+- doc/images/examples-custom_widget.rb.png
+- doc/images/examples-dashboard.rb.png
+- doc/images/examples-list_styles.rb.png
+- doc/images/examples-login_form.rb.png
+- doc/images/examples-map_demo.rb.png
+- doc/images/examples-mouse_events.rb.png
+- doc/images/examples-popup_demo.rb.gif
+- doc/images/examples-quickstart_lifecycle.rb.png
+- doc/images/examples-scroll_text.rb.png
+- doc/images/examples-scrollbar_demo.rb.png
+- doc/images/examples-stock_ticker.rb.png
+- doc/images/examples-system_monitor.rb.png
+- doc/images/examples-table_select.rb.png
+- doc/index.md
+- doc/quickstart.md
 - examples/analytics.rb
 - examples/box_demo.rb
+- examples/calendar_demo.rb
+- examples/chart_demo.rb
+- examples/custom_widget.rb
 - examples/dashboard.rb
+- examples/list_styles.rb
 - examples/login_form.rb
 - examples/map_demo.rb
 - examples/mouse_events.rb
+- examples/popup_demo.rb
+- examples/quickstart_dsl.rb
+- examples/quickstart_lifecycle.rb
+- examples/readme_usage.rb
+- examples/scroll_text.rb
 - examples/scrollbar_demo.rb
 - examples/stock_ticker.rb
 - examples/system_monitor.rb
+- examples/table_select.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_popup_demo.rb
+- examples/test_scroll_text.rb
 - examples/test_stock_ticker.rb
 - examples/test_system_monitor.rb
+- examples/test_table_select.rb
 - ext/ratatui_ruby/.cargo/config.toml
 - ext/ratatui_ruby/.gitignore
 - ext/ratatui_ruby/Cargo.lock
 - ext/ratatui_ruby/Cargo.toml
 - ext/ratatui_ruby/extconf.rb
+- ext/ratatui_ruby/src/buffer.rs
 - ext/ratatui_ruby/src/events.rs
 - ext/ratatui_ruby/src/lib.rs
 - ext/ratatui_ruby/src/rendering.rs
@@ -107,12 +160,14 @@ 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/clear.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,19 +177,23 @@ 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/clear.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
+- lib/ratatui_ruby/schema/rect.rb
 - lib/ratatui_ruby/schema/scrollbar.rb
 - lib/ratatui_ruby/schema/sparkline.rb
 - lib/ratatui_ruby/schema/style.rb
@@ -142,19 +201,23 @@ files:
 - lib/ratatui_ruby/schema/tabs.rb
 - lib/ratatui_ruby/test_helper.rb
 - lib/ratatui_ruby/version.rb
+- mise.toml
+- sig/ratatui_ruby/buffer.rbs
 - 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
+- sig/ratatui_ruby/schema/rect.rbs
 - sig/ratatui_ruby/schema/scrollbar.rbs
 - sig/ratatui_ruby/schema/sparkline.rbs
 - sig/ratatui_ruby/schema/style.rbs
@@ -162,6 +225,31 @@ 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/changelog.rb
+- tasks/bump/comparison_links.rb
+- tasks/bump/header.rb
+- tasks/bump/history.rb
+- tasks/bump/manifest.rb
+- tasks/bump/ruby_gem.rb
+- tasks/bump/sem_ver.rb
+- tasks/bump/unreleased_section.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/version_menu.rb
+- tasks/website/versioned_documentation.rb
+- tasks/website/website.rb
 - vendor/goodcop/base.yml
 homepage: https://sr.ht/~kerrick/ratatui_ruby/
 licenses:
@@ -173,17 +261,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/doc/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/CODE_OF_CONDUCT.md

@@ -1,30 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-# **ratatui_ruby** Code of Conduct
-
-This project is intended to be a safe, productive collaboration, and contributors are expected to adhere to the [Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct/).
-
-For your convenience, it is reproduced below. If this document ever falls out of date and/or conflicts with the linked [Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct/) document, the linked document takes precedence.
-
-
-<!-- SPDX-SnippetBegin -->
-<!--
-  SPDX-FileCopyrightText: 2016 Yukihiro Matsumoto <matz@netlab.jp>
-  SPDX-License-Identifier: BSD-2-Clause
--->
-
-
-## The Ruby Community Conduct Guideline
-
-> **We have picked the following conduct guideline based on an early proposed draft of the PostgreSQL CoC, for Ruby developers community for safe, productive collaboration. Each Ruby related community (conference etc.) may pick their own Code of Conduct.**
-> 
-> This document provides community guidelines for a safe, respectful, productive, and collaborative place for any person who is willing to contribute to the Ruby community. It applies to all “collaborative space”, which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.).
-> 
-> - Participants will be tolerant of opposing views.
-> - Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
-> - When interpreting the words and actions of others, participants should always assume good intentions.
-> - Behaviour which can be reasonably considered harassment will not be tolerated.
-
-<!-- SPDX-SnippetEnd -->

data/CONTRIBUTING.md

@@ -1,40 +0,0 @@
-<!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-  SPDX-License-Identifier: CC-BY-SA-4.0
--->
-# Contribution Guide
-
-This project is intended to be a safe, productive collaboration, and contributors are expected to adhere to the [Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct/).
-
-
-## Reporting Issues
-
-Bug reports are welcome on [sourcehut](https://sourcehut.org) at https://todo.sr.ht/~kerrick/ratatui_ruby.
-
-Issues for Ratatui should be filed at [ratatui/ratatui](https://github.com/ratatui/ratatui).
-
-
-## Requesting Features
-
-ratatui_ruby aims to wrap all [Ratatui](https://ratatui.rs) features. Please request new features there.
-
-
-## Pull Requests
-
-Please join our **devel** mailing list at https://lists.sr.ht/~kerrick/ratatui_ruby-devel. Then, send a pull request via email to the mailing list. 
-
-The easiest way to send a pull request via email is to use [git-send-email](https://git-scm.com/docs/git-send-email). If you are unfamiliar with using git to send a pull request via email, read the [four-step tutorial at git-send-email.io](https://git-send-email.io).
-
-Alternatively, [sourcehut](https://sourcehut.org) has a web UI you can use to prepare the email to send. [Read their documentation](https://man.sr.ht/git.sr.ht/#sending-patches-upstream) to find out if this is right for you.
-
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-
-## Contributors’ Documentation
-
-We have documentation on how **ratatui_ruby** works internally, how it is designed, and how it interacts with the official Ratatui projects. See the [contributors’ documentation index](docs/contributors/index.md) for more information.