ratatui_ruby 1.0.0 → 1.1.0

data/lib/ratatui_ruby/widgets/table.rb

@@ -16,13 +16,13 @@ module RatatuiRuby
     #
     # 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]
+    # {rdoc-image:/doc/images/widget_table.png}[link:/examples/widget_table/app_rb.html]
     #
     # === Example
     #
     # Run the interactive demo from the terminal:
     #
-    #   ruby examples/widget_table_flex/app.rb
+    #   ruby examples/widget_table/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)
       include CoerceableWidget
 

data/lib/ratatui_ruby.rb

@@ -15,7 +15,9 @@ require_relative "ratatui_ruby/buffer"   # Buffer::Cell (for inspection)
 require_relative "ratatui_ruby/text"    # Text::Span, Text::Line, Text.width
 require_relative "ratatui_ruby/draw"    # Draw commands
 require_relative "ratatui_ruby/symbols" # Symbols::Shade, etc.
+require_relative "ratatui_ruby/backend" # Backend::WindowSize
 require_relative "ratatui_ruby/terminal/viewport" # Terminal::Viewport
+require_relative "ratatui_ruby/terminal" # Terminal class
 
 # Event types
 require_relative "ratatui_ruby/event"
@@ -138,8 +140,8 @@ module RatatuiRuby
     # Breaking these rules raises this error.
     #
     # Common causes:
-    # - Calling methods in the wrong order (e.g., \`init_terminal\` twice)
-    # - Callable return type mismatch (e.g., view returns \`nil\` instead of a widget)
+    # - Calling methods in the wrong order (e.g., <tt>init_terminal</tt> twice)
+    # - Callable return type mismatch (e.g., view returns <tt>nil</tt> instead of a widget)
     #
     # To resolve, check the method's documented contract. Ensure
     # state preconditions are met and return types are correct.
@@ -510,12 +512,31 @@ module RatatuiRuby
     alias viewport_size get_viewport_area
   end
 
-  # (Native methods _get_cell_at and _get_terminal_size implemented in Rust)
-  private_class_method :_get_cell_at, :_get_terminal_size
+  ##
+  # Number of frames drawn since terminal initialization.
+  #
+  # TUI applications track render cycles for animations, FPS counters, or
+  # debugging. Manually counting draws is error-prone and clutters app logic.
+  #
+  # This method queries the terminal's internal frame counter. It starts at 0
+  # when the terminal initializes and increments by 1 after each successful
+  # draw. Restoring and re-initializing resets the counter.
+  #
+  # Raises RatatuiRuby::Error::Invariant if terminal not initialized.
+  def self.frame_count
+    _frame_count
+  end
+
+  # (Native methods implemented in Rust)
+  private_class_method :_get_cell_at, :_get_terminal_size, :_frame_count
 
   # Hide native Layout._split helper
   Layout::Layout.singleton_class.__send__(:private, :_split)
 
+  # Raw Terminal bindings - use public wrappers (they have timeout guards)
+  Terminal.singleton_class.__send__(:private, :_available_color_count)
+  Terminal.singleton_class.__send__(:private, :_supports_keyboard_enhancement)
+
   # --- Terminal Safety Hooks ---
   # These ensure the terminal is restored even on unexpected exits.
 

data/sig/examples/app_external_editor/app.rbs

@@ -0,0 +1,12 @@
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: MIT-0
+#++
+
+class AppExternalEditor
+  # @public
+  def self.new: () -> AppExternalEditor
+
+  # @public
+  def run: () -> void
+end