thor-interactive 0.1.0.pre.4 → 0.1.0.pre.6

data/lib/thor/interactive/tui/status_bar.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+class Thor
+  module Interactive
+    module TUI
+      # Configurable status bar with left/center/right sections.
+      # App authors provide lambdas that receive the Thor instance.
+      class StatusBar
+        attr_accessor :left, :center, :right
+
+        def initialize(thor_class, thor_instance, options = {})
+          @thor_class = thor_class
+          @thor_instance = thor_instance
+
+          config = options[:status_bar] || {}
+
+          @left = config[:left] || ->(instance) { " #{instance.class.name}" }
+          @center = config[:center] || ->(instance) { "" }
+          @right = config[:right] || ->(instance) { " ready " }
+        end
+
+        def render_text(width, override_center: nil, override_right: nil)
+          left_text = evaluate_section(@left)
+          center_text = override_center || evaluate_section(@center)
+          right_text = override_right || evaluate_section(@right)
+
+          # Calculate spacing
+          if center_text.empty?
+            padding = width - left_text.length - right_text.length
+            padding = 1 if padding < 1
+            left_text + (" " * padding) + right_text
+          else
+            # Three-section layout
+            left_space = width - left_text.length - center_text.length - right_text.length
+            left_pad = [left_space / 2, 1].max
+            right_pad = [left_space - left_pad, 1].max
+            left_text + (" " * left_pad) + center_text + (" " * right_pad) + right_text
+          end
+        end
+
+        private
+
+        def evaluate_section(section)
+          case section
+          when Proc, Method
+            section.arity == 0 ? section.call.to_s : section.call(@thor_instance).to_s
+          when String
+            section
+          else
+            section.to_s
+          end
+        rescue => e
+          "(error)"
+        end
+      end
+    end
+  end
+end

data/lib/thor/interactive/tui/text_input.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+class Thor
+  module Interactive
+    module TUI
+      # Multi-line text buffer with cursor tracking.
+      # Used as the data model for the input area in the TUI shell.
+      class TextInput
+        attr_reader :cursor_row, :cursor_col
+
+        def initialize
+          @lines = [+""]
+          @cursor_row = 0
+          @cursor_col = 0
+          @history = []
+          @history_index = nil
+          @saved_input = nil
+        end
+
+        def content
+          @lines.join("\n")
+        end
+
+        def empty?
+          @lines.length == 1 && @lines[0].empty?
+        end
+
+        def lines
+          @lines.dup
+        end
+
+        def line_count
+          @lines.length
+        end
+
+        def current_line
+          @lines[@cursor_row] || ""
+        end
+
+        def insert_char(ch)
+          @lines[@cursor_row].insert(@cursor_col, ch)
+          @cursor_col += ch.length
+        end
+
+        def insert_text(text)
+          text_lines = text.split("\n", -1)
+          if text_lines.length == 1
+            insert_char(text_lines[0])
+          else
+            # Split current line at cursor
+            before = @lines[@cursor_row][0...@cursor_col]
+            after = @lines[@cursor_row][@cursor_col..]
+
+            # First fragment joins with text before cursor
+            @lines[@cursor_row] = before + text_lines[0]
+
+            # Middle lines insert after current row
+            text_lines[1...-1].each_with_index do |line, i|
+              @lines.insert(@cursor_row + 1 + i, line)
+            end
+
+            # Last fragment joins with text after cursor
+            last_line = text_lines.last + after.to_s
+            @lines.insert(@cursor_row + text_lines.length - 1, last_line)
+
+            @cursor_row += text_lines.length - 1
+            @cursor_col = text_lines.last.length
+          end
+        end
+
+        def newline
+          # Split current line at cursor
+          before = @lines[@cursor_row][0...@cursor_col]
+          after = @lines[@cursor_row][@cursor_col..]
+
+          @lines[@cursor_row] = before
+          @lines.insert(@cursor_row + 1, after.to_s)
+          @cursor_row += 1
+          @cursor_col = 0
+        end
+
+        def backspace
+          if @cursor_col > 0
+            @lines[@cursor_row] = @lines[@cursor_row][0...@cursor_col - 1] + @lines[@cursor_row][@cursor_col..]
+            @cursor_col -= 1
+          elsif @cursor_row > 0
+            # Join with previous line
+            prev_col = @lines[@cursor_row - 1].length
+            @lines[@cursor_row - 1] += @lines[@cursor_row]
+            @lines.delete_at(@cursor_row)
+            @cursor_row -= 1
+            @cursor_col = prev_col
+          end
+        end
+
+        def delete_char
+          if @cursor_col < @lines[@cursor_row].length
+            @lines[@cursor_row] = @lines[@cursor_row][0...@cursor_col] + @lines[@cursor_row][@cursor_col + 1..]
+          elsif @cursor_row < @lines.length - 1
+            # Join with next line
+            @lines[@cursor_row] += @lines[@cursor_row + 1]
+            @lines.delete_at(@cursor_row + 1)
+          end
+        end
+
+        def move_left
+          if @cursor_col > 0
+            @cursor_col -= 1
+          elsif @cursor_row > 0
+            @cursor_row -= 1
+            @cursor_col = @lines[@cursor_row].length
+          end
+        end
+
+        def move_right
+          if @cursor_col < @lines[@cursor_row].length
+            @cursor_col += 1
+          elsif @cursor_row < @lines.length - 1
+            @cursor_row += 1
+            @cursor_col = 0
+          end
+        end
+
+        def move_up
+          if @cursor_row > 0
+            @cursor_row -= 1
+            @cursor_col = [@cursor_col, @lines[@cursor_row].length].min
+          end
+        end
+
+        def move_down
+          if @cursor_row < @lines.length - 1
+            @cursor_row += 1
+            @cursor_col = [@cursor_col, @lines[@cursor_row].length].min
+          end
+        end
+
+        def move_home
+          @cursor_col = 0
+        end
+
+        def move_end
+          @cursor_col = @lines[@cursor_row].length
+        end
+
+        def clear
+          @lines = [+""]
+          @cursor_row = 0
+          @cursor_col = 0
+        end
+
+        # Submit the current content and add to history.
+        # Returns the content and clears the input.
+        def submit
+          text = content
+          add_to_history(text) unless text.strip.empty?
+          clear
+          @history_index = nil
+          @saved_input = nil
+          text
+        end
+
+        def add_to_history(text)
+          # Don't add duplicates of the most recent entry
+          @history.push(text) unless @history.last == text
+        end
+
+        def history_back
+          return false if @history.empty?
+
+          if @history_index.nil?
+            @saved_input = content
+            @history_index = @history.length - 1
+          elsif @history_index > 0
+            @history_index -= 1
+          else
+            return false
+          end
+
+          load_from_string(@history[@history_index])
+          true
+        end
+
+        def history_forward
+          return false if @history_index.nil?
+
+          if @history_index < @history.length - 1
+            @history_index += 1
+            load_from_string(@history[@history_index])
+          else
+            @history_index = nil
+            load_from_string(@saved_input || "")
+            @saved_input = nil
+          end
+          true
+        end
+
+        # Load history entries from an array of strings
+        def load_history(entries)
+          @history = entries.dup
+        end
+
+        def history_entries
+          @history.dup
+        end
+
+        private
+
+        def load_from_string(str)
+          @lines = str.split("\n", -1).map { |s| +s }
+          @lines = [+""] if @lines.empty?
+          @cursor_row = @lines.length - 1
+          @cursor_col = @lines[@cursor_row].length
+        end
+      end
+    end
+  end
+end

data/lib/thor/interactive/tui/theme.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+class Thor
+  module Interactive
+    module TUI
+      # Theming system for the TUI shell.
+      # Predefined themes and custom color configuration.
+      class Theme
+        THEMES = {
+          default: {
+            output_fg: nil,
+            output_border: :dark_gray,
+            error_fg: :red,
+            command_echo_fg: :dark_gray,
+            system_fg: :cyan,
+            input_fg: nil,
+            input_border: :green,
+            input_title_fg: :green,
+            cursor_fg: :black,
+            cursor_bg: :white,
+            status_bar_fg: :white,
+            status_bar_bg: :blue,
+            completion_fg: :white,
+            completion_bg: :dark_gray,
+            completion_selected_fg: :black,
+            completion_selected_bg: :cyan
+          },
+          dark: {
+            output_fg: :gray,
+            output_border: :dark_gray,
+            error_fg: :light_red,
+            command_echo_fg: :dark_gray,
+            system_fg: :light_cyan,
+            input_fg: :white,
+            input_border: :light_green,
+            input_title_fg: :light_green,
+            cursor_fg: :black,
+            cursor_bg: :light_yellow,
+            status_bar_fg: :white,
+            status_bar_bg: :dark_gray,
+            completion_fg: :white,
+            completion_bg: :dark_gray,
+            completion_selected_fg: :black,
+            completion_selected_bg: :light_cyan
+          },
+          light: {
+            output_fg: :black,
+            output_border: :gray,
+            error_fg: :red,
+            command_echo_fg: :gray,
+            system_fg: :blue,
+            input_fg: :black,
+            input_border: :green,
+            input_title_fg: :green,
+            cursor_fg: :white,
+            cursor_bg: :black,
+            status_bar_fg: :white,
+            status_bar_bg: :blue,
+            completion_fg: :black,
+            completion_bg: :gray,
+            completion_selected_fg: :white,
+            completion_selected_bg: :blue
+          },
+          minimal: {
+            output_fg: nil,
+            output_border: :dark_gray,
+            error_fg: :red,
+            command_echo_fg: :dark_gray,
+            system_fg: :yellow,
+            input_fg: nil,
+            input_border: :dark_gray,
+            input_title_fg: :white,
+            cursor_fg: :black,
+            cursor_bg: :white,
+            status_bar_fg: :black,
+            status_bar_bg: :white,
+            completion_fg: :white,
+            completion_bg: :dark_gray,
+            completion_selected_fg: :black,
+            completion_selected_bg: :white
+          }
+        }.freeze
+
+        attr_reader :colors
+
+        def initialize(theme = :default)
+          @colors = if theme.is_a?(Hash)
+            THEMES[:default].merge(theme)
+          else
+            THEMES.fetch(theme, THEMES[:default]).dup
+          end
+        end
+
+        def [](key)
+          @colors[key]
+        end
+
+        def style(key)
+          color = @colors[key]
+          color ? RatatuiRuby::Style::Style.new(fg: color) : nil
+        end
+
+        def output_style
+          fg = @colors[:output_fg]
+          fg ? RatatuiRuby::Style::Style.new(fg: fg) : nil
+        end
+
+        def error_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:error_fg])
+        end
+
+        def command_echo_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:command_echo_fg])
+        end
+
+        def system_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:system_fg])
+        end
+
+        def input_border_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:input_border])
+        end
+
+        def input_title_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:input_title_fg], modifiers: [:bold])
+        end
+
+        def cursor_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:cursor_fg], bg: @colors[:cursor_bg], modifiers: [:bold])
+        end
+
+        def output_border_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:output_border])
+        end
+
+        def status_bar_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:status_bar_fg], bg: @colors[:status_bar_bg])
+        end
+
+        def completion_style
+          RatatuiRuby::Style::Style.new(fg: @colors[:completion_fg])
+        end
+
+        def completion_bg_style
+          RatatuiRuby::Style::Style.new(bg: @colors[:completion_bg])
+        end
+
+        def completion_selected_style
+          RatatuiRuby::Style::Style.new(
+            fg: @colors[:completion_selected_fg],
+            bg: @colors[:completion_selected_bg],
+            modifiers: [:bold]
+          )
+        end
+      end
+    end
+  end
+end

data/lib/thor/interactive/tui.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class Thor
+  module Interactive
+    module TUI
+      def self.available?
+        require "ratatui_ruby"
+        true
+      rescue LoadError
+        false
+      end
+    end
+  end
+end

data/lib/thor/interactive/version_constant.rb

@@ -4,5 +4,5 @@
 # This file is separate to avoid circular dependencies during gem installation
 
 module ThorInteractive
-  VERSION = "0.1.0.pre.4"
+  VERSION = "0.1.0.pre.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: thor-interactive
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.4
+  version: 0.1.0.pre.6
 platform: ruby
 authors:
 - Chris Petersen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-08 00:00:00.000000000 Z
+date: 2026-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -53,7 +53,10 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/assets/thor-interactive-wide.png
+- docs/assets/thor-interactive.png
 - examples/README.md
+- examples/completion_demo.rb
 - examples/demo_session.rb
 - examples/edge_case_test.rb
 - examples/nested_example.rb
@@ -61,9 +64,18 @@ files:
 - examples/sample_app.rb
 - examples/signal_demo.rb
 - examples/test_interactive.rb
+- examples/tui_demo.rb
 - lib/thor/interactive.rb
 - lib/thor/interactive/command.rb
+- lib/thor/interactive/command_dispatch.rb
 - lib/thor/interactive/shell.rb
+- lib/thor/interactive/tui.rb
+- lib/thor/interactive/tui/output_buffer.rb
+- lib/thor/interactive/tui/ratatui_shell.rb
+- lib/thor/interactive/tui/spinner.rb
+- lib/thor/interactive/tui/status_bar.rb
+- lib/thor/interactive/tui/text_input.rb
+- lib/thor/interactive/tui/theme.rb
 - lib/thor/interactive/version.rb
 - lib/thor/interactive/version_constant.rb
 - sig/thor/interactive.rbs
@@ -90,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Turn any Thor CLI into an interactive REPL with persistent state and auto-completion