ratatui_ruby 0.6.0 → 0.7.0

data/lib/ratatui_ruby/widgets/table.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module Widgets
+    # Displays structured data in rows and columns.
+    #
+    # Data is often multidimensional. You need to show relationships between fields (Name, Age, ID).
+    # Aligning columns manually in a monospaced environment is painful and error-prone.
+    #
+    # This widget creates a grid. It enforces column widths using constraints. It renders headers, rows, and footers aligned perfectly.
+    #
+    # Use it to display database records, logs, or file lists.
+    #
+    # {rdoc-image:/doc/images/widget_table_flex.png}[link:/examples/widget_table_flex/app_rb.html]
+    #
+    # === Example
+    #
+    # Run the interactive demo from the terminal:
+    #
+    #   ruby examples/widget_table_flex/app.rb
+    class Table < Data.define(:header, :rows, :widths, :row_highlight_style, :highlight_symbol, :highlight_spacing, :column_highlight_style, :cell_highlight_style, :selected_row, :selected_column, :offset, :block, :footer, :flex, :style, :column_spacing)
+      ##
+      # :attr_reader: header
+      # Header row content (Array of Strings, Text::Spans, Text::Lines, or Paragraphs).
+
+      ##
+      # :attr_reader: rows
+      # Data rows (Array of Arrays). Each cell can be String, Text::Span, Text::Line, Paragraph, or Cell.
+
+      ##
+      # :attr_reader: widths
+      # Column width constraints (Array of Constraint).
+
+      ##
+      # :attr_reader: row_highlight_style
+      # Style for the selected row.
+
+      ##
+      # :attr_reader: highlight_symbol
+      # Symbol for the selected row.
+
+      ##
+      # :attr_reader: highlight_spacing
+      # When to show the highlight symbol column (<tt>:always</tt>, <tt>:when_selected</tt>, <tt>:never</tt>).
+
+      ##
+      # :attr_reader: column_highlight_style
+      # Style for the selected column.
+
+      ##
+      # :attr_reader: cell_highlight_style
+      # Style for the selected cell (intersection of row and column).
+
+      ##
+      # :attr_reader: selected_row
+      # Index of the selected row (Integer or nil).
+
+      ##
+      # :attr_reader: selected_column
+      # Index of the selected column (Integer or nil).
+
+      ##
+      # :attr_reader: offset
+      # Scroll offset (Integer or nil).
+      #
+      # Controls the viewport's starting row position in the table.
+      #
+      # When +nil+ (default), Ratatui auto-scrolls to keep the selection visible ("natural scrolling").
+      #
+      # When set, forces the viewport to start at this row index. Use this for:
+      # - **Passive scrolling**: Scroll through a log table without selecting rows.
+      # - **Click-to-select math**: Calculate which row index corresponds to a click coordinate.
+      #
+      # *Important*: When both +offset+ and +selected_row+ are set, Ratatui may still adjust
+      # the viewport during rendering to ensure the selection stays visible. Set +selected_row+
+      # to +nil+ for fully manual scroll control.
+
+      ##
+      # :attr_reader: block
+      # Optional wrapping block.
+
+      ##
+      # :attr_reader: footer
+      # Footer row content (Array of Strings, Text::Spans, Text::Lines, or Paragraphs).
+
+      ##
+      # :attr_reader: flex
+      # Flex mode for column distribution.
+
+      ##
+      # :attr_reader: style
+      # Base style for the entire table.
+
+      ##
+      # :attr_reader: column_spacing
+      # Spacing between columns (Integer, default 1).
+
+      # Creates a new Table.
+      #
+      # [header] Array of strings, Text::Spans, Text::Lines, or paragraphs.
+      # [rows] 2D Array where each cell is String, Text::Span, Text::Line, Paragraph, or Cell.
+      # [widths] Array of Constraints.
+      # [row_highlight_style] Style object.
+      # [highlight_symbol] String.
+      # [highlight_spacing] Symbol (optional, default: <tt>:when_selected</tt>).
+      # [column_highlight_style] Style object.
+      # [cell_highlight_style] Style object.
+      # [selected_row] Integer (nullable).
+      # [selected_column] Integer (nullable).
+      # [offset] Numeric (nullable, coerced to Integer). Forces scroll position when set.
+      # [block] Block (optional).
+      # [footer] Array of strings/paragraphs (optional).
+      # [flex] Symbol (optional, default: <tt>:legacy</tt>).
+      # [style] Style object or Hash (optional).
+      # [column_spacing] Integer (optional, default: 1).
+      def initialize(header: nil, rows: [], widths: [], row_highlight_style: nil, highlight_symbol: "> ", highlight_spacing: :when_selected, column_highlight_style: nil, cell_highlight_style: nil, selected_row: nil, selected_column: nil, offset: nil, block: nil, footer: nil, flex: :legacy, style: nil, column_spacing: 1)
+        super(
+          header:,
+          rows:,
+          widths:,
+          row_highlight_style:,
+          highlight_symbol:,
+          highlight_spacing:,
+          column_highlight_style:,
+          cell_highlight_style:,
+          selected_row: selected_row.nil? ? nil : Integer(selected_row),
+          selected_column: selected_column.nil? ? nil : Integer(selected_column),
+          offset: offset.nil? ? nil : Integer(offset),
+          block:,
+          footer:,
+          flex:,
+          style:,
+          column_spacing: Integer(column_spacing)
+        )
+      end
+    end
+  end
+end

data/lib/ratatui_ruby/widgets/tabs.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  module Widgets
+    # Displays a tab bar for navigation.
+    #
+    # Screen real estate is limited. You cannot show everything at once. Segregating content into views is necessary for complex apps.
+    #
+    # This widget separates dimensions. It displays a row of titles, indicating which view is active.
+    #
+    # Use it at the top of your interface to switch between major modes or contexts.
+    #
+    # {rdoc-image:/doc/images/widget_tabs_demo.png}[link:/examples/widget_tabs_demo/app_rb.html]
+    #
+    # === Example
+    #
+    # Run the interactive demo from the terminal:
+    #
+    #   ruby examples/widget_tabs_demo/app.rb
+    class Tabs < Data.define(:titles, :selected_index, :block, :divider, :highlight_style, :style, :padding_left, :padding_right)
+      ##
+      # :attr_reader: titles
+      # Tab titles (Array of Strings).
+
+      ##
+      # :attr_reader: selected_index
+      # Index of the active tab.
+
+      ##
+      # :attr_reader: block
+      # Optional wrapping block.
+
+      ##
+      # :attr_reader: divider
+      # Separator string between tabs.
+
+      ##
+      # :attr_reader: highlight_style
+      # Style for the selected tab title.
+
+      ##
+      # :attr_reader: style
+      # Base style for the tabs area.
+
+      ##
+      # :attr_reader: padding_left
+      # Left padding for the tabs area (Integer, default: 0).
+
+      ##
+      # :attr_reader: padding_right
+      # Right padding for the tabs area (Integer, default: 0).
+
+      # Creates a new Tabs widget.
+      #
+      # [titles] Array of Strings/Lines.
+      # [selected_index] Integer (default: 0).
+      # [block] Block (optional).
+      # [divider] String (optional).
+      # [highlight_style] Style (optional).
+      # [style] Style (optional).
+      # [padding_left] Integer (default: 0).
+      # [padding_right] Integer (default: 0).
+      def initialize(titles: [], selected_index: 0, block: nil, divider: nil, highlight_style: nil, style: nil, padding_left: 0, padding_right: 0)
+        super(
+          titles:,
+          selected_index: Integer(selected_index),
+          block:,
+          divider:,
+          highlight_style:,
+          style:,
+          padding_left: Integer(padding_left),
+          padding_right: Integer(padding_right)
+        )
+      end
+
+      # Returns the total width of the tabs.
+      def width
+        RatatuiRuby._tabs_width(self)
+      end
+    end
+  end
+end

data/lib/ratatui_ruby/widgets.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Widget classes for building terminal UIs.
+  #
+  # This module mirrors +ratatui::widgets+ and contains all renderable
+  # widget types: Block, Paragraph, List, Table, Gauge, Chart, etc.
+  module Widgets
+  end
+end
+
+# Core widgets
+require_relative "widgets/block"
+require_relative "widgets/paragraph"
+require_relative "widgets/list"
+require_relative "widgets/list_item"
+require_relative "widgets/table"
+require_relative "widgets/row"
+require_relative "widgets/cell"
+require_relative "widgets/tabs"
+require_relative "widgets/gauge"
+require_relative "widgets/line_gauge"
+require_relative "widgets/sparkline"
+require_relative "widgets/bar_chart"
+require_relative "widgets/bar_chart/bar"
+require_relative "widgets/bar_chart/bar_group"
+require_relative "widgets/chart"
+require_relative "widgets/scrollbar"
+require_relative "widgets/calendar"
+require_relative "widgets/canvas"
+require_relative "widgets/clear"
+require_relative "widgets/cursor"
+require_relative "widgets/overlay"
+require_relative "widgets/center"
+require_relative "widgets/ratatui_logo"
+require_relative "widgets/ratatui_mascot"
+require_relative "widgets/shape/label"

data/lib/ratatui_ruby.rb

@@ -4,42 +4,27 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 require_relative "ratatui_ruby/version"
-require_relative "ratatui_ruby/schema/rect"
-require_relative "ratatui_ruby/schema/paragraph"
-require_relative "ratatui_ruby/schema/layout"
-require_relative "ratatui_ruby/schema/block"
-require_relative "ratatui_ruby/schema/constraint"
-require_relative "ratatui_ruby/schema/list"
-require_relative "ratatui_ruby/schema/list_item"
-require_relative "ratatui_ruby/schema/style"
-require_relative "ratatui_ruby/schema/gauge"
-require_relative "ratatui_ruby/schema/line_gauge"
-require_relative "ratatui_ruby/schema/table"
-require_relative "ratatui_ruby/schema/tabs"
-require_relative "ratatui_ruby/schema/bar_chart"
-require_relative "ratatui_ruby/schema/bar_chart/bar"
-require_relative "ratatui_ruby/schema/bar_chart/bar_group"
-require_relative "ratatui_ruby/schema/sparkline"
-require_relative "ratatui_ruby/schema/chart"
-require_relative "ratatui_ruby/schema/clear"
-require_relative "ratatui_ruby/schema/cursor"
-require_relative "ratatui_ruby/schema/overlay"
-require_relative "ratatui_ruby/schema/center"
-require_relative "ratatui_ruby/schema/scrollbar"
-require_relative "ratatui_ruby/schema/canvas"
-require_relative "ratatui_ruby/schema/shape/label"
-require_relative "ratatui_ruby/schema/calendar"
-require_relative "ratatui_ruby/schema/ratatui_logo"
-require_relative "ratatui_ruby/schema/ratatui_mascot"
-require_relative "ratatui_ruby/schema/text"
-require_relative "ratatui_ruby/schema/draw"
+
+# New modularized structure (mirrors ratatui Rust crate)
+require_relative "ratatui_ruby/layout"   # Layout::Rect, Layout::Constraint, Layout::Layout
+require_relative "ratatui_ruby/style"    # Style::Style
+require_relative "ratatui_ruby/widgets"  # Widgets::Block, Widgets::Paragraph, etc.
+require_relative "ratatui_ruby/buffer"   # Buffer::Cell (for inspection)
+require_relative "ratatui_ruby/schema/text"  # Text::Span, Text::Line
+require_relative "ratatui_ruby/schema/draw"  # Draw commands
+
+# Event types
 require_relative "ratatui_ruby/event"
-require_relative "ratatui_ruby/cell"
+
+# Frame and state objects
 require_relative "ratatui_ruby/frame"
 require_relative "ratatui_ruby/list_state"
 require_relative "ratatui_ruby/table_state"
 require_relative "ratatui_ruby/scrollbar_state"
 
+# TUI facade (for external instantiation and caching)
+require_relative "ratatui_ruby/tui"
+
 begin
   require "ratatui_ruby/ratatui_ruby"
 rescue LoadError
@@ -129,19 +114,19 @@ module RatatuiRuby
   # pass a block to manipulate the frame directly. The block receives a
   # {Frame} object for imperative drawing.
   #
-  # [tree] A widget tree (Paragraph, Layout, etc.) to render. Optional if
+  # [tree] A widget tree (Widgets::Paragraph, Layout::Layout, etc.) to render. Optional if
   #        a block is given.
   #
   # === Examples
   #
   # Legacy declarative style (tree-based):
   #
-  #   RatatuiRuby.draw(Paragraph.new(text: "Hello"))
+  #   RatatuiRuby.draw(Widgets::Paragraph.new(text: "Hello"))
   #
   # New imperative style (block-based):
   #
   #   RatatuiRuby.draw do |frame|
-  #     frame.render_widget(Paragraph.new(text: "Hello"), frame.area)
+  #     frame.render_widget(Widgets::Paragraph.new(text: "Hello"), frame.area)
   #   end
   #
   def self.draw(tree = nil, &block)
@@ -227,7 +212,7 @@ module RatatuiRuby
   #
   # Managing generic setup/teardown (raw mode, alternate screen) manualy is error-prone. If your app crashes, the terminal might be left in a broken state.
   #
-  # This method handles the safety net. It initializes the terminal, yields a {Session}, and ensures the terminal state is restored even if exceptions occur.
+  # This method handles the safety net. It initializes the terminal, yields a {TUI}, and ensures the terminal state is restored even if exceptions occur.
   #
   # === Example
   #
@@ -236,9 +221,8 @@ module RatatuiRuby
   #     sleep 1
   #   end
   def self.run(focus_events: true, bracketed_paste: true)
-    require_relative "ratatui_ruby/session"
     init_terminal(focus_events:, bracketed_paste:)
-    yield Session.new
+    yield TUI.new
   ensure
     restore_terminal
   end
@@ -249,7 +233,7 @@ module RatatuiRuby
   # When writing tests, you need to verify that your widget drew the correct characters and styles.
   # This method provides deep inspection of the cell's state (symbol, colors, modifiers).
   #
-  # Returns a {Cell} object.
+  # Returns a {Buffer::Cell} object.
   #
   # Values depend on what the backend has rendered. If nothing has been rendered to a cell, it may contain defaults (empty symbol, nil colors).
   #
@@ -262,7 +246,7 @@ module RatatuiRuby
   #
   def self.get_cell_at(x, y)
     raw = _get_cell_at(x, y)
-    Cell.new(
+    Buffer::Cell.new(
       char: raw["char"],
       fg: raw["fg"],
       bg: raw["bg"],
@@ -274,5 +258,5 @@ module RatatuiRuby
   private_class_method :_get_cell_at
 
   # Hide native Layout._split helper
-  Layout.singleton_class.__send__(:private, :_split)
+  Layout::Layout.singleton_class.__send__(:private, :_split)
 end

data/sig/examples/app_all_events/view.rbs

@@ -3,6 +3,6 @@
 
 module View
   interface _View
-    def call(state: ViewState, tui: RatatuiRuby::Session, frame: RatatuiRuby::Frame, area: RatatuiRuby::Rect) -> void
+    def call(state: ViewState, tui: RatatuiRuby::TUI, frame: RatatuiRuby::Frame, area: RatatuiRuby::Rect) -> void
   end
 end

data/sig/examples/app_all_events/view_state.rbs

@@ -10,6 +10,6 @@ class ViewState < Data
   attr_reader border_color: Symbol
   attr_reader area: RatatuiRuby::Rect?
 
-  def self.build(events: Events, focused: bool, tui: RatatuiRuby::Session, _resize_sub_counter: untyped) -> instance
+  def self.build(events: Events, focused: bool, tui: RatatuiRuby::TUI, _resize_sub_counter: untyped) -> instance
   def self.new: (?events: Events, ?focused: bool, ?hotkey_style: RatatuiRuby::Style, ?dimmed_style: RatatuiRuby::Style, ?lit_style: RatatuiRuby::Style, ?border_color: Symbol, ?area: RatatuiRuby::Rect | nil) -> instance
 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/table.rbs

@@ -16,7 +16,7 @@ module RatatuiRuby
     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?, ?offset: 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

@@ -17,6 +17,7 @@ module RatatuiRuby
 
       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

data/sig/ratatui_ruby/session.rbs

@@ -29,30 +29,6 @@ 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
@@ -69,39 +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 list_item: (*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 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 scrollbar_state: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
     def scrollbar_state_new: (*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 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 tabs: (*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/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