ratatui_ruby 1.4.0-x86_64-linux

data/sig/ratatui_ruby/labs.rbs

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+# RBS type definitions for RatatuiRuby::Labs module
+
+# Dir.tmpdir is from stdlib tmpdir extension
+class Dir
+  def self.tmpdir: () -> String
+end
+
+# Interface for Data.define objects (widgets/nodes with to_h/members)
+interface _DataLike
+  def to_h: () -> Hash[Symbol, Object]
+  def members: () -> Array[Symbol]
+end
+
+# Minimal REXML stubs (no official RBS types available)
+module REXML
+  class Document
+    def self.new: (?untyped?) -> Document
+    def add: (untyped) -> void
+  end
+
+  class Element
+    def self.new: (String) -> Element
+    def add: (untyped) -> void
+    def add_attribute: (String, String) -> void
+    attr_accessor text: String?
+  end
+
+  class XMLDecl
+    def self.new: (String, String) -> XMLDecl
+  end
+
+  module Formatters
+    class Pretty
+      def self.new: (Integer) -> Pretty
+      attr_accessor compact: bool
+      def write: (untyped, untyped) -> void
+    end
+  end
+end
+
+module RatatuiRuby
+  module Labs
+    @enabled_lab: Symbol?
+    @warned: bool
+
+    def self.enabled?: (Symbol lab) -> bool
+    def self.enable!: (Symbol | String lab) -> void
+    def self.reset!: () -> void
+    def self.warn_once!: (String feature_name) -> void
+
+    module A11y
+      OUTPUT_PATH: String
+
+      @rexml_loaded: bool?
+
+      def self.dump_widget_tree: ((_CustomWidget | widget) widget, ?Layout::Rect? area) -> void
+      def self.dump_widgets: (Array[[(_CustomWidget | widget), Layout::Rect]] widgets_with_areas) -> void
+      def self.startup_message: () -> String
+
+      # Private class methods (called via class << self)
+      # Duck-typed serialization accepts any widget/value that may have to_h/members
+      def self.write_document: (REXML::Document doc) -> void
+      def self.build_element_with_area: ((_CustomWidget | widget) widget, Layout::Rect area) -> REXML::Element
+      def self.build_element: (untyped node) -> REXML::Element
+      def self.add_members: (REXML::Element element, untyped node, ?parent_id: String?) -> void
+      def self.scalar?: (untyped value) -> bool
+      def self.build_child_element: (Symbol key, untyped value, ?is_wrapper: bool, ?parent_id: String?) -> REXML::Element
+      def self.ensure_rexml_loaded: () -> void
+    end
+  end
+
+  class Frame
+    prepend A11yCapture
+
+    module A11yCapture
+      @a11y_widgets: Array[[(_CustomWidget | widget), Layout::Rect]]?
+
+      def render_widget: ((_CustomWidget | widget) widget, Layout::Rect area) -> void
+      def render_stateful_widget: (widget widget, Layout::Rect area, Object state) -> void
+      def flush_a11y_capture: () -> void
+    end
+  end
+end

data/sig/ratatui_ruby/layout/alignment.rbs

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Layout
+    module HorizontalAlignment
+      LEFT: :left
+      CENTER: :center
+      RIGHT: :right
+      ALL: Array[:left | :center | :right]
+    end
+
+    module VerticalAlignment
+      TOP: :top
+      CENTER: :center
+      BOTTOM: :bottom
+      ALL: Array[:top | :center | :bottom]
+    end
+
+    Alignment: singleton(HorizontalAlignment)
+  end
+end

data/sig/ratatui_ruby/layout/constraint.rbs

@@ -0,0 +1,39 @@
+# 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
+  module Layout
+    class Constraint < Data
+      attr_reader type: Symbol
+      attr_reader value: (Integer | Array[Integer])
+      def self.length: (_ToI) -> Constraint
+      def self.percentage: (_ToI) -> Constraint
+      def self.min: (_ToI) -> Constraint
+      def self.max: (_ToI) -> Constraint
+      def self.fill: (?_ToI) -> Constraint
+      def self.ratio: (_ToI, _ToI) -> Constraint
+      def self.new: (type: Symbol, value: (Integer | Array[Integer])) -> Constraint
+      def initialize: (type: Symbol, value: (Integer | Array[Integer])) -> void
+
+      # Batch constructors
+      def self.from_lengths: (Enumerable[_ToI]) -> Array[Constraint]
+      def self.from_percentages: (Enumerable[_ToI]) -> Array[Constraint]
+      def self.from_mins: (Enumerable[_ToI]) -> Array[Constraint]
+      def self.from_maxes: (Enumerable[_ToI]) -> Array[Constraint]
+      def self.from_fills: (Enumerable[_ToI]) -> Array[Constraint]
+      def self.from_ratios: (Enumerable[[_ToI, _ToI]]) -> Array[Constraint]
+
+      # Instance methods
+      def apply: (_ToInt) -> Integer
+
+      # Ruby-idiomatic alias
+      alias call apply
+    end
+  end
+end

data/sig/ratatui_ruby/layout/layout.rbs

@@ -0,0 +1,45 @@
+# 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
+  module Layout
+    type flex_mode = Symbol
+
+    class Layout < Data
+      FLEX_MODES: Array[Symbol]
+      DIRECTION_VERTICAL: Symbol
+      DIRECTION_HORIZONTAL: Symbol
+      FLEX_LEGACY: Symbol
+      FLEX_START: Symbol
+      FLEX_CENTER: Symbol
+      FLEX_END: Symbol
+      FLEX_SPACE_BETWEEN: Symbol
+      FLEX_SPACE_AROUND: Symbol
+      FLEX_SPACE_EVENLY: Symbol
+
+      attr_reader direction: Symbol
+      attr_reader constraints: Array[Constraint]
+      attr_reader children: Array[RatatuiRuby::widget]
+      attr_reader flex: flex_mode
+      attr_reader margin: (Integer | Hash[Symbol, Integer])
+      attr_reader spacing: Integer
+      def self.new: (?direction: Symbol, ?constraints: Array[Constraint], ?children: Array[RatatuiRuby::widget], ?flex: flex_mode, ?margin: (Integer | Hash[Symbol, Integer]), ?spacing: Integer) -> Layout
+      def initialize: (?direction: Symbol, ?constraints: Array[Constraint], ?children: Array[RatatuiRuby::widget], ?flex: flex_mode, ?margin: (Integer | Hash[Symbol, Integer]), ?spacing: Integer) -> void
+      def self.split: ((Rect | Hash[Symbol, Integer]) area, ?direction: Symbol, constraints: Array[Constraint], ?flex: flex_mode) -> Array[Rect]
+
+      # Splits an area into segments and spacers.
+      # Returns [segments, spacers] where each is an Array of Rects.
+      def self.split_with_spacers: ((Rect | Hash[Symbol, Integer]) area, ?direction: Symbol, constraints: Array[Constraint], ?flex: flex_mode) -> [Array[Rect], Array[Rect]]
+
+      private
+
+      def self._split: (Rect, Symbol, Array[Constraint], Symbol) -> Array[Hash[Symbol, Integer]]
+    end
+  end
+end

data/sig/ratatui_ruby/layout/position.rbs

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Layout
+    class Position < Data
+      attr_reader x: Integer
+      attr_reader y: Integer
+
+      def self.new: (?x: _ToInt, ?y: _ToInt) -> instance
+      def initialize: (?x: _ToInt, ?y: _ToInt) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/layout/rect.rbs

@@ -0,0 +1,64 @@
+# 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
+  module Layout
+    class Rect < Data
+      attr_reader x: Integer
+      attr_reader y: Integer
+      attr_reader width: Integer
+      attr_reader height: Integer
+
+      def self.new: (?x: _ToI, ?y: _ToI, ?width: _ToI, ?height: _ToI) -> instance
+      def initialize: (?x: _ToI, ?y: _ToI, ?width: _ToI, ?height: _ToI) -> void
+
+      # Predicates
+      def contains?: (Integer px, Integer py) -> bool
+      def intersects?: (Rect other) -> bool
+      def empty?: () -> bool
+
+      # Edge accessors
+      def left: () -> Integer
+      def right: () -> Integer
+      def top: () -> Integer
+      def bottom: () -> Integer
+      def area: () -> Integer
+
+      # Geometry transformations
+      def intersection: (Rect other) -> Rect?
+      def union: (Rect other) -> Rect
+      def inner: (Integer margin) -> Rect
+      def outer: (Integer margin) -> Rect
+      def resize: (Size new_size) -> Rect
+      def offset: (Integer dx, Integer dy) -> Rect
+      def clamp: (Rect other) -> Rect
+
+      # Iterators
+      def rows: () -> Enumerator[Rect, void]
+              | () { (Rect) -> void } -> void
+      def columns: () -> Enumerator[Rect, void]
+                 | () { (Rect) -> void } -> void
+      def positions: () -> Enumerator[[Integer, Integer], void]
+                   | () { ([Integer, Integer]) -> void } -> void
+
+      # Conversions
+      def as_position: () -> Position
+      def as_size: () -> Size
+
+      # Centering
+      def centered_horizontally: (Constraint) -> Rect
+      def centered_vertically: (Constraint) -> Rect
+      def centered: (Constraint, Constraint) -> Rect
+
+      # Ruby-idiomatic aliases
+      alias position as_position
+      alias size as_size
+    end
+  end
+end

data/sig/ratatui_ruby/layout/size.rbs

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Layout
+    class Size < Data
+      attr_reader width: Integer
+      attr_reader height: Integer
+
+      def self.new: (?width: _ToInt, ?height: _ToInt) -> instance
+      def initialize: (?width: _ToInt, ?height: _ToInt) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/list_state.rbs

@@ -0,0 +1,23 @@
+# 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
+  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
+    def select_next: () -> nil
+    def select_previous: () -> nil
+    def select_first: () -> nil
+    def select_last: () -> nil
+  end
+end

data/sig/ratatui_ruby/output_guard.rbs

@@ -0,0 +1,23 @@
+# 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
+  module OutputGuard
+    # Null IO object that discards all output
+    class NullIO
+      def method_missing: (Symbol name, *untyped args) ?{ (*untyped) -> untyped } -> NullIO
+      def respond_to_missing?: (Symbol name, ?bool include_private) -> true
+    end
+
+    def is_headless?: () -> bool
+    def headless!: () -> void
+    def guard_io: [T] () { () -> T } -> T
+    def terminal_active?: () -> bool
+  end
+end

data/sig/ratatui_ruby/ratatui_ruby.rbs

@@ -0,0 +1,113 @@
+# 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
+  # Common type aliases for widget parameters
+  type alignment = :left | :center | :right
+  type border_side = :top | :bottom | :left | :right | :all
+  type border_type = :plain | :rounded | :double | :thick | :hidden | :quadrant_inside | :quadrant_outside
+  type title_position = :top | :bottom
+  type style_input = Style::Style | { ?fg: (Symbol | String | Integer), ?bg: (Symbol | String | Integer), ?modifiers: Array[Symbol] }
+  type title_entry = String | { content: (String | Text::Line), ?alignment: alignment, ?position: title_position, ?style: style_input }
+  type border_set_hash = { ?top_left: String, ?top_right: String, ?bottom_left: String, ?bottom_right: String, ?vertical_left: String, ?vertical_right: String, ?horizontal_top: String, ?horizontal_bottom: String }
+  type date_key = Date | [Integer, Integer, Integer]
+
+  type widget = Widgets::Paragraph | Layout::Layout | Widgets::List | Widgets::Gauge | Widgets::Table | Widgets::Tabs | Widgets::BarChart | Widgets::Block | Widgets::Sparkline
+
+  interface _ToS
+    def to_s: () -> String
+  end
+
+  # Error classes
+  class Error < StandardError
+    class Terminal < Error
+    end
+    class Safety < Error
+    end
+    class Invariant < Error
+    end
+    class Internal < Error
+    end
+  end
+
+  # NullIO for headless mode
+
+
+  # Core module methods
+  def self.init_terminal: (?focus_events: bool, ?bracketed_paste: bool, ?viewport: (Terminal::Viewport | :fullscreen | :inline)?, ?height: Integer?) -> void
+  def self.init_test_terminal: (Integer width, Integer height, ?String viewport_type, ?Integer? viewport_height) -> void
+  def self.restore_terminal: () -> void
+  def self.terminal_active?: () -> bool
+  def self.run: (?focus_events: bool, ?bracketed_paste: bool, ?viewport: (Terminal::Viewport | :fullscreen | :inline)?, ?height: Integer?) { (TUI) -> void } -> void
+  def self.draw: (?widget? tree) -> void
+               | () { (Frame) -> void } -> void
+  # untyped: FFI boundary - Rust returns dynamic event hash with varying keys per event type
+  def self._poll_event: (Float?) -> Hash[Symbol, untyped]?
+  def self.poll_event: (?timeout: Float?) -> Event
+  def self.inject_test_event: ("key", { code: String, ?modifiers: Array[String], ?kind: Event::key_kind }) -> void
+                            | ("mouse", { kind: String, x: Integer, y: Integer, ?button: String, ?modifiers: Array[String] }) -> void
+                            | ("resize", { width: Integer, height: Integer }) -> void
+                            | ("paste", { content: String }) -> void
+                            | ("focus_gained", { }) -> void
+                            | ("focus_lost", { }) -> void
+  def self.get_cell_at: (Integer x, Integer y) -> Buffer::Cell
+  def self.experimental_warnings: () -> bool
+  def self.experimental_warnings=: (bool) -> bool
+  def self.warn_experimental_feature: (String feature_name) -> void
+
+  # Warning queue (private)
+  def self.queue_warning: (String message) -> void
+  def self.flush_warnings: () -> void
+
+  # Panic info (private, for deferred backtrace output)
+  def self._get_last_panic: () -> String?
+  def self.flush_panic_info: () -> void
+
+  # Draw internal
+  def self._draw: (widget) -> void
+               | () { (Frame) -> void } -> void
+
+  # Cell accessor internal (returns Hash with String keys from Rust FFI)
+  def self._get_cell_at: (Integer x, Integer y) -> Hash[String, untyped]
+
+  # Signal handling
+  def self.trap: (String | Symbol signal) { () -> void } -> void
+
+  # Paragraph helpers
+  def self._paragraph_line_count: (Widgets::Paragraph p, Integer width) -> Integer
+  def self._paragraph_line_width: (Widgets::Paragraph p) -> Integer
+
+  # Tabs/Text helpers
+  def self._tabs_width: (Widgets::Tabs t) -> Integer
+  def self._text_width: (String text) -> Integer
+
+  # Debug mode convenience method
+  def self.debug_mode!: () -> void
+
+  # Headless mode
+  def self.headless!: () -> void
+  def self.headless?: () -> bool
+
+  def self._get_terminal_area: () -> Hash[String, Integer]
+  def self.get_viewport_area: () -> RatatuiRuby::Layout::Rect
+  def self.terminal_area: () -> RatatuiRuby::Layout::Rect
+  def self.viewport_area: () -> RatatuiRuby::Layout::Rect
+  def self.get_terminal_size: () -> RatatuiRuby::Layout::Rect
+  def self._get_terminal_size: () -> Hash[String, Integer]
+  def self._get_viewport_type: () -> String
+  def self.insert_before: (Integer height, ?widget? widget) ?{ () -> widget } -> void
+  def self._frame_count: () -> Integer
+  def self.frame_count: () -> Integer
+
+  # Color conversion (internal, Rust FFI)
+  def self._color_from_u32: (Integer) -> String
+  def self._color_from_hsl: (Float, Float, Float) -> String
+  def self._color_from_hsluv: (Float, Float, Float) -> String
+end
+

data/sig/ratatui_ruby/rect.rbs

@@ -0,0 +1,17 @@
+# 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
+
+# NOTE: RatatuiRuby::Rect is not defined at runtime in the main gem.
+# This file exists only to satisfy the build system.
+# The actual Rect class is Layout::Rect in sig/ratatui_ruby/schema/rect.rbs.
+#
+# The schema/ folder structure is pending migration per:
+# doc/contributors/v1.0.0_blockers.md
+
+# Empty placeholder - actual type is RatatuiRuby::Layout::Rect

data/sig/ratatui_ruby/scrollbar_state.rbs

@@ -0,0 +1,24 @@
+# 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
+  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

@@ -0,0 +1,93 @@
+# 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
+
+# !!! DO NOT EDIT THIS FILE BY HAND !!!
+# This file is automatically generated by `rake autodoc:rbs:session`.
+# Any changes will be overwritten.
+
+module RatatuiRuby
+  class Session
+    def self.new: () -> Session
+                | () { (Session) -> void } -> void
+
+    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
+    def experimental_warnings=: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_buffer_content: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_cell_at: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def get_cursor_position: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def init_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def init_test_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def inject_test_event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def poll_event: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def resize_terminal: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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 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
+    def event_key: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_mouse: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    def event_none: (*untyped args, **untyped kwargs) ?{ (*untyped) -> untyped } -> untyped
+    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 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/style/color.rbs

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+module RatatuiRuby
+  module Style
+    module Color
+      def self.from_u32: (Integer) -> String
+      def self.from_hsl: (_ToF, _ToF, _ToF) -> String
+      def self.from_hsluv: (_ToF, _ToF, _ToF) -> String
+
+      # Ruby-idiomatic aliases
+      alias self.hex self.from_u32
+      alias self.hsl self.from_hsl
+      alias self.hsluv self.from_hsluv
+    end
+  end
+end
+

data/sig/ratatui_ruby/style/style.rbs

@@ -0,0 +1,29 @@
+# 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
+  # Style module at RatatuiRuby::Style
+  module Style
+    # Style class for RatatuiRuby::Style::Style
+    class Style < Data
+      type color = String | Symbol | Integer
+
+      attr_reader fg: color?
+      attr_reader bg: color?
+      attr_reader underline_color: color?
+      attr_reader modifiers: Array[Symbol]
+      attr_reader remove_modifiers: Array[Symbol]
+
+      def self.new: (?fg: color?, ?bg: color?, ?underline_color: color?, ?modifiers: Array[Symbol], ?remove_modifiers: Array[Symbol]) -> Style
+      def initialize: (?fg: color?, ?bg: color?, ?underline_color: color?, ?modifiers: Array[Symbol], ?remove_modifiers: Array[Symbol]) -> void
+      def self.default: () -> Style
+      def self.with: (?fg: color?, ?bg: color?, ?underline_color: color?, ?modifiers: Array[Symbol], ?remove_modifiers: Array[Symbol]) -> Style
+    end
+  end
+end