ratatui_ruby 0.5.0 → 0.7.0

data/sig/ratatui_ruby/schema/bar_chart/bar.rbs

@@ -5,12 +5,12 @@ module RatatuiRuby
   class BarChart
     class Bar < Data
       attr_reader value: Integer
-      attr_reader label: String?
+      attr_reader label: (String | Text::Span | Text::Line)?
       attr_reader style: Style?
       attr_reader value_style: Style?
-      attr_reader text_value: String?
+      attr_reader text_value: (String | Text::Span | Text::Line)?
 
-      def self.new: (value: Numeric, ?label: String?, ?style: Style?, ?value_style: Style?, ?text_value: String?) -> Bar
+      def self.new: (value: Numeric, ?label: String | Text::Span | Text::Line | nil, ?style: Style?, ?value_style: Style?, ?text_value: String | Text::Span | Text::Line | nil) -> Bar
     end
   end
 end

data/sig/ratatui_ruby/schema/gauge.rbs

@@ -4,12 +4,12 @@
 module RatatuiRuby
   class Gauge < Data
     attr_reader ratio: Float
-    attr_reader label: String?
+    attr_reader label: (String | Text::Span)?
     attr_reader style: Style?
     attr_reader gauge_style: Style?
     attr_reader block: Block?
 
     attr_reader use_unicode: bool
-    def self.new: (?ratio: Numeric?, ?percent: Numeric?, ?label: String?, ?style: Style?, ?gauge_style: Style?, ?block: Block?, ?use_unicode: bool) -> Gauge
+    def self.new: (?ratio: Numeric?, ?percent: Numeric?, ?label: String | Text::Span | nil, ?style: Style?, ?gauge_style: Style?, ?block: Block?, ?use_unicode: bool) -> Gauge
   end
 end

data/sig/ratatui_ruby/schema/line_gauge.rbs

@@ -4,13 +4,13 @@
 module RatatuiRuby
   class LineGauge < Data
     attr_reader ratio: Float
-    attr_reader label: String?
+    attr_reader label: (String | Text::Span)?
     attr_reader filled_style: Style?
     attr_reader unfilled_style: Style?
     attr_reader block: Block?
     attr_reader filled_symbol: String
     attr_reader unfilled_symbol: String
 
-    def self.new: (?ratio: Numeric, ?label: String?, ?style: Style?, ?filled_style: Style?, ?unfilled_style: Style?, ?block: Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> LineGauge
+    def self.new: (?ratio: Numeric, ?label: String | Text::Span | nil, ?style: Style?, ?filled_style: Style?, ?unfilled_style: Style?, ?block: Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> LineGauge
   end
 end

data/sig/ratatui_ruby/schema/list.rbs

@@ -3,8 +3,9 @@
 
 module RatatuiRuby
   class List < Data
-    attr_reader items: Array[String]
+    attr_reader items: Array[String | Text::Span | Text::Line | ListItem]
     attr_reader selected_index: Integer?
+    attr_reader offset: Integer?
     attr_reader style: Style?
     attr_reader highlight_style: Style?
     attr_reader highlight_symbol: String?
@@ -13,6 +14,7 @@ module RatatuiRuby
     attr_reader direction: Symbol
     attr_reader scroll_padding: Integer?
     attr_reader block: Block?
-    def self.new: (?items: Array[String], ?selected_index: Numeric?, ?style: Style?, ?highlight_style: Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: Numeric?, ?block: Block?) -> List
+    def self.new: (?items: Array[String | Text::Span | Text::Line | ListItem], ?selected_index: Numeric?, ?offset: Numeric?, ?style: Style?, ?highlight_style: Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: Numeric?, ?block: Block?) -> List
   end
 end
+

data/sig/ratatui_ruby/schema/list_item.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class ListItem < Data
+    attr_reader content: String | Text::Span | Text::Line
+    attr_reader style: Style?
+    def self.new: (content: String | Text::Span | Text::Line, ?style: Style?) -> ListItem
+  end
+end

data/sig/ratatui_ruby/schema/rect.rbs

@@ -11,5 +11,8 @@ module RatatuiRuby
     attr_reader height: Integer
     def self.new: (?x: Numeric, ?y: Numeric, ?width: Numeric, ?height: Numeric) -> instance
     def contains?: (Integer px, Integer py) -> bool
+    def intersects?: (Rect other) -> bool
+    def intersection: (Rect other) -> Rect?
   end
 end
+

data/sig/ratatui_ruby/schema/row.rbs

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class Row < Data
+    type cell_content = String | Text::Span | Text::Line | Paragraph | Cell
+
+    attr_reader cells: Array[cell_content]
+    attr_reader style: Style?
+    attr_reader height: Integer?
+    attr_reader top_margin: Integer?
+    attr_reader bottom_margin: Integer?
+
+    def self.new: (
+      cells: Array[cell_content],
+      ?style: Style?,
+      ?height: Integer?,
+      ?top_margin: Integer?,
+      ?bottom_margin: Integer?
+    ) -> Row
+  end
+end

data/sig/ratatui_ruby/schema/style.rbs

@@ -3,11 +3,11 @@
 
 module RatatuiRuby
   class Style < Data
-    attr_reader fg: (String | Symbol)?
-    attr_reader bg: (String | Symbol)?
+    attr_reader fg: (String | Symbol | Integer)?
+    attr_reader bg: (String | Symbol | Integer)?
     attr_reader modifiers: Array[Symbol]
 
-    def self.new: (?fg: (String | Symbol)?, ?bg: (String | Symbol)?, ?modifiers: Array[Symbol]) -> Style
+    def self.new: (?fg: (String | Symbol | Integer)?, ?bg: (String | Symbol | Integer)?, ?modifiers: Array[Symbol]) -> Style
     def self.default: () -> Style
   end
 end

data/sig/ratatui_ruby/schema/table.rbs

@@ -14,7 +14,9 @@ module RatatuiRuby
     attr_reader highlight_spacing: Symbol
     attr_reader column_highlight_style: Style?
     attr_reader selected_column: Integer?
+    attr_reader offset: Integer?
 
-    def self.new: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style | _ToS]], ?widths: Array[Constraint], ?highlight_style: Style?, ?highlight_symbol: String, ?highlight_spacing: Symbol, ?column_highlight_style: Style?, ?cell_highlight_style: Style?, ?selected_row: Numeric?, ?selected_column: Numeric?, ?block: Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: (Style | Hash[Symbol, untyped])?, ?column_spacing: Numeric) -> Table
+    def self.new: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style | _ToS]], ?widths: Array[Constraint], ?row_highlight_style: Style?, ?highlight_symbol: String, ?highlight_spacing: Symbol, ?column_highlight_style: Style?, ?cell_highlight_style: Style?, ?selected_row: Numeric?, ?selected_column: Numeric?, ?offset: Numeric?, ?block: Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: (Style | Hash[Symbol, untyped])?, ?column_spacing: Numeric) -> Table
   end
 end
+

data/sig/ratatui_ruby/schema/text.rbs

@@ -5,18 +5,21 @@ module RatatuiRuby
   module Text
     class Span < Data
       attr_reader content: String
-      attr_reader style: Style?
+      attr_reader style: Style | nil
 
-      def self.new: (content: String, ?style: Style?) -> Span
-      def self.styled: (String, ?Style?) -> Span
+      def initialize: (content: String, style: Style | nil) -> void
+      def self.styled: (String, Style | nil) -> Span
     end
 
     class Line < Data
       attr_reader spans: Array[Span]
-      attr_reader alignment: (:left | :center | :right)?
+      attr_reader alignment: Symbol | nil
 
-      def self.new: (?spans: Array[Span], ?alignment: (:left | :center | :right)?) -> Line
-      def self.from_string: (String, ?alignment: (:left | :center | :right)?) -> Line
+      def initialize: (spans: Array[Span], alignment: Symbol | nil) -> void
+      def self.from_string: (String, alignment: Symbol | nil) -> Line
+      def width: () -> Integer
     end
+
+    def self.width: (String) -> Integer
   end
 end

data/sig/ratatui_ruby/scrollbar_state.rbs

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class ScrollbarState
+    def self.new: (Integer content_length) -> ScrollbarState
+    def position: () -> Integer
+    def position=: (Integer value) -> Integer
+    def content_length: () -> Integer
+    def content_length=: (Integer value) -> Integer
+    def viewport_content_length: () -> Integer
+    def viewport_content_length=: (Integer value) -> Integer
+    def first: () -> nil
+    def last: () -> nil
+    def next: () -> nil
+    def prev: () -> nil
+  end
+end

data/sig/ratatui_ruby/session.rbs

@@ -13,6 +13,7 @@ module RatatuiRuby
     def _paragraph_line_count: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def _paragraph_line_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def _tabs_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def _text_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def clear_events: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def experimental_warnings: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -28,33 +29,13 @@ module RatatuiRuby
     def restore_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def run: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def warn_experimental_feature: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def axis: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def bar_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def bar_chart_bar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def bar_chart_bar_group: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def block: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def calendar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def canvas: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cell: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cell_char: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cell_default: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cell_empty: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cell_symbol: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def center: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def clear: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_fill: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_length: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_max: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_min: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_percentage: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def constraint_ratio: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def cursor: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def dataset: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def draw_cell: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def draw_string: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw_cell_cmd: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def draw_string_cmd: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def error: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def error_safety: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def error_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event_focus_gained: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event_focus_lost: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
@@ -64,31 +45,43 @@ module RatatuiRuby
     def event_paste: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def event_resize: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def frame: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def layout: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def layout_split: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def line_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def line_gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def list: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def overlay: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def paragraph: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def paragraph_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def ratatui_logo: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def ratatui_mascot: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def rect: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def scrollbar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_circle: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_label: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_line: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_map: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_point: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def shape_rectangle: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def sparkline: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def style: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def style_default: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def table: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
-    def tabs: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def layout_constraint: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def layout_layout: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def layout_rect: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def list_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def list_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def scrollbar_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def scrollbar_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def style_style: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def table_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def table_state_new: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def text_width: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def text_line: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def text_span: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_axis: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_bar_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_block: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_calendar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_canvas: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_cell: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_center: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_clear: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_cursor: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_dataset: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_line_chart: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_line_gauge: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_list: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_list_item: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_overlay: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_paragraph: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_ratatui_logo: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_ratatui_mascot: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_row: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_scrollbar: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_sparkline: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_table: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def widgets_tabs: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
   end
 end

data/sig/ratatui_ruby/table_state.rbs

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TableState
+    def self.new: (?Integer? selected) -> TableState
+    def select: (Integer? index) -> nil
+    def selected: () -> Integer?
+    def select_column: (Integer? index) -> nil
+    def selected_column: () -> Integer?
+    def offset: () -> Integer
+    def scroll_down_by: (Integer n) -> nil
+    def scroll_up_by: (Integer n) -> nil
+  end
+end

data/sig/ratatui_ruby/test_helper/event_injection.rbs

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module EventInjection
+      def inject_event: (Event::Base event) -> void
+      def inject_mouse: (x: Integer, y: Integer, ?kind: Symbol, ?modifiers: Array[String], ?button: Symbol) -> void
+      def inject_click: (x: Integer, y: Integer, ?modifiers: Array[String]) -> void
+      def inject_right_click: (x: Integer, y: Integer, ?modifiers: Array[String]) -> void
+      def inject_drag: (x: Integer, y: Integer, ?modifiers: Array[String], ?button: Symbol) -> void
+      def inject_keys: (*(String | Symbol | (Hash[Symbol, untyped]) | Event::Key) args) -> void
+      alias inject_key inject_keys
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/snapshot.rbs

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module Snapshot
+      def assert_snapshot: (String name, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+      def assert_screen_matches: (String | Array[String] expected, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+      def assert_rich_snapshot: (String name, ?String? msg) ?{ (Array[String]) -> Array[String] } -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/style_assertions.rbs

@@ -0,0 +1,64 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module StyleAssertions
+      def assert_cell_style: (Integer x, Integer y, **untyped expected_attributes) -> void
+      def assert_color: (Symbol | Integer | String expected, x: Integer, y: Integer, ?layer: Symbol) -> void
+      def assert_area_style: (Rect | Hash[Symbol, Integer] area, **untyped attributes) -> void
+      def assert_fg_color: (Symbol | Integer | String expected, Integer x, Integer y) -> void
+      alias assert_fg assert_fg_color
+      def assert_bg_color: (Symbol | Integer | String expected, Integer x, Integer y) -> void
+      alias assert_bg assert_bg_color
+      def assert_bold: (Integer x, Integer y) -> void
+      def assert_italic: (Integer x, Integer y) -> void
+      def assert_underlined: (Integer x, Integer y) -> void
+      alias assert_underline assert_underlined
+      def assert_dim: (Integer x, Integer y) -> void
+      def assert_reversed: (Integer x, Integer y) -> void
+      alias assert_inverse assert_reversed
+      alias assert_inverse_video assert_reversed
+      def assert_crossed_out: (Integer x, Integer y) -> void
+      alias assert_strikethrough assert_crossed_out
+      alias assert_strike assert_crossed_out
+      def assert_hidden: (Integer x, Integer y) -> void
+      def assert_slow_blink: (Integer x, Integer y) -> void
+      alias assert_blink assert_slow_blink
+      def assert_rapid_blink: (Integer x, Integer y) -> void
+
+      def assert_black: (Integer x, Integer y) -> void
+      def assert_bg_black: (Integer x, Integer y) -> void
+      def assert_red: (Integer x, Integer y) -> void
+      def assert_bg_red: (Integer x, Integer y) -> void
+      def assert_green: (Integer x, Integer y) -> void
+      def assert_bg_green: (Integer x, Integer y) -> void
+      def assert_yellow: (Integer x, Integer y) -> void
+      def assert_bg_yellow: (Integer x, Integer y) -> void
+      def assert_blue: (Integer x, Integer y) -> void
+      def assert_bg_blue: (Integer x, Integer y) -> void
+      def assert_magenta: (Integer x, Integer y) -> void
+      def assert_bg_magenta: (Integer x, Integer y) -> void
+      def assert_cyan: (Integer x, Integer y) -> void
+      def assert_bg_cyan: (Integer x, Integer y) -> void
+      def assert_gray: (Integer x, Integer y) -> void
+      def assert_bg_gray: (Integer x, Integer y) -> void
+      def assert_dark_gray: (Integer x, Integer y) -> void
+      def assert_bg_dark_gray: (Integer x, Integer y) -> void
+      def assert_light_red: (Integer x, Integer y) -> void
+      def assert_bg_light_red: (Integer x, Integer y) -> void
+      def assert_light_green: (Integer x, Integer y) -> void
+      def assert_bg_light_green: (Integer x, Integer y) -> void
+      def assert_light_yellow: (Integer x, Integer y) -> void
+      def assert_bg_light_yellow: (Integer x, Integer y) -> void
+      def assert_light_blue: (Integer x, Integer y) -> void
+      def assert_bg_light_blue: (Integer x, Integer y) -> void
+      def assert_light_magenta: (Integer x, Integer y) -> void
+      def assert_bg_light_magenta: (Integer x, Integer y) -> void
+      def assert_light_cyan: (Integer x, Integer y) -> void
+      def assert_bg_light_cyan: (Integer x, Integer y) -> void
+      def assert_white: (Integer x, Integer y) -> void
+      def assert_bg_white: (Integer x, Integer y) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/terminal.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module Terminal
+      def with_test_terminal: (?Integer width, ?Integer height, ?timeout: Integer?) ?{ () -> void } -> void
+      def buffer_content: () -> Array[String]
+      def cursor_position: () -> { x: Integer, y: Integer }
+      def get_cell: (Integer x, Integer y) -> Cell
+      def print_buffer: () -> void
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper/test_doubles.rbs

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module TestHelper
+    module TestDoubles
+      class MockFrame < Data
+        attr_accessor rendered_widgets: Array[{ widget: untyped, area: Rect }]
+        def self.new: (?rendered_widgets: Array[{ widget: untyped, area: Rect }]) -> MockFrame
+        def render_widget: (untyped widget, Rect area) -> void
+      end
+
+      class StubRect < Data
+        attr_accessor x: Integer
+        attr_accessor y: Integer
+        attr_accessor width: Integer
+        attr_accessor height: Integer
+        def self.new: (?x: Integer, ?y: Integer, ?width: Integer, ?height: Integer) -> StubRect
+      end
+    end
+  end
+end

data/sig/ratatui_ruby/test_helper.rbs

@@ -3,9 +3,10 @@
 
 module RatatuiRuby
   module TestHelper
-    def with_test_terminal: (?Integer width, ?Integer height) { () -> void } -> void
-    def buffer_content: () -> Array[String]
-    def cursor_position: () -> { x: Integer, y: Integer }
-    def inject_event: (String event_type, Hash[Symbol, untyped] data) -> void
+    include Terminal
+    include Snapshot
+    include EventInjection
+    include StyleAssertions
+    include TestDoubles
   end
 end

data/sig/ratatui_ruby/tui/buffer_factories.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module BufferFactories
+      def cell: (?char: String?, ?fg: Symbol?, ?bg: Symbol?, ?modifiers: Array[Symbol]?) -> Buffer::Cell
+    end
+  end
+end

data/sig/ratatui_ruby/tui/canvas_factories.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module CanvasFactories
+      def shape_map: (**top) -> Widgets::Shape::Map
+      def shape_line: (**top) -> Widgets::Shape::Line
+      def shape_point: (**top) -> Widgets::Shape::Point
+      def shape_circle: (**top) -> Widgets::Shape::Circle
+      def shape_rectangle: (**top) -> Widgets::Shape::Rectangle
+    end
+  end
+end

data/sig/ratatui_ruby/tui/core.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module Core
+      def draw: (?Widgets::_Widget? tree) -> void
+              | () { (Frame) -> void } -> void
+      def poll_event: (?timeout: Float) -> Event::event
+      def get_cell_at: (Integer x, Integer y) -> Buffer::Cell
+      def draw_cell: (Integer x, Integer y, Buffer::Cell cell) -> Draw::CellCmd
+    end
+  end
+end

data/sig/ratatui_ruby/tui/layout_factories.rbs

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module LayoutFactories
+      def rect: (?x: Integer, ?y: Integer, ?width: Integer, ?height: Integer) -> Layout::Rect
+      def constraint: (**top) -> Layout::Constraint
+      def constraint_length: (Integer n) -> Layout::Constraint
+      def constraint_percentage: (Integer n) -> Layout::Constraint
+      def constraint_min: (Integer n) -> Layout::Constraint
+      def constraint_max: (Integer n) -> Layout::Constraint
+      def constraint_fill: (?Integer n) -> Layout::Constraint
+      def constraint_ratio: (Integer numerator, Integer denominator) -> Layout::Constraint
+      def layout: (**top) -> Layout::Layout
+      def layout_split: (Layout::Rect area, ?direction: Symbol, constraints: Array[Layout::Constraint], ?flex: Symbol) -> Array[Layout::Rect]
+    end
+  end
+end

data/sig/ratatui_ruby/tui/state_factories.rbs

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module StateFactories
+      def list_state: (**top) -> ListState
+      def table_state: (**top) -> TableState
+      def scrollbar_state: (**top) -> ScrollbarState
+    end
+  end
+end

data/sig/ratatui_ruby/tui/style_factories.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module StyleFactories
+      def style: (?fg: Symbol?, ?bg: Symbol?, ?modifiers: Array[Symbol]?) -> Style::Style
+    end
+  end
+end

data/sig/ratatui_ruby/tui/text_factories.rbs

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module TextFactories
+      def text_span: (?content: String, ?style: Style::Style?) -> Text::Span
+      def span: (?content: String, ?style: Style::Style?) -> Text::Span
+      def text_line: (?spans: Array[Text::Span], ?alignment: Symbol?) -> Text::Line
+      def line: (?spans: Array[Text::Span], ?alignment: Symbol?) -> Text::Line
+      def text_width: (String string) -> Integer
+    end
+  end
+end

data/sig/ratatui_ruby/tui/widget_factories.rbs

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module WidgetFactories
+      def block: (**top) -> Widgets::Block
+      def paragraph: (**top) -> Widgets::Paragraph
+      def list: (**top) -> Widgets::List
+      def list_item: (**top) -> Widgets::ListItem
+      def table: (**top) -> Widgets::Table
+      def row: (**top) -> Widgets::Row
+      def table_row: (**top) -> Widgets::Row
+      def table_cell: (**top) -> Widgets::Cell
+      def tabs: (**top) -> Widgets::Tabs
+      def gauge: (**top) -> Widgets::Gauge
+      def line_gauge: (**top) -> Widgets::LineGauge
+      def sparkline: (**top) -> Widgets::Sparkline
+      def bar_chart: (**top) -> Widgets::BarChart
+      def bar: (**top) -> Widgets::BarChart::Bar
+      def bar_group: (**top) -> Widgets::BarChart::BarGroup
+      def bar_chart_bar: (**top) -> Widgets::BarChart::Bar
+      def bar_chart_bar_group: (**top) -> Widgets::BarChart::BarGroup
+      def chart: (**top) -> Widgets::Chart
+      def dataset: (**top) -> Widgets::Dataset
+      def axis: (**top) -> Widgets::Axis
+      def scrollbar: (**top) -> Widgets::Scrollbar
+      def calendar: (**top) -> Widgets::Calendar
+      def canvas: (**top) -> Widgets::Canvas
+      def clear: (**top) -> Widgets::Clear
+      def cursor: (**top) -> Widgets::Cursor
+      def overlay: (**top) -> Widgets::Overlay
+      def center: (**top) -> Widgets::Center
+      def ratatui_logo: (**top) -> Widgets::RatatuiLogo
+      def ratatui_mascot: (**top) -> Widgets::RatatuiMascot
+      def shape_label: (**top) -> Widgets::Shape::Label
+    end
+  end
+end

data/sig/ratatui_ruby/tui.rbs

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Terminal User Interface facade providing a concise DSL for building TUI applications.
+  #
+  # Combines all factory mixins to provide convenient access to widgets, layouts,
+  # styles, and terminal operations without verbose class name qualification.
+  class TUI
+    include Core
+    include LayoutFactories
+    include StyleFactories
+    include WidgetFactories
+    include TextFactories
+    include StateFactories
+    include CanvasFactories
+    include BufferFactories
+  end
+end