fatty 0.99.0

data/lib/fatty/config_files/themes/terminal.yml

@@ -0,0 +1,90 @@
+# lib/fatty/config_files/themes/terminal.yml
+name: terminal
+inherit: null
+
+output:
+  fg: default
+  bg: default
+
+input:
+  fg: default
+  bg: default
+
+input_suggestion:
+  fg: default
+  bg: default
+  attrs: [dim]
+
+cursor:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+region:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+info:
+  fg: default
+  bg: default
+
+good:
+  fg: default
+  bg: default
+  attrs: [bold]
+
+warn:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+error:
+  fg: default
+  bg: default
+  attrs: [bold, reverse]
+
+pager_status:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+search_input:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+match_current:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+match_other:
+  fg: default
+  bg: default
+  attrs: [underline]
+
+popup:
+  fg: default
+  bg: default
+
+popup_selection:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+popup_input:
+  fg: default
+  bg: default
+  attrs: [reverse]
+
+popup_frame:
+  fg: default
+  bg: default
+  border: single
+  corners: square
+
+popup_counts:
+  fg: default
+  bg: default
+  attrs: [bold]

data/lib/fatty/config_files/themes/wordperfect.yml

@@ -0,0 +1,77 @@
+name: wordperfect
+inherit: null
+
+output:
+  fg: white
+  bg: navy
+
+input:
+  fg: white
+  bg: navy
+  attrs: [bold]
+
+input_suggestion:
+  fg: lightgray
+  bg: navy
+
+cursor:
+  fg: white
+  bg: red
+
+region:
+  fg: navy
+  bg: yellow
+
+good:
+  fg: green
+  bg: navy
+
+info:
+  fg: black
+  bg: navy
+
+warn:
+  fg: black
+  bg: magenta
+
+error:
+  fg: white
+  bg: red
+
+pager_status:
+  fg: black
+  bg: lightgreen
+
+search_input:
+  fg: black
+  bg: cyan
+
+match_current:
+  fg: black
+  bg: red
+
+match_other:
+  fg: grey
+  bg: pink
+
+popup:
+  fg: white
+  bg: navy
+
+popup_input:
+  fg: white
+  bg: navy
+
+popup_counts:
+  fg: navy
+  bg: red
+
+popup_selection:
+  fg: navy
+  bg: yellow
+
+popup_frame:
+  fg: navy
+  bg: yellow
+  border: single
+  corners: rounded

data/lib/fatty/config_files/themes/wordperfect_light.yml

@@ -0,0 +1,77 @@
+name: wordperfect_light
+inherit: wordperfect
+
+output:
+  fg: white
+  bg: lightblue
+
+# input:
+#   fg: white
+#   bg: navy
+#   attrs: [bold]
+
+# input_suggestion:
+#   fg: lightgray
+#   bg: navy
+
+# cursor:
+#   fg: white
+#   bg: red
+
+# region:
+#   fg: navy
+#   bg: yellow
+
+# good:
+#   fg: green
+#   bg: navy
+
+# info:
+#   fg: black
+#   bg: navy
+
+# warn:
+#   fg: black
+#   bg: magenta
+
+# error:
+#   fg: white
+#   bg: red
+
+# pager_status:
+#   fg: black
+#   bg: lightgreen
+
+# search_input:
+#   fg: black
+#   bg: cyan
+
+# match_current:
+#   fg: black
+#   bg: red
+
+# match_other:
+#   fg: grey
+#   bg: pink
+
+# popup:
+#   fg: white
+#   bg: navy
+
+# popup_input:
+#   fg: white
+#   bg: navy
+
+# popup_counts:
+#   fg: navy
+#   bg: red
+
+# popup_selection:
+#   fg: navy
+#   bg: yellow
+
+# popup_frame:
+#   fg: navy
+#   bg: yellow
+#   border: single
+#   corners: rounded

data/lib/fatty/core_ext/string.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# These can be used to add "roles" to strings so that they can be styled
+# according to the theme.
+class String
+  def fatty_good
+    { text: self, role: :good }
+  end
+
+  def fatty_info
+    { text: self, role: :info }
+  end
+
+  def fatty_warn
+    { text: self, role: :warn }
+  end
+
+  def fatty_error
+    { text: self, role: :error }
+  end
+end

data/lib/fatty/core_ext.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "core_ext/string"

data/lib/fatty/counter.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Fatty
+  # Counter accumulates and otherwise managed a numeric prefix count (e.g.,
+  # "12").
+  #
+  # Intended usage:
+  #   counter.push_digit(1)
+  #   counter.push_digit(2)
+  #   n = counter.consume(default: 1)  # => 12 (and clears)
+  #
+  class Counter
+    MAX_DIGITS = 6
+
+    def initialize
+      @digits = +""
+      @replace_next = false
+    end
+
+    def to_s
+      "Counter: #{@digits}; #{@replace_next}"
+    end
+
+    def active?
+      !@digits.empty?
+    end
+
+    def clear!
+      @digits.clear
+      @replace_next = false
+      self
+    end
+
+    def digits
+      @digits.dup
+    end
+
+    def push_digit(n)
+      if @replace_next
+        @digits.clear
+        @replace_next = false
+      end
+      if @digits.length < MAX_DIGITS
+        @digits << n.to_i.to_s
+      end
+      self
+    end
+
+    def set(n)
+      @digits = n.to_i.to_s
+      @replace_next = false
+      self
+    end
+
+    def universal_argument!
+      if active?
+        set(value * 4)
+      else
+        set(4)
+        @replace_next = true # next digit replaces the "4"
+      end
+      self
+    end
+
+    def value
+      if active?
+        @digits.to_i
+      end
+    end
+
+    def consume(default: nil)
+      n = value
+      if n.nil?
+        default
+      else
+        clear!
+        n
+      end
+    end
+  end
+end

data/lib/fatty/curses/context.rb

@@ -0,0 +1,279 @@
+# frozen_string_literal: true
+
+require "curses"
+
+module Fatty
+  module Curses
+    # Context represents the active curses environment.
+    #
+    # It owns:
+    #   - curses initialization and shutdown
+    #   - terminal mode configuration
+    #   - window lifecycle
+    #
+    # Context does NOT:
+    #   - read input
+    #   - decode keys
+    #   - render UI
+    #
+    # Those responsibilities belong to EventSource and Renderer.
+    #
+    # Context exists so that all curses state is centralized and never leaks
+    # into Sessions, Views, or Terminal.
+    class Context
+      DEFAULT_ESC_DELAY = 25
+
+      attr_reader :input_win, :output_win, :status_win, :alert_win
+      attr_reader :rows, :cols, :palette, :truecolor
+
+      def initialize
+        @started = false
+      end
+
+      def start
+        return self if @started
+
+        ::Curses.init_screen
+        configure_escape_delay!
+        MouseConstants.ensure!
+
+        ::Curses.raw
+        ::Curses.noecho
+        ::Curses.curs_set(1)
+        ::Curses.stdscr.keypad(true)
+        ::Curses.mousemask(::Curses::ALL_MOUSE_EVENTS)
+        enable_bracketed_paste!
+        setup_colors
+        @truecolor = truecolor_enabled?
+        @started = true
+        self
+      end
+
+      def configure_escape_delay!
+        delay =
+          if ENV["ESCDELAY"]
+            ENV["ESCDELAY"].to_i
+          else
+            Fatty::Config.config.dig(:esc_delay)&.to_i
+          end
+        delay = DEFAULT_ESC_DELAY if delay.nil? || delay <= 0
+        if ::Curses.respond_to?(:set_escdelay)
+          ::Curses.set_escdelay(delay)
+        else
+          ENV["ESCDELAY"] = delay.to_s
+        end
+        Fatty.info("ESC delay set to #{delay} ms", tag: :input)
+      end
+
+      def setup_colors
+        return unless ::Curses.has_colors?
+
+        reset_ansi_pairs!
+        ::Curses.start_color
+        ::Curses.use_default_colors if ::Curses.respond_to?(:use_default_colors)
+
+        theme_spec = Fatty::Themes::Manager.roles(Fatty::Themes::Manager.current) || {}
+        palette = Fatty::Colors::Palette.compile(
+          theme_spec,
+          available_colors: ::Curses.colors,
+        )
+        apply_palette(palette)
+      end
+
+      # Allocate or reallocate windows using Screen layout.
+      def apply_layout(screen)
+        ensure_started!
+
+        @rows = screen.rows
+        @cols = screen.cols
+
+        close_windows
+
+        out = screen.output_rect
+        sts = screen.status_rect
+        inp = screen.input_rect
+        alr = screen.alert_rect
+
+        @output_win = ::Curses::Window.new(out.rows, out.cols, out.row, out.col)
+        @status_win = ::Curses::Window.new(sts.rows, sts.cols, sts.row, sts.col)
+        @input_win  = ::Curses::Window.new(inp.rows, inp.cols, inp.row, inp.col)
+        @alert_win  = ::Curses::Window.new(alr.rows, alr.cols, alr.row, alr.col)
+
+        # We do our own viewport/paging; allowing curses to scroll introduces
+        # “mystery” blank lines if a newline slips into output
+        @output_win.scrollok(true)
+        @input_win.keypad(true)
+        self
+      end
+
+      def close
+        close_windows
+        disable_bracketed_paste! if @started
+        ::Curses.close_screen if @started
+        @started = false
+      end
+
+      # Map a Fatty::Ansi::Style to a curses attribute.
+      #
+      # - If style has no explicit fg/bg, we keep the themed role pair.
+      # - If style specifies fg/bg, we allocate/init a curses pair on demand.
+      #
+      # Note: this is intentionally independent of theme roles; it is for SGR
+      # output runs inside the output pane.
+      def truecolor_enabled?
+        cfg = Fatty::Config.config
+
+        setting =
+          if cfg.key?(:truecolor)
+            cfg[:truecolor]
+          else
+            "auto"
+          end
+        @truecolor =
+          case setting.to_s.downcase
+          when "true", "yes", "on", "1"
+            true
+          when "false", "no", "off", "0"
+            false
+          else
+            truecolor_env?
+          end
+        Fatty.info(
+          "truecolor=#{@truecolor} setting=#{setting.inspect} " \
+            "TERM=#{ENV['TERM'].inspect} COLORTERM=#{ENV['COLORTERM'].inspect} " \
+            "TERM_PROGRAM=#{ENV['TERM_PROGRAM'].inspect} TMUX=#{ENV.key?('TMUX')}",
+          tag: :themes,
+        )
+        @truecolor
+      end
+
+      def truecolor_env?
+        colorterm = ENV["COLORTERM"].to_s
+        term = ENV["TERM"].to_s
+        term_program = ENV["TERM_PROGRAM"].to_s
+
+        colorterm.match?(/truecolor|24bit/i) ||
+          term.match?(/truecolor|24bit|direct/i) ||
+          term.match?(/kitty|wezterm|alacritty|ghostty|foot/i) ||
+          term_program.match?(/kitty|wezterm|alacritty|ghostty|iTerm/i)
+      end
+
+      # Map a Fatty::Ansi::Style to a curses attribute.
+      #
+      # - If style has no explicit fg/bg, keep the themed role pair.
+      # - If style specifies fg/bg, allocate/init a curses pair on demand.
+      #
+      # This is intentionally independent of theme roles; it is for SGR output
+      # runs inside the output pane.
+      def ansi_attr(style, fallback_role: :output)
+        base_pair_id = Fatty::Colors::Pairs::ROLE_TO_PAIR.fetch(fallback_role)
+        base_attr = ::Curses.color_pair(base_pair_id)
+
+        has_explicit = !(style.fg.nil? && style.bg.nil?)
+        attr =
+          if has_explicit
+            pair_id = ansi_pair_id(style.fg, style.bg, fallback_pair_id: base_pair_id)
+            ::Curses.color_pair(pair_id)
+          else
+            base_attr
+          end
+        attr |= ::Curses::A_BOLD if style.bold
+        attr |= ::Curses::A_UNDERLINE if style.underline
+        attr |= ::Curses::A_REVERSE if style.reverse
+        if style.italic && defined?(::Curses::A_ITALIC)
+          attr |= ::Curses::A_ITALIC
+        end
+        if style.strike && defined?(::Curses::A_HORIZONTAL)
+          attr |= ::Curses::A_HORIZONTAL
+        end
+        attr
+      end
+
+      def apply_palette(palette)
+        if ::Curses.has_colors?
+          ::Curses.start_color
+          ::Curses.use_default_colors if ::Curses.respond_to?(:use_default_colors)
+          palette.each_value do |entry|
+            next unless entry[:pair]
+
+            ::Curses.init_pair(entry[:pair], entry[:fg], entry[:bg])
+          end
+        end
+        @palette = palette
+      end
+
+      private
+
+      def ensure_started!
+        return if @started
+
+        raise "Curses::Context not started"
+      end
+
+      def close_windows
+        @output_win&.close
+        @input_win&.close
+        @alert_win&.close
+        @status_win&.close
+
+        @output_win = nil
+        @input_win = nil
+        @alert_win = nil
+        @status_win = nil
+      end
+
+      # Generate a map from [fg, bg] pairs to Cuses pair ids.
+      def ansi_pair_id(fg, bg, fallback_pair_id:)
+        has_colors = ::Curses.has_colors?
+        return fallback_pair_id unless has_colors
+
+        @ansi_pairs ||= {}
+        @ansi_pair_limit ||= begin
+          ::Curses.color_pairs
+        rescue StandardError
+          256
+        end
+
+        key = [fg || -1, bg || -1]
+        cached = @ansi_pairs[key]
+        return cached if cached
+
+        # Leave low pair ids for stable theme roles.
+        start_id = 64
+        @ansi_next_pair_id ||= start_id
+        @ansi_next_pair_id = start_id if @ansi_next_pair_id < start_id
+
+        if @ansi_next_pair_id >= @ansi_pair_limit
+          @ansi_pairs[key] = fallback_pair_id
+        else
+          pair_id = @ansi_next_pair_id
+          @ansi_next_pair_id += 1
+
+          fg_i = fg.nil? ? -1 : fg.to_i
+          bg_i = bg.nil? ? -1 : bg.to_i
+          ::Curses.init_pair(pair_id, fg_i, bg_i)
+          @ansi_pairs[key] = pair_id
+        end
+
+        @ansi_pairs[key]
+      end
+
+      def reset_ansi_pairs!
+        @ansi_pairs = {}
+        @ansi_next_pair_id = 1
+      end
+
+      def enable_bracketed_paste!
+        $stdout.write("\e[?2004h")
+        $stdout.flush
+        nil
+      end
+
+      def disable_bracketed_paste!
+        $stdout.write("\e[?2004l")
+        $stdout.flush
+        nil
+      end
+    end
+  end
+end