irb-autosuggestions 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9d8279c02d62499ce7d58d2b8c4c47c7f8289fa4e601b140106219ea4d0d472
-  data.tar.gz: f35c372e76961a2b91fc65bdf1fe94e6ec6daa7fec810461b49eb8dd11c34379
+  metadata.gz: 4707ca01caa7501953cc12ea344aa7b4ebcc818c3e505a72f5f102f5e702e215
+  data.tar.gz: 343171aa866561a3e4af8502df4f02a45ba4df53b45487da08a78fa9d9dad764
 SHA512:
-  metadata.gz: 838a7272d857247def598a2989cd8c43eb35b8272183ce3623c25c53faa8e3bb2c375ed3b0006ec9942c2a34537e8fdc644961ab61477dfd86118fbc9f4ccf33
-  data.tar.gz: 85643f9c47045b2accbceb5a0f84b4eb13ae988b39550a541a21e320fec2f81d75e56128a73a59a9ab5061f0ccce1a2c8e984fcebb8b5a083b2927fcd0c6171f
+  metadata.gz: 8921326d3b52cba86e73a10fc8ca7eb88322897ad4296dafe2e34e2cd440c88de61086fb522ebf1a06367ec380dc6f1bb2f08afe420347a152d43bb68f393207
+  data.tar.gz: 3596a6d3c5a74336f68a21c1f13bff4e664ed2fbd3bd1728e84023a37a2bc2e64dd3ee74b153b810c253f8d6f85f61e5fc962c57bf9927afad4ada3037e77fc1

data/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+## [0.2.3] - 2026-08-21
+
+### Fixed
+
+- Text duplication and stale ghost fragments when typing lines that wrap past the terminal edge; ghost preview is now
+  hidden for suggestions that do not fit the current row instead of corrupting the display
+- Dim/color state leaking into subsequent input after accepting a suggestion
+
+## [0.2.2] - 2026-07-08
+
+### Added
+
+- Alternative key bindings to accept ghost suggestion: Tab, Ctrl+F, Ctrl+E (configurable via
+  `IRB.conf[:AUTOSUGGESTION_ACCEPT_KEYS]`) ([#15], [#157])
+- Configurable ghost color/style via `IRB.conf[:AUTOSUGGESTION_GHOST_COLOR]` (ANSI string) and
+  `IRB.conf[:AUTOSUGGESTION_GHOST_STYLE]` (declarative hash) ([#16], [#163])
+- GitHub issue templates (bug report, feature request) and pull request template
+
+### Fixed
+
+- Ghost text artifacts and cursor misalignment after accepting multiline (10+ lines) suggestions ([#19], [#256])
+- Auto-execute guard — verified Enter always fires exactly once regardless of ghost visibility ([#18], [#159])
+
+## [0.2.1] - 2026-07-05
+
+### Fixed
+
+- Ruby 4.0 compatibility: arrow (`ed_next_char`) not erasing after suggestion accept ([#13])
+
+## [0.2.0] - 2026-06-30
+
+### Added
+
+- Syntax-colored ghost text via `IRB::Color.colorize_code` (dimmed)
+- Prefix-filtered history navigation (up/down arrows match typed prefix)
+- Ruby 2.7 support
+
+### Changed
+
+- Ghost text now uses dim syntax colors when `IRB.conf[:USE_COLORIZE]` is enabled
+
+## [0.1.1] - 2026-06-25
+
+### Added
+
+- `IRB.conf[:USE_AUTOSUGGESTIONS]` toggle
+- Environment variable `IRB_AUTOSUGGESTIONS` override
+- RBS type signatures
+
+### Fixed
+
+- Gem metadata (licenses, homepage)
+
+## [0.1.0] - 2026-06-20
+
+### Added
+
+- Initial release: fish-like autosuggestions from `Reline::HISTORY`
+- Right arrow key accepts ghost suggestion
+- Gray ghost text (`\e[90m`)
+- Configuration via `IRB.conf[:USE_AUTOSUGGESTIONS]`
+
+[#15]: https://github.com/unurgunite/irb-autosuggestions/pull/15
+
+[#16]: https://github.com/unurgunite/irb-autosuggestions/pull/16
+
+[#18]: https://github.com/unurgunite/irb-autosuggestions/pull/18
+
+[#19]: https://github.com/unurgunite/irb-autosuggestions/pull/19
+
+[#157]: https://github.com/unurgunite/irb-autosuggestions/issues/157
+
+[#163]: https://github.com/unurgunite/irb-autosuggestions/issues/163
+
+[#159]: https://github.com/unurgunite/irb-autosuggestions/issues/159
+
+[#256]: https://github.com/unurgunite/irb-autosuggestions/issues/256

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    irb-autosuggestions (0.2.1)
+    irb-autosuggestions (0.2.3)
       reline
 
 GEM
@@ -9,16 +9,16 @@ GEM
   specs:
     ast (2.4.3)
     diff-lcs (1.6.2)
-    docscribe (1.3.3)
+    docscribe (1.6.0)
       parser (>= 3.3)
       prism (~> 1.8)
-    io-console (0.8.2)
-    json (2.19.5)
-    language_server-protocol (3.17.0.5)
+    io-console (0.9.2)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     logger (1.7.0)
     parallel (1.28.0)
-    parser (3.3.11.1)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
@@ -28,7 +28,7 @@ GEM
     rbs (3.6.1)
       logger
     regexp_parser (2.12.0)
-    reline (0.6.3)
+    reline (0.7.0)
       io-console (~> 0.5)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
@@ -43,7 +43,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.86.2)
+    rubocop (1.89.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -54,23 +54,24 @@ GEM
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.9.0)
+    rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
-      rubocop (~> 1.81)
-    rubocop-sorted_methods_by_call (1.2.2)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
+    rubocop-sorted_methods_by_call (1.2.3)
       lint_roller
       rubocop (>= 1.72.0)
     ruby-progressbar (1.13.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    yard (0.9.44)
+    yard (0.9.45)
 
 PLATFORMS
   arm64-darwin-24
@@ -91,4 +92,4 @@ DEPENDENCIES
   yard (>= 0.9.38)
 
 BUNDLED WITH
-  4.0.11
+   2.4.22

data/Gemfile_2_7.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    irb-autosuggestions (0.2.1)
+    irb-autosuggestions (0.2.3)
       reline
 
 GEM
@@ -9,15 +9,15 @@ GEM
   specs:
     ast (2.4.3)
     diff-lcs (1.6.2)
-    docscribe (1.3.3)
+    docscribe (1.6.0)
       parser (>= 3.3)
       prism (~> 1.8)
-    io-console (0.8.2)
-    json (2.19.5)
-    language_server-protocol (3.17.0.5)
+    io-console (0.9.2)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     parallel (1.28.0)
-    parser (3.3.11.1)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
@@ -25,7 +25,7 @@ GEM
     rainbow (3.1.1)
     rake (13.4.2)
     regexp_parser (2.12.0)
-    reline (0.6.3)
+    reline (0.7.0)
       io-console (~> 0.5)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
@@ -40,7 +40,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.86.2)
+    rubocop (1.89.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -51,23 +51,24 @@ GEM
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.9.0)
+    rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
-      rubocop (~> 1.81)
-    rubocop-sorted_methods_by_call (1.2.2)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
+    rubocop-sorted_methods_by_call (1.2.3)
       lint_roller
       rubocop (>= 1.72.0)
     ruby-progressbar (1.13.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    yard (0.9.44)
+    yard (0.9.45)
 
 PLATFORMS
   arm64-darwin-25

data/README.md

@@ -18,7 +18,9 @@ No need to explain. Fish-like autosuggestions for IRB — ghost text from histor
     * [Usage](#usage)
         * [Prefix-filtered history navigation](#prefix-filtered-history-navigation)
     * [Configuration](#configuration)
+        * [Ghost color](#ghost-color)
         * [Colors](#colors)
+        * [Accept keys](#accept-keys)
         * [How it works](#how-it-works)
     * [Development](#development)
     * [License](#license)
@@ -48,7 +50,8 @@ irb(main):002*   el.succ      <- "cc" in gray
 irb(main):003> end            <- "d" in gray
 ```
 
-Press **right arrow** (`->`) to accept the full multiline suggestion.
+Press **right arrow** (`->`), **Tab**, **Ctrl+F**, or **Ctrl+E** to accept the full multiline suggestion. Tab falls
+back to normal completion when no suggestion is visible. Accept keys are configurable (see below).
 
 ### Prefix-filtered history navigation
 
@@ -96,6 +99,29 @@ Or via environment variable:
 export IRB_AUTOSUGGESTIONS=0
 ```
 
+### Ghost color
+
+The plain gray fallback color can be customized. Syntax-colored ghost text (when `IRB::Color` is available) always
+takes precedence over these settings.
+
+Set a raw ANSI escape code:
+
+```ruby
+IRB.conf[:AUTOSUGGESTION_GHOST_COLOR] = "\e[32m" # green
+```
+
+Or use the declarative style hash:
+
+```ruby
+IRB.conf[:AUTOSUGGESTION_GHOST_STYLE] = { fg: :bright_black, italic: true }
+```
+
+Supported colors: `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`, `default`,
+`bright_black`, `bright_red`, `bright_green`, `bright_yellow`, `bright_blue`, `bright_magenta`,
+`bright_cyan`, `bright_white`.
+
+Supported attributes: `bold`, `dim`, `italic`, `underline`, `blink`, `reverse`.
+
 ### Colors
 
 Syntax-colored ghost text is **enabled by default** when `IRB::Color` is available and `IRB.conf[:USE_COLORIZE]` is
@@ -118,6 +144,19 @@ irb --nocolorize
 > schemes. If you notice visual artifacts (e.g., wrong colors, underlines, or unusual brightness), try disabling the
 > feature or switch to the gray fallback or create new issue.
 
+### Accept keys
+
+Configure which keys accept the ghost suggestion:
+
+```ruby
+IRB.conf[:AUTOSUGGESTION_ACCEPT_KEYS] = %i[ed_next_char tab ed_end_of_line]
+```
+
+Defaults: `[:ed_next_char, :ed_end_of_line, :tab]` (right arrow/Ctrl+F, Ctrl+E, Tab).
+
+Available symbols: `:ed_next_char` (right arrow/Ctrl+F), `:ed_end_of_line` (Ctrl+E), `:tab`, or
+any Reline method symbol. When no suggestion is visible, the key falls through to its normal behavior.
+
 ### How it works
 
 - Each keystroke queries `Reline::HISTORY` for the most recent entry whose prefix matches the current buffer.
@@ -127,7 +166,7 @@ irb --nocolorize
 - Extra ghost lines (for multiline history entries) are drawn below the prompt.
 - Ghost artifacts are cleared each frame using cursor save/restore (`\e[s`/`\e[u`) and per-line clearing (`\e[2K`),
   avoiding `\e[J` which interfered with Reline's cursor tracking.
-- Right arrow triggers `ed_next_char`, which replaces the buffer with the ghost text.
+- Configurable accept keys (right arrow, Tab, Ctrl+F, Ctrl+E by default) replace the buffer with the ghost text.
 - Up/down arrows use prefix-filtered navigation when the buffer is non-empty, falling back to unfiltered browsing
   when nothing was typed.
 

data/lib/irb/autosuggestions/line_editor_patch.rb

@@ -14,40 +14,66 @@ module Irb
       ENV_KEY = 'IRB_AUTOSUGGESTIONS'
       CONFIG_NAV_KEY = :USE_PREFIX_HISTORY_NAVIGATION
       ENV_NAV_KEY = 'IRB_PREFIX_HISTORY_NAVIGATION'
-
-      # Intercepts key input to accept autosuggestions on right arrow
+      ACCEPT_KEYS_CONFIG = :AUTOSUGGESTION_ACCEPT_KEYS
+      DEFAULT_ACCEPT_KEYS = %i[ed_next_char ed_end_of_line tab].freeze
+      GHOST_COLOR_CONFIG = :AUTOSUGGESTION_GHOST_COLOR
+      GHOST_STYLE_CONFIG = :AUTOSUGGESTION_GHOST_STYLE
+      DEFAULT_GHOST_COLOR = "\e[90m"
+      FG_MAP = {
+        black: 30, red: 31, green: 32, yellow: 33, blue: 34, magenta: 35, cyan: 36, white: 37,
+        default: 39,
+        bright_black: 90, bright_red: 91, bright_green: 92, bright_yellow: 93,
+        bright_blue: 94, bright_magenta: 95, bright_cyan: 96, bright_white: 97
+      }.freeze
+      ATTR_MAP = {
+        bold: 1, dim: 2, italic: 3, underline: 4, blink: 5, reverse: 7
+      }.freeze
+
+      # Intercepts key input to accept autosuggestions on configured keys
       # and clears the prefix navigation anchor on non-history keys.
       #
       # @param [Object] key A Reline key event.
       # @return [Object]
       def input_key(key)
+        # Some keys (Enter, submission) bypass rerender, so ghost is cleared
+        # on every key to avoid stale ghost lines leftover on screen.
+        clear_previous_ghost if enabled?
+
         clear_prefix_anchor if navigation_enabled? && !history_navigation_key?(key)
 
-        if enabled? && right_arrow?(key)
-          buffer = whole_buffer
-          suggestion = find_suggestion(buffer)
-
-          if suggestion && suggestion != buffer
-            accept_suggestion(suggestion)
-            return
-          end
-        end
+        return if enabled? && accept_key?(key) && accept_matching_suggestion?
 
         super
       end
 
+      # Accepts the current suggestion when it extends the buffer.
+      #
+      # @return [Boolean] true when a suggestion was accepted
+      def accept_matching_suggestion?
+        buffer = whole_buffer
+        suggestion = find_suggestion(buffer)
+        return false unless suggestion && suggestion != buffer
+
+        accept_suggestion(suggestion)
+        true
+      end
+
       # Injects ghost text into terminal output after Reline finishes rendering.
       # Must be public because Reline::Core calls +rerender+ externally.
       # Works on both Reline 0.3.x (rerender is the main rendering entry) and
       # Reline 0.4+ (rerender calls render internally).
       #
+      # Ghost is cleared BEFORE super to avoid cursor-position-dependent
+      # escapes targeting wrong lines after accept_suggestion changes buffer.
+      #
       # @return [Object] The result of +super+.
       def rerender
+        clear_previous_ghost if enabled?
+
         result = super
-        if enabled?
-          clear_previous_ghost
-          render_ghost_suggestion
-        end
+
+        render_ghost_suggestion if enabled?
+
         result
       end
 
@@ -212,14 +238,34 @@ module Irb
         end
       end
 
-      # Checks if a key event is a right arrow press.
+      # Checks if a key event matches any configured accept key.
+      # Defaults to right arrow (:ed_next_char).
+      # Tab is matched specially — method_symbol == :ed_insert + char == "\t".
       #
       # @private
       # @param [Object] key A Reline key event.
       # @return [Boolean]
-      def right_arrow?(key)
-        key.respond_to?(:method_symbol) &&
-          key.method_symbol == :ed_next_char
+      def accept_key?(key)
+        accept_keys = IRB.conf.fetch(ACCEPT_KEYS_CONFIG, DEFAULT_ACCEPT_KEYS)
+        accept_keys.any? { |k| key_match?(key, k) }
+      end
+
+      # Checks if a key matches a given config symbol.
+      #
+      # @private
+      # @param [Object] key A Reline key event.
+      # @param [Symbol] config_symbol One of :ed_next_char, :ed_end_of_line, :tab, etc.
+      # @return [Boolean]
+      def key_match?(key, config_symbol)
+        return false unless key.respond_to?(:method_symbol)
+
+        if config_symbol == :tab
+          key.method_symbol == :ed_insert &&
+            key.respond_to?(:char) &&
+            key.char == "\t"
+        else
+          key.method_symbol == config_symbol
+        end
       end
 
       # Finds the index of the previous (older) history entry starting with +buffer+.
@@ -283,6 +329,13 @@ module Irb
 
       # Renders ghost text for the current buffer, if a suggestion exists.
       #
+      # The ghost is reduced to fit the terminal width so it never wraps
+      # onto the following row. A ghost that wraps corrupts Reline's
+      # single-row cursor model (duplicated text, stale ANSI state),
+      # because Reline does not track visual wrapping of long lines.
+      # Suggestions remain accept-able via the configured keys even when
+      # the ghost is truncated.
+      #
       # @private
       # @return [void]
       def render_ghost_suggestion
@@ -296,7 +349,99 @@ module Irb
         ghost = suggestion[buffer.size..]
         return if ghost.nil? || ghost.empty?
 
-        render_ghost(ghost, suggestion)
+        render_ghost(truncate_ghost_to_terminal(ghost), suggestion, suggestion.bytesize - ghost.bytesize)
+      end
+
+      # Truncates ghost text so no visible line exceeds the terminal width:
+      # the inline part is capped at the space left on the current line,
+      # each following line at the space left after the prompt.
+      #
+      # @private
+      # @param [String] ghost The ghost text (suffix of the suggestion).
+      # @return [String]
+      def truncate_ghost_to_terminal(ghost)
+        inline_limit = terminal_width - current_line_width - 1
+        return String.new if inline_limit <= 0
+
+        lines = ghost.split("\n", -1)
+        truncate_to_width(lines.first, inline_limit) + truncate_rest_lines(lines)
+      end
+
+      # Truncates every ghost line after the first at the width left
+      # after the prompt, keeping line breaks intact.
+      #
+      # @private
+      # @param [Array<String>] lines
+      # @return [String]
+      def truncate_rest_lines(lines)
+        rest_limit = terminal_width - prompt_width - 1
+        rest = lines.drop(1).map { |line| truncate_to_width(line, rest_limit) }
+        rest.empty? ? String.new : "\n#{rest.join("\n")}"
+      end
+
+      # Display width of the first ghost line.
+      #
+      # @private
+      # Truncates a string to the given display width, appending an
+      # ellipsis when cut. Counts Unicode display width, so multi-column
+      # characters are handled correctly.
+      #
+      # @private
+      # @param [String] str
+      # @param [Integer] max_width
+      # @return [String]
+      def truncate_to_width(str, max_width)
+        return String.new if max_width.negative?
+        return str if max_width.zero? || Reline::Unicode.calculate_width(str) <= max_width
+
+        "#{chars_up_to(str, max_width - 1)}…"
+      end
+
+      # Characters of +str+ whose combined display width does not
+      # exceed +max_width+.
+      #
+      # @private
+      # @param [String] str
+      # @param [Integer] max_width
+      # @return [String]
+      def chars_up_to(str, max_width)
+        width = 0
+        str.each_char.with_object(+'') do |char, out|
+          char_width = Reline::Unicode.calculate_width(char)
+          break out if width + char_width > max_width
+
+          width += char_width
+          out << char
+        end
+      end
+
+      # Width of the prompt (in display columns).
+      #
+      # @private
+      # @return [Integer]
+      def prompt_width
+        @prompt ? Reline::Unicode.calculate_width(@prompt) : 0
+      end
+
+      # Display width of the prompt plus the current buffer line.
+      #
+      # @private
+      # @return [Integer]
+      def current_line_width
+        line = @buffer_of_lines[@line_index] || ''
+        prompt_width + Reline::Unicode.calculate_width(line)
+      end
+
+      # Terminal width in columns, falling back to 80 when unknown.
+      #
+      # @private
+      # @return [Integer]
+      def terminal_width
+        if defined?(Reline::IOGate) && Reline::IOGate.respond_to?(:get_screen_size)
+          Reline::IOGate.get_screen_size[1]
+        else
+          80
+        end
       end
 
       # Finds the most recent history entry that starts with the given buffer.
@@ -333,10 +478,12 @@ module Irb
       # @private
       # @param [String] ghost The ghost text (suffix of the suggestion).
       # @param [String, nil] suggestion The full matching history entry.
+      # @param [Integer, nil] ghost_byte_start Byte offset of the ghost within the
+      #   full suggestion (pre-truncation), used to extract the colored suffix.
       # @return [void]
-      def render_ghost(ghost, suggestion = nil) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+      def render_ghost(ghost, suggestion = nil, ghost_byte_start = nil) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
         output = Reline.core.instance_variable_get(:@output)
-        display_lines = ghost_display_lines(ghost, suggestion)
+        display_lines = ghost_display_lines(ghost, suggestion, ghost_byte_start)
         @ghost_line_count = display_lines.size - 1
         @has_inline_ghost = true
 
@@ -354,21 +501,47 @@ module Irb
       #
       # When colorization is enabled, the full suggestion is colorized via
       # IRB::Color and the ghost portion is extracted from the colored output.
-      # Otherwise, each line is wrapped in GRAY/RESET.
       #
       # @private
       # @param [String] ghost The ghost text (suffix of the suggestion).
       # @param [String, nil] suggestion The full matching history entry.
+      # @param [Integer, nil] ghost_byte_start Byte offset of the ghost within the
+      #   full suggestion (pre-truncation), used to extract the colored suffix.
       # @raise [StandardError]
       # @return [Array<String>]
-      def ghost_display_lines(ghost, suggestion)
+      def ghost_display_lines(ghost, suggestion, ghost_byte_start = nil)
         if suggestion && use_colorize?
-          colorize_ghost_lines(ghost, suggestion)
+          colorize_ghost_lines(ghost, suggestion, ghost_byte_start)
         else
-          ghost.split("\n").map { |line| "#{GRAY}#{line}#{RESET}" }
+          ghost.split("\n").map { |line| "#{ghost_color}#{line}#{RESET}" }
         end
       rescue StandardError
-        ghost.split("\n").map { |line| "#{GRAY}#{line}#{RESET}" }
+        ghost.split("\n").map { |line| "#{ghost_color}#{line}#{RESET}" }
+      end
+
+      # Returns the effective ANSI color code for ghost text.
+      # Checks GHOST_STYLE_CONFIG first, then GHOST_COLOR_CONFIG, then default.
+      #
+      # @private
+      # @return [String]
+      def ghost_color
+        style = IRB.conf[GHOST_STYLE_CONFIG]
+        return resolve_ghost_style(style) if style.is_a?(Hash)
+
+        IRB.conf.fetch(GHOST_COLOR_CONFIG, DEFAULT_GHOST_COLOR)
+      end
+
+      # Converts a style hash like +{ fg: :bright_black, italic: true }+
+      # to an ANSI escape sequence.
+      #
+      # @private
+      # @param [Hash] hash Style hash with +:fg+ color and optional attribute keys.
+      # @return [String]
+      def resolve_ghost_style(hash)
+        codes = []
+        codes << FG_MAP[hash[:fg]] if hash[:fg]
+        ATTR_MAP.each { |attr, code| codes << code if hash[attr] }
+        "\e[#{codes.join(';')}m"
       end
 
       # Checks whether syntax coloring is available and enabled.
@@ -383,15 +556,78 @@ module Irb
 
       # Colorizes the full suggestion and extracts the ghost portion.
       #
+      # +ghost_byte_start+ is the visible-byte offset of the ghost within
+      # the suggestion. It must come from the full (untruncated) ghost:
+      # using a truncated ghost shifts the offset into the middle of the
+      # suggestion and the colored suffix no longer matches the buffer.
+      # Colored lines are then truncated to fit the terminal width, same
+      # as the plain-text ghost.
+      #
       # @private
       # @param [String] ghost The ghost text (suffix of the suggestion).
       # @param [String] suggestion The full matching history entry.
+      # @param [Integer, nil] ghost_byte_start Visible-byte offset of the ghost.
       # @return [Array<String>] Colorized ghost lines with ANSI codes.
-      def colorize_ghost_lines(ghost, suggestion)
+      def colorize_ghost_lines(ghost, suggestion, ghost_byte_start = nil)
         colored = IRB::Color.colorize_code(suggestion)
-        ghost_byte_start = suggestion.bytesize - ghost.bytesize
-        colored_ghost = extract_ansi_colored_suffix(colored, ghost_byte_start)
-        colored_ghost.split("\n").map { |line| dim_line(line) }
+        start = ghost_byte_start || (suggestion.bytesize - ghost.bytesize)
+        colored_ghost = extract_ansi_colored_suffix(colored, start)
+        truncate_colored_ghost(colored_ghost).map { |line| dim_line(line) }
+      end
+
+      # Truncates colorized ghost lines so no line exceeds the terminal
+      # width, mirroring +truncate_ghost_to_terminal+ for plain text.
+      #
+      # @private
+      # @param [String] colored_ghost ANSI-colored ghost text.
+      # @return [Array<String>]
+      def truncate_colored_ghost(colored_ghost)
+        lines = colored_ghost.split("\n")
+        rest_limit = terminal_width - prompt_width - 1
+        first = truncate_colored_to_width(lines.first, terminal_width - current_line_width - 1)
+        [first] + lines.drop(1).map { |line| truncate_colored_to_width(line, rest_limit) }
+      end
+
+      # Truncates an ANSI-colored line to the given display width, counting
+      # escape codes as zero-width, and appending an ellipsis when cut.
+      #
+      # @private
+      # @param [String] line ANSI-colored line.
+      # @param [Integer] max_width
+      # @return [String]
+      def truncate_colored_to_width(line, max_width)
+        return String.new if max_width <= 0
+        return line if Reline::Unicode.calculate_width(line, true) <= max_width
+
+        "#{colored_chars_up_to(line, max_width - 1)}…"
+      end
+
+      # Characters of +line+ (with ANSI codes preserved) whose combined
+      # display width does not exceed +max_width+.
+      #
+      # @private
+      # @param [String] line ANSI-colored line.
+      # @param [Integer] max_width
+      # @return [String]
+      def colored_chars_up_to(line, max_width) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+        width = 0
+        out = +''
+        rest = line.dup
+        until rest.empty?
+          if rest.start_with?("\e")
+            code = rest[/\e\[[0-9;]*m/]
+            out << code
+            rest = code ? rest[code.length..] : ''
+            next
+          end
+          char = rest.each_char.first
+          break if width + Reline::Unicode.calculate_width(char) > max_width
+
+          width += Reline::Unicode.calculate_width(char)
+          out << char
+          rest = rest[char.length..]
+        end
+        out
       end
 
       # Prepends each ANSI foreground color code with +2;+ (dim)
@@ -450,7 +686,6 @@ module Irb
       def write_extra_ghost_lines(lines)
         return if lines.empty?
 
-        prompt_width = @prompt ? Reline::Unicode.calculate_width(@prompt) : 0
         output = Reline.core.instance_variable_get(:@output)
 
         lines.each do |line|
@@ -466,7 +701,6 @@ module Irb
       # @private
       # @return [Integer]
       def cursor_column_at_byte_pointer
-        prompt_width = @prompt ? Reline::Unicode.calculate_width(@prompt) : 0
         current_line = @buffer_of_lines[@line_index] || ''
         prompt_width + Reline::Unicode.calculate_width(current_line[0...@byte_pointer])
       end
@@ -476,10 +710,8 @@ module Irb
       # @private
       # @return [String]
       def move_to_buffer_end
-        prompt_width = @prompt ? Reline::Unicode.calculate_width(@prompt) : 0
         current_line = @buffer_of_lines[@line_index] || ''
-        buf_end = prompt_width + Reline::Unicode.calculate_width(current_line)
-        "\e[0G\e[#{buf_end}C"
+        "\e[0G\e[#{prompt_width + Reline::Unicode.calculate_width(current_line)}C"
       end
     end
   end

data/lib/irb/autosuggestions/version.rb

@@ -2,6 +2,6 @@
 
 module Irb
   module Autosuggestions
-    VERSION = '0.2.1'
+    VERSION = '0.2.3'
   end
 end

data/sig/lib/irb/autosuggestions/line_editor_patch.rbs

@@ -10,24 +10,39 @@ module Irb
       CONFIG_KEY: Symbol
       ENV_KEY: String
       RESET_COLOR: String
+      ACCEPT_KEYS_CONFIG: Symbol
+      DEFAULT_ACCEPT_KEYS: Array[Symbol]
+      GHOST_COLOR_CONFIG: Symbol
+      GHOST_STYLE_CONFIG: Symbol
+      DEFAULT_GHOST_COLOR: String
+      FG_MAP: Hash[Symbol, Integer]
+      ATTR_MAP: Hash[Symbol, Integer]
 
       @buffer_of_lines: Array[String]
       @byte_pointer: Integer
       @line_index: Integer
 
       def input_key: (untyped key) -> untyped
+      def rerender: () -> untyped
       def render: (*untyped) -> untyped
       def enabled?: () -> bool
+      def navigation_enabled?: () -> bool
       def use_colorize?: () -> bool
-      def right_arrow?: (untyped key) -> bool
+      def accept_key?: (untyped key) -> bool
+      def key_match?: (untyped key, Symbol config_symbol) -> bool
+      def ghost_color: () -> String
+      def resolve_ghost_style: (Hash[Symbol, untyped] hash) -> String
+      def render_ghost_suggestion: () -> void
       def render_ghost: (String ghost, ?String suggestion) -> void
       def ghost_display_lines: (String ghost, ?String suggestion) -> Array[String]
       def colorize_ghost_lines: (String ghost, String suggestion) -> Array[String]
+      def dim_line: (String line) -> String
       def extract_ansi_colored_suffix: (String colored_text, Integer visible_byte_offset) -> String
       def write_extra_ghost_lines: (Array[String] lines) -> void
-      def restore_cursor_after: (Array[String] lines) -> void
       def find_suggestion: (String buffer) -> (String | nil)
       def accept_suggestion: (String suggestion) -> void
+      def find_prev_match: (String buffer, Integer? from_pointer) -> Integer?
+      def find_next_match: (String buffer, Integer? from_pointer) -> Integer?
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: irb-autosuggestions
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - unurgunite
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-30 00:00:00.000000000 Z
+date: 2026-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: reline
@@ -145,6 +145,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock