ratatui_ruby 1.0.0.pre.beta.1 → 1.0.0.pre.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c251e31a8aea8d5e84bc0969f8f6c95f690a2ce94d0cbd3538856bfbdafd055a
-  data.tar.gz: ee38d86ebdc50612ba5a32990e7f1c3757e9f35ced6d621fc92203836c938793
+  metadata.gz: 69c2adadc9306ebeb02ffefa11e56abe7db2f0ef1c361a2edaf1cf5a3f9b9fee
+  data.tar.gz: c8e07b3361a46597f957fa6a4ade8e9eef426fa85a0df8650f7188a306384d5a
 SHA512:
-  metadata.gz: 4f555dd2eddeef420df2512c53e26a136a791cfabd72bfe74ac1c5bd3f652d317bc9c60d47a78611f3a20e76ae72925494d867fcd992a17f0dcd29b3bb18b33d
-  data.tar.gz: 47d21c6a4e5969a5457705eb088efaa45dd29ee5d6fac1f67166f3a4c2114aa65d54b926b05191fcf8f2a20b8a1c6481d19ffed195f0e2ee045bfaf561589dc5
+  metadata.gz: eb439fe49d032bf2d7221b4771b2b6b0156d9b5373d32fe6710ff0077046263fc5e719c1d91d1ed271b3cb58c18cf9f31ef6d366daed59b6f4413ac66db82447
+  data.tar.gz: dc395bd562a70d0bc8a9d6eafa4ca0b488ef3ce450a3f3d65b125550ed616c1516b2b5301bb0b634028433f90d4306885ba8f756542241fb9d5e0c4fa25d6644

data/.builds/ruby-3.2.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.3.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.4.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-4.0.0.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.1.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.0.0.pre.beta.2.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.rubocop.yml

@@ -5,4 +5,6 @@ inherit_from:
   - ./vendor/goodcop/base.yml
 
 AllCops:
-  TargetRubyVersion: "3.3"
+  TargetRubyVersion: "3.3"
+  Exclude:
+    - 'examples/verify_website_menu/app.rb'

data/CHANGELOG.md

@@ -18,6 +18,18 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Removed
 
+## [1.0.0-beta.2] - 2026-01-20
+
+### Added
+
+### Changed
+
+### Fixed
+
+- **TableState Row Navigation Methods**: Added missing row navigation methods (`select_next`, `select_previous`, `select_first`, `select_last`) that should have been included alongside the column navigation methods added in v0.10.0. These methods match `ListState`'s navigation API and are used in the `app_stateful_interaction` example.
+
+### Removed
+
 ## [1.0.0-beta.1] - 2026-01-20
 This release is functionally equivalent to v0.10.3. The version bump signals the beginning of the 1.0 release series.
 
@@ -670,6 +682,7 @@ This release is functionally equivalent to v0.10.3. The version bump signals the
 - **Testing Support**: Included `RatatuiRuby::TestHelper` and RSpec integration to make testing your TUI applications possible.
 
 [Unreleased]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/HEAD
+[1.0.0-beta.2]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v1.0.0-beta.2
 [1.0.0-beta.1]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v1.0.0-beta.1
 [0.10.3]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.3
 [0.10.2]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.2

data/README.md

@@ -21,7 +21,7 @@ Mailing List: Announcements](https://img.shields.io/badge/mailing_list-announcem
 **ratatui_ruby** is a community wrapper that is not affiliated with [the Ratatui team](https://github.com/orgs/ratatui/people).
 
 > [!WARNING]
-> **ratatui_ruby** is currently in **ALPHA**. The API may change between minor versions.
+> **ratatui_ruby** is currently in **BETA**. Please report any bugs you find!
 
 **[Why RatatuiRuby?](./doc/getting_started/why.md)** — Native Rust performance, zero runtime overhead, and Ruby's expressiveness. [See how we compare](./doc/getting_started/why.md) to CharmRuby, raw Rust, and Go.
 
@@ -91,7 +91,7 @@ Or install it yourself with:
   SPDX-License-Identifier: MIT-0
 -->
 ```bash
-gem install ratatui_ruby
+gem install ratatui_ruby --pre
 ```
 <!-- SPDX-SnippetEnd -->
 

data/README.rdoc

@@ -5,7 +5,7 @@ RatatuiRuby[https://rubygems.org/gems/ratatui_ruby] is a RubyGem built on
 Ratatui[https://ratatui.rs], a leading TUI library written in
 Rust[https://rust-lang.org]. You get native performance with the joy of Ruby.
 
-  gem install ratatui_ruby
+  gem install ratatui_ruby --pre
 
 {rdoc-image:https://ratatui-ruby.dev/hero.gif}[https://www.ratatui-ruby.dev/docs/v0.10/examples/app_cli_rich_moments/README_md.html]
 

data/examples/app_all_events/view/live_view.rb

@@ -49,7 +49,7 @@ class View::Live
       desc_str = event_data ? event_data[:description] : "—"
 
       is_lit = model.lit?(type)
-      row_style = is_lit ? tui.style(fg: :black, bg: :green) : nil
+      row_style = is_lit ? tui.style(fg: :green, modifiers: [:reversed]) : nil
 
       rows << tui.text_line(spans: [
         tui.text_span(content: class_str.ljust(9), style: row_style || tui.style(fg: :cyan)),

data/examples/verify_website_menu/app.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# rubocop:disable all
 
 #--
 # SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
@@ -15,14 +16,10 @@ class RadioMenu
   CHOICES = ["Production", "Staging", "Development"]         # ASCII strings are universally supported.
   PREFIXES = { active: "●", inactive: "○" }                  # Some terminals may not support Unicode.
   CONTROLS = "↑/↓: Select | Enter: Choose | Ctrl+C: Cancel"  # Let users know what keys you handle.
-  TITLES = [
-    "Select Environment", # The default title position is top left.
-    {
-content: CONTROLS, # Multiple titles can save space.
-position: :bottom, # Titles go on the top or bottom,
-alignment: :right,
-},
-] # aligned left, right, or center
+  TITLES = ["Select Environment",                            # The default title position is top left.
+            { content: CONTROLS,                             # Multiple titles can save space.
+              position: :bottom,                             # Titles go on the top or bottom,
+              alignment: :right }]                           # aligned left, right, or center
 
   def call                                                   # This method blocks until a choice is made.
     RatatuiRuby.run(viewport: :inline, height: 5) do |tui|   # RatauiRuby.run manages the terminal.
@@ -32,8 +29,9 @@ alignment: :right,
     RadioMenu::CHOICES[@choice]                              # so you can use it synchronously.
   end
                                                              # Classes like RadioMenu are convenient for
+  private                                                    # CLI authors to offer "rich moments."
 
-  private def show_menu = @tui.draw do |frame| # RatatuiRuby gives you low-level access.
+  def show_menu = @tui.draw do |frame|                       # RatatuiRuby gives you low-level access.
     widget = @tui.paragraph(                                 # But the TUI facade makes it easy to use.
       text: menu_items,                                      # Text can be spans, lines, or paragraphs.
       block: @tui.block(borders: :all, titles: TITLES)       # Blocks give you boxes and titles, and hold
@@ -41,7 +39,7 @@ alignment: :right,
     frame.render_widget(widget, frame.area)                  # but "area" lets you compose sub-views.
   end
 
-  private def chosen? # You are responsible for handling input.
+  def chosen?                                                # You are responsible for handling input.
     interaction = @tui.poll_event                            # Every frame, you receive an event object:
     return choose if interaction.enter?                      # Key, Mouse, Resize, Paste, FocusGained,
                                                              # FocusLost, or None objects. They come with
@@ -51,39 +49,36 @@ alignment: :right,
     false                                                    # even interrupts and other exit patterns.
   end
 
-  private def choose # Here, the loop is about to exit, and the
+  def choose                                                 # Here, the loop is about to exit, and the
     prepare_next_line                                        # block will return. The inline viewport
     @choice                                                  # will be torn down and the terminal will
   end                                                        # be restored, but you are responsible for
-
                                                              # positioning the cursor.
-  private def prepare_next_line # To ensure the next output is on a new
+  def prepare_next_line                                      # To ensure the next output is on a new
     area = @tui.viewport_area                                # line, query the viewport area and move
     RatatuiRuby.cursor_position = [0, area.y + area.height]  # the cursor to the start of the last line.
     puts                                                     # Then print a newline.
   end
 
-  private def quit! # All of your familiar Ruby control flow
+  def quit!                                                  # All of your familiar Ruby control flow
     prepare_next_line                                        # keywords work as expected, so we can
     exit 0                                                   # use them to leave the TUI.
   end
 
-  private def move_by(line_count) # You are in full control of your UX, so
+  def move_by(line_count)                                    # You are in full control of your UX, so
     @choice = (@choice + line_count) % CHOICES.size          # you can implement any logic you need:
   end                                                        # Would you "wrap around" here, or not?
-
-  private def menu_items = CHOICES.map.with_index do |choice, i| # Notably, RatatuiRuby has no concept of
+                                                             #
+  def menu_items = CHOICES.map.with_index do |choice, i|     # Notably, RatatuiRuby has no concept of
     "#{prefix_for(i)} #{choice}"                             # "menus" or "radio buttons". You are in
   end                                                        # full control, but it also means you must
-
-  private def prefix_for(choice_index) # implement the logic yourself. For larger
+  def prefix_for(choice_index)                               # implement the logic yourself. For larger
     return PREFIXES[:active] if choice_index == @choice      # applications, consider using Rooibos,
     PREFIXES[:inactive]                                      # an MVU framework built with RatatuiRuby.
   end                                                        # Or, use the upcoming ratatui-ruby-kit,
-
                                                              # our object-oriented component library.
-  private def initialize = @choice = 0 # However, those are both optional, and
+  def initialize = @choice = 0                               # However, those are both optional, and
 end                                                          # designed for full-screen Terminal UIs.
                                                              # RatatuiRuby will always give you the most
 choice = RadioMenu.new.call                                  # control, and is enough for "rich CLI
-puts "You chose #{choice}!"                                  # moments" like this one.
+puts "You chose #{choice}!"                                  # moments" like this one.

data/ext/ratatui_ruby/Cargo.lock

@@ -1059,7 +1059,7 @@ dependencies = [
 
 [[package]]
 name = "ratatui_ruby"
-version = "1.0.0-beta.1"
+version = "1.0.0-beta.2"
 dependencies = [
  "bumpalo",
  "lazy_static",

data/ext/ratatui_ruby/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "ratatui_ruby"
-version = "1.0.0-beta.1"
+version = "1.0.0-beta.2"
 edition = "2021"
 
 [lib]

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

@@ -95,6 +95,26 @@ impl RubyTableState {
         self.inner.borrow_mut().select_last_column();
     }
 
+    /// Selects the next row or the first one if no row is selected.
+    pub fn select_next(&self) {
+        self.inner.borrow_mut().select_next();
+    }
+
+    /// Selects the previous row or the last one if no row is selected.
+    pub fn select_previous(&self) {
+        self.inner.borrow_mut().select_previous();
+    }
+
+    /// Selects the first row.
+    pub fn select_first(&self) {
+        self.inner.borrow_mut().select_first();
+    }
+
+    /// Selects the last row.
+    pub fn select_last(&self) {
+        self.inner.borrow_mut().select_last();
+    }
+
     /// Creates a new `RubyTableState` with a selected cell (row, column).
     pub fn with_selected_cell(cell: Option<(usize, usize)>) -> Self {
         let state = TableState::default().with_selected_cell(cell);
@@ -144,6 +164,13 @@ pub fn register(ruby: &Ruby, module: magnus::RModule) -> Result<(), Error> {
     class.define_method("offset", method!(RubyTableState::offset, 0))?;
     class.define_method("scroll_down_by", method!(RubyTableState::scroll_down_by, 1))?;
     class.define_method("scroll_up_by", method!(RubyTableState::scroll_up_by, 1))?;
+    class.define_method("select_next", method!(RubyTableState::select_next, 0))?;
+    class.define_method(
+        "select_previous",
+        method!(RubyTableState::select_previous, 0),
+    )?;
+    class.define_method("select_first", method!(RubyTableState::select_first, 0))?;
+    class.define_method("select_last", method!(RubyTableState::select_last, 0))?;
     Ok(())
 }
 

data/lib/ratatui_ruby/table_state.rb

@@ -138,6 +138,106 @@ module RatatuiRuby
     #
     # (Native method implemented in Rust)
 
+    ##
+    # :method: select_next
+    # :call-seq: select_next() -> nil
+    #
+    # Moves selection to the next row. Selects first row if nothing selected.
+    #
+    # === Optimistic Indexing
+    #
+    # Increments the index immediately, even past table bounds. The renderer
+    # clamps to valid range on draw. Reading <tt>selected</tt> between this
+    # call and render may return an out-of-bounds value.
+    #
+    # To detect actual selection changes, check bounds first:
+    #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
+    #   max_index = rows.size - 1
+    #   return if (state.selected || 0) >= max_index
+    #   state.select_next
+    #
+    #--
+    # SPDX-SnippetEnd
+    #++
+    # (Native method implemented in Rust)
+
+    ##
+    # :method: select_previous
+    # :call-seq: select_previous() -> nil
+    #
+    # Moves selection to the previous row. Selects last row if nothing selected.
+    #
+    # === Optimistic Indexing
+    #
+    # At index 0, does nothing. With no selection, sets index to maximum value;
+    # the renderer clamps to actual last row on draw.
+    #
+    # To detect actual selection changes, check bounds first:
+    #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
+    #   return if (state.selected || 0) <= 0
+    #   state.select_previous
+    #
+    #--
+    # SPDX-SnippetEnd
+    #++
+    # (Native method implemented in Rust)
+
+    ##
+    # :method: select_first
+    # :call-seq: select_first() -> nil
+    #
+    # Jumps selection to the first row (index 0).
+    #
+    # To detect actual selection changes:
+    #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
+    #   return if (state.selected || 0) == 0
+    #   state.select_first
+    #
+    #--
+    # SPDX-SnippetEnd
+    #++
+    # (Native method implemented in Rust)
+
+    ##
+    # :method: select_last
+    # :call-seq: select_last() -> nil
+    #
+    # Jumps selection to the last row.
+    #
+    # === Optimistic Indexing
+    #
+    # Sets index to maximum possible value. The renderer clamps to actual last
+    # row on draw. To get or check the real last index, track row count:
+    #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
+    #   max_index = rows.size - 1
+    #   return if (state.selected || 0) == max_index
+    #   state.select(max_index)
+    #
+    #--
+    # SPDX-SnippetEnd
+    #++
+    # (Native method implemented in Rust)
+
     ##
     # :singleton-method: with_selected_cell
     # :call-seq: with_selected_cell(cell) -> TableState

data/lib/ratatui_ruby/version.rb

@@ -8,5 +8,5 @@
 module RatatuiRuby
   # The version of the ratatui_ruby gem.
   # See https://semver.org/spec/v2.0.0.html
-  VERSION = "1.0.0-beta.1"
+  VERSION = "1.0.0-beta.2"
 end

data/tasks/lint.rake

@@ -85,8 +85,10 @@ namespace :reuse do
   desc "Normalize Ruby files: frozen_string_literal at top, SPDX in #--/#++ block"
   task :normalize_ruby do
     ruby_extensions = %w[rb rake gemspec].freeze
+    # Exclude intentionally-formatted files
+    excluded_files = %w[examples/verify_website_menu/app.rb].freeze
     ruby_files = Dir.glob("**/*.{#{ruby_extensions.join(',')}}")
-      .reject { |f| f.start_with?("vendor/", "tmp/", ".") }
+      .reject { |f| f.start_with?("vendor/", "tmp/", ".") || excluded_files.include?(f) }
 
     fixed_count = 0
     ruby_files.each do |file|

data/tasks/sourcehut.rake

@@ -84,6 +84,27 @@ end
 
 if Rake::Task.task_defined?("release")
   Rake::Task["release"].enhance do
+    # Replace Bundler's normalized tag with semver-style for prerelease versions.
+    # Bundler creates tags using normalized Gem::Version (e.g., v1.0.0.pre.beta.1).
+    # Semver uses hyphens (e.g., v1.0.0-beta.1). We want only the semver tag.
+    version_content = File.read("lib/ratatui_ruby/version.rb")
+    version = version_content.match(/VERSION = "(.+?)"/)[1]
+
+    if version.include?("-")
+      normalized_tag = "v#{Gem::Version.new(version)}"
+      semver_tag = "v#{version}"
+
+      if normalized_tag != semver_tag
+        puts "Replacing normalized tag #{normalized_tag} with semver tag #{semver_tag}..."
+        # Delete the normalized tag locally and remotely
+        sh "git tag -d #{normalized_tag}"
+        sh "git push origin :refs/tags/#{normalized_tag}"
+        # Create the semver tag pointing to the same commit
+        sh "git tag #{semver_tag} HEAD"
+        sh "git push origin #{semver_tag}"
+      end
+    end
+
     Rake::Task["sourcehut:update_stable"].invoke
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.beta.1
+  version: 1.0.0.pre.beta.2
 platform: ruby
 authors:
 - Kerrick Long
@@ -101,7 +101,7 @@ description: |2-
   Ratatui[https://ratatui.rs], a leading TUI library written in
   Rust[https://rust-lang.org]. You get native performance with the joy of Ruby.
 
-    gem install ratatui_ruby
+    gem install ratatui_ruby --pre
 
   {rdoc-image:https://ratatui-ruby.dev/hero.gif}[https://www.ratatui-ruby.dev/docs/v0.10/examples/app_cli_rich_moments/README_md.html]