ratatui_ruby 0.4.0 → 0.6.0

data/sig/examples/app_stateful_interaction/app.rbs

@@ -0,0 +1,33 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class AppStatefulInteraction
+  @tables: Array[String]
+  @data: Hash[String, Array[Array[String]]]
+  @list_state: RatatuiRuby::ListState
+  @table_state: RatatuiRuby::TableState
+  @active_pane: :list | :table
+  @tui: untyped
+  @style_active: RatatuiRuby::Style
+  @style_inactive: RatatuiRuby::Style
+  @style_highlight: RatatuiRuby::Style
+  @list_area: RatatuiRuby::Rect
+  @table_area: RatatuiRuby::Rect
+
+  # @public
+  def self.new: () -> AppStatefulInteraction
+
+  # @public
+  def run: () -> void
+
+  private
+
+  def render: () -> void
+  def render_list: (untyped frame, RatatuiRuby::Rect area) -> void
+  def render_table: (untyped frame, RatatuiRuby::Rect area) -> void
+  def handle_input: () -> (:quit | nil)
+  def scroll_active: (Integer delta) -> void
+  def handle_click: (Integer x, Integer y) -> void
+  def handle_list_click: (Integer mouse_y) -> void
+  def handle_table_click: (Integer mouse_y) -> void
+end

data/sig/examples/verify_quickstart_dsl/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class VerifyQuickstartDsl
+  # @public
+  def self.new: () -> VerifyQuickstartDsl
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/verify_quickstart_lifecycle/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class VerifyQuickstartLifecycle
+  # @public
+  def self.new: () -> VerifyQuickstartLifecycle
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/verify_readme_usage/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class VerifyReadmeUsage
+  # @public
+  def self.new: () -> VerifyReadmeUsage
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_block_demo/app.rbs

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+#
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetBlockDemo
+  @tui: RatatuiRuby::Tui
+  @hotkey_style: RatatuiRuby::Style
+  @title_configs: Array[{name: String, title: String?}]
+  @title_index: Integer
+  @titles_configs: Array[{name: String, titles: Array[RatatuiRuby::Block::title_input]}]
+  @titles_index: Integer
+  @alignment_configs: Array[{name: String, alignment: RatatuiRuby::Alignment}]
+  @alignment_index: Integer
+  @title_styles: Array[{name: String, style: RatatuiRuby::Style?}]
+  @title_style_index: Integer
+  @border_configs: Array[{name: String, borders: Array[RatatuiRuby::Block::border_option]}]
+  @border_index: Integer
+  @border_type_configs: Array[{name: String, type: RatatuiRuby::Block::border_type?, set: Hash[Symbol, String]?}]
+  @border_type_index: Integer
+  @border_styles: Array[{name: String, style: RatatuiRuby::Style?}]
+  @border_style_index: Integer
+  @base_styles: Array[{name: String, style: RatatuiRuby::Style?}]
+  @base_style_index: Integer
+  @padding_configs: Array[{name: String, padding: RatatuiRuby::Block::padding_input}]
+  @padding_index: Integer
+
+  def self.new: () -> WidgetBlockDemo
+  def run: () -> void
+  private def render: () -> void
+  private def handle_input: () -> (:quit)?
+end

data/sig/examples/widget_box_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetBoxDemo
+  # @public
+  def self.new: () -> WidgetBoxDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_calendar_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetCalendarDemo
+  # @public
+  def self.new: () -> WidgetCalendarDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_cell_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetCellDemo
+  # @public
+  def self.new: () -> WidgetCellDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_chart_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetChartDemo
+  # @public
+  def self.new: () -> WidgetChartDemo
+
+  # @public
+  def run: () -> void
+end

data/{examples/gauge_demo → sig/examples/widget_gauge_demo}/app.rbs

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
 class SystemMonitorApp
   # @public
   def self.new: () -> SystemMonitorApp

data/sig/examples/widget_layout_split/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetLayoutSplit
+  # @public
+  def self.new: () -> WidgetLayoutSplit
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_line_gauge_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetLineGaugeDemo
+  # @public
+  def self.new: () -> WidgetLineGaugeDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_list_demo/app.rbs

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetListDemo
+  # @public
+  def self.new: () -> WidgetListDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_map_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetMapDemo
+  # @public
+  def self.new: () -> WidgetMapDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_popup_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetPopupDemo
+  # @public
+  def self.new: () -> WidgetPopupDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_ratatui_logo_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRatatuiLogoDemo
+  # @public
+  def self.new: () -> WidgetRatatuiLogoDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_ratatui_mascot_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRatatuiMascotDemo
+  # @public
+  def self.new: () -> WidgetRatatuiMascotDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_rect/app.rbs

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRect
+  MENU_ITEMS: Array[String]
+
+  # @public
+  def self.new: () -> WidgetRect
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_render/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRender
+  # @public
+  def self.new: () -> WidgetRender
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_rich_text/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetRichText
+  # @public
+  def self.new: () -> WidgetRichText
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_scroll_text/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetScrollText
+  # @public
+  def self.new: () -> WidgetScrollText
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_scrollbar_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetScrollbarDemo
+  # @public
+  def self.new: () -> WidgetScrollbarDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_sparkline_demo/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetSparklineDemo
+  # @public
+  def self.new: () -> WidgetSparklineDemo
+
+  # @public
+  def run: () -> void
+end

data/{examples → sig/examples}/widget_style_colors/app.rbs

@@ -1,7 +1,7 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-class ColorGradientDemo
+class WidgetStyleColors
   def initialize: () -> void
   def run: () -> void
 

data/sig/examples/widget_table_demo/app.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetTableDemo
+  # @public
+  def self.new: () -> WidgetTableDemo
+
+  # @public
+  def run: () -> void
+end

data/sig/examples/widget_text_width/app.rbs

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+class WidgetTextWidth
+  # @public
+  def self.new: () -> WidgetTextWidth
+
+  # @public
+  def run: () -> void
+end

data/sig/ratatui_ruby/event.rbs

@@ -11,11 +11,14 @@ module RatatuiRuby
     def focus_lost?: () -> bool
     def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
 
+    type key_kind = :standard | :function | :media | :modifier | :system
+
     class Key < Event
       attr_reader code: String
       attr_reader modifiers: Array[String]
+      attr_reader kind: key_kind
 
-      def initialize: (code: String, modifiers: Array[String]) -> void
+      def initialize: (code: String, ?modifiers: Array[String], ?kind: key_kind) -> void
       def ==: (untyped other) -> bool
       def to_sym: () -> Symbol
       def to_s: () -> String
@@ -24,6 +27,13 @@ module RatatuiRuby
       def alt?: () -> bool
       def shift?: () -> bool
       def text?: () -> bool
+      def char: () -> String
+      def media?: () -> bool
+      def system?: () -> bool
+      def function?: () -> bool
+      def modifier?: () -> bool
+      def standard?: () -> bool
+      def unmodified?: () -> bool
       def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
     end
 

data/sig/ratatui_ruby/frame.rbs

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class Frame
+    def area: () -> Rect
+    def render_widget: (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
+end

data/sig/ratatui_ruby/list_state.rbs

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

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -8,10 +8,11 @@ module RatatuiRuby
     def to_s: () -> String
   end
 
-  def self.init_terminal: () -> void
+  def self.init_terminal: (focus_events: bool, bracketed_paste: bool) -> void
   def self.restore_terminal: () -> void
-  def self.draw: (widget) -> void
-  def self._poll_event: () -> Hash[Symbol, untyped]?
-  def self.poll_event: () -> Event?
+  def self.draw: (widget tree) -> void
+               | () { (Frame) -> void } -> void
+  def self._poll_event: (Float?) -> Hash[Symbol, untyped]?
+  def self.poll_event: (?timeout: Float?) -> Event?
   def self.inject_test_event: (String, Hash[Symbol, untyped]) -> void
 end

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/draw.rbs

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
 module RatatuiRuby
   module Draw
     class StringCmd < Data

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/layout.rbs

@@ -16,6 +16,6 @@ module RatatuiRuby
 
     private
 
-    def self._split: (Rect | Hash[Symbol, Integer], Symbol, Array[Constraint], Symbol) -> Array[Hash[Symbol, Integer]]
+    def self._split: (Rect, Symbol, Array[Constraint], Symbol) -> Array[Hash[Symbol, Integer]]
   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/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], ?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,20 @@ 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
     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