terminal_rb 0.12.2 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76a55505ad930b5c59af396e566e1079e3aa0c339d4ef68d5adf559c243c549a
-  data.tar.gz: 87882ec5820678e2f657d739588cd8502167aa68c5fffad47296903b387ced94
+  metadata.gz: 107b7b65dc5f58b1178e01fc86adad127df49fd175e56f7e36d2bfb873fc17a9
+  data.tar.gz: dfbf4797df22ac2803034a85a00fce2c480e4530840abd0d2a900bfb98993db5
 SHA512:
-  metadata.gz: e9fffe327952f951928e43e2b29aec523f87794c499b1b9c81a483a529653c4434f3422e0a32b0ed2c08a3886a50a3f74f10704a50c5397867c470cc97a974ac
-  data.tar.gz: fee9b96d3b899667b772fb68590ecea6476c904279b374132d30fca959f5c1cc4559709a600302cb71aeb78eb4a9b128cc7167a64efd835ddc96e93f10c5b85a
+  metadata.gz: 115235b382d02c4c5242925e1bf1ff3b9928702b30682dd4a2964282b11df6339118da582e0eebc096806005f781a537688741eab2e94984db391abaf6b4ec72
+  data.tar.gz: 2718bf0147fcb7c3d84374f59c4f8ea4862c58dfd6982057196a78bd1f4308eb9c319a55ba3c41339a45a6fa994b1449b2cedb2e00ce6de5548dd3eaa5b98fa0

data/README.md

@@ -1,10 +1,10 @@
 # Terminal.rb ![version](https://img.shields.io/gem/v/terminal_rb?label=)
 
-Terminal access with super fast ANSI control codes support and [BBCode-like](https://en.wikipedia.org/wiki/BBCode) embedded text attribute syntax.
+Terminal.rb supports you with input and output on your terminal. Simple [BBCode](https://en.wikipedia.org/wiki/BBCode)-like markup for attributes and coloring, word-wise line breaks, and correct special key recognition enable you to implement your CLI app quickly and easily.
 
 - Gem: [rubygems.org](https://rubygems.org/gems/terminal_rb)
 - Source: [codeberg.org](https://codeberg.org/mblumtritt/Terminal.rb)
-- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/Terminal)
+- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/index)
 
 ## Features
 

data/examples/bbcode.rb

@@ -7,12 +7,13 @@ Terminal.puts <<~TEXT
   ✅ [b bright_green]Terminal.rb::Ansi[/b] — BBCode:[/]
 
               [b]Bold[/b]   [\\b]...[\\/b] or [\\bold]...[\\/bold]
-             [faint]Faint[/faint]   [\\faint]...[\\/faint]
-            [i]Italic[/i]   [\\i]...[\\/i] or [\\|italic]...[\\/italic]
+             [dim]Dim[/dim]     [\\d]...[\\/d] or [\\dim]...[\\/dim]
+            [i]Italic[/i]   [\\i]...[\\/i] or [\\italic]...[\\/italic]
+         [u]Underline[/u]   [\\u]...[\\/u] or [\\|undeline]...[\\/undeline]
             [inv]Invert[/inv]   [\\inv]...[\\/inv] or [\\invert]...[\\/invert]
-            [strike]Strike[/strike]   [\\strike]...[\\/strike]
               [h]Hide[/h]   [\\h]...[\\/h] or [\\hide]...[\\/hide] or [\\conceal]...[\\/conceal]
-        [blink]Slow blink[/blink]   [\\blink]...[\\/blink] or [\\slow_blink]...[\\/slow_blink]
+            [strike]Strike[/strike]   [\\strike]...[\\/strike]
+             [blink]Blink[/blink]   [\\blink]...[\\/blink]
          [u]Underline[/u]   [\\u]...[\\/u] or [\\underline]...[\\/underline]
   [uu]Double underline[/uu]   [\\uu]...[\\/uu] or [\\double_underline]...[\\/double_underline]
    [cu]Curly underline[/cu]   [\\cu]...[\\/cu] or [\\curly_underline]...[\\/curly_underline]

data/lib/terminal/ansi.rb

@@ -12,7 +12,7 @@ module Terminal
       #
       # @attribute [r] attributes
       # @return [Array<Symbol>] all attribute names
-      def attributes = @attr_sym.keys
+      def attributes = @attributes.dup
 
       # Supported 3/4-bit color names.
       #
@@ -20,7 +20,7 @@ module Terminal
       #
       # @attribute [r] colors
       # @return [Array<Symbol>] all color names
-      def colors = @colors_sym.keys
+      def colors = @colors.dup
 
       # Supported basic 24-bit (Kitty compatible) color names.
       #
@@ -99,10 +99,9 @@ module Terminal
             .map do |arg|
               case arg
               when String
-                @attr[arg] || @colors[arg] || _color(arg) || _invalid(arg)
+                @attr_map[arg] || _invalid(arg)
               when Symbol
-                @attr_sym[arg] || @colors_sym[arg] || _color(arg) ||
-                  _invalid(arg)
+                @attrs_map[arg] || _invalid(arg)
               when (0..255)
                 "38;5;#{arg}"
               when (256..511)
@@ -179,11 +178,7 @@ module Terminal
       def try_convert(attributes, separator: ' ')
         return unless attributes
         return if (attributes = attributes.to_s.split(separator)).empty?
-        "\e[#{
-          attributes
-            .map! { @attr[_1] || @colors[_1] || _color(_1) || return }
-            .join(';')
-        }m"
+        "\e[#{attributes.map! { @attr_map[_1] || return }.join(';')}m"
       end
 
       # Test if all given attributes are valid.
@@ -196,9 +191,9 @@ module Terminal
         attributes.all? do |arg|
           case arg
           when String
-            @attr[arg] || @colors[arg] || _color(arg)
+            @attr_map[arg]
           when Symbol
-            @attr_sym[arg] || @colors_sym[arg] || _color(arg)
+            @attrs_map[arg]
           when (0..767)
             true
           end
@@ -249,7 +244,7 @@ module Terminal
           match = Regexp.last_match(1) or next match_str
           next "[#{match[1..]}]" if match[0] == '\\'
           next match_str if (match = match.split).empty?
-          next if match.all? { @attr[_1] || @colors[_1] || _color(_1) }
+          next if match.all? { @attr_map[_1] }
           match_str
         end
       end
@@ -277,7 +272,7 @@ module Terminal
             match = Regexp.last_match(1) or next match_str
             next "[#{match[1..]}]" if match[0] == '\\'
             next match_str if (match = match.split).empty?
-            next if match.all? { @attr[_1] || @colors[_1] || _color(_1) }
+            next if match.all? { @attr_map[_1] }
             match_str
           end
         str.index("\e") ? str.gsub!(@re_test, '') : str
@@ -392,7 +387,7 @@ module Terminal
 
       # Erase screen part.
       #
-      # @param [:below, :above, :all, :scrollback] part screen part to erase
+      # @param part [:below, :above, :all, :scrollback] screen part to erase
       # @return (see cursor_up)
       def screen_erase(part = :all)
         "\e[#{
@@ -449,7 +444,7 @@ module Terminal
 
       # Erase part of line.
       #
-      # @param [:to_end, :to_start, :all] part line part to erase
+      # @param part [:to_end, :to_start, :all] line part to erase
       # @return (see cursor_up)
       def line_erase(part = :all)
         "\e[#{
@@ -473,7 +468,7 @@ module Terminal
       # Tabby,
       # WezTerm.
       #
-      # @param [#to_s] title text
+      # @param title [#to_s] text
       # @return (see cursor_up)
       def title(title) = "\e]0;#{title}\a"
 
@@ -486,8 +481,8 @@ module Terminal
       # Tabby,
       # WezTerm.
       #
-      # @param [#to_s] url URL to link to
-      # @param [#to_s] text text to display for the link
+      # @param url [#to_s] URL to link to
+      # @param text [#to_s] text to display for the link
       # @return (see cursor_up)
       def link(url, text) = "\e]8;;#{url}\a#{text}\e]8;;\a"
 
@@ -502,18 +497,19 @@ module Terminal
       # @example Half-height Greeting
       #   Terminal::Ansi.scale('Hello Ruby!', fracn: 1, fracd: 2, vertical: :centered)
       #
-      # @param [#to_s] text text to scale
-      # @param [Integer, nil] scale
+      # @param text [#to_s]
+      #   text to scale
+      # @param scale [Integer, nil]
       #   overall scale size, range 1..7
-      # @param [Integer, nil] width
+      # @param width [Integer, nil]
       #   with in cells, range 0..7
-      # @param [Integer, nil] fracn
+      # @param fracn [Integer, nil]
       #   numerator for the fractional scale, range: 0..15
-      # @param [Integer, nil] fracd
+      # @param fracd [Integer, nil]
       #   denominator for the fractional scale, range: 0..15, > fracn
-      # @param [:top, :bottom, :centered, nil] vertical
+      # @param vertical [:top, :bottom, :centered, nil]
       #   vertical alignment to use for fractionally scaled text
-      # @param [:left, :right, :centered, nil] horizontal
+      # @param horizontal [:left, :right, :centered, nil]
       #   horizontal alignment to use for fractionally scaled text
       # @return (see cursor_up)
       def scale(
@@ -586,9 +582,9 @@ module Terminal
       end
     end
 
-    @cbase =
-      { 'bg' => '48', 'on' => '48', 'ul' => '58' }.tap { _1.default = '38' }
-        .freeze
+    @cbase = { 'bg' => '48', 'on' => '48', 'ul' => '58' }
+    @cbase.default = '38'
+    @cbase.freeze
 
     @re_test =
       /
@@ -599,71 +595,259 @@ module Terminal
 
     @re_bbcode = /(?:\[((?~[\[\]]))\])/
 
-    require_relative 'ansi/attributes'
+    attr_map = {
+      '' => 'reset',
+      '1' => 'bold',
+      '2' => 'faint',
+      '3' => 'italic',
+      '4' => 'underline',
+      '5' => 'blink',
+      '6' => 'rapid_blink',
+      '7' => 'invert',
+      '8' => 'hide',
+      '9' => 'strike',
+      '10' => 'primary_font',
+      '11' => 'font1',
+      '12' => 'font2',
+      '13' => 'font3',
+      '14' => 'font4',
+      '15' => 'font5',
+      '16' => 'font6',
+      '17' => 'font7',
+      '18' => 'font8',
+      '19' => 'font9',
+      '20' => 'fraktur',
+      '21' => 'double_underline',
+      '22' => 'bold_off', # faint_off
+      '23' => 'italic_off', # fraktur_off
+      '24' => 'underline_off', # double_underline_off
+      '25' => 'blink_off', # rapid_blink_off
+      '26' => 'proportional',
+      '27' => 'invert_off',
+      '28' => 'hide_off',
+      '29' => 'strike_off',
+      # colors ...
+      '50' => 'proportional_off',
+      '51' => 'framed',
+      '52' => 'encircled',
+      '53' => 'overlined',
+      '54' => 'framed_off', # encircled_off
+      '55' => 'overlined_off',
+      # ...
+      '73' => 'superscript',
+      '74' => 'subscript',
+      '75' => 'superscript_off', # subscript_off
+      # special underline
+      '4:3' => 'curly_underline',
+      '4:4' => 'dotted_underline',
+      '4:5' => 'dashed_underline',
+      '4:0' => 'curly_underline_off' # dotted_underline_off, dashed_underline_off
+    }.invert
+    attr_alias = ->(t, s) { attr_map[t] = attr_map[s] }
+
+    clr_map = {
+      # foreground
+      '30' => 'black',
+      '31' => 'red',
+      '32' => 'green',
+      '33' => 'yellow',
+      '34' => 'blue',
+      '35' => 'magenta',
+      '36' => 'cyan',
+      '37' => 'white',
+      '39' => 'default', # reset
+      # background
+      '40' => 'on_black',
+      '41' => 'on_red',
+      '42' => 'on_green',
+      '43' => 'on_yellow',
+      '44' => 'on_blue',
+      '45' => 'on_magenta',
+      '46' => 'on_cyan',
+      '47' => 'on_white',
+      '49' => 'on_default', # reset
+      # underline
+      '58;2;0;0;0' => 'ul_black',
+      '58;2;0;0;128' => 'ul_blue',
+      '58;2;0;0;255' => 'ul_bright_blue',
+      '58;2;0;128;0' => 'ul_green',
+      '58;2;0;128;128' => 'ul_cyan',
+      '58;2;0;255;0' => 'ul_bright_green',
+      '58;2;0;255;255' => 'ul_bright_cyan',
+      '58;2;128;0;0' => 'ul_red',
+      '58;2;128;0;128' => 'ul_magenta',
+      '58;2;128;128;0' => 'ul_yellow',
+      '58;2;128;128;128' => 'ul_white',
+      '58;2;255;0;0' => 'ul_bright_red',
+      '58;2;255;0;255' => 'ul_bright_magenta',
+      '58;2;255;255;0' => 'ul_bright_yellow',
+      '58;2;255;255;255' => 'ul_bright_white',
+      '58;2;64;64;64' => 'ul_bright_black',
+      '59' => 'ul_default', # reset
+      # bright foreground
+      '90' => 'bright_black',
+      '91' => 'bright_red',
+      '92' => 'bright_green',
+      '93' => 'bright_yellow',
+      '94' => 'bright_blue',
+      '95' => 'bright_magenta',
+      '96' => 'bright_cyan',
+      '97' => 'bright_white',
+      # bright background
+      '100' => 'on_bright_black',
+      '101' => 'on_bright_red',
+      '102' => 'on_bright_green',
+      '103' => 'on_bright_yellow',
+      '104' => 'on_bright_blue',
+      '105' => 'on_bright_magenta',
+      '106' => 'on_bright_cyan',
+      '107' => 'on_bright_white'
+    }.invert
+    clr_alias = ->(t, s) { clr_map[t] = clr_map[s] }
+
+    %w[black red green yellow blue magenta cyan white].each do |name|
+      clr_alias["fg_#{name}", name]
+      clr_alias["bg_#{name}", "on_#{name}"]
+      clr_alias["fg_bright_#{name}", "bright_#{name}"]
+      clr_alias["bg_bright_#{name}", "on_bright_#{name}"]
+    end
+    clr_alias['fg_default', 'default']
+    clr_alias['bg_default', 'on_default']
+
+    attr_alias['faint_off', 'bold_off']
+    attr_alias['fraktur_off', 'italic_off']
+    attr_alias['double_underline_off', 'underline_off']
+    attr_alias['rapid_blink_off', 'blink_off']
+    attr_alias['encircled_off', 'framed_off']
+    attr_alias['subscript_off', 'superscript_off']
+    attr_alias['dotted_underline_off', 'curly_underline_off']
+    attr_alias['dashed_underline_off', 'curly_underline_off']
+
+    # extra aliases:
+    attr_alias['off', 'reset']
+    attr_alias['dim', 'faint']
+    attr_alias['dim_off', 'faint_off']
+    attr_alias['conceal', 'hide']
+    attr_alias['conceal_off', 'hide_off']
+    attr_alias['reveal', 'hide_off']
+    attr_alias['spacing', 'proportional']
+    attr_alias['spacing_off', 'proportional_off']
+
+    # shortcuts:
+    attr_alias['b', 'bold']
+    attr_alias['d', 'dim']
+    attr_alias['i', 'italic']
+    attr_alias['u', 'underline']
+    attr_alias['inv', 'invert']
+    attr_alias['h', 'hide']
+    attr_alias['s', 'strike']
+    attr_alias['uu', 'double_underline']
+    attr_alias['ovr', 'overlined']
+    attr_alias['sup', 'superscript']
+    attr_alias['sub', 'subscript']
+    attr_alias['cu', 'curly_underline']
+    attr_alias['dau', 'dashed_underline']
+    attr_alias['dou', 'dotted_underline']
+
+    @colors = clr_map.keys.map!(&:to_sym).sort!.freeze
+    @attributes = attr_map.keys.map!(&:to_sym).sort!.freeze
+
+    # shortcuts disable:
+    attr_map.keys.each do |n|
+      attr_alias["/#{n.delete_suffix('_off')}", n] if n.end_with?('_off')
+    end
+    attr_alias['/b', 'bold_off']
+    attr_alias['/d', 'dim_off']
+    attr_alias['/i', 'italic_off']
+    attr_alias['/u', 'underline_off']
+    attr_alias['/inv', 'invert_off']
+    attr_alias['/h', 'hide_off']
+    attr_alias['/s', 'strike_off']
+    attr_alias['/uu', 'double_underline_off']
+    attr_alias['/ovr', 'overlined_off']
+    attr_alias['/sup', 'superscript_off']
+    attr_alias['/sub', 'subscript_off']
+    attr_alias['/cu', 'curly_underline_off']
+    attr_alias['/dau', 'dashed_underline_off']
+    attr_alias['/dou', 'dotted_underline_off']
+
+    # additional shortcuts disable:
+    attr_alias['/', 'reset']
+    attr_map['/fg'] = clr_map['default']
+    attr_map['/bg'] = clr_map['on_default']
+    attr_map['/ul'] = clr_map['ul_default']
+
+    @attr_map = Hash.new { _color(_2) }
+    attr_map.merge!(clr_map).keys.sort!.each { @attr_map[_1] = attr_map[_1] }
+    @attr_map.freeze
+
+    @attrs_map = @attr_map.transform_keys(&:to_sym)
+    @attrs_map.default_proc = @attr_map.default_proc
+    @attrs_map.compare_by_identity.freeze
 
     autoload :NAMED_COLORS, "#{__dir__}/ansi/named_colors.rb"
     private_constant :NAMED_COLORS
 
-    # @!visibility private
+    # @private
     RESET = self[:reset].freeze
 
-    # @!visibility private
+    # @private
     FULL_RESET = "\ec"
 
-    # @!visibility private
+    # @private
     CURSOR_HOME = cursor_pos(nil, nil).freeze
-    # @!visibility private
+    # @private
     CURSOR_FIRST_ROW = cursor_pos(1).freeze
-    # @!visibility private
+    # @private
     CURSOR_FIRST_COLUMN = cursor_column(1).freeze
 
-    # @!visibility private
+    # @private
     CURSOR_SHOW = "\e[?25h"
-    # @!visibility private
+    # @private
     CURSOR_HIDE = "\e[?25l"
 
     # @comment CURSOR_POS_SAVE_SCO = "\e[s"
     # @comment CURSOR_POS_SAVE_DEC = "\e7"
-    # @!visibility private
+    # @private
     CURSOR_POS_SAVE = "\e7"
 
     # @comment CURSOR_POS_RESTORE_SCO = "\e[u"
     # @comment CURSOR_POS_RESTORE_DEC = "\e8"
-    # @!visibility private
+    # @private
     CURSOR_POS_RESTORE = "\e8"
 
-    # @!visibility private
+    # @private
     SCREEN_ERASE = screen_erase.freeze
-    # @!visibility private
+    # @private
     SCREEN_ERASE_BELOW = screen_erase(:below).freeze
-    # @!visibility private
+    # @private
     SCREEN_ERASE_ABOVE = screen_erase(:above).freeze
-    # @!visibility private
+    # @private
     SCREEN_ERASE_SCROLLBACK = screen_erase(:scrollback).freeze
 
-    # @!visibility private
+    # @private
     SCREEN_SAVE = "\e[?47h"
-    # @!visibility private
+    # @private
     SCREEN_RESTORE = "\e[?47l"
 
-    # @!visibility private
+    # @private
     # @comment at least Kitty requires CURSOR_HOME too
     SCREEN_ALTERNATE = "\e[?1049h#{CURSOR_HOME}".freeze
-    # @!visibility private
+    # @private
     SCREEN_ALTERNATE_OFF = "\e[?1049l"
 
-    # @!visibility private
+    # @private
     SCREEN_REVERSE_MODE_ON = "\e[?5h"
-    # @!visibility private
+    # @private
     SCREEN_REVERSE_MODE_OFF = "\e[?5l"
 
-    # @!visibility private
+    # @private
     LINE_ERASE = line_erase.freeze
-    # @!visibility private
+    # @private
     LINE_ERASE_TO_END = line_erase(:to_end).freeze
-    # @!visibility private
+    # @private
     LINE_ERASE_TO_START = line_erase(:to_start).freeze
-    # @!visibility private
+    # @private
     LINE_ERASE_PREV = "#{cursor_prev_line(nil)}#{LINE_ERASE}".freeze
 
     # @comment seems not widely supported:
@@ -689,14 +873,6 @@ module Terminal
     #
     #   def set_scroll_region(top = nil, bottom = nil) = "\e[#{top};#{bottom}r"
 
-    # @comment TODO:
-    #   https://sw.kovidgoyal.net/kitty/desktop-notifications
-    #   https://sw.kovidgoyal.net/kitty/pointer-shapes
-    #   https://sw.kovidgoyal.net/kitty/unscroll
-    #   https://sw.kovidgoyal.net/kitty/color-stack
-    #   https://sw.kovidgoyal.net/kitty/deccara
-    #   https://sw.kovidgoyal.net/kitty/clipboard
-
     # @comment other:
     #   "\eE" same as "\r\n"
     #   "\eD" same as "\n" but preserves X coord
@@ -705,5 +881,13 @@ module Terminal
     #   "\e[21t report window’s title as ESC ] l title ESC \"
     #   "\e[?1004h" report focus lost "\e[O" and focus get "\e[I"
     #     (disable by "\e[?1004l")
+
+    # @comment TODO:
+    #   https://sw.kovidgoyal.net/kitty/desktop-notifications
+    #   https://sw.kovidgoyal.net/kitty/pointer-shapes
+    #   https://sw.kovidgoyal.net/kitty/unscroll
+    #   https://sw.kovidgoyal.net/kitty/color-stack
+    #   https://sw.kovidgoyal.net/kitty/deccara
+    #   https://sw.kovidgoyal.net/kitty/clipboard
   end
 end

data/lib/terminal/input/key_event.rb

@@ -7,7 +7,7 @@ module Terminal
   class KeyEvent
     class << self
       # @attribute [w] caching
-      # @return [true, false] whether KeyCodes should be cached
+      # @return [true, false] whether {KeyEvent}s should be cached
       def caching = !!@cache
 
       # @attribute [w] caching
@@ -21,7 +21,7 @@ module Terminal
 
       # Translate a keyboard input string into a related KeyEvent
       #
-      # @param [String] raw keyboard input
+      # @param raw [String] keyboard input
       # @return [KeyEvent] related key event
       def [](raw)
         return new(raw, *@single_key[raw.ord]) if raw.size == 1
@@ -52,7 +52,7 @@ module Terminal
         unknown(raw)
       end
 
-      # @!visibility private
+      # @private
       def new(raw, key = raw, modifier = 0, extra = nil)
         @cache ? (@cache[raw] ||= super.freeze) : super.freeze
       end
@@ -164,7 +164,7 @@ module Terminal
     attr_reader :modifier
 
     # @comment for mouse events
-    # @!visibility private
+    # @private
     attr_reader :extra
 
     # Name of the key event.
@@ -188,16 +188,16 @@ module Terminal
     # @return [Array<Symbol, String>] all pressed keys
     def to_a = @ary.dup
 
-    # @!visibility private
+    # @private
     def to_ary = simple? ? [@raw] : [@raw, @name]
 
-    # @!visibility private
+    # @private
     def to_s = @name.dup
 
-    # @!visibility private
+    # @private
     def inspect = "<#{self.class.name} #{to_ary.map(&:inspect).join(' ')}>"
 
-    # @!visibility private
+    # @private
     def freeze
       @raw.freeze
       @key.freeze

data/lib/terminal/input.rb

@@ -28,7 +28,7 @@ module Terminal
     #
     # @deprecated Use rather {read_key_event} for better input handling.
     #
-    # @param [:named, :raw, :both] mode modifies the result
+    # @param mode [:named, :raw, :both] modifies the result
     # @return [String] key code ("as is") in `:raw` mode
     # @return [String] key name in `:named` mode
     # @return [[String, String]] key code and key name in `:both` mode
@@ -64,8 +64,8 @@ module Terminal
       return :dumb if im == 'dumb'
       return :legacy if im == 'legacy'
       return :dumb unless STDIN.tty?
-      if ansi? && _write("\e[>1u\e[?u\e[c") && csi_u?
-        at_exit { _write("\e[<u") }
+      if ansi? && raw_write("\e[>1u\e[?u\e[c") && csi_u?
+        at_exit { raw_write("\e[<u") }
         return :csi_u
       end
       :legacy
@@ -99,10 +99,10 @@ module Terminal
       # urxvt: '1015'
       # pixel: '1016'
       opts = each_move ? '1000;1003;1006;1015' : '1000;1006;1015'
-      opts = _write("\e[?#{opts}h") ? "\e[?#{opts}l" : nil
+      opts = raw_write("\e[?#{opts}h") ? "\e[?#{opts}l" : nil
       read_tty
     ensure
-      _write(opts) if opts
+      raw_write(opts) if opts
     end
 
     def read_tty

data/lib/terminal/rspec/helper.rb

@@ -53,7 +53,7 @@ RSpec.shared_context 'with Terminal.rb' do |ansi: true, application: :kitty, col
       nil
     end
 
-    allow(Terminal).to receive(:_write) do |object|
+    allow(Terminal).to receive(:raw_write) do |object|
       stdout.push(object = object.to_s)
       object.bytesize
     end