ratatui_ruby 0.8.0 → 0.9.1

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__)
@@ -124,6 +124,12 @@ class WidgetLayoutSplit
           ]
         },
       },
+      {
+        name: "Batch (from_percentages)",
+        constraints: -> (_dir) {
+          RatatuiRuby::Layout::Constraint.from_percentages([25, 50, 25])
+        },
+      },
     ]
   end
 
@@ -193,7 +199,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

data/examples/widget_line_gauge/README.md

@@ -29,9 +29,15 @@ Standard block gauges take up vertical space. Sometimes you only have one line t
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_line_gauge/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_line_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_list/README.md

@@ -36,9 +36,15 @@ Lists are the workhorse of terminal interfaces. Managing selection state, scroll
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_list/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_list/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_map/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
 -->
 
 # Map (World Map, Canvas) Example
@@ -27,9 +27,15 @@ Standard widgets are great for text, but sometimes you need to draw. The `Canvas
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_map/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_map/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_overlay/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
 -->
 # Overlay Example
@@ -24,9 +24,15 @@ This example demonstrates the `Overlay` composition pattern for layering widgets
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_overlay/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_overlay/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_popup/README.md

@@ -24,9 +24,15 @@ Terminal renders are additive. If you draw a new widget over an old one, the bac
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_popup/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_popup/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_ratatui_logo/README.md

@@ -22,9 +22,15 @@ A polished application often needs an "About" screen or a splash screen. This wi
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_ratatui_logo/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_ratatui_logo/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_ratatui_mascot/README.md

@@ -23,9 +23,15 @@ Interfaces can feel clinical. A friendly mascot adds charm and brand identity to
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_ratatui_mascot/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_ratatui_mascot/app.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 #--
-# 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: MIT-0
 #++
 
 $LOAD_PATH.unshift File.expand_path("../../lib", __dir__)

data/examples/widget_rect/README.md

@@ -14,6 +14,10 @@ TUI layouts are composed of rectangles. Understanding how to manipulate `Rect` o
 ## Features Demonstrated
 
 - **Rect Attributes**: Investigating x, y, width, and height.
+- **Edge Accessors**: Using `left`, `right`, `top`, `bottom` instead of manual math.
+- **Size Methods**: Checking `area` and `empty?` for guard clauses.
+- **Geometry Transformations**: Computing `inner`, `offset`, `union`, and `clamp`.
+- **Iterators**: Traversing `rows`, `columns`, and `positions`.
 - **Cached Layout Pattern**: Computing constraints in the render loop and reusing the resulting `Rect`s in the event loop for logic.
 - **Hit Testing**: Using `Rect#contains?(x, y)` to determine if a mouse click happened inside a specific panel.
 
@@ -26,9 +30,15 @@ TUI layouts are composed of rectangles. Understanding how to manipulate `Rect` o
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_rect/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 
@@ -37,5 +47,7 @@ Use this example if you need to...
 - Handle mouse clicks on specific buttons or areas.
 - Create resizable panes (like a split pane in an IDE).
 - Debug layout issues by inspecting Rect coordinates.
+- Compute inner padding, bounding boxes, or clamped popups.
+- Iterate over rows, columns, or individual positions within a region.
 
 [Read the source code →](app.rb)