kward 0.71.0 → 0.72.0

data/lib/kward/prompt_interface/interactive/renderer.rb

@@ -0,0 +1,71 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # Renderer for interactive mode canvas frames. Draws the canvas buffer into
+    # the composer region using the same boxed-row infrastructure as the editor.
+    module InteractiveRenderer
+      private
+
+      def interactive_active_locked?
+        !@interactive_state.nil?
+      end
+
+      def interactive_layout(width, height = screen_height)
+        state = @interactive_state
+        controller = state[:controller]
+        rows = [interactive_top_border(width, state)]
+        content_width = [width - 4, 1].max
+        canvas_width = [content_width - 2, 1].max
+
+        controller.cells.each do |cell_row|
+          line = cell_row[0, canvas_width].map do |cell|
+            char = cell[:char]
+            colors = cell[:colors]
+            colors.empty? ? char : colored(char, *colors)
+          end.join
+          rows << box_content_row(visible_ljust(line, content_width), content_width)
+        end
+
+        rows << footer_row(content_width, interactive_status_text(state))
+        rows.concat(interactive_bottom_rows(width))
+        cursor_row = 1
+        cursor_col = 2
+        [rows, cursor_row, cursor_col]
+      end
+
+      def interactive_top_border(width, state)
+        title = visible_truncate(state[:title].to_s, [width - 4, 1].max)
+        plain_title = ANSI.strip(title)
+        "#{colored("╭", :primary_green)} #{title} #{colored("─" * [width - plain_title.length - 4, 0].max, :primary_green)}#{colored("╮", :primary_green)}"
+      end
+
+      def interactive_status_text(state)
+        fps = state[:controller].fps
+        "Interactive · #{fps.to_i}fps · Ctrl+C exits"
+      end
+
+      def interactive_bottom_rows(width)
+        @tabs.empty? ? [bottom_border(width)] : tab_border_rows(width)
+      end
+
+      def tick_interactive_locked
+        return false unless interactive_active_locked?
+
+        controller = @interactive_state[:controller]
+        return false if controller.exited?
+
+        now = monotonic_now
+        interval = 1.0 / controller.fps
+        elapsed = now - @last_interactive_tick
+        return false if elapsed < interval
+
+        steps = (elapsed / interval).floor
+        @last_interactive_tick += steps * interval
+        result = controller.invoke_tick
+        controller.exit if result == :exit
+        true
+      end
+    end
+  end
+end

data/lib/kward/prompt_interface/interactive/state.rb

@@ -0,0 +1,62 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # State lifecycle for interactive mode. Manages entering and exiting the
+    # canvas-based render loop, including composer snapshot save/restore.
+    module InteractiveState
+      private
+
+      def interactive_canvas_width
+        [screen_width - 6, 1].max
+      end
+
+      def route_interactive_key(key)
+        return false unless interactive_active_locked?
+
+        interactive_key = interactive_csi_u_key(key)
+        unless interactive_key == false
+          return force_interactive_exit if interactive_key == :force_exit
+
+          @interactive_state[:controller].push_key(interactive_key)
+          return true
+        end
+
+        name = key_name_for(key) if key.is_a?(String) && key.length >= 1
+        return force_interactive_exit if key == "\x03" || name == :escape
+
+        @interactive_state[:controller].push_key(name || key)
+        true
+      end
+
+      def interactive_csi_u_key(key)
+        sequence = parse_csi_u_key(key)
+        return false unless sequence
+
+        code = sequence[:code]
+        modifier = sequence[:modifier]
+        queue_pending_keys(sequence[:remaining]) if sequence[:remaining] && !sequence[:remaining].empty?
+
+        return :force_exit if code == 27 || (code.to_i.chr.downcase == "c" && ctrl_modifier?(modifier))
+        return :return if code == 13
+        return :backspace if [8, 127].include?(code)
+        return :space if code == 32 && !ctrl_modifier?(modifier) && !alt_modifier?(modifier) && !super_modifier?(modifier)
+
+        text = csi_u_printable_text(sequence)
+        return text if text
+
+        false
+      end
+
+      def force_interactive_exit
+        @interactive_state[:controller].force_exit
+        true
+      end
+
+      def handle_interactive_key(key)
+        route_interactive_key(key)
+        nil
+      end
+    end
+  end
+end