ratatui_ruby 0.8.0 → 0.9.1

data/lib/ratatui_ruby.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
 #++
 
 require_relative "ratatui_ruby/version"
@@ -31,6 +31,9 @@ require_relative "ratatui_ruby/terminal_lifecycle"
 # TUI facade (for external instantiation and caching)
 require_relative "ratatui_ruby/tui"
 
+# Synthetic events queue (for async synchronization)
+require_relative "ratatui_ruby/synthetic_events"
+
 begin
   require "ratatui_ruby/ratatui_ruby"
 rescue LoadError
@@ -53,11 +56,19 @@ module RatatuiRuby
   #
   # === Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   begin
   #     RatatuiRuby.run { |tui| ... }
   #   rescue RatatuiRuby::Error => e
   #     puts "RatatuiRuby error: #{e.message}"
   #   end
+  #--
+  # SPDX-SnippetEnd
+  #++
   class Error < StandardError
     # Operational failure during terminal I/O.
     #
@@ -71,11 +82,19 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   begin
     #     RatatuiRuby.init_terminal
     #   rescue RatatuiRuby::Error::Terminal => e
     #     puts "Terminal failed: #{e.message}"
     #   end
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Terminal < Error; end
 
     # Object lifetime violation.
@@ -91,26 +110,43 @@ module RatatuiRuby
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   stored_frame = nil
     #   RatatuiRuby.draw { |frame| stored_frame = frame }
     #   stored_frame.area  # => raises Error::Safety
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Safety < Error; end
 
-    # State invariant violation.
+    # Invariant violation.
     #
-    # The library has rules about valid state transitions.
-    # Calling methods in the wrong order or state breaks invariants.
+    # The library enforces rules about valid states and contracts.
+    # Breaking these rules raises this error.
     #
-    # This error signals you violated a state machine contract.
-    # The program state doesn't allow this operation right now.
+    # Common causes:
+    # - Calling methods in the wrong order (e.g., \`init_terminal\` twice)
+    # - Callable return type mismatch (e.g., view returns \`nil\` instead of a widget)
     #
-    # To resolve, check `terminal_active?` or restructure the
-    # code to ensure methods are called in the expected order.
+    # To resolve, check the method's documented contract. Ensure
+    # state preconditions are met and return types are correct.
     #
     # === Example
     #
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-FileCopyrightText: 2026 Kerrick Long
+    # SPDX-License-Identifier: MIT-0
+    #++
     #   RatatuiRuby.init_terminal
     #   RatatuiRuby.init_terminal  # => raises Error::Invariant
+    #--
+    # SPDX-SnippetEnd
+    #++
     class Invariant < Error; end
   end
 
@@ -149,8 +185,16 @@ module RatatuiRuby
   # [event_type] "key" or "mouse"
   # [data] a Hash containing event data
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   inject_test_event("key", { code: "a" })
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # (Native method implemented in Rust)
 
   ##
@@ -189,20 +233,44 @@ module RatatuiRuby
   # {Frame} object for imperative drawing.
   #
   # [tree] A widget tree (Widgets::Paragraph, Layout::Layout, etc.) to render. Optional if
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #        a block is given.
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # === Examples
   #
   # Legacy declarative style (tree-based):
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   RatatuiRuby.draw(Widgets::Paragraph.new(text: "Hello"))
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # New imperative style (block-based):
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   RatatuiRuby.draw do |frame|
   #     frame.render_widget(Widgets::Paragraph.new(text: "Hello"), frame.area)
   #   end
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   def self.draw(tree = nil, &block)
     if tree && block
       raise ArgumentError, "Cannot provide both a tree and a block to draw"
@@ -229,11 +297,24 @@ module RatatuiRuby
   # This method checks for an event. It returns the event if one is found. It returns {RatatuiRuby::Event::None} if the timeout expires.
   #
   # [timeout] Float seconds to wait (default: 0.016).
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #           Pass <tt>nil</tt> to block indefinitely (wait forever).
   #           Pass <tt>0.0</tt> for a non-blocking check.
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   # === Examples
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2026 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   # Standard loop (approx 60 FPS)
   #   event = RatatuiRuby.poll_event
   #
@@ -243,6 +324,9 @@ module RatatuiRuby
   #   # Non-blocking check (returns immediately)
   #   event = RatatuiRuby.poll_event(timeout: 0.0)
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   def self.poll_event(timeout: 0.016)
     raise ArgumentError, "timeout must be non-negative" if timeout && timeout < 0
 
@@ -293,11 +377,19 @@ module RatatuiRuby
   #
   # === Example
   #
+  #--
+  # SPDX-SnippetBegin
+  # SPDX-FileCopyrightText: 2025 Kerrick Long
+  # SPDX-License-Identifier: MIT-0
+  #++
   #   cell = RatatuiRuby.get_cell_at(10, 5)
   #   expect(cell.symbol).to eq("X")
   #   expect(cell.fg).to eq(:red)
   #   expect(cell).to be_bold
   #
+  #--
+  # SPDX-SnippetEnd
+  #++
   def self.get_cell_at(x, y)
     raw = _get_cell_at(x, y)
     Buffer::Cell.new(

data/sig/examples/app_all_events/view.rbs

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

data/sig/examples/app_all_events/view_state.rbs

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

data/sig/examples/app_color_picker/app.rbs

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

data/sig/examples/app_stateful_interaction/app.rbs

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

data/sig/examples/verify_quickstart_dsl/app.rbs

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

data/sig/examples/verify_quickstart_lifecycle/app.rbs

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

data/sig/examples/verify_readme_usage/app.rbs

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

data/sig/examples/widget_block_demo/app.rbs

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

data/sig/examples/widget_box_demo/app.rbs

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

data/sig/examples/widget_calendar_demo/app.rbs

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

data/sig/examples/widget_cell_demo/app.rbs

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

data/sig/examples/widget_chart_demo/app.rbs

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

data/sig/examples/widget_gauge_demo/app.rbs

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

data/sig/examples/widget_layout_split/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetLayoutSplit

data/sig/examples/widget_line_gauge_demo/app.rbs

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

data/sig/examples/widget_list_demo/app.rbs

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

data/sig/examples/widget_map_demo/app.rbs

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

data/sig/examples/widget_popup_demo/app.rbs

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

data/sig/examples/widget_ratatui_logo_demo/app.rbs

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

data/sig/examples/widget_ratatui_mascot_demo/app.rbs

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

data/sig/examples/widget_rect/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetRect

data/sig/examples/widget_render/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetRender

data/sig/examples/widget_rich_text/app.rbs

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

data/sig/examples/widget_scroll_text/app.rbs

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

data/sig/examples/widget_scrollbar_demo/app.rbs

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

data/sig/examples/widget_sparkline_demo/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetSparklineDemo

data/sig/examples/widget_style_colors/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetStyleColors

data/sig/examples/widget_table_demo/app.rbs

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

data/sig/examples/widget_text_width/app.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 class WidgetTextWidth

data/sig/ratatui_ruby/event.rbs

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

data/sig/ratatui_ruby/frame.rbs

@@ -1,10 +1,22 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
 
 module RatatuiRuby
+  # Interface for custom widgets that can be passed to Frame#render_widget.
+  #
+  # Any Ruby object implementing this interface works as a widget.
+  # Return an Array of Draw commands describing what to render.
+  interface _CustomWidget
+    def render: (Rect area) -> Array[Draw::StringCmd | Draw::CellCmd]
+  end
+
   class Frame
     def area: () -> Rect
-    def render_widget: (widget widget, Rect area) -> nil
+    def render_widget: (_CustomWidget | widget widget, Rect area) -> nil
     def render_stateful_widget: (widget widget, Rect area, (ListState | TableState | ScrollbarState) state) -> nil
     def set_cursor_position: (Integer x, Integer y) -> nil
   end

data/sig/ratatui_ruby/list_state.rbs

@@ -1,4 +1,10 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 module RatatuiRuby
@@ -9,5 +15,9 @@ module RatatuiRuby
     def offset: () -> Integer
     def scroll_down_by: (Integer n) -> nil
     def scroll_up_by: (Integer n) -> nil
+    def select_next: () -> nil
+    def select_previous: () -> nil
+    def select_first: () -> nil
+    def select_last: () -> nil
   end
 end

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -1,8 +1,14 @@
-# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 module RatatuiRuby
-  type widget = Paragraph | Layout | List | Gauge | Table | Tabs | BarChart | Block | Sparkline | LineChart
+  type widget = Paragraph | Layout | List | Gauge | Table | Tabs | BarChart | Block | Sparkline
 
   interface _ToS
     def to_s: () -> String