ratatui_ruby 1.4.0-x86_64-linux

data/sig/ratatui_ruby/widgets/coerceable_widget.rbs

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+
+module RatatuiRuby
+  module Widgets
+    # Mixin that provides DWIM hash coercion for widget classes.
+    #
+    # When users call `tui.table(hash)` instead of `tui.table(**hash)`,
+    # this mixin detects the bare hash and automatically splats it.
+    #
+    # This module is designed to be included in Data subclasses.
+    # The coerce_args method is typed per-widget rather than generically
+    # here because RBS cannot express "self.new" in module ClassMethods.
+    module CoerceableWidget
+      KNOWN_KEYS: Array[Symbol]
+
+      # Class methods extended onto widget classes.
+      # Each widget class provides its own typed coerce_args signature.
+      module ClassMethods
+      end
+
+      # Called when the module is included; extends ClassMethods.
+      def self.included: (Class base) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/gauge.rbs

@@ -0,0 +1,44 @@
+# 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 Widgets
+    # Options hash type for Gauge constructor arguments.
+    type gauge_options = {
+      ?ratio: _ToF?,
+      ?percent: _ToF?,
+      ?label: String | Text::Span | nil,
+      ?style: Style::Style?,
+      ?gauge_style: Style::Style?,
+      ?block: Widgets::Block?,
+      ?use_unicode: bool
+    }
+
+    class Gauge < Data
+      attr_reader ratio: Float
+      attr_reader label: (String | Text::Span)?
+      attr_reader style: Style::Style?
+      attr_reader gauge_style: Style::Style?
+      attr_reader block: Widgets::Block?
+      attr_reader use_unicode: bool
+
+      include CoerceableWidget
+
+      def self.coerce_args: (gauge_options first, ?gauge_options kwargs) -> Gauge
+                          | (nil first, gauge_options kwargs) -> Gauge
+
+      def self.new: (?ratio: _ToF?, ?percent: _ToF?, ?label: String | Text::Span | nil, ?style: Style::Style?, ?gauge_style: Style::Style?, ?block: Widgets::Block?, ?use_unicode: bool) -> Gauge
+      def initialize: (?ratio: _ToF?, ?percent: _ToF?, ?label: String | Text::Span | nil, ?style: Style::Style?, ?gauge_style: Style::Style?, ?block: Widgets::Block?, ?use_unicode: bool) -> void
+
+      def filled?: () -> bool
+      def complete?: () -> bool
+      def percent: () -> Integer
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/line_gauge.rbs

@@ -0,0 +1,48 @@
+# 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 Widgets
+    # Options hash type for LineGauge constructor arguments.
+    type line_gauge_options = {
+      ?ratio: _ToF?,
+      ?percent: _ToF?,
+      ?label: String | Text::Span | nil,
+      ?style: Style::Style?,
+      ?filled_style: Style::Style?,
+      ?unfilled_style: Style::Style?,
+      ?block: Widgets::Block?,
+      ?filled_symbol: String,
+      ?unfilled_symbol: String
+    }
+
+    class LineGauge < Data
+      attr_reader ratio: Float
+      attr_reader label: (String | Text::Span)?
+      attr_reader style: Style::Style?
+      attr_reader filled_style: Style::Style?
+      attr_reader unfilled_style: Style::Style?
+      attr_reader block: Widgets::Block?
+      attr_reader filled_symbol: String
+      attr_reader unfilled_symbol: String
+
+      include CoerceableWidget
+
+      def self.coerce_args: (line_gauge_options first, ?line_gauge_options kwargs) -> LineGauge
+                          | (nil first, line_gauge_options kwargs) -> LineGauge
+
+      def self.new: (?ratio: _ToF?, ?percent: _ToF?, ?label: String | Text::Span | nil, ?style: Style::Style?, ?filled_style: Style::Style?, ?unfilled_style: Style::Style?, ?block: Widgets::Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> LineGauge
+      def initialize: (?ratio: _ToF?, ?percent: _ToF?, ?label: String | Text::Span | nil, ?style: Style::Style?, ?filled_style: Style::Style?, ?unfilled_style: Style::Style?, ?block: Widgets::Block?, ?filled_symbol: String, ?unfilled_symbol: String) -> void
+
+      def filled?: () -> bool
+      def complete?: () -> bool
+      def percent: () -> Integer
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/list.rbs

@@ -0,0 +1,63 @@
+# 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 Widgets
+    # Options hash type for List constructor arguments.
+    type list_options = {
+      ?items: Array[String | Text::Span | Text::Line | ListItem],
+      ?selected_index: _ToI?,
+      ?offset: _ToI?,
+      ?style: Style::Style?,
+      ?highlight_style: Style::Style?,
+      ?highlight_symbol: String?,
+      ?repeat_highlight_symbol: bool,
+      ?highlight_spacing: Symbol,
+      ?direction: Symbol,
+      ?scroll_padding: _ToI?,
+      ?block: Widgets::Block?
+    }
+
+    class List < Data
+      HIGHLIGHT_ALWAYS: Symbol
+      HIGHLIGHT_WHEN_SELECTED: Symbol
+      HIGHLIGHT_NEVER: Symbol
+      DIRECTION_TOP_TO_BOTTOM: Symbol
+      DIRECTION_BOTTOM_TO_TOP: Symbol
+
+      attr_reader items: Array[String | Text::Span | Text::Line | ListItem]
+      attr_reader selected_index: Integer?
+      attr_reader offset: Integer?
+      attr_reader style: Style::Style?
+      attr_reader highlight_style: Style::Style?
+      attr_reader highlight_symbol: String?
+      attr_reader repeat_highlight_symbol: bool
+      attr_reader highlight_spacing: Symbol
+      attr_reader direction: Symbol
+      attr_reader scroll_padding: Integer?
+      attr_reader block: Widgets::Block?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (list_options first, ?list_options kwargs) -> List
+                          | (nil first, list_options kwargs) -> List
+
+      def self.new: (?items: Array[String | Text::Span | Text::Line | ListItem], ?selected_index: _ToI?, ?offset: _ToI?, ?style: Style::Style?, ?highlight_style: Style::Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: _ToI?, ?block: Widgets::Block?) -> List
+      def initialize: (?items: Array[String | Text::Span | Text::Line | ListItem], ?selected_index: _ToI?, ?offset: _ToI?, ?style: Style::Style?, ?highlight_style: Style::Style?, ?highlight_symbol: String?, ?repeat_highlight_symbol: bool, ?highlight_spacing: Symbol, ?direction: Symbol, ?scroll_padding: _ToI?, ?block: Widgets::Block?) -> void
+
+      def selected?: () -> bool
+      def empty?: () -> bool
+      def len: () -> Integer
+      alias length len
+      alias size len
+      # NOTE: No 'selection' alias - use selected_index or selected_item
+      def selected_item: () -> (String | Text::Span | Text::Line | ListItem)?
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/misc.rbs

@@ -0,0 +1,158 @@
+# 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 Widgets
+    # Options hash type for Cell constructor arguments.
+    type cell_options = {
+      ?content: String | Text::Span | Text::Line | Paragraph,
+      ?style: Style::Style?
+    }
+
+    # Options hash type for Center constructor arguments.
+    type center_options = {
+      ?child: widget,
+      ?width_percent: _ToF,
+      ?height_percent: _ToF
+    }
+
+    # Options hash type for Cursor constructor arguments.
+    type cursor_options = {
+      ?x: _ToI,
+      ?y: _ToI
+    }
+
+    # NOTE: line_gauge_options and LineGauge are now defined in line_gauge.rbs
+
+    # Options hash type for ListItem constructor arguments.
+    type list_item_options = {
+      ?content: String | Text::Span | Text::Line,
+      ?style: Style::Style?
+    }
+
+    # Options hash type for Overlay constructor arguments.
+    type overlay_options = {
+      ?layers: Array[widget]
+    }
+
+    # Options hash type for Clear constructor arguments.
+    type clear_options = {
+      ?block: Widgets::Block?
+    }
+
+    # Options hash type for RatatuiLogo constructor arguments (empty).
+    type ratatui_logo_options = { }
+
+    # Options hash type for RatatuiMascot constructor arguments.
+    type ratatui_mascot_options = {
+      ?block: Widgets::Block?
+    }
+
+    class Cell < Data
+      attr_reader content: String | Text::Span | Text::Line | Paragraph
+      attr_reader style: Style::Style?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (cell_options first, ?cell_options kwargs) -> Cell
+                          | (nil first, cell_options kwargs) -> Cell
+
+      def self.new: (content: String | Text::Span | Text::Line | Paragraph, ?style: Style::Style?) -> Cell
+      def initialize: (content: String | Text::Span | Text::Line | Paragraph, ?style: Style::Style?) -> void
+    end
+
+    class Center < Data
+      attr_reader child: widget
+      attr_reader width_percent: Float
+      attr_reader height_percent: Float
+
+      include CoerceableWidget
+
+      def self.coerce_args: (center_options first, ?center_options kwargs) -> Center
+                          | (nil first, center_options kwargs) -> Center
+
+      def self.new: (child: widget, ?width_percent: _ToF, ?height_percent: _ToF) -> Center
+      def initialize: (child: widget, ?width_percent: _ToF, ?height_percent: _ToF) -> void
+    end
+
+    class Cursor < Data
+      attr_reader x: Integer
+      attr_reader y: Integer
+
+      include CoerceableWidget
+
+      def self.coerce_args: (cursor_options first, ?cursor_options kwargs) -> Cursor
+                          | (nil first, cursor_options kwargs) -> Cursor
+
+      def self.new: (x: _ToI, y: _ToI) -> Cursor
+      def initialize: (x: _ToI, y: _ToI) -> void
+    end
+
+    # NOTE: LineGauge is now defined in line_gauge.rbs
+
+    class ListItem < Data
+      attr_reader content: String | Text::Span | Text::Line
+      attr_reader style: Style::Style?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (list_item_options first, ?list_item_options kwargs) -> ListItem
+                          | (nil first, list_item_options kwargs) -> ListItem
+
+      def self.new: (content: String | Text::Span | Text::Line, ?style: Style::Style?) -> ListItem
+      def initialize: (content: String | Text::Span | Text::Line, ?style: Style::Style?) -> void
+    end
+
+    class Overlay < Data
+      attr_reader layers: Array[widget]
+
+      include CoerceableWidget
+
+      def self.coerce_args: (overlay_options first, ?overlay_options kwargs) -> Overlay
+                          | (nil first, overlay_options kwargs) -> Overlay
+
+      def self.new: (?layers: Array[widget]) -> Overlay
+      def initialize: (?layers: Array[widget]) -> void
+    end
+
+    class Clear < Data
+      attr_reader block: Widgets::Block?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (clear_options first, ?clear_options kwargs) -> Clear
+                          | (nil first, clear_options kwargs) -> Clear
+
+      def self.new: (?block: Widgets::Block?) -> Clear
+      def initialize: (?block: Widgets::Block?) -> void
+    end
+
+    class RatatuiLogo < Data
+      include CoerceableWidget
+
+      def self.coerce_args: (ratatui_logo_options first, ?ratatui_logo_options kwargs) -> RatatuiLogo
+                          | (nil first, ratatui_logo_options kwargs) -> RatatuiLogo
+
+      def self.new: () -> RatatuiLogo
+      def initialize: () -> void
+    end
+
+    class RatatuiMascot < Data
+      attr_reader block: Widgets::Block?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (ratatui_mascot_options first, ?ratatui_mascot_options kwargs) -> RatatuiMascot
+                          | (nil first, ratatui_mascot_options kwargs) -> RatatuiMascot
+
+      def self.new: (?block: Widgets::Block?) -> RatatuiMascot
+      def initialize: (?block: Widgets::Block?) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/paragraph.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 Widgets
+    # Options hash type for Paragraph constructor arguments.
+    type paragraph_options = {
+      ?text: String,
+      ?style: Style::Style?,
+      ?fg: (String | Symbol)?,
+      ?bg: (String | Symbol)?,
+      ?block: Widgets::Block?,
+      ?wrap: bool,
+      ?alignment: Symbol,
+      ?scroll: [_ToI, _ToI]
+    }
+
+    class Paragraph < Data
+      attr_reader text: String
+      attr_reader style: Style::Style?
+      attr_reader block: Widgets::Block?
+      attr_reader wrap: bool
+      attr_reader alignment: Symbol
+      attr_reader scroll: [Integer, Integer]
+
+      include CoerceableWidget
+
+      def self.coerce_args: (paragraph_options first, ?paragraph_options kwargs) -> Paragraph
+                          | (nil first, paragraph_options kwargs) -> Paragraph
+
+      # Legacy constructor with fg/bg convenience params
+      def self.new: (text: String, ?style: Style::Style?, ?fg: (String | Symbol)?, ?bg: (String | Symbol)?, ?block: Widgets::Block?, ?wrap: bool, ?alignment: Symbol, ?scroll: [_ToI, _ToI]) -> Paragraph
+      # Instance initialize
+      def initialize: (?text: String, ?style: Style::Style?, ?block: Widgets::Block?, ?wrap: bool, ?alignment: Symbol, ?scroll: Array[Integer]) -> void
+      def line_count: (Integer width) -> Integer
+      def line_width: () -> Integer
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/row.rbs

@@ -0,0 +1,43 @@
+# 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 Widgets
+    # Options hash type for Row constructor arguments.
+    type row_options = {
+      ?cells: Array[Row::cell_content],
+      ?style: Style::Style?,
+      ?height: Integer?,
+      ?top_margin: Integer?,
+      ?bottom_margin: Integer?
+    }
+
+    class Row < Data
+      type cell_content = String | Text::Span | Text::Line | Paragraph | Cell
+
+      attr_reader cells: Array[cell_content]
+      attr_reader style: Style::Style?
+      attr_reader height: Integer?
+      attr_reader top_margin: Integer?
+      attr_reader bottom_margin: Integer?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (row_options first, ?row_options kwargs) -> Row
+                          | (nil first, row_options kwargs) -> Row
+
+      def self.new: (cells: Array[cell_content], ?style: Style::Style?, ?height: Integer?, ?top_margin: Integer?, ?bottom_margin: Integer?) -> Row
+      def initialize: (cells: Array[cell_content], ?style: Style::Style?, ?height: Integer?, ?top_margin: Integer?, ?bottom_margin: Integer?) -> void
+
+      # Returns a new Row with strikethrough styling enabled.
+      def enable_strikethrough: () -> Row
+      alias strikethrough enable_strikethrough
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/scrollbar.rbs

@@ -0,0 +1,53 @@
+# 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 Widgets
+    # Options hash type for Scrollbar constructor arguments.
+    type scrollbar_options = {
+      ?content_length: _ToI,
+      ?position: _ToI,
+      ?orientation: Symbol,
+      ?thumb_symbol: String,
+      ?thumb_style: Style::Style?,
+      ?track_symbol: String?,
+      ?track_style: Style::Style?,
+      ?begin_symbol: String?,
+      ?begin_style: Style::Style?,
+      ?end_symbol: String?,
+      ?end_style: Style::Style?,
+      ?style: Style::Style?,
+      ?block: Widgets::Block?
+    }
+
+    class Scrollbar < Data
+      attr_reader content_length: Integer
+      attr_reader position: Integer
+      attr_reader orientation: Symbol
+      attr_reader thumb_symbol: String
+      attr_reader thumb_style: Style::Style?
+      attr_reader track_symbol: String?
+      attr_reader track_style: Style::Style?
+      attr_reader begin_symbol: String?
+      attr_reader begin_style: Style::Style?
+      attr_reader end_symbol: String?
+      attr_reader end_style: Style::Style?
+      attr_reader style: Style::Style?
+      attr_reader block: Widgets::Block?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (scrollbar_options first, ?scrollbar_options kwargs) -> Scrollbar
+                          | (nil first, scrollbar_options kwargs) -> Scrollbar
+
+      def self.new: (content_length: _ToI, position: _ToI, ?orientation: Symbol, ?thumb_symbol: String, ?thumb_style: Style::Style?, ?track_symbol: String?, ?track_style: Style::Style?, ?begin_symbol: String?, ?begin_style: Style::Style?, ?end_symbol: String?, ?end_style: Style::Style?, ?style: Style::Style?, ?block: Widgets::Block?) -> Scrollbar
+      def initialize: (content_length: _ToI, position: _ToI, ?orientation: Symbol, ?thumb_symbol: String, ?thumb_style: Style::Style?, ?track_symbol: String?, ?track_style: Style::Style?, ?begin_symbol: String?, ?begin_style: Style::Style?, ?end_symbol: String?, ?end_style: Style::Style?, ?style: Style::Style?, ?block: Widgets::Block?) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/shape/label.rbs

@@ -0,0 +1,37 @@
+# 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 Widgets
+    module Shape
+      # Options hash type for Shape::Label constructor arguments.
+      type label_options = {
+        ?x: _ToF,
+        ?y: _ToF,
+        ?text: String | Text::Line,
+        ?style: Style::Style?
+      }
+
+      class Label < Data
+        attr_reader x: Float
+        attr_reader y: Float
+        attr_reader text: String | Text::Line
+        attr_reader style: Style::Style?
+
+        include CoerceableWidget
+
+        def self.coerce_args: (label_options first, ?label_options kwargs) -> Label
+                            | (nil first, label_options kwargs) -> Label
+
+        def self.new: (x: _ToF, y: _ToF, text: String | Text::Line, ?style: Style::Style?) -> Label
+        def initialize: (x: _ToF, y: _ToF, text: String | Text::Line, ?style: Style::Style?) -> void
+      end
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/sparkline.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 Widgets
+    # Options hash type for Sparkline constructor arguments.
+    type sparkline_options = {
+      ?data: Array[_ToI?],
+      ?max: _ToI?,
+      ?style: Style::Style?,
+      ?block: Widgets::Block?,
+      ?direction: (:left_to_right | :right_to_left)?,
+      ?absent_value_symbol: String?,
+      ?absent_value_style: Style::Style?,
+      ?bar_set: Hash[Symbol, String]?
+    }
+
+    class Sparkline < Data
+      BAR_KEYS: Array[Symbol]
+
+      attr_reader data: Array[Integer?]
+      attr_reader max: Integer?
+      attr_reader style: Style::Style?
+      attr_reader block: Widgets::Block?
+      attr_reader direction: (:left_to_right | :right_to_left)?
+      attr_reader absent_value_symbol: String?
+      attr_reader absent_value_style: Style::Style?
+      attr_reader bar_set: Hash[Symbol, String]?
+
+      include CoerceableWidget
+
+      def self.coerce_args: (sparkline_options first, ?sparkline_options kwargs) -> Sparkline
+                          | (nil first, sparkline_options kwargs) -> Sparkline
+
+      def self.new: (data: Array[_ToI?], ?max: _ToI?, ?style: Style::Style?, ?block: Widgets::Block?, ?direction: (:left_to_right | :right_to_left)?, ?absent_value_symbol: String?, ?absent_value_style: Style::Style?, ?bar_set: Hash[Symbol, String]?) -> Sparkline
+      def initialize: (data: Array[_ToI?], ?max: _ToI?, ?style: Style::Style?, ?block: Widgets::Block?, ?direction: (:left_to_right | :right_to_left)?, ?absent_value_symbol: String?, ?absent_value_style: Style::Style?, ?bar_set: Hash[Symbol, String]?) -> void
+    end
+  end
+end

data/sig/ratatui_ruby/widgets/table.rbs

@@ -0,0 +1,78 @@
+# 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 Widgets
+    # Options hash type for Table constructor arguments.
+    # Used by coerce_args for DWIM bare-hash acceptance.
+    type table_options = {
+      ?header: Array[String | Paragraph]?,
+      ?rows: Array[Array[String | Paragraph | Style::Style | _ToS]],
+      ?widths: Array[Layout::Constraint | Integer],
+      ?row_highlight_style: Style::Style?,
+      ?highlight_symbol: String?,
+      ?highlight_spacing: Symbol,
+      ?column_highlight_style: Style::Style?,
+      ?cell_highlight_style: Style::Style?,
+      ?selected_row: _ToI?,
+      ?selected_column: _ToI?,
+      ?offset: _ToI?,
+      ?block: Widgets::Block?,
+      ?footer: Array[String | Paragraph]?,
+      ?flex: Symbol,
+      ?style: style_input?,
+      ?column_spacing: _ToI
+    }
+
+    class Table < Data
+      HIGHLIGHT_ALWAYS: Symbol
+      HIGHLIGHT_WHEN_SELECTED: Symbol
+      HIGHLIGHT_NEVER: 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 header: Array[String | Paragraph]?
+      attr_reader rows: Array[Array[String | Paragraph | Style::Style | _ToS]]
+      attr_reader widths: Array[Layout::Constraint]
+      attr_reader block: Widgets::Block?
+      attr_reader footer: Array[String | Paragraph]?
+      attr_reader flex: Symbol
+      attr_reader style: style_input?
+      attr_reader column_spacing: Integer?
+      attr_reader highlight_spacing: Symbol
+      attr_reader column_highlight_style: Style::Style?
+      attr_reader selected_column: Integer?
+      attr_reader offset: Integer?
+      attr_reader row_highlight_style: Style::Style?
+      attr_reader highlight_symbol: String?
+      attr_reader cell_highlight_style: Style::Style?
+      attr_reader selected_row: Integer?
+
+      include CoerceableWidget
+
+      # DWIM hash coercion: accepts bare Hash (first arg) or keyword arguments.
+      def self.coerce_args: (table_options first, ?table_options kwargs) -> Table
+                          | (nil first, table_options kwargs) -> Table
+
+      def self.new: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style::Style | _ToS]], ?widths: Array[Layout::Constraint | Integer], ?row_highlight_style: Style::Style?, ?highlight_symbol: String?, ?highlight_spacing: Symbol, ?column_highlight_style: Style::Style?, ?cell_highlight_style: Style::Style?, ?selected_row: _ToI?, ?selected_column: _ToI?, ?offset: _ToI?, ?block: Widgets::Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: style_input?, ?column_spacing: _ToI) -> Table
+      def initialize: (?header: Array[String | Paragraph]?, ?rows: Array[Array[String | Paragraph | Style::Style | _ToS]], ?widths: Array[Layout::Constraint | Integer], ?row_highlight_style: Style::Style?, ?highlight_symbol: String?, ?highlight_spacing: Symbol, ?column_highlight_style: Style::Style?, ?cell_highlight_style: Style::Style?, ?selected_row: _ToI?, ?selected_column: _ToI?, ?offset: _ToI?, ?block: Widgets::Block?, ?footer: Array[String | Paragraph]?, ?flex: Symbol, ?style: style_input?, ?column_spacing: _ToI) -> void
+
+      def row_selected?: () -> bool
+      def column_selected?: () -> bool
+      def cell_selected?: () -> bool
+      def empty?: () -> bool
+      # NOTE: No 'selection' alias - use selected_row or selected_column
+    end
+  end
+end