ratatui_ruby 0.7.4 → 0.9.0

data/lib/ratatui_ruby/schema/cursor.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -16,8 +16,16 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   Cursor.new(x: 10, y: 5)
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # See also:
   # - {Declarative implementation using Tree API}[link:/examples/app_login_form/app_rb.html]
   # - {Component-based implementation using Frame API}[link:/examples/app_color_picker/app_rb.html]

data/lib/ratatui_ruby/schema/draw.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -13,6 +13,11 @@ module RatatuiRuby
   #
   # === Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   class MyWidget
   #     def render(area)
   #       [
@@ -21,6 +26,9 @@ module RatatuiRuby
   #       ]
   #     end
   #   end
+  #--
+  # SPDX-SnippetEnd
+  #++
   module Draw
     # Command to draw a string at the given coordinates.
     #

data/lib/ratatui_ruby/schema/gauge.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/layout.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -70,6 +70,11 @@ module RatatuiRuby
     # This is a pure calculation helper for hit testing. It computes where
     # widgets *would* be placed without actually rendering them.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   rects = Layout.split(
     #     area,
     #     direction: :horizontal,
@@ -77,6 +82,9 @@ module RatatuiRuby
     #   )
     #   left, right = rects
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [area]
     #   The area to split. Can be a <tt>Rect</tt> or a <tt>Hash</tt> containing <tt>:x</tt>, <tt>:y</tt>, <tt>:width</tt>, and <tt>:height</tt>.
     # [direction]
@@ -84,8 +92,16 @@ module RatatuiRuby
     # [constraints]
     #   Array of <tt>Constraint</tt> objects defining section sizes.
     # [flex]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Flex mode for spacing (default: <tt>:legacy</tt>).
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns an Array of <tt>Rect</tt> objects.
     def self.split(area, direction: :vertical, constraints:, flex: :legacy)
       # Duck-typing: If it lacks geometry methods but can be a Hash, convert it.

data/lib/ratatui_ruby/schema/line_gauge.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/list.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -19,6 +19,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Basic List
   #   List.new(items: ["Item 1", "Item 2"])
   #
@@ -29,6 +34,9 @@ module RatatuiRuby
   #     highlight_style: Style.new(bg: :blue),
   #     highlight_symbol: ">> "
   #   )
+  #--
+  # SPDX-SnippetEnd
+  #++
   class List < Data.define(:items, :selected_index, :offset, :style, :highlight_style, :highlight_symbol, :repeat_highlight_symbol, :highlight_spacing, :direction, :scroll_padding, :block)
     ##
     # :attr_reader: items

data/lib/ratatui_ruby/schema/list_item.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -16,6 +16,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Item with red background
   #   ListItem.new(content: "Error", style: Style.new(bg: :red))
   #
@@ -23,6 +28,9 @@ module RatatuiRuby
   #   ListItem.new(
   #     content: Text::Span.new(content: "Status: OK", style: Style.new(fg: :green, modifiers: [:bold]))
   #   )
+  #--
+  # SPDX-SnippetEnd
+  #++
   class ListItem < Data.define(:content, :style)
     ##
     # :attr_reader: content

data/lib/ratatui_ruby/schema/overlay.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -18,6 +18,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   Overlay.new(
   #     layers: [
   #       BackgroundMap.new,
@@ -25,6 +30,9 @@ module RatatuiRuby
   #       ModalDialog.new  # Draws over everything
   #     ]
   #   )
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Overlay < Data.define(:layers)
     ##
     # :attr_reader: layers

data/lib/ratatui_ruby/schema/paragraph.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -16,6 +16,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Basic Text
   #   Paragraph.new(text: "Hello, World!")
   #
@@ -29,6 +34,9 @@ module RatatuiRuby
   #
   #   # Scrolling mechanism
   #   Paragraph.new(text: large_text, scroll: [scroll_y, 0])
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Paragraph < Data.define(:text, :style, :block, :wrap, :alignment, :scroll)
     ##
     # :attr_reader: text

data/lib/ratatui_ruby/schema/ratatui_logo.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/ratatui_mascot.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/rect.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -18,8 +18,16 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   area = Rect.new(x: 0, y: 0, width: 80, height: 24)
   #   puts area.width # => 80
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Rect < Data.define(:x, :y, :width, :height)
     ##
     # :attr_reader: x
@@ -58,15 +66,31 @@ module RatatuiRuby
     #
     # Essential for hit testing mouse clicks against layout regions.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   area = Rect.new(x: 10, y: 5, width: 20, height: 10)
     #   area.contains?(15, 8) # => true
     #   area.contains?(5, 8)  # => false
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [px]
     #   X coordinate to test (column).
     # [py]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Y coordinate to test (row).
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns true if the point (px, py) is within the rectangle bounds.
     def contains?(px, py)
       px >= x && px < x + width && py >= y && py < y + height
@@ -76,13 +100,29 @@ module RatatuiRuby
     #
     # Essential for determining if a widget is visible within a viewport or clipping area.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   viewport = Rect.new(x: 0, y: 0, width: 80, height: 24)
     #   widget = Rect.new(x: 70, y: 20, width: 20, height: 10)
     #   viewport.intersects?(widget) # => true (partial overlap)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [other]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Another Rect to test against.
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns true if the rectangles overlap.
     def intersects?(other)
       x < other.x + other.width &&
@@ -95,14 +135,30 @@ module RatatuiRuby
     #
     # Essential for calculating visible portions of widgets inside scroll views.
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   viewport = Rect.new(x: 0, y: 0, width: 80, height: 24)
     #   widget = Rect.new(x: 70, y: 20, width: 20, height: 10)
     #   visible = viewport.intersection(widget)
     #   # => Rect(x: 70, y: 20, width: 10, height: 4)
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [other]
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Another Rect to intersect with.
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # Returns a new Rect representing the intersection, or +nil+ if no overlap.
     def intersection(other)
       return nil unless intersects?(other)

data/lib/ratatui_ruby/schema/row.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -16,6 +16,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Row with red background
   #   Row.new(cells: ["Error", "Something went wrong"], style: Style.new(bg: :red))
   #
@@ -27,6 +32,9 @@ module RatatuiRuby
   #     ],
   #     height: 2
   #   )
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Row < Data.define(:cells, :style, :height, :top_margin, :bottom_margin)
     ##
     # :attr_reader: cells

data/lib/ratatui_ruby/schema/scrollbar.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/shape/label.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -19,6 +19,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   # Simple label
     #   Shape::Label.new(x: 0, y: 0, text: "Origin")
     #
@@ -37,6 +42,9 @@ module RatatuiRuby
     #       Text::Span.new(content: "World", style: Style.new(fg: :blue))
     #     ])
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Label < Data.define(:x, :y, :text, :style)
       ##
       # :attr_reader: x

data/lib/ratatui_ruby/schema/sparkline.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -71,6 +71,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   bar_set: {
     #     empty: " ",
     #     one_eighth: " ",
@@ -90,6 +95,9 @@ module RatatuiRuby
     #
     #   # Array (9 items)
     #   bar_set: [" ", " ", "▂", "▃", "▄", "▅", "▆", "▇", "█"]
+    #--
+    # SPDX-SnippetEnd
+    #++
 
     BAR_KEYS = %i[empty one_eighth one_quarter three_eighths half five_eighths three_quarters seven_eighths full].freeze
 

data/lib/ratatui_ruby/schema/style.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -17,12 +17,20 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Standard colors
   #   Style.new(fg: :red, bg: :white, modifiers: [:bold])
   #
   #   # Hex colors
   #   Style.new(fg: "#ff00ff")
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # === Supported Colors
   #
   # ==== Integer
@@ -36,9 +44,17 @@ module RatatuiRuby
   # * <tt>:black</tt>, <tt>:red</tt>, <tt>:green</tt>, <tt>:yellow</tt>,
   #   <tt>:blue</tt>, <tt>:magenta</tt>, <tt>:cyan</tt>, <tt>:gray</tt>
   # * <tt>:dark_gray</tt>, <tt>:light_red</tt>, <tt>:light_green</tt>,
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   <tt>:light_yellow</tt>, <tt>:light_blue</tt>, <tt>:light_magenta</tt>,
   #   <tt>:light_cyan</tt>, <tt>:white</tt>
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # ==== String
   # Represents a specific RGB color using a Hex code (<tt>"#RRGGBB"</tt>).
   # Requires a terminal emulator with "True Color" (24-bit color) support.

data/lib/ratatui_ruby/schema/table.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/tabs.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby

data/lib/ratatui_ruby/schema/text.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: LGPL-3.0-or-later
 #++
 
 module RatatuiRuby
@@ -31,6 +31,11 @@ module RatatuiRuby
   #
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Simple ASCII text
   #   RatatuiRuby::Text.width("Hello")        # => 5
   #
@@ -42,6 +47,9 @@ module RatatuiRuby
   #
   #   # Mixed content
   #   RatatuiRuby::Text.width("Hi 你好 👍")   # => 11 (2 + space + 4 + space + 2)
+  #--
+  # SPDX-SnippetEnd
+  #++
   module Text
     # A styled string fragment.
     #
@@ -90,12 +98,20 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2025 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   Text::Line.new(
     #     spans: [
     #       Text::Span.styled("User: ", Style.new(modifiers: [:bold])),
     #       Text::Span.styled("kerrick", Style.new(fg: :blue))
     #     ]
     #   )
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Line < Data.define(:spans, :alignment, :style)
       ##
       # :attr_reader: spans
@@ -136,12 +152,20 @@ module RatatuiRuby
       #
       # === Examples
       #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
       #   line = Text::Line.new(spans: [
       #     Text::Span.new(content: "Hello "),
       #     Text::Span.new(content: "世界")
       #   ])
       #   line.width  # => 10 (6 ASCII + 4 CJK)
       #
+      #--
+      # SPDX-SnippetEnd
+      #++
       # Returns: Integer (number of terminal cells)
       def width
         RatatuiRuby::Text.width(spans.map { |s| s.content.to_s }.join)
@@ -162,6 +186,11 @@ module RatatuiRuby
     #
     # === Examples
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   RatatuiRuby::Text.width("Hello")        # => 5 (5 ASCII chars × 1 cell)
     #
     #   RatatuiRuby::Text.width("你好")         # => 4 (2 CJK chars × 2 cells)
@@ -173,6 +202,9 @@ module RatatuiRuby
     #     width = tui.text_width("Hello 👍")
     #   end
     #
+    #--
+    # SPDX-SnippetEnd
+    #++
     # [string] String to measure (String or object convertible to String)
     # Returns: Integer (number of terminal cells the string occupies)
     # Raises: TypeError if the argument is not a String