ratatui_ruby 0.8.0 → 0.9.0

data/examples/app_color_picker/palette.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 #++
 

data/examples/app_login_form/README.md

@@ -1,6 +1,6 @@
 <!--
-SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-SPDX-License-Identifier: CC-BY-SA-4.0
+  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+  SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
 # Login Form Example
@@ -36,9 +36,15 @@ This example solves this by using the `Overlay` widget to stack a centered popup
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/app_login_form/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/app_login_form/app.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 #++
 

data/examples/app_stateful_interaction/README.md

@@ -1,6 +1,6 @@
 <!--
-SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-SPDX-License-Identifier: CC-BY-SA-4.0
+  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+  SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 
 # Stateful Interaction Example

data/examples/app_stateful_interaction/app.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 #++
 
@@ -106,7 +106,7 @@ class AppStatefulInteraction
       render_table(frame, table_area)
 
       # 4. Render Help
-      help_text = "q: Quit | Tab/Arrows: Nav | Mouse: Click rows (Try it!)"
+      help_text = "q: Quit | Tab/Arrows: Nav | Home/End: Jump | Mouse: Click rows"
       frame.render_widget(@tui.paragraph(text: help_text), help_area)
     end
   end
@@ -193,10 +193,16 @@ class AppStatefulInteraction
       @active_pane = (@active_pane == :list) ? :table : :list
 
     in { type: :key, code: "down" }
-      scroll_active(1)
+      move_selection_next
 
     in { type: :key, code: "up" }
-      scroll_active(-1)
+      move_selection_previous
+
+    in { type: :key, code: "home" }
+      move_selection_first
+
+    in { type: :key, code: "end" }
+      move_selection_last
 
     # Mouse Interaction
     in { type: :mouse, kind: "down", x:, y: }
@@ -207,24 +213,72 @@ class AppStatefulInteraction
     end
   end
 
-  private def scroll_active(delta)
+  private def move_selection_next
     if @active_pane == :list
-      i = @list_state.selected || 0
-      new_i = (i + delta).clamp(0, @tables.size - 1)
-      @list_state.select(new_i)
-      # Reset table selection when switching categories
-      if i != new_i
-        @table_state.select(0)
-        @table_state.select_column(nil) # Ensure clean slate
-      end
+      current = @list_state.selected || 0
+      max_index = @tables.size - 1
+      return if current >= max_index # Already at end
+
+      @list_state.select_next
+      reset_table_selection
     else
-      current_rows = @data[@tables[@list_state.selected || 0]].size
-      i = @table_state.selected || 0
-      new_i = (i + delta).clamp(0, current_rows - 1)
-      @table_state.select(new_i)
+      current = @table_state.selected || 0
+      max_index = current_table_rows.size - 1
+      return if current >= max_index
+
+      @table_state.select_next
     end
   end
 
+  private def move_selection_previous
+    if @active_pane == :list
+      current = @list_state.selected || 0
+      return if current <= 0 # Already at start
+
+      @list_state.select_previous
+      reset_table_selection
+    else
+      current = @table_state.selected || 0
+      return if current <= 0
+
+      @table_state.select_previous
+    end
+  end
+
+  private def move_selection_first
+    if @active_pane == :list
+      current = @list_state.selected || 0
+      return if current == 0 # Already at first
+
+      @list_state.select_first
+      reset_table_selection
+    else
+      @table_state.select_first
+    end
+  end
+
+  private def move_selection_last
+    if @active_pane == :list
+      current = @list_state.selected || 0
+      max_index = @tables.size - 1
+      return if current == max_index # Already at last
+
+      @list_state.select(max_index)
+      reset_table_selection
+    else
+      @table_state.select(current_table_rows.size - 1)
+    end
+  end
+
+  private def reset_table_selection
+    @table_state.select(0)
+    @table_state.select_column(nil)
+  end
+
+  private def current_table_rows
+    @data[@tables[@list_state.selected || 0]]
+  end
+
   private def handle_click(x, y)
     if @list_area.contains?(x, y)
       handle_list_click(y)

data/examples/timeout_demo.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 #++
 

data/examples/verify_quickstart_dsl/README.md

@@ -11,6 +11,11 @@ This example exists as a documentation regression test. It ensures the recommend
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 <!-- SYNC:START:app.rb:main -->
 ```ruby
 # 1. Initialize the terminal, start the run loop, and ensure the terminal is restored.
@@ -45,5 +50,6 @@ RatatuiRuby.run do |tui|
 end
 ```
 <!-- SYNC:END -->
+<!-- SPDX-SnippetEnd -->
 
 [![verify_quickstart_dsl](../../doc/images/verify_quickstart_dsl.png)](../../doc/getting_started/quickstart.md#simplified-api)

data/examples/verify_quickstart_dsl/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -23,7 +23,7 @@ class VerifyQuickstartDsl
             title: "My Ruby TUI App",
             title_alignment: :center,
             borders: [:all],
-            border_color: "cyan",
+            border_style: { fg: "cyan" },
             style: { fg: "white" }
           )
         )

data/examples/verify_quickstart_layout/README.md

@@ -11,6 +11,11 @@ This example exists as a documentation regression test. It ensures the layout an
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 <!-- SYNC:START:app.rb:main -->
 ```ruby
 loop do
@@ -67,5 +72,6 @@ loop do
 end
 ```
 <!-- SYNC:END -->
+<!-- SPDX-SnippetEnd -->
 
 [![verify_quickstart_layout](../../doc/images/verify_quickstart_layout.png)](../../doc/getting_started/quickstart.md#adding-layouts)

data/examples/verify_quickstart_layout/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -30,7 +30,7 @@ class VerifyQuickstartLayout
             tui.paragraph(
               text: "Hello, Ratatui!",
               alignment: :center,
-              block: tui.block(title: "Content", borders: [:all], border_color: "cyan")
+              block: tui.block(title: "Content", borders: [:all], border_style: { fg: "cyan" })
             ),
             top
           )

data/examples/verify_quickstart_lifecycle/README.md

@@ -11,6 +11,11 @@ This example exists as a documentation regression test. It ensures the core life
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 <!-- SYNC:START:app.rb:main -->
 ```ruby
 # 1. Initialize the terminal
@@ -58,5 +63,6 @@ ensure
 end
 ```
 <!-- SYNC:END -->
+<!-- SPDX-SnippetEnd -->
 
 [![verify_quickstart_lifecycle](../../doc/images/verify_quickstart_lifecycle.png)](../../doc/getting_started/quickstart.md#basic-application)

data/examples/verify_quickstart_lifecycle/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -27,7 +27,7 @@ class VerifyQuickstartLifecycle
             title: "My Ruby TUI App",
             title_alignment: :center,
             borders: [:all],
-            border_color: "cyan",
+            border_style: { fg: "cyan" },
             style: { fg: "white" }
           )
         )

data/examples/verify_readme_usage/README.md

@@ -11,6 +11,11 @@ This example exists as a documentation regression test. It ensures that the very
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 <!-- SYNC:START:app.rb:main -->
 ```ruby
 RatatuiRuby.run do |tui|
@@ -39,5 +44,6 @@ RatatuiRuby.run do |tui|
 end
 ```
 <!-- SYNC:END -->
+<!-- SPDX-SnippetEnd -->
 
 [![verify_readme_usage](../../doc/images/verify_readme_usage.png)](../../README.md#usage)

data/examples/verify_readme_usage/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -21,7 +21,7 @@ class VerifyReadmeUsage
               block: tui.block(
                 title: "My Ruby TUI App",
                 borders: [:all],
-                border_color: "cyan"
+                border_style: { fg: "cyan" }
               )
             ),
             frame.area

data/examples/widget_barchart/README.md

@@ -37,9 +37,15 @@ Comparing magnitudes in raw tables requires mental arithmetic. Bar charts make t
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_barchart/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_barchart/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_block/README.md

@@ -1,5 +1,5 @@
 <!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
   SPDX-License-Identifier: CC-BY-SA-4.0
 -->
 # Block Example
@@ -31,8 +31,14 @@ This example demonstrates the versatile `Block` widget, which provides the visua
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_block/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 [Read the source code →](app.rb)

data/examples/widget_block/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_box/README.md

@@ -32,9 +32,15 @@ Widgets often float in a void. Without boundaries, interfaces become a chaotic m
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_box/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_box/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -132,9 +132,13 @@ set: {
     border_style_config = @border_styles[@border_style_index]
 
     # 1. State/View
-    # Use border_style if provided, otherwise fall back to border_color
-    effective_border_style = border_style_config[:style]
-    effective_border_color = effective_border_style ? nil : (style_config[:style] ? nil : color_config[:color])
+    # Use border_style if explicitly set; otherwise, only apply color picker
+    # color when no content style is set (preserves original border_color behavior)
+    effective_border_style = if border_style_config[:style]
+      border_style_config[:style]
+    elsif style_config[:style].nil?
+      @tui.style(fg: color_config[:color])
+    end
 
     # Show overridden status if border_set is active
     type_display = border_type_config[:name]
@@ -147,7 +151,6 @@ set: {
       title_alignment: title_alignment_config[:alignment],
       title_style: title_style_config[:style],
       borders: [:all],
-      border_color: effective_border_color,
       border_style: effective_border_style,
       border_type: border_type_config[:type],
       border_set: border_set_config[:set],

data/examples/widget_calendar/README.md

@@ -27,9 +27,15 @@ Rendering dates in a grid involves complex calculations for leap years and weekd
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_calendar/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_calendar/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_canvas/README.md

@@ -1,3 +1,7 @@
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+  SPDX-License-Identifier: CC-BY-SA-4.0
+-->
 # Canvas (Circle, Line, Point, Rectangle) Example
 
 [![widget_canvas](../../doc/images/widget_canvas.png)](app.rb)

data/examples/widget_canvas/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_cell/README.md

@@ -24,9 +24,15 @@ Sometimes you need to render specific characters with unique styles outside of s
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_cell/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_cell/app.rb

@@ -1,9 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_center/README.md

@@ -1,3 +1,7 @@
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+  SPDX-License-Identifier: CC-BY-SA-4.0
+-->
 # Center Example
 
 [![widget_center](../../doc/images/widget_center.png)](app.rb)

data/examples/widget_center/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_chart/README.md

@@ -29,9 +29,15 @@ Trends and patterns are invisible in raw logs. Charts visualize X/Y datasets to
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_chart/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_chart/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_gauge/README.md

@@ -29,9 +29,15 @@ Long-running tasks create anxiety. Users need to know the system is working. Gau
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_gauge/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_gauge/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_layout_split/README.md

@@ -31,9 +31,15 @@ Terminal screens vary in size. Hardcoded layouts break. `Layout.split` manages s
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_layout_split/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_layout_split/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
@@ -193,7 +193,7 @@ class WidgetLayoutSplit
       block = @tui.block(
         title: "Block #{i + 1}",
         borders: [:all],
-        border_color: BLOCK_COLORS[i % BLOCK_COLORS.length]
+        border_style: @tui.style(fg: BLOCK_COLORS[i % BLOCK_COLORS.length])
       )
       frame.render_widget(block, block_area)
     end