natty-ui 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c2fdc1d9e9799f56f2781822273de9239840e94ceadac332710fe70fc1082bd
-  data.tar.gz: e33e6c658e86259f364f320f1e060d7d2f8a7444e07119d125cd0a335cb23313
+  metadata.gz: 0aa357f7937c367ecc77396e7241f33a774973d773b99c6923cc975199755a14
+  data.tar.gz: '060778aaca552a23c57e39e4efd8adf3eff07658e6a712708b6c8e46c5077bc1'
 SHA512:
-  metadata.gz: b8fc4cfe81f56efafb0b605d9694e7b592bbd4daa4edab2b6b0d1e7a81ba87704f4fb4d0f8acc9572907cd4f3d815762d41002b64082bb04c9a085f5709e4be5
-  data.tar.gz: 4cab9391a300aaf0c7f74f6861c7805f008df6c824de3813eeaaebda0cbc42ff661b14da4a71e2c0860687e971dd98f680d33573fdb9da8f4b38bf4d2ef21bf2
+  metadata.gz: c79a14e0f8b02181a19268958c8784e306f66853e0e09f40ae630043a3f89b699aaaaee72622d06fff43df0eab9814908b5d692f748df0c7ff5f67d4cac1b460
+  data.tar.gz: 7b27b83b5592b3ec556e640d7d583983ec42615ac036c40a0f5b2a305616e3df846f292aae191952e312aeaf6d9e4be99ab84ed123c1853acbf055c515b9335f

data/examples/8bit-colors.rb

@@ -7,7 +7,7 @@ ui.h1 'NattyUI: 8-bit Color Support'
 ui.space
 
 color = ->(i) { "[bg#{i = i.to_s(16).rjust(2, '0')}] #{i} " }
-ui.msg 'System Colors', glyph: :point do
+ui.msg 'System Colors' do
   ui.puts <<~COLORS
     [#ff]#{0.upto(7).map(&color).join}
     [#00]#{8.upto(15).map(&color).join}
@@ -15,7 +15,7 @@ ui.msg 'System Colors', glyph: :point do
   COLORS
 end
 
-ui.msg '6x6x6 Color Cube', glyph: :point do
+ui.msg '6x6x6 Color Cube' do
   [16, 22, 28].each do |b|
     b.step(b + 185, by: 36) do |i|
       left = i.upto(i + 5).map(&color).join
@@ -26,7 +26,7 @@ ui.msg '6x6x6 Color Cube', glyph: :point do
   end
 end
 
-ui.msg 'Grayscale', glyph: :point do
+ui.msg 'Grayscale' do
   ui.puts <<~GRAYSCALE
     [#ff]#{232.upto(243).map(&color).join}
     [#ff]#{244.upto(255).map(&color).join}

data/examples/animate.rb

@@ -13,32 +13,32 @@ TEXT = <<~TEXT.tr("\n", ' ')
   aliquip ex ea commodo [bold]consequat[/].
 TEXT
 
-ui.message 'Default Animation', glyph: :point do
+ui.message 'Default Animation' do
   ui.animate TEXT, animation: :default
 end
 ui.space
 
-ui.message 'Shiny Rainbow', glyph: :point do
+ui.message 'Shiny Rainbow' do
   ui.animate TEXT, animation: :rainbow
 end
 ui.space
 
-ui.message 'Binary Encoded', glyph: :point do
+ui.message 'Binary Encoded' do
   ui.animate TEXT, animation: :binary, style: 'green', alt_style: :bright_green
 end
 ui.space
 
-ui.message 'Matrix Style', glyph: :point do
+ui.message 'Matrix Style' do
   ui.animate TEXT, animation: :matrix
 end
 ui.space
 
-ui.message 'Typewriter Like', glyph: :point do
+ui.message 'Typewriter Like' do
   ui.animate TEXT, animation: :type_writer
 end
 ui.space
 
-ui.message 'Default Styled', glyph: :point do
+ui.message 'Default Styled' do
   ui.animate TEXT, style: 'bold bright_white on_red'
 end
 ui.space

data/examples/progress.rb

@@ -7,8 +7,13 @@ ui.h1 'NattyUI: Progress Indication'
 ui.space
 
 # just simulate some work
-def something = sleep(0.5)
-def some = sleep(0.15)
+if ENV.key?('NO_WAIT')
+  def something = nil
+  def some = nil
+else
+  def something = sleep(0.5)
+  def some = sleep(0.15)
+end
 
 ui.info 'Tasks are sections to visualize step by step processing.' do
   ui.task 'Assemble assets' do
@@ -25,7 +30,7 @@ ui.info 'Tasks are sections to visualize step by step processing.' do
 
     ui.task 'Compile files...' do
       %w[readme.txt main.css main.html sub.html].each do |name|
-        ui.msg "Compile file [bright_yellow]./source/#{name}[/]..."
+        ui.msg "Compile file [bright_yellow]./source/#{name}[/]...", glyph: :dot
         something
       end
       ui.done 'Files compiled.'

data/lib/natty-ui/animation/binary.rb

@@ -12,9 +12,8 @@ module NattyUI
         35.times do |i|
           binary.each do |chars|
             rc = rand_char
-            rc = @style + rc if rc.size == 1
             chars.pop
-            chars.unshift(rc)
+            chars.unshift(rc.size == 1 ? @style + rc : rc)
             puts(stream, chars.join)
           end
           (stream << @top).flush

data/lib/natty-ui/animation/default.rb

@@ -11,23 +11,19 @@ module NattyUI
         @lines.each do |line, size|
           time = 0.25 / size
           stream << style
+          line = Text.plain(line)
           if (num += 1).odd?
             stream << @pos1
-            Text
-              .plain(line)
-              .each_char do |char|
-                (stream << char).flush
-                sleep(time)
-              end
+            line.each_char do |char|
+              (stream << char).flush
+              sleep(time)
+            end
           else
             stream << Ansi.cursor_column(@prefix_width + size - 1)
-            Text
-              .plain(line)
-              .reverse
-              .each_char do |char|
-                (stream << char << CURSOR_LEFT).flush
-                sleep(time)
-              end
+            line.reverse.each_char do |char|
+              (stream << char << CURSOR_LEFT).flush
+              sleep(time)
+            end
           end
           stream << Ansi::RESET << @pos1 << line << Ansi::LINE_NEXT
         end

data/lib/natty-ui/animation/matrix.rb

@@ -22,10 +22,6 @@ module NattyUI
               pos.pop(count).each { enc[_1] = line[_1] }
               pos.sample(pos.size / 3).each { enc[_1] = CHARS.sample }
             end
-
-            # next stream << Ansi::LINE_NEXT if pos.size < 4
-            # pos.shift(pos.size / 8).each { enc[_1] = line[_1] }
-            # pos.sample(pos.size / 2).each { enc[_1] = CHARS.sample }
             puts(stream, enc)
           end
           (stream << @top).flush

data/lib/natty-ui/animation/type_writer.rb

@@ -10,15 +10,15 @@ module NattyUI
         @style = attribute(:style, :default)
         @cursor_style = attribute(:cursor_style, 0x2e)
         @lines.each do |line, size|
+          line = Text.plain(line)
           if (num += 1).odd?
             stream << @pos1
-            Text.plain(line).each_char { cursor(stream, _1).flush }
+            line.each_char { cursor(stream, _1).flush }
           else
             stream << Ansi.cursor_column(@prefix_width + size - 1)
-            Text
-              .plain(line)
-              .reverse
-              .each_char { (cursor(stream, _1) << CURSOR_2LEFT).flush }
+            line.reverse.each_char do |char|
+              (cursor(stream, char) << CURSOR_2LEFT).flush
+            end
           end
           stream << Ansi::RESET << @pos1 << line << Ansi::LINE_NEXT
         end

data/lib/natty-ui/animation.rb

@@ -2,19 +2,19 @@
 
 module NattyUI
   module Animation
-    def self.defined = @defined.keys
-    def self.defined?(name) = @defined.key?(name)
-    def self.define(**kwargs) = @defined.merge!(kwargs)
+    def self.names = @all.keys
 
     def self.[](name)
       return if name.nil?
-      klass = @defined[name] || @defined[:default]
+      klass = @all[name] || @all[:default]
       return klass unless klass.is_a?(String)
       require(klass)
-      klass = @defined[name] and return klass
+      klass = @all[name] and return klass
       raise(LoadError, "unknown animation - #{name}")
     end
 
+    def self.define(**kwargs) = @all.merge!(kwargs)
+
     class Base
       attr_reader :lines_written
 
@@ -58,7 +58,7 @@ module NattyUI
     private_constant :Base
 
     dir = __dir__
-    @defined = {
+    @all = {
       binary: "#{dir}/animation/binary",
       default: "#{dir}/animation/default",
       matrix: "#{dir}/animation/matrix",

data/lib/natty-ui/ansi/constants.rb

@@ -59,17 +59,17 @@ module NattyUI::Ansi
   REVEAL = self[:reveal].freeze
 
   # @!visibility private
-  CLS = (CURSOR_HOME + SCREEN_ERASE).freeze
+  CLS = "#{CURSOR_HOME}#{SCREEN_ERASE}".freeze
 
   # @!visibility private
-  CLL = (CURSOR_FIRST_COLUMN + LINE_ERASE).freeze
+  CLL = "#{CURSOR_FIRST_COLUMN}#{LINE_ERASE}".freeze
 
   # @!visibility private
   SCREEN_BLANK =
-    (
-      CURSOR_SAFE_POS + SCREEN_ALTERNATE + CURSOR_HOME + SCREEN_ERASE + RESET
-    ).freeze
+    "#{CURSOR_SAFE_POS}#{
+      SCREEN_ALTERNATE
+    }#{CURSOR_HOME}#{SCREEN_ERASE}#{RESET}".freeze
 
   # @!visibility private
-  SCREEN_UNBLANK = (RESET + SCREEN_ALTERNATE_OFF + CURSOR_RESTORE_POS).freeze
+  SCREEN_UNBLANK = "#{RESET}#{SCREEN_ALTERNATE_OFF}#{CURSOR_RESTORE_POS}".freeze
 end

data/lib/natty-ui/ansi_wrapper.rb

@@ -85,11 +85,7 @@ module NattyUI
         (wrapper.stream << @msg << Ansi::CURSOR_HIDE).flush
         @msg = "#{Ansi::CLL}#{@msg}"
         return @msg << BAR_COLOR if @max_value
-        spinner_color = Ansi[:bold, 220]
-        @spinner =
-          Enumerator.new do |y|
-            spinner.each_char { y << "#{spinner_color}#{_1}" } while true
-          end
+        @spinner = NattyUI::Spinner[spinner]
       end
 
       def redraw
@@ -162,7 +158,7 @@ module NattyUI
 
       def initialize(parent, title:, glyph:, **opts)
         color = COLORS[glyph] || COLORS[:default]
-        glyph = NattyUI.glyph(glyph) || glyph
+        glyph = NattyUI::Glyph[glyph]
         prefix_width = Text.width(glyph) + 1
         parent.puts(
           title,

data/lib/natty-ui/frame.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module NattyUI
+  # Helper class to select frame types.
+  # @see Features#framed
+  # @see Features#table
+  module Frame
+    # Define frame type used by default.
+    #
+    # @attribute [w] self.default
+    # @param value [Symbol] type name
+    # @return [Symbol] type name
+    def self.default=(value)
+      @default = self[value.nil? || value == :default ? :rounded : value]
+    end
+
+    # Defined frame type names.
+    # @see []
+    #
+    # @attribute [r] self.names
+    # @return [Array<Symbol>] supported attribute names
+    def self.names = @all.keys
+
+    # @param name [Symbol, String]
+    #   defined type name (see {.names})
+    #   or frame elements
+    # @return [String] frame definition
+    def self.[](name)
+      return @default if name == :default
+      if name.is_a?(Symbol)
+        ret = @all[name] and return ret
+      elsif name.is_a?(String)
+        return name if name.size == 11
+        return name * 11 if name.size == 1
+      end
+      raise(ArgumentError, "invalid frame type - #{name}")
+    end
+
+    @all = {
+      cols: '    │ │    ',
+      double: '╔╗╚╝║═╬╦╩╠╣',
+      heavy: '┏┓┗┛┃━╋┳┻┣┫',
+      rounded: '╭╮╰╯│─┼┬┴├┤',
+      rows: '     ──    ',
+      semi: '╒╕╘╛│═╪╤╧╞╡',
+      semi2: '╓╖╙╜│─╫╥╨╟╢',
+      simple: '┌┐└┘│─┼┬┴├┤',
+      undecorated: '           '
+    }.compare_by_identity
+
+    self.default = nil
+  end
+end

data/lib/natty-ui/glyph.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'text'
+
+module NattyUI
+  # Helper class to select glyph types.
+  # @see Features#message
+  module Glyph
+    # Define glyph type used by default.
+    # @attribute [w] self.default
+    # @param value [Symbol] type name
+    # @return [Symbol] type name
+    def self.default=(value)
+      @default = self[value.nil? || value == :default ? :point : value]
+    end
+
+    # Defined glyph type names.
+    # @see []
+    #
+    # @attribute [r] self.names
+    # @return [Array<Symbol>] supported attribute names
+    def self.names = @all.keys
+
+    # @param name [Symbol, #to_s]
+    #   defined type name (see {.names})
+    #   or glyph
+    # @return [String] glyph definition
+    def self.[](name)
+      return @default if name == :default
+      Text.embellish(
+        if name.is_a?(Symbol)
+          @all[name] or raise(ArgumentError, "invalid glyph type - #{name}")
+        else
+          name.to_s
+        end
+      )
+    end
+
+    @all = {
+      completed: '[b 52]✓',
+      dot: '[27]•',
+      error: '[b d0]𝙓',
+      failed: '[b c4]𝑭',
+      information: '[b 77]𝒊',
+      point: '[27]◉',
+      query: '[b 27]▸',
+      task: '[b 27]➔',
+      warning: '[b dd]!'
+    }.compare_by_identity
+
+    # GLYPH = {
+    #   default: '●',
+    #   information: '🅸 ',
+    #   warning: '🆆 ',
+    #   error: '🅴 ',
+    #   completed: '✓',
+    #   failed: '🅵 ',
+    #   task: '➔',
+    #   query: '🆀 '
+    # }.compare_by_identity.freeze
+
+    self.default = nil
+  end
+end

data/lib/natty-ui/preload.rb

@@ -3,7 +3,10 @@
 require_relative '../natty-ui'
 
 module NattyUI
-  Animation.defined?(:matrix)
-  Text::EastAsianWidth[0]
+  Animation[nil]
+  Frame[:default]
+  Glyph[:default]
   KEY_MAP[0]
+  Spinner[:default]
+  Text.width("\u1100")
 end

data/lib/natty-ui/spinner.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require_relative 'ansi'
+
+module NattyUI
+  # Helper class to select spinner types.
+  # @see Features#progress
+  module Spinner
+    class << self
+      # Define spinner type used by default.
+      # @attribute [w] self.default
+      # @param value [Symbol] type name
+      # @return [Symbol] type name
+      def default=(value)
+        @default = self[value.nil? || value == :default ? :pulse : value]
+      end
+
+      # Defined spinner type names.
+      # @see []
+      #
+      # @attribute [r] self.names
+      # @return [Array<Symbol>] supported attribute names
+      def names = @all.keys
+
+      # @param name [Symbol, #to_a, #to_s]
+      #   defined type name (see {.names})
+      #   or spinner elements
+      # @return [Enumerator] spinner definition
+      def [](name)
+        return @default if name == :default
+        parts =
+          if name.is_a?(Symbol)
+            @all[name] or raise(ArgumentError, "invalid spinner type - #{name}")
+          else
+            name
+          end
+        parts =
+          (parts.respond_to?(:map) ? parts : parts.to_s.chars).map do |part|
+            "#{@style}#{part}"
+          end
+        raise(ArgumentError, "invalid spinner type - #{name}") if parts.empty?
+        parts = parts.zip(parts).flatten(1) while parts.size < 6
+        Enumerator.new { |y| parts.each { y << _1 } while true }
+      end
+
+      private
+
+      def slide(a, b, size, prefix = nil, suffix = prefix)
+        Enumerator.new do |y|
+          fn =
+            lambda do |i|
+              y << "#{prefix}#{a * (i += 1)}#{b * (size - i)}#{suffix}"
+            end
+          size.times(&fn)
+          a, b = b, a
+          size.times(&fn)
+        end
+      end
+
+      def bounce(a, b, size, prefix = nil, suffix = prefix)
+        Enumerator.new do |y|
+          fn =
+            lambda do |i|
+              y << "#{prefix}#{a * (i += 1)}#{b * (size - i)}#{suffix}"
+            end
+          size.times(&fn)
+          a, b = b, a
+          (size - 1).times(&fn)
+          fn = ->(i) { y << "#{prefix}#{a * i}#{b * (size - i)}#{suffix}" }
+          (size - 2).downto(0, &fn)
+          a, b = b, a
+          (size - 1).downto(0, &fn)
+        end
+      end
+
+      def move(a, b, size, prefix = nil, suffix = prefix)
+        Enumerator.new do |y|
+          size.times do |i|
+            y << "#{prefix}#{b * i}#{a}#{b * (size - i - 1)}#{suffix}"
+          end
+          y << "#{prefix}#{b * size}#{suffix}"
+        end
+      end
+    end
+
+    @style = Ansi[:bold, 220]
+    @all = {
+      bar: '▁▂▃▄▅▆▇█▇▆▅▄▃▂',
+      blink: '■□▪▫',
+      blocks: '▖▘▝▗',
+      bounce: bounce('◼︎', '◻︎', 7),
+      bounce2: bounce('▰', '▱', 7),
+      bounce3: bounce('● ', '◌ ', 7),
+      bounce4: bounce('=', ' ', 5, '[', ']'),
+      circle: '◐◓◑◒',
+      colors: '🟨🟨🟧🟧🟥🟥🟦🟦🟪🟪🟩🟩',
+      dots: '⣷⣯⣟⡿⢿⣻⣽⣾',
+      dots2: '⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏',
+      dots3: '⠋⠙⠚⠞⠖⠦⠴⠲⠳⠓',
+      dots4: '⠄⠆⠇⠋⠙⠸⠰⠠⠰⠸⠙⠋⠇⠆',
+      dots5: '⠋⠙⠚⠒⠂⠂⠒⠲⠴⠦⠖⠒⠐⠐⠒⠓⠋',
+      move: move('◼︎', '◻︎', 7),
+      move2: move('▰', '▱', 7),
+      move3: move('● ', '◌ ', 7),
+      move4: move('=', ' ', 5, '[', ']'),
+      pulse: '•✺◉●◉✺',
+      slide: slide('◼︎', '◻︎', 7),
+      slide2: slide('▰', '▱', 7),
+      slide3: slide('● ', '◌ ', 7),
+      slide4: slide('=', ' ', 5, '[', ']'),
+      slide5: slide('.', ' ', 3),
+      snake: '⠁⠉⠙⠸⢰⣠⣄⡆⠇⠃',
+      stod: '⡿⣟⣯⣷⣾⣽⣻⢿',
+      swap: '㊂㊀㊁',
+      vintage: '-\\|/'
+    }.compare_by_identity
+
+    self.default = nil
+  end
+end