terminal_rb 1.0.4 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cafc2d55ed2812b89586adb37fbe22d9c1a46bec4c7ab87f7ba326792254ff5f
-  data.tar.gz: 1cf7e56b768478dbafa982fe555693cb110c1825476f155af52214853527b9c5
+  metadata.gz: 8f2f93f672f13936c9415cf3a474533df0f5785da3272f3482a02842a0607917
+  data.tar.gz: 52a1498c80085ea7667b7641416f406ae8694e02505a0c3201efd5f150f8d986
 SHA512:
-  metadata.gz: 80820ee91b7ae9db787cdbeb0d28fc0bfeafae944ea5106008286b693e13dfed8fa718794cc5c2f656d47d0a1a84918b0708b92206e6e00ec180a75b4ab406d3
-  data.tar.gz: 1fe8c92a73d3469cb356c924919dc2d4639e74706606f13b6cf7d06c299637ab193e4d6722d061dcfd59b854231d55c23c538dc4593ca21a5cfd600620bebc55
+  metadata.gz: 41cfbe3e34fa3db0af51674dc0f70f32dd08fb20d2b3a1040eff2834c65440f917f2ecea021500037658fbcf613373148c8399fdb29b7ea987916e71c570a65d
+  data.tar.gz: b6485ac5e2a9ba17ec72ffadc94cad6f5348ab846f885d12e9a68a338c15baeaa0d564ce1e1a4d2f946505887782e02dfd7221fc03e60bd3e7bb40afb88b47a1

data/README.md

@@ -1,10 +1,10 @@
-# Terminal.rb v1.0.4
+# Terminal.rb v1.0.6
 
 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)
-- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/1.0.4/Terminal)
+- Help: [rubydoc.info](https://rubydoc.info/gems/terminal_rb/1.0.6/Terminal)
 
 ## Features
 

data/examples/lorem_ipsum.ansi

@@ -0,0 +1,39 @@
+[b red]Lorem ipsum[/] dolor sit amet, [yellow]consectetur[/] adipiscing elit. Praesent odio orci, [black on_bright_yellow]congue[/] sit amet turpis a, posuere [inv]congue[/] purus. Proin et lectus eget mi vehicula [i green uu]pellentesque[/] nec eu sem. Quisque nunc lectus, [uu]pharetra[/] non justo nec, porttitor mollis enim. Aenean dapibus massa tortor. Curabitur iaculis consequat sapien, eget [i green uu]pellentesque[/] turpis tempor bibendum. Nam cursus at quam vel [yellow]sollicitudin[/]. Etiam luctus nisl nisl, at eleifend tortor blandit non. Duis non suscipit quam. Vestibulum commodo molestie [u]fermentum[/]. Vivamus gravida dui sed nisl ornare, in eleifend leo tristique. Pellentesque eget eleifend [i]augue[/].
+
+Vestibulum ultrices, ipsum ut volutpat aliquet, lectus mauris varius ante, non faucibus massa nisi et magna. Nullam id lacus sit amet nisi luctus gravida ut ac odio. Suspendisse ligula erat, vehicula sit amet nulla eget, porta semper neque. Fusce eget ultrices massa. Sed quis mauris tempor, [black on_bright_yellow]congue[/] nibh sed, lacinia mauris. Pellentesque convallis viverra ultrices. Ut sit amet massa [yellow]sollicitudin[/] lectus [uu]pharetra[/] vehicula. Ut hendrerit risus sit amet consequat maximus. Aliquam at ligula at nulla bibendum laoreet ac vitae [i]augue[/]. Sed ullamcorper, orci vel fringilla imperdiet, nisl leo [yellow]consectetur[/] nunc, sit amet pulvinar tortor nulla quis ex.
+
+Morbi vitae [i]augue[/] eu neque laoreet [black on_bright_yellow]congue[/]. Integer eu est libero. Quisque consequat felis ipsum, quis consequat dui eleifend eu. Quisque malesuada ipsum vel arcu [yellow]consectetur[/] fringilla. Integer eu eleifend enim. Nam feugiat rutrum justo, consequat ornare massa molestie quis. Aenean eget malesuada ex. Morbi [yellow]sollicitudin[/] commodo nisi, nec auctor ante porta vitae. Aenean tristique ligula sit amet purus ultricies auctor. Nam [cu]finibus[/], libero at vestibulum mattis, diam ipsum placerat massa, sit amet porta ligula libero et lorem. Nullam est tellus, elementum venenatis justo aliquam, pulvinar rutrum nulla. Phasellus nec nisl sem. Sed [i green uu]sagittis[/] nulla sed aliquet auctor. Quisque sit amet [yellow]sollicitudin[/] massa, ut porttitor lacus. Aliquam at sem nec lacus varius pretium rhoncus vel mi. Praesent et lacus sed nunc lacinia porttitor.
+
+Nulla mauris [i]augue[/], lacinia sit amet porta et, efficitur in ex. Fusce a fringilla ex. Phasellus ut sem justo. Sed nec sapien orci. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Maecenas lectus dui, pretium quis massa vel, gravida commodo mi. Proin feugiat, felis eget bibendum dictum, urna velit cursus odio, ut accumsan ligula orci eu nibh. Donec cursus placerat est ac euismod.
+
+Aliquam erat volutpat. Suspendisse iaculis leo porttitor quam pretium lacinia. Morbi euismod sit amet enim in condimentum. Morbi sed [uu]pharetra[/] purus. Vivamus quis libero sed neque [inv]congue[/] egestas. Mauris ullamcorper ipsum vel justo eleifend fringilla. Mauris facilisis quam convallis mauris [inv]congue[/] tempor. Fusce tortor purus, ultrices ut molestie sit amet, [u]fermentum[/] vel quam.
+
+Duis placerat ultricies [i green uu]pellentesque[/]. Nam nec efficitur orci, in [yellow]sollicitudin[/] sapien. Nunc condimentum aliquet enim id efficitur. Nulla tempus urna ex. Ut sed dolor eget sapien faucibus imperdiet et tincidunt ex. Vestibulum feugiat vel quam id eleifend. Sed tristique a mauris eget [white on_red]lobortis[/]. Nulla mollis est ipsum, in [black on_bright_yellow]congue[/] nisi maximus eget. Phasellus laoreet rutrum facilisis. In suscipit elementum lorem, a blandit turpis.
+
+Suspendisse suscipit in odio quis facilisis. Aliquam nec eros ultrices, hendrerit lacus sit amet, bibendum turpis. Duis ligula ligula, efficitur non tortor quis, ornare dictum urna. Nam blandit lorem blandit turpis laoreet malesuada. Duis et magna ut lorem tempus dignissim. Phasellus dui turpis, ultrices et aliquam nec, pulvinar sed [i]augue[/]. Morbi [uu]pharetra[/] laoreet ipsum non laoreet. Pellentesque a felis vitae sapien condimentum [yellow]sollicitudin[/]. Etiam in nisl eget odio luctus gravida. Donec [yellow]sollicitudin[/] risus porta, scelerisque est ut, pulvinar odio. Nulla at suscipit tortor. Curabitur euismod [inv]congue[/] rhoncus. Cras imperdiet enim arcu, non vehicula tortor tincidunt non. Vivamus tincidunt [u]fermentum[/] quam et dignissim. In lacinia venenatis nunc, non [inv]congue[/] ipsum [inv]congue[/] ut.
+
+Donec vitae nulla id elit efficitur facilisis ut sit amet enim. Nam sed magna lorem. Sed scelerisque vel urna sed porta. Donec a orci vel est interdum ultricies ac eu mi. Quisque condimentum luctus venenatis. Proin laoreet [yellow]sollicitudin[/] magna. Proin at nisl a sem condimentum vehicula. Fusce interdum ipsum ac lectus [u]fermentum[/] rutrum. Fusce aliquam, eros at interdum semper, purus urna vulputate lacus, eu [u]fermentum[/] felis sem ut nisl. Pellentesque at viverra libero. Integer [u]fermentum[/] vestibulum tortor, eu aliquam tortor [black on_bright_yellow]congue[/] at. Vestibulum vel fringilla velit. Proin ultricies magna ac ipsum bibendum porttitor. Duis nec leo urna. Morbi rhoncus fringilla [cu]finibus[/].
+
+Praesent metus mi, laoreet vel enim in, luctus aliquam odio. Maecenas ultrices metus quam, eget auctor ante [cu]finibus[/] ac. Etiam venenatis et tellus nec suscipit. Sed a nunc libero. In hac habitasse platea dictumst. Ut cursus efficitur dolor, at fringilla risus. Etiam id placerat tellus. Cras sit amet [white on_red]lobortis[/] turpis. Sed bibendum dolor tortor, a elementum nunc molestie cursus. Nullam nec lectus in [i]augue[/] commodo [i green uu]sagittis[/] sed eu tellus. Nam vitae mollis eros. Vivamus ut rhoncus risus. Phasellus [i]augue[/] risus, ultrices ac aliquet quis, suscipit at ipsum. Ut eu odio in felis facilisis [uu]pharetra[/] vitae ut neque. Nunc eget risus [white on_red]lobortis[/], placerat neque id, aliquet arcu. Etiam est tortor, ultricies sit amet eleifend eget, maximus nec ipsum.
+
+Proin ex turpis, viverra a convallis at, tincidunt et mi. Ut venenatis tincidunt nisl ac rhoncus. Sed dapibus, metus sit amet [yellow]consectetur[/] mattis, nunc lectus [black on_bright_yellow]congue[/] metus, vitae ornare [i]augue[/] diam eu [i]augue[/]. Proin eget sapien a lorem laoreet [yellow]consectetur[/]. Morbi [i green uu]sagittis[/], dui at egestas malesuada, felis lectus aliquet ante, nec euismod tellus elit semper ante. Nulla vehicula non nibh a aliquet. Donec a massa eget justo tincidunt ullamcorper. Praesent elementum dictum orci et convallis. Sed non dui a [i]augue[/] accumsan vestibulum. Vestibulum id lacus [black on_bright_yellow]congue[/], hendrerit justo sit amet, suscipit magna. Mauris ultrices mattis diam a [white on_red]lobortis[/]. Ut interdum et sapien in [white on_red]lobortis[/].
+
+Suspendisse placerat in ex et auctor. Nunc maximus metus quis [black on_bright_yellow]congue[/] suscipit. Vivamus lectus mi, efficitur vel turpis id, suscipit fringilla nunc. Fusce malesuada massa turpis. Aliquam dolor orci, facilisis eu lorem id, elementum placerat ipsum. Proin ac sem sem. Cras [cu]finibus[/] varius fringilla. Fusce non feugiat risus, ut egestas massa. Suspendisse vestibulum [i]augue[/] eu dapibus egestas. Nulla facilisi. Sed ut nulla eu massa fringilla commodo nec vitae neque.
+
+Curabitur gravida posuere nunc ut placerat. Phasellus aliquam interdum [u]fermentum[/]. Ut ac mi erat. Morbi [yellow]consectetur[/] odio non nibh ultricies [u]fermentum[/]. Nam dolor enim, mollis at purus a, euismod facilisis ex. Pellentesque dui massa, [yellow]sollicitudin[/] vitae [white on_red]lobortis[/] nec, malesuada a eros. Donec [yellow]sollicitudin[/] tempor volutpat. Cras ac dignissim velit. Cras nec blandit lorem.
+
+Phasellus [black on_bright_yellow]congue[/] eu urna non mollis. Suspendisse magna turpis, maximus eget ornare vel, [inv]congue[/] id nisl. Proin feugiat molestie odio quis semper. Pellentesque convallis viverra euismod. Mauris porttitor rhoncus eros, at egestas urna. Nam eget condimentum mi. Fusce ut purus metus. Sed sed ipsum nibh. Vestibulum vehicula tempor turpis, at rhoncus tellus porttitor sed.
+
+Donec id dictum sem, ut vulputate nisl. Donec [black on_bright_yellow]congue[/] eleifend purus, eu pretium eros laoreet non. Duis commodo justo a quam laoreet egestas. Donec eu mauris ac metus pulvinar venenatis. Praesent dictum urna ac iaculis vehicula. Ut non felis viverra, semper odio ornare, [yellow]sollicitudin[/] purus. Sed nec metus vehicula, elementum sapien eu, ultrices massa. Quisque tristique semper luctus. Vestibulum sit amet diam sed purus [black on_bright_yellow]congue[/] efficitur et non justo. In massa magna, accumsan at condimentum sit amet, pretium ut orci. Nulla [uu]pharetra[/] magna a metus vehicula varius. Integer et lacus semper, suscipit [i]augue[/] non, [yellow]consectetur[/] nisi. In id tellus vel turpis tristique dignissim nec vel lectus. Sed interdum diam felis, at bibendum arcu feugiat sed.
+
+Morbi tortor urna, suscipit non nulla nec, cursus interdum nisl. Nam ante nisi, suscipit a felis eu, faucibus tincidunt metus. Mauris gravida tellus in ipsum porttitor lacinia eu et ante. Maecenas blandit eleifend dui, eu viverra leo. Ut eu [i green uu]pellentesque[/] est. Cras id [cu]finibus[/] ipsum. Vestibulum eget mi ac ante dictum dictum scelerisque at nibh. Ut accumsan aliquam eros eget tincidunt. Nunc sit amet dignissim mauris. Praesent id [i]augue[/] consequat lectus [u]fermentum[/] accumsan quis ut elit. Proin venenatis eros lacus, non ullamcorper purus [u]fermentum[/] vitae. Fusce dolor libero, pretium ac mi nec, porta elementum mauris. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed viverra cursus ultricies.
+
+Nam egestas ante a dui mollis rutrum. Phasellus a dapibus arcu. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Suspendisse ac tortor in urna tristique bibendum. Aliquam ultrices, sem sit amet semper vehicula, [i]augue[/] erat porttitor [i]augue[/], a pretium nisi magna [i green uu]pellentesque[/] enim. Vestibulum nec nibh vitae nulla interdum [cu]finibus[/] ut viverra dolor. Pellentesque quis lacus enim. Donec et auctor mi. Curabitur eu [i green uu]pellentesque[/] risus. Aliquam [cu]finibus[/] dolor nec velit placerat [inv]congue[/]. Duis eget porttitor dolor. Vestibulum turpis nisi, porttitor ac pulvinar ac, vehicula viverra quam. In mollis, ante sit amet dictum [inv]congue[/], turpis dui luctus sem, eget convallis risus velit eget lorem.
+
+Nam quis accumsan tellus, vitae dictum lectus. Donec varius porta metus et iaculis. Ut et consequat est, nec tincidunt neque. Sed ullamcorper lectus eu enim suscipit, sed tincidunt massa dictum. Sed venenatis elit metus, [inv]congue[/] aliquam lectus [i green uu]sagittis[/] at. Pellentesque ante arcu, pulvinar ut commodo at, consequat id sapien. Nunc mollis dolor eu ultricies mattis.
+
+Phasellus et elementum lectus, vitae convallis nunc. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Sed dictum arcu [white on_red]lobortis[/] erat vulputate rhoncus. Ut id imperdiet justo. Donec vehicula in eros at lacinia. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nam iaculis [black on_bright_yellow]congue[/] dignissim. Duis vel quam feugiat, gravida quam non, volutpat nisi. Integer eget auctor mauris, consequat dignissim nunc. Ut scelerisque [i]augue[/] aliquam erat rutrum, vitae aliquet est semper. Etiam nec velit lorem. Ut malesuada auctor metus sit amet posuere. Vivamus quis ipsum magna. Vivamus libero erat, dictum ut lorem auctor, tincidunt ultricies tortor. Suspendisse faucibus, ligula id auctor tincidunt, odio ligula tristique [i]augue[/], ac interdum ligula justo dictum magna.
+
+Aliquam eros sapien, [inv]congue[/] ut metus eget, blandit iaculis ex. Donec id condimentum leo. Nunc [white on_red]lobortis[/] [yellow]consectetur[/] nunc nec posuere. Curabitur id iaculis diam. Nullam elementum luctus odio, et vehicula velit scelerisque at. Sed lorem nisl, malesuada quis massa sed, hendrerit [uu]pharetra[/] eros. Pellentesque leo mi, placerat id maximus ut, consequat sed turpis. Nulla nunc mi, convallis at iaculis non, ultricies vel tortor. Donec purus velit, molestie in [u]fermentum[/] ut, [black on_bright_yellow]congue[/] in dui. Morbi molestie, enim tempus malesuada consequat, orci lacus bibendum velit, non porta nisi ante a ipsum. Donec vitae nulla nulla.
+
+Nulla varius dignissim turpis ac consequat. Fusce ut varius sapien. Cras [yellow]consectetur[/] est eleifend, imperdiet nibh a, dapibus justo. Etiam vehicula, est ac aliquam consequat, ante nibh porta ex, dictum suscipit diam justo et sapien. Sed porttitor ipsum nec diam [u]fermentum[/], vitae mattis diam gravida. Vivamus ac elementum ex, vitae maximus est. Maecenas tempor elementum pretium. Cras aliquam magna sit amet ipsum rutrum commodo. Aliquam cursus tincidunt sapien, et imperdiet sem [black on_bright_yellow]congue[/].

data/lib/terminal/ansi/screen_viewer.rb

@@ -52,7 +52,7 @@ module Terminal
       # Total number of lines.
       #
       # @attribute [r] line_count
-      # @return [Integer, nil] +nil+ when not already calculated
+      # @return [Integer, nil] `nil` when not already calculated
       def line_count = @buf&.size
 
       # Index of the topmost visible line.
@@ -68,7 +68,7 @@ module Terminal
 
       # Resize to the current terminal dimensions and redraw.
       #
-      # @return [self, nil] +nil+ when resize is not required
+      # @return [self, nil] `nil` when resize is not required
       def resize_to_screen = _resize(*Terminal.size)
 
       # Resize to specific dimensions (clamped to terminal bounds)
@@ -76,7 +76,7 @@ module Terminal
       #
       # @param rows [Integer] new row count
       # @param columns [Integer] new column count
-      # @return [self, nil] +nil+ when resize is not required
+      # @return [self, nil] `nil` when resize is not required
       def resize(rows, columns)
         _resize(
           rows.clamp(1, Terminal.rows),
@@ -99,7 +99,7 @@ module Terminal
 
       # Scroll to the beginning of the content.
       #
-      # @return [self, nil] +nil+ when already on begin
+      # @return [self, nil] `nil` when already on begin
       def begin
         return draw unless @buf
         return if @line_top == 0
@@ -109,7 +109,7 @@ module Terminal
 
       # Scroll to the end of the content.
       #
-      # @return [self, nil] +nil+ when already on end
+      # @return [self, nil] `nil` when already on end
       def end
         return draw unless @buf
         idx = @buf.size - @rows_visible

data/lib/terminal/ansi.rb

@@ -45,7 +45,7 @@ module Terminal
       # Generate an ANSI escape sequence from attribute names or color
       # indices.
       #
-      # Accepts symbols (`:bold`, +:red+), strings (`"bold"`, +"#ff0000"+),
+      # Accepts symbols (`:bold`, `:red`), strings (`"bold"`, `"#ff0000"`),
       # or integers for 256-color palette (0-255 foreground, 256-511
       # background, 512-767 underline color).
       #
@@ -122,11 +122,11 @@ module Terminal
       #
       # @example
       #   Terminal::Ansi.try_convert('bold red')  # => "\e[1;31m"
-      #   Terminal::Ansi.try_convert('invalid')    # => nil
+      #   Terminal::Ansi.try_convert('invalid')   # => nil
       #
       # @param attributes [#to_s] space-separated attribute names
       # @param separator [String] delimiter for splitting
-      # @return [String, nil] ANSI escape sequence, or +nil+ if any
+      # @return [String, nil] ANSI escape sequence, or `nil` if any
       #   attribute is invalid
       def try_convert(attributes, separator: ' ')
         return unless attributes
@@ -168,9 +168,9 @@ module Terminal
 
       # Convert BBCode markup to ANSI escape codes.
       #
-      # Tags like +[bold]+ are converted to their ANSI equivalents;
-      # +[/bold]+ or +[/]+ resets. Unknown tags are left unchanged.
-      # Escape a tag with a backslash: +[\\bold]+ renders as +[bold]+.
+      # Tags like `[bold]` are converted to their ANSI equivalents;
+      # `[/bold]` or `[/]` resets. Unknown tags are left unchanged.
+      # Escape a tag with a backslash: `[\\bold]` renders as `[bold]`.
       #
       # @see .unbbcode
       # @see .plain
@@ -361,7 +361,7 @@ module Terminal
       #   Terminal::Ansi.cursor_pos(1, 1)  # home position
       #   Terminal::Ansi.cursor_pos(10, 5) # row 10, column 5
       #
-      # @param row [Integer, nil] row number; +nil+ moves to home
+      # @param row [Integer, nil] row number; `nil` moves to home
       # @param column [Integer, nil] column number
       # @return (see .[])
       def cursor_pos(row, column = nil)
@@ -396,7 +396,7 @@ module Terminal
       # Erase part of the screen.
       #
       # @param part [Symbol] area to erase:
-      #   +:all+, +:below+, +:above+, or +:scrollback+
+      #   `:all`, `:below`, `:above`, or `:scrollback`
       # @return (see .[])
       def screen_erase(part = :all) = "\e[#{@screen_erase[part]}J"
 
@@ -449,7 +449,7 @@ module Terminal
       # Erase part of the current line.
       #
       # @param part [Symbol] area to erase:
-      #   +:all+, +:to_end+, or +:to_start+
+      #   `:all`, `:to_end`, or `:to_start`
       # @return (see .[])
       def line_erase(part = :all) = "\e[#{@line_erase[part]}K"
 
@@ -472,7 +472,7 @@ module Terminal
       # @see .link_end
       #
       # @param url [#to_s] the link URL
-      # @param params [Hash] optional link parameters (e.g., +id:+)
+      # @param params [Hash] optional link parameters (e.g., `id:`)
       # @return (see .[])
       def link_start(url, **params)
         "\e]8;#{params.map { it.join('=') }.join(':')};#{url}\a"
@@ -520,12 +520,12 @@ module Terminal
       #   Terminal.raw_write(Terminal::Ansi.progress(:error)) # error state
       #   Terminal.raw_write(Terminal::Ansi.progress(nil))    # hide
       #
-      # @param state [Symbol, Numeric, Boolean] progress state:
-      #   - +:show+ or +true+ to show, `:err`/`:error`, `:warn`/`:warning`,
-      #   +:indeterminate+, a +Numeric+ (0-100) to set percentage, or
+      # @param state [Symbol, Numeric, true, false] progress state:
+      #   - `:show` or `true` to show, `:err`/`:error`, `:warn`/`:warning`,
+      #   `:indeterminate`, a `Numeric` (0-100) to set percentage, or
       #   any other value to hide
-      # @param percent [Integer] progress percentage (0-100, used with
-      #   +:show+ state)
+      # @param percent [#to_i] progress percentage (0-100, used with
+      #   `:show` state)
       # @return (see .[])
       def progress(state, percent = 0)
         case state
@@ -563,9 +563,9 @@ module Terminal
       # @param fracd [Integer, nil] fractional denominator
       #   (must be > fracn, max 15)
       # @param vertical [Symbol, Integer, nil] vertical alignment:
-      #   +:top+, +:bottom+, +:middle+
+      #   `:top`, `:bottom`, `:middle`
       # @param horizontal [Symbol, Integer, nil] horizontal alignment:
-      #   +:left+, +:right+, +:center+
+      #   `:left`, `:right`, `:center`
       # @return (see .[])
       def scale(
         text,

data/lib/terminal/input/ansi.rb

@@ -6,14 +6,13 @@ module Terminal
     attr_reader :input_mode
 
     def on_key_event(mouse: false, mouse_move: false, focus: false)
-      raise('already reading key events') if (@in_recursion += 1) != 1
       return unless block_given?
-      opts = __input_option(mouse, mouse_move, focus)
+      opts = nil
       STDIN.noecho do
-        opts &&= @in.syswrite("#{opts}h") ? "#{opts}l" : nil
+        opts = __input_options(mouse, mouse_move, focus)
         while (raw = @in.getch)
           next yield(KeyEvent[raw]) if raw != "\e"
-          while String === (nc = @in.read_nonblock(1, exception: false))
+          while (nc = @in.read_nonblock(1, exception: false)).is_a?(String)
             raw << nc
           end
           next yield(KeyEvent[raw]) if raw.rindex("\e") < 2
@@ -25,13 +24,15 @@ module Terminal
       __input_error
       false
     ensure
-      @in_recursion -= 1
-      @in.syswrite(opts) if opts && @in
+      if opts
+        @in_opts.pop
+        @in&.syswrite(opts)
+      end
     end
 
     private
 
-    def __input_option(mouse, mouse_move, focus)
+    def __input_options(mouse, mouse_move, focus)
       opts = (mouse ? ['1000'] : [])
       # highlight: '1001'
       # drag: '1002'
@@ -41,7 +42,19 @@ module Terminal
       # sgr: '1006'
       # urxvt: '1015'
       # pixel: '1016'
-      "\e[?#{opts.join(';')};1006" unless opts.empty?
+      if (last = @in_opts[-1])
+        if opts.empty?
+          @in.syswrite("#{last}l")
+          return "#{last}h"
+        end
+        @in_opts << (opts = "\e[?#{opts.join(';')};1006")
+        @in.syswrite("#{last}l#{opts}h")
+        return "#{opts}l#{last}h"
+      end
+      return if opts.empty?
+      @in_opts << (opts = "\e[?#{opts.join(';')};1006")
+      @in.syswrite("#{opts}h")
+      "#{opts}l"
     end
   end
 

data/lib/terminal/input/dumb.rb

@@ -5,8 +5,7 @@ module Terminal
   module DumpInput
     def input_mode = :dumb
 
-    def on_key_event(*_)
-      raise('already reading key events') if (@in_recursion += 1) != 1
+    def on_key_event(*)
       return unless block_given?
       while (raw = STDIN.getc)
         opts = dumb_keys[raw.ord] if raw.size == 1
@@ -17,8 +16,6 @@ module Terminal
     rescue IOError, SystemCallError
       __input_error
       false
-    ensure
-      @in_recursion -= 1
     end
 
     private

data/lib/terminal/input/key_event.rb

@@ -23,8 +23,8 @@ module Terminal
   class KeyEvent
     # The key identifier.
     #
-    # @return [Symbol, String, nil] a named key like +:Enter+, +:Tab+,
-    #   +:MBLeft+ (mouse), or a character string like +"a"+; +nil+ for
+    # @return [Symbol, String, nil] a named key like `:Enter`, `:Tab`,
+    #   `:MBLeft` (mouse), or a character string like `"a"`; `nil` for
     #   unknown sequences
     attr_reader :key
 
@@ -61,8 +61,8 @@ module Terminal
 
     # Mouse position when this is a mouse event.
     #
-    # @return [Array<Integer, Integer>, nil] +[row, column]+ for mouse
-    #   events, +nil+ for keyboard events
+    # @return [Array<Integer, Integer>, nil] `[row, column]` for mouse
+    #   events, `nil` for keyboard events
     attr_reader :position
 
     # The raw input sequence as received from the terminal.
@@ -85,8 +85,8 @@ module Terminal
     # @private
     # Destructuring-friendly array representation.
     #
-    # @return [Array<String>] +[raw]+ if {#simple?}
-    # @return [Array<String, String>] +[raw, name]+ otherwise
+    # @return [Array<String>] `[raw]` if {#simple?}
+    # @return [Array<String, String>] `[raw, name]` otherwise
     def to_ary = simple? ? [@raw] : [@raw, @name]
 
     # @return [String] the event {#name}
@@ -140,7 +140,7 @@ module Terminal
           @names ||=
             (@csiu.values + @csi.values + @ss3.values)
               .uniq
-              .keep_if { Symbol === it }
+              .keep_if { it.is_a?(Symbol) }
               .sort!
         ).dup
       end

data/lib/terminal/input.rb

@@ -15,7 +15,7 @@ module Terminal
   #   Terminal.input_mode # => :csi_u
   #
   # @attribute [r] input_mode
-  # @return [Symbol] +:csi_u+, +:legacy+, +:dumb+, or +:error+
+  # @return [Symbol] `:csi_u`, `:legacy`, `:dumb`, or `:error`
 
   #
   # @!endgroup
@@ -42,8 +42,7 @@ module Terminal
   #   @param focus [true, false] enable terminal focus/unfocus events
   #   @yield [event] called for each input event
   #   @yieldparam event [KeyEvent] the parsed key event
-  #   @return [nil, false] +false+ on I/O error
-  #   @raise [RuntimeError] if already inside a key event loop
+  #   @return [nil, false] `false` on I/O error
 
   # @!method self.read_key_event
   #
@@ -53,7 +52,7 @@ module Terminal
   #     event = Terminal.read_key_event
   #     puts "You pressed: #{event.name}"
   #
-  #   @return [KeyEvent, false] the next key event, or +false+ on error
+  #   @return [KeyEvent, false] the next key event, or `false` on error
 
   #
   # @!endgroup
@@ -62,10 +61,10 @@ module Terminal
   # @private
   module Input
     def input_mode
-      @in_recursion = 0
       case @input_mode = __find_input_mode
       when :legacy, :csi_u
         @in = IO.console
+        @in_opts = []
         require_relative('input/ansi')
         extend AnsiInput
       when :dumb
@@ -105,7 +104,7 @@ module Terminal
       con = IO.console
       STDIN.noecho do
         return :legacy if con.syswrite("\e[>1u\e[?u\e[c") != 12
-        inp = +''
+        inp = ''.b
         inp << con.getch until inp.rindex('c')
         return :legacy unless inp.include?("\e[?1u")
       end

data/lib/terminal/output/ansi.rb

@@ -56,8 +56,8 @@ module Terminal
 
     def print(*objects, bbcode: true)
       return if objects.empty?
-      return @out.print(*objects) unless bbcode
-      @out.print(*objects.map! { Ansi.bbcode(it) })
+      objects.map! { Ansi.bbcode(it) } if bbcode
+      @out.print(*objects)
     rescue IOError, SystemCallError
       __output_error(nil)
     end
@@ -65,8 +65,8 @@ module Terminal
     def puts(*objects, bbcode: true)
       objects.flatten!
       return @out.puts if objects.empty?
-      return @out.puts(objects) unless bbcode
-      @out.puts(objects.map! { Ansi.bbcode(it) })
+      objects.map! { Ansi.bbcode(it) } if bbcode
+      @out.puts(*objects)
     rescue IOError, SystemCallError
       __output_error(nil)
     end
@@ -84,6 +84,7 @@ module Terminal
       suffix: nil
     )
       objects.flatten!
+      return @out.puts if objects.empty?
       @out.puts(
         Text::Formatter.format(
           *objects,
@@ -145,6 +146,7 @@ module Terminal
     private_class_method def self.extended(mod)
       mod.instance_variable_set(:@cc, 0)
       mod.instance_variable_set(:@as, 0)
+      # at_exit { raw_write("#{Ansi::CURSOR_SHOW}#{Ansi::SCREEN_ALTERNATE_OFF}") }
     end
   end
 

data/lib/terminal/output/dumb.rb

@@ -67,13 +67,14 @@ module Terminal
       suffix: nil
     )
       objects.flatten!
+      return @out.puts if objects.empty?
       @out.puts(
         Text::Formatter.format(
           *objects,
           ansi: false,
           bbcode:,
           spaces:,
-          eol: eol,
+          eol:,
           align:,
           width:,
           height:,

data/lib/terminal/output.rb

@@ -66,7 +66,7 @@ module Terminal
     #
     #   The terminal size.
     #
-    #   @return [Array<Integer, Integer>] +[rows, columns]+
+    #   @return [Array<Integer, Integer>] `[rows, columns]`
 
     # Terminal width in columns.
     #
@@ -89,7 +89,7 @@ module Terminal
     #   Current cursor position.
     #   This is only available when ANSI is supported ({ansi?} return true).
     #
-    #   @return [Array<Integer, Integer>, nil] +[row, column]+ or +nil+ if
+    #   @return [Array<Integer, Integer>, nil] `[row, column]` or `nil` if
     #     unavailable
 
     # Whether the terminal has been resized since the last size query.
@@ -113,7 +113,7 @@ module Terminal
     #   @example
     #     Terminal << '[bold]Hello[/bold] World'
     #
-    #   @param object [#to_s, nil] the object to output; +nil+ is ignored
+    #   @param object [#to_s, nil] the object to output; `nil` is ignored
     #   @return [self]
 
     # @!method print(*objects, bbcode: true)
@@ -162,7 +162,7 @@ module Terminal
     #   processing.
     #
     #   @param object [#to_s] object to write
-    #   @return [Integer, nil] bytes written, or +nil+ on error
+    #   @return [Integer, nil] bytes written, or `nil` on error
 
     # @!method hide_cursor
     #

data/lib/terminal/rspec/helper.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
+require 'stringio'
+
 # RSpec shared context for testing code that uses Terminal.rb.
 #
-# Stubs all Terminal I/O methods and provides +stdout+, +stdin+, and
-# +stdoutstr+ test helpers. Output is captured into the +stdout+ array;
-# input is read from the +stdin+ array.
+# Stubs all Terminal I/O methods and provides `stdout`, `stdin`, and
+# `stdoutstr` test helpers. Output is captured into the `stdout` array;
+# input is read from the `stdin` array.
 #
 # @example Basic usage
 #   RSpec.describe MyClass do
@@ -20,19 +22,19 @@
 #   include_context 'with Terminal.rb', ansi: false, colors: 8,
 #     size: [40, 120]
 #
-# @param ansi [true, false] mock ANSI support (default: +true+)
+# @param ansi [true, false] mock ANSI support (default: `true`)
 # @param application [Symbol] mock terminal application
-#   (default: +:kitty+)
-# @param colors [Integer, Symbol] mock color depth; use +:true_color+
-#   for 16777216 (default: +256+)
+#   (default: `:kitty`)
+# @param colors [Integer, Symbol] mock color depth; use `:true_color`
+#   for 16777216 (default: `256`)
 # @param size [Array<Integer, Integer>] mock terminal size as
-#   +[rows, columns]+ (default: +[25, 80]+)
+#   `[rows, columns]` (default: `[25, 80]`)
 # @param pos [Array<Integer, Integer>] mock cursor position as
-#   +[row, column]+ (default: +[1, 1]+)
+#   `[row, column]` (default: `[1, 1]`)
 RSpec.shared_context 'with Terminal.rb' do |ansi: true, application: :kitty, colors: 256, size: [25, 80], pos: [1, 1]|
-  let(:stdout) { [] }
+  let(:stdout) { StringIO.new }
+  let(:stdout_lines) { stdout.string.lines(chomp: true) }
   let(:stdin) { [] }
-  let(:stdoutstr) { stdout.join }
 
   before do
     allow(Terminal).to receive(:ansi?).with(no_args).and_return(ansi)
@@ -48,46 +50,48 @@ RSpec.shared_context 'with Terminal.rb' do |ansi: true, application: :kitty, col
     allow(Terminal).to receive(:size).with(no_args).and_return(size)
     allow(Terminal).to receive(:pos).with(no_args).and_return(pos)
 
-    bbcode_ = {
-      true =>
-        ansi ?
-          ->(s) { Terminal::Ansi.bbcode(s) } :
-          ->(s) { Terminal::Ansi.plain(s) },
-      false => ansi ? lambda(&:to_s) : ->(s) { Terminal::Ansi.undecorate(s) }
-    }.compare_by_identity
+    if ansi
+      bbcode_ = ->(s) { Terminal::Ansi.bbcode(s) }
 
-    allow(Terminal).to receive(:<<) do |object|
-      stdout.push(bbcode[object]) unless object.nil?
-      Terminal
-    end
+      allow(Terminal).to receive(:<<) do |object|
+        stdout.write(bbcode_[object]) if object != nil
+        Terminal
+      end
 
-    allow(Terminal).to receive(:print) do |*objects, bbcode: true|
-      bbcode = bbcode_[bbcode]
-      objects.flatten.each { stdout.push(bbcode[it]) unless it.nil? }
-      nil
-    end
+      allow(Terminal).to receive(:print) do |*objects, bbcode: true|
+        next if objects.empty?
+        objects.map! { Ansi.bbcode(it) } if bbcode
+        stdout.print(*objects)
+      end
 
-    allow(Terminal).to receive(:puts) do |*objects, bbcode: true|
-      objects.flatten!
-      if objects.empty?
-        stdout.push("\n")
-        next
+      allow(Terminal).to receive(:puts) do |*objects, bbcode: true|
+        objects.flatten!
+        next @out.puts if objects.empty?
+        objects.map! { Ansi.bbcode(it) } if bbcode
+        stdout.puts(*objects)
       end
-      bbcode = bbcode_[bbcode]
-      objects.each do |s|
-        next stdout.push("\n") if s.nil?
-        stdout.push(s = bbcode[s])
-        stdout.push("\n") if s[-1] != "\n"
+
+      allow(Terminal).to receive(:raw_write) { stdout.syswrite(it) }
+    else
+      plain_ = ->(s) { Terminal::Ansi.plain(s) }
+      undecorate_ = ->(s) { Terminal::Ansi.undecorate(s) }
+
+      allow(Terminal).to receive(:<<) do |object|
+        stdout.write(Terminal::Ansi.plain(object)) if object != nil
+        Terminal
       end
-      nil
-    end
 
-    if ansi
-      allow(Terminal).to receive(:raw_write) do |object|
-        stdout.push(object = object.to_s)
-        object.bytesize
+      allow(Terminal).to receive(:print) do |*objects, bbcode: true|
+        next if objects.empty?
+        stdout.print(*objects.map!(&(bbcode ? plain_ : undecorate_)))
       end
-    else
+
+      allow(Terminal).to receive(:puts) do |*objects, bbcode: true|
+        objects.flatten!
+        next stdout.puts if objects.empty?
+        stdout.puts(*objects.map!(&(bbcode ? plain_ : undecorate_)))
+      end
+
       allow(Terminal).to receive(:raw_write).and_return(nil)
     end
 

data/lib/terminal/shell.rb

@@ -77,7 +77,7 @@ module Terminal
         return unless obj
         return copy_writer(obj) if obj.respond_to?(:readpartial)
         return copy_writer(obj.to_io) if obj.respond_to?(:to_io)
-        return array_writer(obj) if Array === obj
+        return array_writer(obj) if obj.is_a?(Array)
         if obj.respond_to?(:each)
           return enum_writer(obj.enum_for(:each)) if obj.respond_to?(:enum_for)
           return enum_writer(Enumerator.new { |y| obj.each { y << it } })

data/lib/terminal/text/formatter.rb

@@ -32,8 +32,8 @@ module Terminal
       #   # => [["Hello", 5]]
       #
       # @param (see #initialize)
-      # @param with_size [true, false] when +true+,
-      #   return +[line, width]+ pairs instead of plain strings
+      # @param with_size [true, false] when `true`,
+      #   return `[line, width]` pairs instead of plain strings
       # @param (see #lines_with_size)
       # @return (see #lines_with_size)
       def self.[](
@@ -86,17 +86,23 @@ module Terminal
       # @param ansi [true, false] recognize ANSI escape codes
       # @param bbcode [true, false] process BBCode markup
       # @param spaces [true, false] preserve whitespace;
-      #   when +false+ leading/trailing spaces and multiple spaces are
+      #   when `false` leading/trailing spaces and multiple spaces are
       #   collapsed
       # @param eol [true, false] preserve line endings;
-      #   when +false+ newlines are treated as spaces
+      #   when `false` newlines are treated as spaces
       def initialize(*str, ansi: true, bbcode: true, spaces: true, eol: true)
         @lex = []
         return if str.empty?
         ansi ? _generate_ansi(str, bbcode) : _generate(str, bbcode)
         return if @lex.empty?
+        @keep_paragraph = true
         @lex = _ignore_whitespace unless spaces
-        @lex = _ignore_newline unless eol
+        case eol
+        when false, nil
+          @lex = _ignore_newline
+        when :no_paragraph
+          @keep_paragraph = false
+        end
       end
 
       # Word-wrap and return lines with their display widths.
@@ -106,10 +112,10 @@ module Terminal
       #   fmt.lines_with_size(width: 5)
       #   # => [["Hello", 5], ["World", 5]]
       #
-      # @param width [Integer, nil] maximum line width in columns;
-      #   +nil+ returns unwrapped lines
+      # @param width [#to_i, nil] maximum line width in columns;
+      #   `nil` returns unwrapped lines
       # @return [Array<String, Integer>] pairs of
-      #   +[line_text, display_width]+
+      #   `[line_text, display_width]`
       # @raise (see #format)
       def lines_with_size(width: nil)
         return [] if @lex.empty?
@@ -125,9 +131,9 @@ module Terminal
       #   fmt.lines(width: 5)
       #   # => ["Hello", "World"]
       #
-      # @param width [Integer, nil] maximum line width in columns
+      # @param width [#to_i, nil] maximum line width in columns
       # @return [Array<String>]
-      # @raise [ArgumentError] if +width+ is zero or negative
+      # @raise [ArgumentError] if `width` is zero or negative
       def lines(width: nil) = lines_with_size(width:).map(&:first)
 
       # Format lines with alignment, padding, and decorations.
@@ -138,11 +144,11 @@ module Terminal
       #   # => [" Hi         "]
       #
       # @param align [Symbol, nil] text alignment:
-      #   +:left+, +:right+, +:center+, or +nil+ (no fill)
-      # @param width [Integer, nil] output line width in columns
-      # @param height [Integer, nil] number of output lines;
+      #   `:left`, `:right`, `:center`, or `nil` (no fill)
+      # @param width [#to_i, nil] output line width in columns
+      # @param height [#to_i, nil] number of output lines;
       #   negative values take lines from the end
-      # @param padding [Integer, Array, nil] CSS-style padding
+      # @param padding [#to_i, Array, nil] CSS-style padding
       #    - 1 value: all sides;
       #    - 2 values: [vertical, horizontal];
       #    - 3 values: [top, horizontal, bottom];
@@ -150,7 +156,7 @@ module Terminal
       # @param prefix [#to_s, nil] string prepended to each line
       # @param suffix [#to_s, nil] string appended to each line
       # @return [Array<String>] formatted output lines
-      # @raise [ArgumentError] if +width+ is zero or negative
+      # @raise [ArgumentError] if `width` is zero or negative
       def format(
         align: nil,
         width: nil,
@@ -172,27 +178,29 @@ module Terminal
           return [] if height < 1
         end
 
+        space = SPACE_CACHE.dup
+
         if width
           w = (width = width.to_i) - left - right
           raise(ArgumentError, "invalid width - #{width.inspect}") if w < 1
           lws = _limited(w)
           lws = tail ? lws.last(height) : lws.take(height) if height
-          empty = "#{prefix}#{' ' * width}#{suffix}" if top + bottom > 0
+          empty = "#{prefix}#{space[width]}#{suffix}" if top + bottom > 0
         else
           lws = @unlimited || _unlimited
           lws = tail ? lws.last(height) : lws.take(height) if height
           w = lws.empty? ? 0 : lws.max_by(&:last)[-1]
           if top + bottom > 0
-            empty = "#{prefix}#{' ' * (w + left + right)}#{suffix}"
+            empty = "#{prefix}#{space[w + left + right]}#{suffix}"
           end
         end
 
         ret = []
         ret.fill(empty, 0, top) if top > 0
-        left = left < 1 ? prefix.to_s : "#{prefix}#{' ' * left}"
-        right = right < 1 ? suffix.to_s : "#{' ' * right}#{suffix}"
+        left = left < 1 ? prefix.to_s : "#{prefix}#{space[left]}"
+        right = right < 1 ? suffix.to_s : "#{space[right]}#{suffix}"
 
-        space = SPACE_CACHE.dup
+        # TODO: styling
 
         case align
         when :left
@@ -201,9 +209,9 @@ module Terminal
           lws.each { |l, s| ret << "#{left}#{space[w - s]}#{l}#{right}" }
         when :center
           lws.each do |l, s|
-            ls = (s = w - s) / 2
-            next ret << "#{left}#{l}#{right}" if ls < 1
-            ret << "#{left}#{space[ls]}#{l}#{space[s - ls]}#{right}"
+            rs = ((s = w - s) / 2.0).round
+            next ret << "#{left}#{l}#{right}" if rs < 1
+            ret << "#{left}#{space[s - rs]}#{l}#{space[rs]}#{right}"
           end
         else
           lws.each { |l, _| ret << "#{left}#{l}#{right}" }
@@ -224,7 +232,7 @@ module Terminal
       #   fmt = Terminal::Text::Formatter.new("short\na longer line")
       #   fmt.max_line_width # => 13
       #
-      # @return [Integer] widest line in columns, +0+ when empty
+      # @return [Integer] widest line in columns, `0` when empty
       def max_line_width
         @max_line_width ||=
           (@lex.empty? ? 0 : (@unlimited || _unlimited).max_by(&:last)[-1])
@@ -237,7 +245,7 @@ module Terminal
       #   Terminal::Text::Formatter.new('Hello World').to_s(width: 5)
       #   # => "Hello\nWorld"
       #
-      # @param width [Integer, nil] maximum line width in columns
+      # @param width [#to_i, nil] maximum line width in columns
       # @return [String]
       def to_s(width: nil) = lines(width:).join("\n")
 
@@ -294,8 +302,9 @@ module Terminal
             if (last = line[-1]).is_a?(Space) # ignore trailing space
               line.pop
               size -= last.size
+              next add_line.call
             end
-            add_line.call # if size > 0
+            add_line.call if (current != EOP) || (@keep_paragraph || size > 0)
             next
           end
 
@@ -507,7 +516,7 @@ module Terminal
       # @private
       class Space
         attr_accessor :size
-        def to_str = (' ' * @size)
+        def to_str = (@size == 1 ? ' ' : ' ' * @size)
         def initialize = (@size = 1)
         def inc = (@size += 1)
         def inspect = @size == 1 ? '<Space>' : "<Space #{@size}>"
@@ -565,7 +574,7 @@ module Terminal
         class << self
           attr_reader :to_str, :size, :inspect
         end
-        @to_str = "\e[m"
+        @to_str = Ansi::RESET
         @size = 0
         @inspect = '<CsiEnd>'
       end
@@ -581,11 +590,12 @@ module Terminal
 
       ENCODING = Encoding::UTF_8
 
-      SPACE_CACHE =
-        Hash
-          .new { |h, s| h[s] = s < 1 ? '' : ' ' * s }
-          .compare_by_identity
-          .freeze
+      space_cache =
+        Hash.new { |h, s| h[s] = s < 1 ? '' : ' ' * s }.compare_by_identity
+      space_cache[0]
+      space_cache[1]
+      space_cache[2]
+      SPACE_CACHE = space_cache.freeze
 
       SCAN_REGEX =
         /\G(?:

data/lib/terminal/text.rb

@@ -28,7 +28,7 @@ module Terminal
       #   Terminal::Text.ambiguous_char_width     # => 1
       #   Terminal::Text.ambiguous_char_width = 2 # for CJK terminals
       #
-      # @return [Integer] default: +1+
+      # @return [Integer] default: `1`
       attr_accessor :ambiguous_char_width
 
       # Calculate the display width of a string in terminal columns.

data/lib/terminal/version.rb

@@ -2,5 +2,5 @@
 
 module Terminal
   # The version number of the gem.
-  VERSION = '1.0.4'
+  VERSION = '1.0.6'
 end

data/lib/terminal.rb

@@ -30,32 +30,32 @@ module Terminal
     # Detect the terminal emulator application.
     #
     # Known applications:
-    # +:alacritty+,
-    # +:amiga+,
-    # +:code_edit+,
-    # +:dg_unix+,
-    # +:docker+,
-    # +:fluent+,
-    # +:hpterm+,
-    # +:hyper+,
-    # +:iterm+,
-    # +:kitty+,
-    # +:macos+,
-    # +:mintty+,
-    # +:ms_terminal+,
-    # +:ncr260+,
-    # +:nsterm+,
-    # +:terminator+,
-    # +:terminology+,
-    # +:termite+,
-    # +:vscode+,
-    # +:vt100+,
-    # +:warp+,
-    # +:wyse+,
-    # +:xnuppc+
+    # `:alacritty`,
+    # `:amiga`,
+    # `:code_edit`,
+    # `:dg_unix`,
+    # `:docker`,
+    # `:fluent`,
+    # `:hpterm`,
+    # `:hyper`,
+    # `:iterm`,
+    # `:kitty`,
+    # `:macos`,
+    # `:mintty`,
+    # `:ms_terminal`,
+    # `:ncr260`,
+    # `:nsterm`,
+    # `:terminator`,
+    # `:terminology`,
+    # `:termite`,
+    # `:vscode`,
+    # `:vt100`,
+    # `:warp`,
+    # `:wyse`,
+    # `:xnuppc`
     #
-    # Any unrecognized +TERM_PROGRAM+ value is converted to a sanitized
-    # symbol. Returns +nil+ when no terminal can be identified.
+    # Any unrecognized `TERM_PROGRAM` value is converted to a sanitized
+    # symbol. Returns `nil` when no terminal can be identified.
     #
     # @example
     #   Terminal.application # => :kitty
@@ -77,7 +77,7 @@ module Terminal
     #   @param cmd [Array<String>] command and arguments
     #   @param options [Hash] options passed to the shell runner
     #   @return [Array<Process::Status, Array<String>, Array<String>>]
-    #     +[status, stdout_lines, stderr_lines]+
+    #     `[status, stdout_lines, stderr_lines]`
     #   @example
     #     status, output, error = Terminal.sh('echo', 'hello')
     #     output # => ["hello\n"]
@@ -88,7 +88,7 @@ module Terminal
     #   @param options [Hash] options passed to the shell runner
     #   @yield [line, type] called for each output line
     #   @yieldparam line [String] the output line
-    #   @yieldparam type [Symbol] +:output+ or +:error+
+    #   @yieldparam type [Symbol] `:output` or `:error`
     #   @return [Process::Status] the exit status
     #   @example
     #     Terminal.sh('make') do |line, type|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: terminal_rb
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.6
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -29,6 +29,7 @@ files:
 - examples/bbcode.rb
 - examples/info.rb
 - examples/key-codes.rb
+- examples/lorem_ipsum.ansi
 - examples/screen_viewer.rb
 - examples/text.rb
 - lib/terminal.rb
@@ -59,13 +60,13 @@ metadata:
   yard.run: yard
   source_code_uri: https://codeberg.org/mblumtritt/Terminal.rb
   bug_tracker_uri: https://codeberg.org/mblumtritt/Terminal.rb/issues
-  documentation_uri: https://rubydoc.info/gems/terminal_rb/1.0.4
+  documentation_uri: https://rubydoc.info/gems/terminal_rb/1.0.6
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -74,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.15
 specification_version: 4
 summary: Fast terminal access with ANSI, CSIu, mouse events, BBCode, word-wise line
   break support and much more.