natty-ui 0.27.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43f1afe6be5864d4895c974783fbfcff1f4b5a23f963eb24f6a964fe09b1174c
-  data.tar.gz: e3a4c8e1981f0299f9927c4a3f53fa0c4eca95f792f9590c9ea191e7018adcb5
+  metadata.gz: db28cf57db8670d12ed258d70765447c08bd51462acc7907ea9072b64117f965
+  data.tar.gz: 36e9c43bf76fcb1e68b450a1289bcffa8b4cfb33fa2d575ed9b1b92dc6ecce69
 SHA512:
-  metadata.gz: d9c75d24c0363076c3e0d41ac458d4f13a6552811d166028d5d758ba408d20aa63907a471ee56c4fe4b0638db1cb03e915d0b6c606e8770a9753d59eafb7c951
-  data.tar.gz: 77a95400ba528d57f3e1b559ac1ffa584c68a60bcc45d212341bc803031f204abac44e269db1d81903a4629b7c9c466c27acae66d84c2f802a3486bab37a929b
+  metadata.gz: e19e8e97300a844d294f61e9d4e6c43f5db5fe5a7122ff7c07c7bdd460e229ffffb0b6c943fe1e9f015bf91008824312746290098e10c7851ece75b7bfcb21bf
+  data.tar.gz: c6caff65104a42913c3f38ad53b0d628b11aff7517f6450d562c7f41e3b99234caaa48d8e266dd7abb6ca3a83546cd27a019612d0ee6f9e40e249717d26ecfd1

data/examples/8bit-colors.rb

@@ -6,13 +6,13 @@ ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]8bit Color Support[/]' do
   color = ->(i) { "[bg#{i = i.to_s(16).rjust(2, '0')}] #{i} " }
 
   ui.space
-  ui.message('System Colors', <<~COLORS.chomp)
+  ui.message 'System Colors', <<~COLORS.chomp
     [#ff]#{0.upto(7).map(&color).join}
     [#00]#{8.upto(15).map(&color).join}
   COLORS
 
   ui.space
-  ui.message('Grayscale', <<~GRAYSCALE.chomp)
+  ui.message 'Grayscale', <<~GRAYSCALE.chomp
     [#ff]#{0xe8.upto(0xf3).map(&color).join}
     [#ff]#{0xf4.upto(0xff).map(&color).join}
   GRAYSCALE

data/examples/elements.rb

@@ -4,16 +4,16 @@ require_relative '../lib/natty-ui'
 
 ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Simple Elements[/]' do
   ui.space
-  ui.h1('This is a [b]H1[/b] heading element')
+  ui.h1 'This is a [b]H1[/b] heading element'
 
   ui.space
-  ui.h2('This is a [b]H2[/b] heading element')
+  ui.h2 'This is a [b]H2[/b] heading element'
 
   ui.space
   ui.quote "This is a\nmulti-line quotation"
 
   ui.space
-  ui.h3('This is a [b]H3[/b] heading element')
+  ui.h3 'This is a [b]H3[/b] heading element'
   ui.mark(
     'This is a multi-line message',
     'with a leading checkmark.',
@@ -21,11 +21,11 @@ ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Simple Elements[/]' do
   )
 
   ui.space
-  ui.h4('This is a [b]H4[/b] heading element')
+  ui.h4 'This is a [b]H4[/b] heading element'
 
   ui.space
-  ui.h5('This is a [b]H5[/b] heading element')
+  ui.h5 'This is a [b]H5[/b] heading element'
 
   ui.space
-  ui.h6('This is a [b]H6[/b] heading element')
+  ui.h6 'This is a [b]H6[/b] heading element'
 end

data/examples/examples.rb

@@ -13,6 +13,8 @@ EXAMPLES = {
   'ls' => 'Print Lists',
   'tables' => 'Print Tables',
   'cols' => 'Print Columns',
+  'vbars' => 'Print Vertical Bars',
+  'hbars' => 'Print Horizontal Bars',
   'sections' => 'Sections',
   'tasks' => 'Tasks'
 }.freeze
@@ -23,7 +25,7 @@ ui.space
 
 while true
   selected =
-    ui.choice(**EXAMPLES, abortable: true) do
+    ui.choice(**EXAMPLES, abortable: true, selected: selected) do
       ui.cols(
         "[red] /\\_/\\\n( o.o )\n > ^ <",
         '[bright_green b]Select a natty example:',

data/examples/hbars.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative '../lib/natty-ui'
+
+ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Print Horizontal Bars[/]' do
+  values = [11.97, 14.35, 15.51, 12.39, 14.3, 10.6, 17.7].freeze
+
+  ui.space
+  ui.hbars values, style: :blue
+  ui.puts 'NattyUI can quick dump values as horizontal bars.'
+
+  ui.space
+  ui.hbars values, style: :green, normalize: true, width: 0.5
+  ui.puts(
+    'These are the same values but [i]normalized[/i] ' \
+      'and printed in half width.'
+  )
+end

data/examples/illustration.rb

@@ -39,7 +39,7 @@ ui.message '[b]​ᓚᕠᗢ NattyUI[/b]' do
     table.add do |row|
       row.add 'Layout'
       row.add <<~TEXT.chomp
-        🎩 heading elements     📝 messages
+        🎩 heading elements     📝 messages    📊 bar graphs
         📏 horizontal rulers    [blue]┼┼[/] tables
         📋 lists                [b green]✓✓[/] tasks
       TEXT

data/examples/info.rb

@@ -2,29 +2,30 @@
 
 require_relative '../lib/natty-ui'
 
+def colors
+  return Terminal.colors.to_s if Terminal.colors < 8
+  colors = [
+    Terminal.true_color? ? 'true color' : Terminal.colors,
+    "#{(0..15).map { "[#{_1.to_s(16).rjust(2, '0')}]██" }.join}[/]"
+  ]
+  if Terminal.true_color?
+    colors << Terminal::Ansi.rainbow('████████████████████████████████')
+  end
+  colors.join("\n")
+end
+
 ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Terminal Information[/]' do
   ui.space
   ui.table do |table|
-    table.add('Identifier', Terminal.application || 'unidentified')
-    table.add('ANSI support', Terminal.ansi? ? 'yes' : 'no')
-    table.add('Input mode', Terminal.input_mode)
-    table.add(
-      'Colors',
-      "#{Terminal.true_color? ? 'true color' : Terminal.colors}
-      [black]██[red]██[green]██[yellow]██[blue]██[magenta]██[cyan]██[white]██" \
-        '[bright_black]██[bright_red]██[bright_green]██[bright_yellow]██' \
-        '[bright_blue]██[bright_magenta]██[bright_cyan]██[bright_white]██[/]' \
-        "#{
-          if Terminal.true_color?
-            Terminal::Ansi.rainbow("\n████████████████████████████████")
-          end
-        }"
-    )
-    table.add('Screen size', Terminal.size.join(' x '))
+    table.add 'Identifier', Terminal.application || 'unidentified'
+    table.add 'ANSI support', Terminal.ansi? ? 'yes' : 'no'
+    table.add 'Input mode', Terminal.input_mode
+    table.add 'Colors', colors
+    table.add 'Screen size', Terminal.size.join(' x ')
     fc = table.columns[0]
-    fc.width = 13
-    fc.padding_right = 1
+    fc.width = 14
+    fc.padding_right = 2
     fc.align = :right
-    table.columns[1].style = :bold
+    table.columns[1].style = %i[bold bright_yellow]
   end
 end

data/examples/key-codes.rb

@@ -2,27 +2,29 @@
 
 require_relative '../lib/natty-ui'
 
-raw = name = :start
-while name != 'Esc'
+event = nil
+while true
   ui.temporary do
     ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Keyboard Key Codes[/]' do
       ui.puts(
-        "\n#{
-          case name
-          when :start
-            "Your terminal uses [i]#{
-              Terminal.input_mode
-            }[/i] mode. Press a key!"
-          when nil
-            "[green]#{raw.inspect}[/fg] → [bold bright_green][\\#{raw}]"
+        "
+        #{
+          if event
+            "#{event.to_a.size < 2 ? ' Key' : 'Keys'}: [bold bright_green]#{
+              event.to_a.map { "[\\#{_1}]" }.join(' ')
+            }[/]
+            Code: [bright_blue]#{event.raw.inspect}[/]"
           else
-            "[green]#{raw.inspect}[/fg] → [bold bright_green]#{
-              name.split('+').map! { "[\\#{_1}]" }.join(' ')
-            }"
+            "Your terminal uses [bright_blue]#{
+              Terminal.input_mode
+            }[/] mode. Press a key!"
           end
-        }\n\n[bright_black](Exit with ESC)"
+        }
+
+        [faint](Exit with ESC)"
       )
     end
-    raw, name = Terminal.read_key(mode: :both)
+    event = Terminal.read_key_event
+    exit if event.nil? || event.name == 'Esc'
   end
 end

data/examples/tasks.rb

@@ -21,7 +21,7 @@ ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Tasks[/]' do
 
     ui.task('Connect to Library') do
       foo
-      ui.mark('Server Found', mark: :checkmark)
+      ui.mark 'Server Found', mark: :checkmark
       ui.task('Login...') { some }
     end
 

data/examples/vbars.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative '../lib/natty-ui'
+
+ui.message '[b]​ᓚᕠᗢ NattyUI[/b] [i green]Print Vertical Bars[/]' do
+  values = [
+    11.97,
+    14.35,
+    15.51,
+    12.39,
+    14.3,
+    10.6,
+    17.7,
+    14.47,
+    14.56,
+    17.31,
+    12.98,
+    16.21,
+    14.9,
+    17.23,
+    13.35,
+    11.62,
+    14.81,
+    19.7,
+    13.42,
+    14.18
+  ].freeze
+
+  ui.space
+  ui.vbars values, style: :blue
+  ui.puts 'NattyUI can quick dump values as vertical bars.'
+
+  ui.space
+  ui.vbars values, style: :green, normalize: true, bar_width: 2
+  ui.puts(
+    'These are the same values but [i]normalized[/i] and printed with ' \
+      'a fixed bar width.'
+  )
+end

data/lib/natty-ui/choice.rb

@@ -7,22 +7,24 @@ module NattyUI
     def select
       yield(self) if block_given?
       pin_line = NattyUI.lines_written
-      draw(current = 0)
-      while (key = Terminal.read_key)
-        case key
+      draw(current = @ret.index(@selected) || 0)
+      while (event = Terminal.read_key_event)
+        case event.name
         when 'Esc', 'Ctrl+c'
           break nil if @abortable
         when 'Enter', ' '
           break @ret[current]
-        when 'Up', 'Left', 'Back', 'Shift+Tab'
+        when 'Home'
+          current = 0
+        when 'End'
+          current = @texts.size - 1
+        when 'Up', 'Back', 'Shift+Tab', 'i'
           current = @texts.size - 1 if (current -= 1) < 0
-          pin_line = NattyUI.back_to_line(pin_line, erase: false)
-          draw(current)
-        when 'Down', 'Right', 'Tab'
+        when 'Down', 'Tab', 'k'
           current = 0 if (current += 1) == @texts.size
-          pin_line = NattyUI.back_to_line(pin_line, erase: false)
-          draw(current)
         end
+        pin_line = NattyUI.back_to_line(pin_line, erase: false)
+        draw(current)
       end
     ensure
       NattyUI.back_to_line(@start_line)
@@ -30,12 +32,13 @@ module NattyUI
 
     private
 
-    def initialize(parent, args, kwargs, abortable)
+    def initialize(parent, args, kwargs, abortable, selected)
       super(parent)
       @start_line = NattyUI.lines_written
       @texts = args + kwargs.values
       @ret = Array.new(args.size, &:itself) + kwargs.keys
       @abortable = abortable
+      @selected = selected
       theme = Theme.current
       @mark = [theme.mark(:choice), theme.choice_style]
       @mark_current = [theme.mark(:current_choice), theme.choice_current_style]

data/lib/natty-ui/dumb_choice.rb

@@ -7,10 +7,10 @@ module NattyUI
     def select
       yield(self) if block_given?
       draw
-      while (code = Terminal.read_key)
-        return if @abortable && (code == 'Esc' || code == 'Ctrl+c')
-        next if code.size > 1
-        code = code[0].upcase
+      while (event = Terminal.read_key_event)
+        return if @abortable && %w[Esc Ctrl+c].include?(event.name)
+        next unless event.simple?
+        code = event.raw.upcase
         if @ret.size <= 9 && ('1'..'9').include?(code)
           code = @ret[code.ord - 49] and break code
         elsif ('A'..'Z').include?(code)

data/lib/natty-ui/features.rb

@@ -15,12 +15,12 @@ module NattyUI
     # Print given text as lines.
     #
     # @example Print two lines text, right aligned
-    #   ui.puts("Two lines", "of nice text", align: :right)
+    #   ui.puts "Two lines", "of nice text", align: :right
     #   # =>    Two lines
     #   # => of nice text
     #
     # @example Print two lines text, with a prefix
-    #   ui.puts("Two lines", "of nice text", prefix: ': ')
+    #   ui.puts "Two lines", "of nice text", prefix: ': '
     #   # => : Two lines
     #   # => : of nice text
     #
@@ -39,6 +39,7 @@ module NattyUI
     def puts(*text, **options)
       bbcode = true if (bbcode = options[:bbcode]).nil?
       max_width = options[:max_width] || Terminal.columns
+      max_width = Terminal.columns + max_width if max_width < 0
 
       prefix_width =
         if (prefix = options[:prefix])
@@ -272,8 +273,8 @@ module NattyUI
 
     # Print a horizontal rule.
     #
-    # @example
-    #   ui.hr(:heavy)
+    # @example Print double line
+    #   ui.hr :double
     #
     # @param type [Symbol]
     #   border type
@@ -305,10 +306,10 @@ module NattyUI
     # - any text as prefix
     #
     # @example Print all Ruby files as a numbered list
-    #   ui.ls(Dir['*/**/*.rb'], glyph: 1)
+    #   ui.ls Dir['*/**/*.rb'], glyph: 1
     #
     # @example Print all Ruby files as a bullet point list (with green bullets)
-    #   ui.ls(Dir['*/**/*.rb'], glyph: '[green]•[/fg]')
+    #   ui.ls Dir['*/**/*.rb'], glyph: '[green]•[/fg]'
     #
     # @param items [#to_s]
     #   one or more convertible objects to list
@@ -416,6 +417,86 @@ module NattyUI
       table(**tab_att) { |table| table.add { _1.add(*text, **att) } }
     end
 
+    # Dump given values as vertical bars.
+    #
+    # @example Draw green bars
+    #   ui.vbars 1..10, style: :green
+    #
+    # @example Draw very big bars
+    #   ui.vbars 1..10, bar_width: 5, height: 20
+    #
+    # @param values [#to_a, Array<Numeric>] values to print
+    # @param normalize [true, false] whether the values should be normalized
+    # @param height [Integer] output height
+    # @param bar_width [:auto, :min, Integer] with of each bar
+    # @param style [Symbol, Array<Symbol>, nil] drawing style
+    #
+    # @raise [ArgumentError] if any value is negative
+    #
+    # @return (see puts)
+    def vbars(
+      values,
+      normalize: false,
+      height: 10,
+      bar_width: :auto,
+      style: nil
+    )
+      return self if (values = values.to_a).empty?
+      if values.any?(&:negative?)
+        raise(ArgumentError, 'values can not be negative')
+      end
+      puts(
+        *VBarsRenderer.lines(
+          values,
+          columns,
+          height,
+          normalize,
+          bar_width,
+          Terminal.ansi? ? style : nil
+        )
+      )
+    end
+
+    # Dump given values as horizontal bars.
+    #
+    # @example Draw green bars
+    #   ui.hbars 1..10, style: :green
+    #
+    # @example Draw bars in half sreen width
+    #   ui.hbars 1..10, style: :blue, width: 0.5
+    #
+    # @param values [#to_a, Array<Numeric>] values to print
+    # @param with_values [true, false] whether the values should be printed too
+    # @param normalize [true, false] whether the values should be normalized
+    # @param height [Integer] output height
+    # @param bar_width [:auto, :min, Integer] with of each bar
+    # @param style [Symbol, Array<Symbol>, nil] bar drawing style
+    # @param text_style [Symbol, Array<Symbol>, nil] text style
+    #
+    # @raise [ArgumentError] if any value is negative
+    #
+    # @return (see puts)
+    def hbars(
+      values,
+      with_values: true,
+      normalize: false,
+      width: :auto,
+      style: nil,
+      text_style: nil
+    )
+      return self if (values = values.to_a).empty?
+      if values.any?(&:negative?)
+        raise(ArgumentError, 'values can not be negative')
+      end
+      style = text_style = nil unless Terminal.ansi?
+      size = Utils.as_size(3..columns, width)
+      if with_values
+        puts(*HBarsRenderer.lines(values, size, normalize, style, text_style))
+      else
+        puts(*HBarsRenderer.lines_bars_only(values, size, normalize, style))
+      end
+    end
+
     # Dynamically display a task progress.
     # When a `max` parameter is given the progress will be displayed as a
     # progress bar below the `title`. Otherwise the progress is displayed just
@@ -434,15 +515,15 @@ module NattyUI
     #   end
     #
     # @example Display simple progress
-    #   progress = ui.progress('Check some stuff')
+    #   progress = ui.progress 'Check some stuff'
     #   10.times do
     #     # simulate some work
-    #     sleep(0.1)
+    #     sleep 0.1
     #
     #     # here we actualize the progress
     #     progress.step
     #   end
-    #   progress.ok('Stuff checked ok')
+    #   progress.ok 'Stuff checked ok'
     #
     # @overload progress(title, max: nil, pin: false)
     #   @param title [#to_s]
@@ -491,10 +572,10 @@ module NattyUI
     #
     # @example
     #   ui.section do |section|
-    #     section.h1('About Sections')
+    #     section.h1 'About Sections'
     #     section.space
-    #     section.puts('Sections are areas of text elements.')
-    #     section.puts('You can use any other feature inside such an area.')
+    #     section.puts 'Sections are areas of text elements.'
+    #     section.puts 'You can use any other feature inside such an area.'
     #   end
     #   # => ╭────╶╶╶
     #   # => │ ╴╶╴╶─═══ About Sections ═══─╴╶╴╶
@@ -643,18 +724,14 @@ module NattyUI
     #
     #   @return [true, false]
     #     wheter the user inputs a positive result
+    #   @return nil
+    #     in error case
     #
     def await(yes: 'Enter', no: 'Esc')
-      temporary do |arg|
-        yield(arg) if block_given?
-        while (key = Terminal.read_key)
-          if (no == key) || (no.is_a?(Enumerable) && no.include?(key))
-            return false
-          end
-          if (yes == key) || (yes.is_a?(Enumerable) && yes.include?(key))
-            return true
-          end
-        end
+      return __await(yes, no) unless block_given?
+      temporary do |temp|
+        yield(temp)
+        __await(yes, no)
       end
     end
 
@@ -727,12 +804,12 @@ module NattyUI
     #   @return [nil]
     #     when user aborted the selection
     #
-    def choice(*choices, abortable: false, **kwchoices, &block)
+    def choice(*choices, abortable: false, selected: nil, **kwchoices, &block)
       return if choices.empty? && kwchoices.empty?
       choice =
         case NattyUI.input_mode
         when :default
-          Choice.new(self, choices, kwchoices, abortable)
+          Choice.new(self, choices, kwchoices, abortable, selected)
         when :dumb
           DumbChoice.new(self, choices, kwchoices, abortable)
         else
@@ -757,7 +834,7 @@ module NattyUI
     #
     # @example Show tempoary information
     #   ui.temporary do
-    #     ui.info('Information', 'This text will disappear when you pressed ENTER.')
+    #     ui.info 'Information', 'This text will disappear when you pressed ENTER.'
     #     ui.await
     #   end
     #
@@ -783,15 +860,27 @@ module NattyUI
       __sec(color, "#{Theme.current.mark(color)}#{title}", text, &block)
     end
 
+    def __await(yes, no)
+      while (event = Terminal.read_key_event&.name)
+        if (no == event) || (no.is_a?(Enumerable) && no.include?(event))
+          return false
+        end
+        if (yes == event) || (yes.is_a?(Enumerable) && yes.include?(event))
+          return true
+        end
+      end
+    end
+
     EOL__ = Terminal.ansi? ? "\e[m\n" : "\n"
     private_constant :EOL__
   end
 
   dir = __dir__
   autoload :Choice, "#{dir}/choice.rb"
-  autoload :CompactLSRenderer, "#{dir}/ls_renderer.rb"
   autoload :DumbChoice, "#{dir}/dumb_choice.rb"
+  autoload :CompactLSRenderer, "#{dir}/ls_renderer.rb"
   autoload :Framed, "#{dir}/framed.rb"
+  autoload :HBarsRenderer, "#{dir}/hbars_renderer.rb"
   autoload :LSRenderer, "#{dir}/ls_renderer.rb"
   autoload :Progress, "#{dir}/progress.rb"
   autoload :DumbProgress, "#{dir}/progress.rb"
@@ -801,6 +890,18 @@ module NattyUI
   autoload :Temporary, "#{dir}/temporary.rb"
   autoload :Theme, "#{dir}/theme.rb"
   autoload :Utils, "#{dir}/utils.rb"
-
-  private_constant :Choice, :DumbChoice, :LSRenderer, :CompactLSRenderer
+  autoload :VBarsRenderer, "#{dir}/vbars_renderer.rb"
+
+  private_constant(
+    :Choice,
+    :DumbChoice,
+    :CompactLSRenderer,
+    :Framed,
+    :HBarsRenderer,
+    :LSRenderer,
+    :Progress,
+    :DumbProgress,
+    :Utils,
+    :VBarsRenderer
+  )
 end

data/lib/natty-ui/hbars_renderer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'utils'
+
+module NattyUI
+  module HBarsRenderer
+    class << self
+      def lines(vals, width, normalize, style, text_style)
+        if text_style
+          bots = Ansi[*text_style]
+          eots = Ansi::RESET
+        end
+        texts = vals.map { Str.new(_1) }
+        tw = texts.max_by(&:width).width
+        size = width - tw - 1
+        if size < 2 # text only
+          return texts.map { "#{bots}#{' ' * (tw - _1.width)}#{_1}#{eots}" }
+        end
+        if style
+          bos = Ansi[*style]
+          eos = Ansi::RESET
+        end
+        vals = normalize ? normalize!(vals, size) : adjust!(vals, size)
+        texts.map.with_index do |str, idx|
+          "#{bots}#{' ' * (tw - str.width)}#{str}#{eots}#{bos}▕#{
+            '▆' * vals[idx]
+          }#{eos}"
+        end
+      end
+
+      def lines_bars_only(vals, width, normalize, style)
+        if style
+          bos = Ansi[*style]
+          eos = Ansi::RESET
+        end
+        width -= 1
+        vals = normalize ? normalize!(vals, width) : adjust!(vals, width)
+        vals.map { "#{bos}▕#{'▆' * _1}#{eos}" }
+      end
+
+      private
+
+      def adjust!(vals, size)
+        max = vals.max.to_f
+        vals.map { ((_1 / max) * size).round }
+      end
+
+      def normalize!(vals, size)
+        min, max = vals.minmax
+        return Array.new(vals.size, size) if min == max
+        max = (max - min).to_f
+        vals.map { (((_1 - min) / max) * size).round }
+      end
+    end
+  end
+
+  private_constant :HBarsRenderer
+end

data/lib/natty-ui/table_renderer.rb

@@ -156,6 +156,7 @@ module NattyUI
         ["#{@style}#{' ' * @padding[3]}", "#{' ' * @padding[1]}[/]"]
       end
     end
+    private_constant :Cell
   end
   private_constant :TableRenderer
 end

data/lib/natty-ui/utils.rb

@@ -59,6 +59,19 @@ module NattyUI
         end
       end
       alias margin padding
+
+      # @!visibility private
+      def as_size(range, value)
+        return range.begin if value == :min
+        return range.end if value.nil? || value.is_a?(Symbol)
+        (
+          if value.is_a?(Numeric)
+            (value > 0 && value < 1 ? (range.end * value) : value).round
+          else
+            value.to_i
+          end
+        ).clamp(range)
+      end
     end
 
     POS_ALI = %i[right centered].freeze
@@ -79,11 +92,25 @@ module NattyUI
       @width
     end
 
-    def initialize(str, width = nil)
-      @to_s = Ansi.bbcode(str).freeze
-      return unless width
-      @width = @width.is_a?(Integer) ? width : Text.width(self)
-      freeze
+    def +(other)
+      other = Str.new(other) unless other.is_a?(Str)
+      Str.new(@to_s + other.to_s, width + other.width)
+    end
+
+    if Terminal.ansi?
+      def initialize(str, width = nil)
+        @to_s = Ansi.bbcode(str).freeze
+        return unless width
+        @width = @width.is_a?(Integer) ? width : Text.width(self)
+        freeze
+      end
+    else
+      def initialize(str, width = nil)
+        @to_s = Ansi.plain(str).freeze
+        return unless width
+        @width = @width.is_a?(Integer) ? width : Text.width(self)
+        freeze
+      end
     end
   end
 

data/lib/natty-ui/vbars_renderer.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module NattyUI
+  module VBarsRenderer
+    class << self
+      def lines(vals, width, height, normalize, bar_width, style)
+        if style
+          bos = Ansi[*style]
+          eos = Ansi::RESET
+        end
+        if ((bar_width != :auto) && bar_width <= 1) || (vals.size * 2 > width)
+          db = '▉'
+          ds = ' '
+          el = "#{bos}#{'▔' * vals.size}#{eos}"
+          vals = vals.take(width) if vals.size > width
+        else
+          bw = (width - vals.size) / vals.size
+          bw = [bw, bar_width].min if bar_width != :auto
+          db = "#{'█' * bw} "
+          bw += 1
+          ds = ' ' * bw
+          el = "#{bos}#{'▔' * ((bw * vals.size) - 1)}#{eos}"
+        end
+        height -= 1
+        vals = normalize ? normalize!(vals, height) : adjust!(vals, height)
+        height
+          .downto(1)
+          .map { |i| "#{bos}#{vals.map { _1 < i ? ds : db }.join}#{eos}" } << el
+      end
+
+      private
+
+      def adjust!(vals, height)
+        max = vals.max.to_f
+        vals.map { ((_1 / max) * height).round }
+      end
+
+      def normalize!(vals, height)
+        min, max = vals.minmax
+        return Array.new(vals.size, height) if min == max
+        max = (max - min).to_f
+        vals.map { (((_1 - min) / max) * height).round }
+      end
+    end
+  end
+
+  private_constant :VBarsRenderer
+end

data/lib/natty-ui/version.rb

@@ -2,5 +2,5 @@
 
 module NattyUI
   # The version number of the gem.
-  VERSION = '0.27.0'
+  VERSION = '0.28.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: natty-ui
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: '0.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: '0.12'
 description: |
   This is the beautiful, nice, nifty, fancy, neat, pretty, cool, rich, lovely,
   natty user interface tool you like to have for your command line applications.
@@ -44,6 +44,7 @@ files:
 - examples/cols.rb
 - examples/elements.rb
 - examples/examples.rb
+- examples/hbars.rb
 - examples/illustration.rb
 - examples/info.rb
 - examples/key-codes.rb
@@ -52,6 +53,7 @@ files:
 - examples/sections.rb
 - examples/tables.rb
 - examples/tasks.rb
+- examples/vbars.rb
 - lib/natty-ui.rb
 - lib/natty-ui/attributes.rb
 - lib/natty-ui/choice.rb
@@ -59,6 +61,7 @@ files:
 - lib/natty-ui/element.rb
 - lib/natty-ui/features.rb
 - lib/natty-ui/framed.rb
+- lib/natty-ui/hbars_renderer.rb
 - lib/natty-ui/ls_renderer.rb
 - lib/natty-ui/progress.rb
 - lib/natty-ui/section.rb
@@ -68,6 +71,7 @@ files:
 - lib/natty-ui/temporary.rb
 - lib/natty-ui/theme.rb
 - lib/natty-ui/utils.rb
+- lib/natty-ui/vbars_renderer.rb
 - lib/natty-ui/version.rb
 - lib/natty-ui/width_finder.rb
 - lib/natty_ui.rb
@@ -76,9 +80,10 @@ licenses:
 - BSD-3-Clause
 metadata:
   rubygems_mfa_required: 'true'
+  yard.run: yard
   source_code_uri: https://github.com/mblumtritt/natty-ui
   bug_tracker_uri: https://github.com/mblumtritt/natty-ui/issues
-  documentation_uri: https://rubydoc.info/gems/natty-ui/0.27.0/NattyUI
+  documentation_uri: https://rubydoc.info/gems/natty-ui/NattyUI
 rdoc_options: []
 require_paths:
 - lib