terminal_rb 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 107b7b65dc5f58b1178e01fc86adad127df49fd175e56f7e36d2bfb873fc17a9
-  data.tar.gz: dfbf4797df22ac2803034a85a00fce2c480e4530840abd0d2a900bfb98993db5
+  metadata.gz: 05eda4c596ad7060b576cb01f6fe7dafd38e114274b44c14c4c90e1b3a2b322a
+  data.tar.gz: '0479860569041d6fb874d38de0d183a2cc778a6803d3eed302425cd795133e06'
 SHA512:
-  metadata.gz: 115235b382d02c4c5242925e1bf1ff3b9928702b30682dd4a2964282b11df6339118da582e0eebc096806005f781a537688741eab2e94984db391abaf6b4ec72
-  data.tar.gz: 2718bf0147fcb7c3d84374f59c4f8ea4862c58dfd6982057196a78bd1f4308eb9c319a55ba3c41339a45a6fa994b1449b2cedb2e00ce6de5548dd3eaa5b98fa0
+  metadata.gz: ab038b9b4cc9ed41ba09673be9a2e2d25aa2edc2ffbf1fa0cad826ca7f55c8fef3aab734648f13f63750ea7799bce638479839e5f609e597eeb0bf4508b0f0e7
+  data.tar.gz: b501721dfd7d6d79ceb8821fa5dd9d877e764e235435f3e6441e9b02b424a5873aba1318365a4b064a9430c135882be39470361d0042b56726be3dd2505e9db5

data/README.md

@@ -1,6 +1,6 @@
 # Terminal.rb ![version](https://img.shields.io/gem/v/terminal_rb?label=)
 
-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.
+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, correct special key recognition and mouse event reporting 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)
@@ -16,6 +16,7 @@ Terminal.rb supports you with input and output on your terminal. Simple [BBCode]
 - calculation for correct display width of strings containing Unicdode chars inclusive emojis
 - word-wise line break generator
 - supports [CSIu protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol)
+- mouse events support
 
 ## Examples
 

data/examples/info.rb

@@ -12,5 +12,6 @@ Terminal.puts <<~TEXT
      Terminal Size: [b]#{Terminal.size.join(' x ')}[/]
    Cursor Position: [b]#{Terminal.pos&.join(', ')}[/]
         Input Mode: [b]#{Terminal.input_mode}[/]
+      Link Support: [b]#{Terminal::Ansi.link('https://codeberg.org/mblumtritt/Terminal.rb', 'Link')}[/]
 
 TEXT

data/examples/key-codes.rb

@@ -13,10 +13,13 @@ TEXT
 Terminal.hide_cursor
 at_exit { Terminal.show_cursor } # required for some terminals :/
 
-while true
-  event = Terminal.read_key_event or break puts
+# if you like to have mouse position changes reported then use
+# 'mouse_move: true' in next line
+Terminal.on_key_event(mouse: true, focus: true, mouse_move: false) do |event|
   str = "[blue]: [yellow]#{event.raw.inspect}"
   str << " [bold bright_green]#{event.name}[/]" unless event.simple?
+  str << " [dim]#{event.position.inspect}[/]" if event.position
   Terminal.puts(str)
-  break puts if event.name == 'Esc'
+  event.name != 'Esc'
 end
+puts

data/examples/text.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative '../lib/terminal'
+
+LOREM = <<~IPSUM
+  This example outputs [i bright_white]Lorem ipsum[/] text so that it takes up 75% of the screen width and fits the height of your screen.
+
+  [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet.
+
+  Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla [red]facilisis[/fg] at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. [i bright_white]Lorem ipsum[/] dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore [b]magna[/b] aliquam erat volutpat.
+
+  Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla [red]facilisis[/fg] at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.
+
+  Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. [i bright_white]Lorem ipsum[/] dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore [b]magna[/b] aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.
+
+  Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla [red]facilisis[/fg].
+
+  At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, At accusam aliquyam diam diam dolore dolores duo eirmod eos erat, et nonumy sed tempor et et invidunt justo labore Stet clita ea et gubergren, kasd [b]magna[/b] no rebum. [yellow]sanctus[/fg] sea sed takimata ut vero voluptua. est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat.
+
+  Consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg].
+
+  [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet. [i bright_white]Lorem ipsum[/] dolor sit amet, [green]consetetur[/fg] sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore [b]magna[/b] aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata [yellow]sanctus[/fg] est [i bright_white]Lorem ipsum[/] dolor sit amet.
+
+  Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla [red]facilisis[/fg] at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. [i bright_white]Lorem ipsum[/] dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore [b]magna[/b] aliquam erat volutpat.
+
+  Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla [red]facilisis[/fg] at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.
+
+  Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. [i bright_white]Lorem ipsum[/] dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore [b]magna[/b] aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.
+IPSUM
+
+rows, cols = Terminal.size
+puts Terminal::Text.each(LOREM, limit: cols * 0.75).take(rows - 1)

data/lib/terminal/ansi.rb

@@ -34,8 +34,8 @@ module Terminal
       # @!group ANSI control code generator functions
       #
 
-      # Combine given ANSI {attributes}, {colors}, {named_colors} and color
-      # codes.
+      # Combine given {attributes}, {colors}, {named_colors} and color codes to
+      # an ANSI control code sequence.
       #
       # Colors can specified by their name for ANSI 3-bit and 4-bit colors.
       # For 8-bit ANSI colors use 2-digit hexadecimal values `00`...`ff`.
@@ -96,7 +96,7 @@ module Terminal
         return +'' if attributes.empty?
         "\e[#{
           attributes
-            .map do |arg|
+            .map! do |arg|
               case arg
               when String
                 @attr_map[arg] || _invalid(arg)
@@ -154,8 +154,7 @@ module Terminal
       # @param str [#to_s] string to be modified
       # @return [String] string without ANSI attributes
       def undecorate(str)
-        str = str.to_s
-        str.index("\e") ? str.gsub(@re_test, '') : str.dup
+        (str = str.to_s).index("\e") ? str.gsub(@re_test, '') : str.dup
       end
 
       # Try to combine given ANSI attributes and colors.
@@ -263,8 +262,7 @@ module Terminal
       # @param str [#to_s] string to be modified
       # @return [String] string without BBCode and ANSI control codes.
       def plain(str)
-        str = str.to_s
-        unless str.index('[')
+        unless (str = str.to_s).index('[')
           return str.index("\e") ? str.gsub(@re_test, '') : str.dup
         end
         str =
@@ -289,16 +287,14 @@ module Terminal
         pos = -1
         @pi2_third ||= 2.0 * Math::PI / 3.0
         @pi4_third ||= 4.0 * Math::PI / 3.0
-        str
-          .to_s
-          .chars
-          .map! do |char|
+        (
+          str.to_s.chars.map! do |char|
             i = (seed + ((pos += 1) / spread)) * frequency
             "\e[38;2;#{(Math.sin(i) * 255).to_i.abs};" \
               "#{(Math.sin(i + @pi2_third) * 255).to_i.abs};" \
               "#{(Math.sin(i + @pi4_third) * 255).to_i.abs}m#{char}"
-          end
-          .join << RESET
+          end << RESET
+        ).join
       end
 
       #
@@ -349,6 +345,21 @@ module Terminal
       # @return (see cursor_up)
       def cursor_column(column = 1) = "\e[#{column}G"
 
+      # Move cursor to given column in the current row relative to the current
+      # position.
+      # (Skip some columns.)
+      #
+      # @param (see cursor_column)
+      # @return (see cursor_up)
+      def cursor_column_rel(column = 1) = "\e[#{column}a"
+
+      # Move cursor to given row relative to the current position.
+      # (Skip some rows.)
+      #
+      # @param row [Integer] row index
+      # @return (see cursor_up)
+      def cursor_row_rel(row = 1) = "\e[#{row}e"
+
       # Move to given row and column.
       #
       # @param row [Integer] row index
@@ -389,20 +400,7 @@ module Terminal
       #
       # @param part [:below, :above, :all, :scrollback] screen part to erase
       # @return (see cursor_up)
-      def screen_erase(part = :all)
-        "\e[#{
-          case part
-          when :below
-            # nop
-          when :above
-            '1'
-          when :scrollback
-            '3'
-          else # all
-            '2'
-          end
-        }J"
-      end
+      def screen_erase(part = :all) = "\e[#{@screen_erase[part]}J"
 
       # Safe current screen.
       #
@@ -442,22 +440,17 @@ module Terminal
       # @!group Other ANSI control functions
       #
 
+      # Repeat last char.
+      #
+      # @param count [Integer] repeat count
+      # @return (see cursor_up)
+      def char_repeat(count = 1) = "\e[#{count}b"
+
       # Erase part of line.
       #
       # @param part [:to_end, :to_start, :all] line part to erase
       # @return (see cursor_up)
-      def line_erase(part = :all)
-        "\e[#{
-          case part
-          when :to_end
-            # nop
-          when :to_start
-            '1'
-          else # :all
-            '2'
-          end
-        }K"
-      end
+      def line_erase(part = :all) = "\e[#{@line_erase[part]}K"
 
       # Set (tab) title.
       # This is not widely supported; works for
@@ -486,6 +479,17 @@ module Terminal
       # @return (see cursor_up)
       def link(url, text) = "\e]8;;#{url}\a#{text}\e]8;;\a"
 
+      # Show a simple notification.
+      # This is not widely supported; works for
+      # Ghosty,
+      # iTerm2,
+      # Kitty,
+      # WezTerm.
+      #
+      # @param text [#to_s] text to display
+      # @return (see cursor_up)
+      def notify(text) = "\e]9;#{text}\a"
+
       # Create scaled text.
       # It uses the
       # [text sizing protocol](https://sw.kovidgoyal.net/kitty/text-sizing-protocol).
@@ -559,27 +563,6 @@ module Terminal
           caller(1)
         )
       end
-
-      def _color(str)
-        b, v = /\A(fg|bg|on|ul)?_?#?([[:xdigit:]]{1,6})\z/.match(str)&.captures
-        if v
-          return(
-            case v.size
-            when 1, 2
-              "#{@cbase[b]};5;#{v.hex}"
-            when 3
-              "#{@cbase[b]};2;#{(v[0] * 2).hex};#{
-                (v[1] * 2).hex
-              };#{(v[2] * 2).hex}"
-            when 6
-              "#{@cbase[b]};2;#{v[0, 2].hex};#{v[2, 2].hex};#{v[4, 2].hex}"
-            end
-          )
-        end
-        b, v = /\A(fg|bg|on|ul)?_?([a-z]{3,}[0-9]{0,3})\z/.match(str)&.captures
-        return unless v
-        name = NAMED_COLORS[v] and return "#{@cbase[b]};#{name}"
-      end
     end
 
     @cbase = { 'bg' => '48', 'on' => '48', 'ul' => '58' }
@@ -588,63 +571,13 @@ module Terminal
 
     @re_test =
       /
-      (?:\e\[[\d;:\?]*[ABCDEFGHJKSTfminsuhl])
+      (?:\e\[[\d;:?]*[ABCDEFGHJKSTfminsuhl])
       |
       (?:\e\]\d+(?:;[^\a\e]+)*(?:\a|\e\\))
     /x
 
     @re_bbcode = /(?:\[((?~[\[\]]))\])/
 
-    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',
@@ -714,6 +647,56 @@ module Terminal
     clr_alias['fg_default', 'default']
     clr_alias['bg_default', 'on_default']
 
+    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] }
+
     attr_alias['faint_off', 'bold_off']
     attr_alias['fraktur_off', 'italic_off']
     attr_alias['double_underline_off', 'underline_off']
@@ -777,7 +760,23 @@ module Terminal
     attr_map['/bg'] = clr_map['on_default']
     attr_map['/ul'] = clr_map['ul_default']
 
-    @attr_map = Hash.new { _color(_2) }
+    @attr_map =
+      Hash.new do |_, str|
+        b, v = /\A(fg|bg|on|ul)?_?#?([[:xdigit:]]{1,6})\z/.match(str)&.captures
+        unless v
+          b = /\A(fg|bg|on|ul)?_?([a-z]{3,}[0-9]{0,3})\z/.match(str) or next
+          name = NAMED_COLORS[b[2]] or next
+          next "#{@cbase[b[1]]};#{name}"
+        end
+        case v.size
+        when 1, 2
+          "#{@cbase[b]};5;#{v.hex}"
+        when 3
+          "#{@cbase[b]};2;#{(v[0] * 2).hex};#{(v[1] * 2).hex};#{(v[2] * 2).hex}"
+        when 6
+          "#{@cbase[b]};2;#{v[0, 2].hex};#{v[2, 2].hex};#{v[4, 2].hex}"
+        end
+      end
     attr_map.merge!(clr_map).keys.sort!.each { @attr_map[_1] = attr_map[_1] }
     @attr_map.freeze
 
@@ -785,21 +784,29 @@ module Terminal
     @attrs_map.default_proc = @attr_map.default_proc
     @attrs_map.compare_by_identity.freeze
 
+    @screen_erase = { below: nil, above: '1', scrollback: '3' }
+    @screen_erase.default = '2'
+    @screen_erase.compare_by_identity.freeze
+
+    @line_erase = { to_end: nil, to_start: '1' }
+    @line_erase.default = '2'
+    @line_erase.compare_by_identity.freeze
+
     autoload :NAMED_COLORS, "#{__dir__}/ansi/named_colors.rb"
     private_constant :NAMED_COLORS
 
     # @private
-    RESET = self[:reset].freeze
+    RESET = -self[:reset]
 
     # @private
     FULL_RESET = "\ec"
 
     # @private
-    CURSOR_HOME = cursor_pos(nil, nil).freeze
+    CURSOR_HOME = -cursor_pos(nil, nil)
     # @private
-    CURSOR_FIRST_ROW = cursor_pos(1).freeze
+    CURSOR_FIRST_ROW = -cursor_pos(1)
     # @private
-    CURSOR_FIRST_COLUMN = cursor_column(1).freeze
+    CURSOR_FIRST_COLUMN = -cursor_column(1)
 
     # @private
     CURSOR_SHOW = "\e[?25h"
@@ -817,13 +824,13 @@ module Terminal
     CURSOR_POS_RESTORE = "\e8"
 
     # @private
-    SCREEN_ERASE = screen_erase.freeze
+    SCREEN_ERASE = -screen_erase
     # @private
-    SCREEN_ERASE_BELOW = screen_erase(:below).freeze
+    SCREEN_ERASE_BELOW = -screen_erase(:below)
     # @private
-    SCREEN_ERASE_ABOVE = screen_erase(:above).freeze
+    SCREEN_ERASE_ABOVE = -screen_erase(:above)
     # @private
-    SCREEN_ERASE_SCROLLBACK = screen_erase(:scrollback).freeze
+    SCREEN_ERASE_SCROLLBACK = -screen_erase(:scrollback)
 
     # @private
     SCREEN_SAVE = "\e[?47h"
@@ -832,7 +839,7 @@ module Terminal
 
     # @private
     # @comment at least Kitty requires CURSOR_HOME too
-    SCREEN_ALTERNATE = "\e[?1049h#{CURSOR_HOME}".freeze
+    SCREEN_ALTERNATE = -"\e[?1049h#{CURSOR_HOME}"
     # @private
     SCREEN_ALTERNATE_OFF = "\e[?1049l"
 
@@ -842,21 +849,19 @@ module Terminal
     SCREEN_REVERSE_MODE_OFF = "\e[?5l"
 
     # @private
-    LINE_ERASE = line_erase.freeze
+    LINE_ERASE = -line_erase
     # @private
-    LINE_ERASE_TO_END = line_erase(:to_end).freeze
+    LINE_ERASE_TO_END = -line_erase(:to_end)
     # @private
-    LINE_ERASE_TO_START = line_erase(:to_start).freeze
+    LINE_ERASE_TO_START = -line_erase(:to_start)
     # @private
-    LINE_ERASE_PREV = "#{cursor_prev_line(nil)}#{LINE_ERASE}".freeze
+    LINE_ERASE_PREV = -"#{cursor_prev_line(nil)}#{LINE_ERASE}"
 
     # @comment seems not widely supported:
     #   doubled: def cursor_column(column = 1) = "\e[#{column}`"
     #   doubled: def cursor_row(row = 1) = "\e[#{row}d"
     #   doubled: def cursor_pos(row, col) = "\e[#{row};#{col}f"
     #
-    #   def cursor_column_rel(columns = 1) = "\e[#{columns}a"
-    #   def cursor_row_rel(rows = 1) = "\e[#{rows}e"
     #   def cursor_tab(count = 1) = "\e[#{column}I"
     #   def cursor_reverse_tab(count = 1) = "\e[#{count}Z"
     #
@@ -867,20 +872,14 @@ module Terminal
     #   def chars_delete(count = 1) = "\e[#{count}P"
     #   def chars_erase(count = 1) = "\e[#{count}X"
     #
-    #   def chars_repeat_last(count = 1) = "\e[#{count}b"
-    #
-    #   def notify(title) = "\e]9;#{title}\a"
-    #
     #   def set_scroll_region(top = nil, bottom = nil) = "\e[#{top};#{bottom}r"
 
     # @comment other:
     #   "\eE" same as "\r\n"
-    #   "\eD" same as "\n" but preserves X coord
+    #   "\eD" same as "\n" but preserves column
     #   "\eM" reverse "\n"
     #   "\e[6n" report Cursor Position as "ESC \[ row ; col R"
     #   "\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