ratatui_ruby 0.8.0 → 0.9.0

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)

data/examples/widget_rect/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__)
@@ -14,9 +14,11 @@ require "ratatui_ruby"
 #
 # Rect is the fundamental geometry primitive for TUI layout. This example shows:
 # - Rect attributes: x, y, width, height
+# - Edge accessors: left, right, top, bottom
+# - Geometry methods: area, empty?, union, inner, offset, clamp
+# - Iterators: rows, columns, positions
 # - Rect#contains? for hit testing mouse clicks
 # - Layout.split returning cached rects for reuse
-# - The layout caching pattern: compute in draw, reuse in handle_input
 #
 # Controls:
 #   ←/→: Adjust sidebar width
@@ -57,7 +59,7 @@ class WidgetRect
         direction: :vertical,
         constraints: [
           @tui.constraint_fill(1),
-          @tui.constraint_length(8),
+          @tui.constraint_length(5),
         ]
       )
 
@@ -88,21 +90,41 @@ class WidgetRect
   end
 
   private def render_content(frame)
+    r = @content_rect
+    inner_r = r.inner(2)
+    offset_r = r.offset(3, 2)
+    bounds = RatatuiRuby::Layout::Rect.new(x: 0, y: 0, width: 50, height: 20)
+    clamped = r.clamp(bounds)
+    union_r = r.union(@sidebar_rect)
+
     text_content = [
       @tui.text_line(spans: [
         @tui.text_span(content: "Active View: ", style: @label_style),
         @tui.text_span(content: MENU_ITEMS[@selected_index], style: @tui.style(fg: :green)),
       ]),
-      "",
       @tui.text_line(spans: [
         @tui.text_span(content: "Rect Attributes ", style: @label_style),
         @tui.text_span(content: "(from Layout.split):", style: @dim_style),
       ]),
-      "  Sidebar: Rect(x:#{@sidebar_rect.x}, y:#{@sidebar_rect.y}, " \
-        "width:#{@sidebar_rect.width}, height:#{@sidebar_rect.height})",
-      "  Content: Rect(x:#{@content_rect.x}, y:#{@content_rect.y}, " \
-        "width:#{@content_rect.width}, height:#{@content_rect.height})",
-      "",
+      "  x:#{r.x} y:#{r.y} width:#{r.width} height:#{r.height}",
+      @tui.text_line(spans: [
+        @tui.text_span(content: "Edge Accessors:", style: @label_style),
+      ]),
+      "  left:#{r.left} right:#{r.right} top:#{r.top} bottom:#{r.bottom}",
+      @tui.text_line(spans: [
+        @tui.text_span(content: "Size Methods:", style: @label_style),
+      ]),
+      "  area:#{r.area} empty?:#{r.empty?}",
+      @tui.text_line(spans: [
+        @tui.text_span(content: "Geometry Transformations:", style: @label_style),
+      ]),
+      "  inner(2): x:#{inner_r.x} y:#{inner_r.y} w:#{inner_r.width} h:#{inner_r.height}",
+      "  offset(3,2): x:#{offset_r.x} y:#{offset_r.y}  clamp: x:#{clamped.x} y:#{clamped.y}",
+      "  union(sidebar): w:#{union_r.width} h:#{union_r.height}",
+      @tui.text_line(spans: [
+        @tui.text_span(content: "Iterators:", style: @label_style),
+      ]),
+      "  rows:#{r.height} columns:#{r.width} positions:#{r.area}",
       @tui.text_line(spans: [
         @tui.text_span(content: "Hit Testing ", style: @label_style),
         @tui.text_span(content: "(Rect#contains?):", style: @dim_style),
@@ -125,27 +147,19 @@ class WidgetRect
         @tui.paragraph(
           text: [
             @tui.text_line(spans: [
-              @tui.text_span(content: "LAYOUT", style: @label_style),
-              @tui.text_span(content: "  "),
               @tui.text_span(content: "←", style: @hotkey_style),
-              @tui.text_span(content: ": Shrink sidebar  "),
+              @tui.text_span(content: "/"),
               @tui.text_span(content: "→", style: @hotkey_style),
-              @tui.text_span(content: ": Expand sidebar  "),
-              @tui.text_span(content: "(width: #{@sidebar_width})"),
-            ]),
-            @tui.text_line(spans: [
-              @tui.text_span(content: "NAVIGATION", style: @label_style),
-              @tui.text_span(content: "  "),
-              @tui.text_span(content: "↑↓", style: @hotkey_style),
-              @tui.text_span(content: ": Select menu item  "),
+              @tui.text_span(content: ": Sidebar width  "),
+              @tui.text_span(content: "↑", style: @hotkey_style),
+              @tui.text_span(content: "/"),
+              @tui.text_span(content: "↓", style: @hotkey_style),
+              @tui.text_span(content: ": Menu selection  "),
+              @tui.text_span(content: "Click", style: @hotkey_style),
+              @tui.text_span(content: ": Hit test  "),
               @tui.text_span(content: "q", style: @hotkey_style),
               @tui.text_span(content: ": Quit"),
             ]),
-            "",
-            @tui.text_line(spans: [
-              @tui.text_span(content: "HIT TESTING", style: @label_style),
-              @tui.text_span(content: "  Click any panel → Rect#contains?(x, y) determines which rect was hit."),
-            ]),
           ]
         ),
       ]

data/examples/widget_render/README.md

@@ -25,9 +25,15 @@ Sometimes standard widgets aren't enough. You need to draw custom shapes, games,
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_render/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_render/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_render/app.rbs

@@ -0,0 +1,41 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: MIT-0
+
+class DiagonalWidget
+  @widget_index: Integer
+  @widgets: Array[{ name: String, widget: (DiagonalWidget | CheckerboardWidget | BorderWidget) }]
+  @tui: RatatuiRuby::TUI
+
+  def run: () -> void
+
+  private def render: () -> void
+  private def handle_input: () -> Symbol?
+end
+
+class DiagonalWidget
+  def render: (RatatuiRuby::Rect area) -> Array[RatatuiRuby::Draw::StringCmd | RatatuiRuby::Draw::CellCmd]
+end
+
+class CheckerboardWidget
+  @char: String
+
+  def initialize: (?String char) -> void
+  def render: (RatatuiRuby::Rect area) -> Array[RatatuiRuby::Draw::StringCmd | RatatuiRuby::Draw::CellCmd]
+end
+
+class BorderWidget
+  def render: (RatatuiRuby::Rect area) -> Array[RatatuiRuby::Draw::StringCmd | RatatuiRuby::Draw::CellCmd]
+end
+
+class WidgetRender
+  @widget_index: Integer
+  @widgets: Array[{ name: String, widget: (DiagonalWidget | CheckerboardWidget | BorderWidget) }]
+  @tui: RatatuiRuby::TUI
+
+  def initialize: () -> void
+  def run: () -> void
+
+  private def render: () -> void
+  private def handle_input: () -> Symbol?
+end

data/examples/widget_rich_text/README.md

@@ -23,9 +23,15 @@ Standard strings are monochromatic. "Rich Text" is composed of `Lines` containin
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_rich_text/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_rich_text/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_scroll_text/README.md

@@ -25,9 +25,15 @@ Sometimes text exceeds the available space. The `Paragraph` widget supports a `s
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_scroll_text/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_scroll_text/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_scrollbar/README.md

@@ -26,9 +26,15 @@ Content overflows. Users get lost in long lists. Scrollbars provide essential sp
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_scrollbar/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_scrollbar/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_sparkline/README.md

@@ -30,9 +30,15 @@ Users need context. A single number ("90% CPU") tells you status, but not the tr
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_sparkline/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_sparkline/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_style_colors/README.md

@@ -22,9 +22,15 @@ Terminals support millions of colors. This example generates a mathematically pr
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_style_colors/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_style_colors/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_table/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
 -->
 
 # Table (Row, Cell) Example
@@ -36,9 +36,15 @@ Data grids are complex. Users expect to navigate them with keys, select rows, an
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_table/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_table/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_tabs/README.md

@@ -29,9 +29,15 @@ Screen real estate is limited. You cannot show everything at once. Tabs segregat
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_tabs/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes
 

data/examples/widget_tabs/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_text_width/README.md

@@ -23,9 +23,15 @@ Not all characters are created equal. In a TUI, "Width" means cell count, not st
 
 ## Usage
 
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
 ```bash
 ruby examples/widget_text_width/app.rb
 ```
+<!-- SPDX-SnippetEnd -->
 
 ## Learning Outcomes