natty-ui 0.8.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2010faafec270df6749dff93943748316c626939965e501dbe6bdb224514e2dc
-  data.tar.gz: 0eecd3c29cc7b90cd70a6d40245b18fdbc8556232b6a3795ba2d92ffbaea5123
+  metadata.gz: 88f26cebef7a281c4b11df8e8accf096706d4308aa22d716bb516f9c85b51be6
+  data.tar.gz: 62fc6e920615b9f4536da8a9db33cc9e4261352d36a3423cdd11c64ab7b2e93c
 SHA512:
-  metadata.gz: 6d2939a6c9bd6256a9de3e14b80ab9a67a6fa1108f20f2073e6ef0762789531016ef641bbfd451a0f3ac6c87079bd771a71853043744e481ed867616e392466e
-  data.tar.gz: 106fc8ddca80ccf6eb8933fdf835d7373afba963df8625267f37b1a9795ac6be22671123e18baa72ec6b5ded1c3f76f98d5f4dd905de935d465a2751ce690fad
+  metadata.gz: 231f29c1bca8face152dbb63ed1c6137866a97941e092ed3db3f30ee2c372d71bbb10b1885100fd28691fb6093d2d4deab14fcf8d95fe05106cfc0c2d44d3b66
+  data.tar.gz: e39a9f14e9adfb4bfc1360cc9ee3dda19f96b3cce23afbf97da2315b184bf5b0b62f62c0f4e6fb283f22029d2902bc14623beec8cb42c45d528ea5168a5bb274

data/.yardopts

@@ -1,10 +1,11 @@
---readme README.md
 --title 'NattyUI Documentation'
 --charset utf-8
 --markup markdown
+--readme README.md
+--no-private
+--embed-mixins
 --tag comment
 --hide-tag comment
---embed-mixins
 --exclude lib/natty-ui/ansi_wrapper.rb
 lib/**/*.rb
 -

data/examples/24bit-colors.rb

@@ -1,8 +1,12 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
-RGB_COLORS = <<~RGB_COLORS.lines(chomp: true).map!(&:split)
+ui.space
+ui.h1 'NattyUI: 24-bit Color Support'
+ui.space
+
+RGB_COLORS = <<~SAMPLES.lines(chomp: true).map!(&:split)
   #800000 #8b0000 #a52a2a #b22222 #dc143c #ff0000 #ff6347 #ff7f50
   #cd5c5c #f08080 #e9967a #fa8072 #ffa07a #ff4500 #ff8c00 #ffa500
   #ffd700 #b8860b #daa520 #eee8aa #bdb76b #f0e68c #808000 #ffff00
@@ -11,13 +15,13 @@ RGB_COLORS = <<~RGB_COLORS.lines(chomp: true).map!(&:split)
   #2e8b57 #66cdaa #3cb371 #20b2aa #2f4f4f #008080 #008b8b #00ffff
   #00ffff #e0ffff #00ced1 #40e0d0 #48d1cc #afeeee #7fffd4 #b0e0e6
   #5f9ea0 #4682b4 #6495ed #00bfff #1e90ff #add8e6 #87ceeb #87cefa
-RGB_COLORS
-
-ui.space
-ui.h1 '24-bit Color Support'
-ui.space
+SAMPLES
 
 RGB_COLORS.each { ui.puts _1.map { |v| " [[#{v}]]#{v}[[/]] " }.join }
 ui.space
 RGB_COLORS.each { ui.puts _1.map { |v| " [[on:#{v}]]#{v}[[/]] " }.join }
 ui.space
+RGB_COLORS.each do |code|
+  ui.puts code.map { |v| " [[underline ul:#{v}]]#{v}[[/]] " }.join
+end
+ui.space

data/examples/3bit-colors.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
 ui.space
-ui.h1 '3/4-bit Color Support'
+ui.h1 'NattyUI: 3/4-bit Color Support'
 ui.space
 
 color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]] sample text [[/]]" }
 %w[black red green yellow blue magenta cyan white].each do |name|
   ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
 end
+
 ui.space

data/examples/8bit-colors.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
 ui.space
-ui.h1 '8-bit Color Support'
+ui.h1 'NattyUI: 8-bit Color Support'
 ui.space
 
 color = ->(i) { "[[bg#{i = i.to_s(16).rjust(2, '0')}]] #{i} " }

data/examples/animate.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative '../lib/natty-ui'
+
+ui.space
+ui.h1 'NattyUI: Text Line Animation'
+ui.space
+
+TEXT = <<~TEXT.tr("\n", ' ')
+  Lorem [[yellow]]ipsum[[/]] dolor sit amet, consectetur adipisicing elit, sed
+  do eiusmod tempor incididunt ut labore et dolore [[red]]magna[[/]] aliqua.
+  Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+  aliquip ex ea commodo [[bold]]consequat[[/]].
+TEXT
+
+{
+  default: 'Default Animation',
+  type_writer: 'Typewriter Like',
+  rainbow: 'Shiny Rainbow',
+  matrix: 'Matrix Style'
+}.each_pair do |type, title|
+  ui.message(title, glyph: '[[27]]◉') { ui.animate TEXT, animation: type }
+  ui.space
+end

data/examples/attributes.rb

@@ -1,72 +1,27 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
 ui.space
-ui.h1 'NattyUI ANSI Attributes Demo'
-ui.puts <<~TEXT
-
-  This text contains all supported ANSI attrubtes and explains the available
-  colors.
-
-  Please, keep in mind that no all terminals will support of all attributes and
-  color types used in this text. In fact, you can use the output of this text to
-  check the supported ANSI attributes.
-
-TEXT
-
-ui.h2 'Attributes'
-ui.puts <<~TEXT
-
-  Some attributes are widely supported, such as [[bold]]bold[[/]], [[italic]]italic[[/]], [[underline]]underline[[/]], [[blink]]blink[[/]],
-  [[invert]]invert[[/]] and [[strike]]strike[[/]], while others are rarely complete or correctly implemented,
-  like [[faint]]faint[[/]], [[rapid_blink]]rapid_blink[[/]], [[double_underline]]double_underline[[/]], [[framed]]framed[[/]], [[encircled]]encircled[[/]], [[overlined]]overlined[[/]],
-  [[proportional]]proportional[[/]] and [[spacing]]spacing[[/]].
-
-  Different font types are very rarely displayed:
-
-    [[primary_font]]primary_font[[/]]
-    [[fraktur]]fraktur[[/]]
-    [[font1]]font1[[/]]    [[font2]]font2[[/]]    [[font3]]font3[[/]]
-    [[font4]]font4[[/]]    [[font5]]font5[[/]]    [[font6]]font6[[/]]
-    [[font7]]font7[[/]]    [[font8]]font8[[/]]    [[font9]]font9[[/]]
-
-TEXT
-
-ui.h2 '3-bit and 4-bit Colors'
-ui.space
-color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]]sample text[[/]]" }
-%w[black red green yellow blue magenta cyan white].each do |name|
-  ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
-end
+ui.h2 'NattyUI: ANSI Attributes'
 ui.space
 
-ui.h2 '8-bit Colors'
-ui.space
-ui.puts 'There are 256 pre-defined color which can be used by their index:'
-ui.space
+ui.puts <<~PARA1.tr("\n", ' '), <<~PARA2.tr("\n", ' ')
+  Some attributes are widely supported, such as [[bold]]bold[[/]],
+  [[italic]]italic[[/]], [[underline]]underline[[/]], [[blink]]blink[[/]],
+  [[invert]]invert[[/]] and [[strike]]strike[[/]], while others are rarely
+  complete or correctly implemented,  like [[faint]]faint[[/]],
+  [[double_underline]]double underline[[/]], [[curly_underline]]curly
+  underline[[/]], [[dotted_underline]]dotted underline[[/]],
+  [[dashed_underline]]dashed underline[[/]], [[rapid_blink]]rapid_blink[[/]],
+  [[framed]]framed[[/]], [[encircled]]encircled[[/]],
+  [[overlined]]overlined[[/]] and [[proportional]]proportional[[/]].
+PARA1
+  Alternative fonts are mostly completely ignored:
+  [[primary_font]]primary_font[[/]], [[fraktur]]fraktur[[/]],
+  [[font1]]font1[[/]], [[font2]]font2[[/]], [[font3]]font3[[/]],
+  [[font4]]font4[[/]], [[font5]]font5[[/]], [[font6]]font6[[/]],
+  [[font7]]font7[[/]], [[font8]]font8[[/]], [[font9]]font9[[/]].
+PARA2
 
-color = ->(i) { "[[bg#{i.to_s(16).rjust(2, '0')}]] #{i.to_s.rjust(2)} " }
-ui.msg 'System Colors', glyph: '[[27]]◉' do
-  ui.puts "[[#ff]]#{0.upto(7).map(&color).join}"
-  ui.puts "[[#00]]#{8.upto(15).map(&color).join}"
-  ui.space
-end
-
-color = ->(i) { "[[bg#{i.to_s(16)}]] #{i.to_s.rjust(3)} " }
-ui.msg '6x6x6 Color Cube', glyph: '[[27]]◉' do
-  [16, 22, 28].each do |b|
-    b.step(b + 185, by: 36) do |i|
-      left = i.upto(i + 5).map(&color).join
-      right = (i + 18).upto(i + 23).map(&color).join
-      ui.puts "[[#ff]]#{left}[[bg_default]]  #{right}"
-    end
-    ui.space
-  end
-
-  ui.msg 'Grayscale', glyph: '[[27]]◉' do
-    ui.puts "[[#ff]]#{232.upto(243).map(&color).join}"
-    ui.puts "[[#ff]]#{244.upto(255).map(&color).join}"
-    ui.space
-  end
-end
+ui.space

data/examples/demo.rb

@@ -1,217 +1,53 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
-def attributes
-  ui.puts <<~TEXT
-
-    Some attributes are widely supported, such as [[bold]]bold[[/]], [[italic]]italic[[/]], [[underline]]underline[[/]], [[blink]]blink[[/]],
-    [[invert]]invert[[/]] and [[strike]]strike[[/]], while others are rarely complete or correctly implemented,
-    like [[faint]]faint[[/]], [[rapid_blink]]rapid_blink[[/]], [[double_underline]]double_underline[[/]], [[framed]]framed[[/]], [[encircled]]encircled[[/]], [[overlined]]overlined[[/]],
-    [[proportional]]proportional[[/]] and [[spacing]]spacing[[/]].
-
-    Different font types are very rarely displayed:
-
-      [[primary_font]]primary_font[[/]]
-      [[fraktur]]fraktur[[/]]
-      [[font1]]font1[[/]]    [[font2]]font2[[/]]    [[font3]]font3[[/]]
-      [[font4]]font4[[/]]    [[font5]]font5[[/]]    [[font6]]font6[[/]]
-      [[font7]]font7[[/]]    [[font8]]font8[[/]]    [[font9]]font9[[/]]
-
-  TEXT
-end
-
-def colors_3bit
-  color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]]sample text[[/]]" }
-  %w[black red green yellow blue magenta cyan white].each do |name|
-    ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
-  end
-end
-
-def colors_8bit
-  color = ->(i) { "[[bg#{i.to_s(16).rjust(2, '0')}]] #{i.to_s.rjust(2)} " }
-  ui.msg 'System Colors', glyph: '[[27]]◉' do
-    ui.puts "[[#ff]]#{0.upto(7).map(&color).join}"
-    ui.puts "[[#00]]#{8.upto(15).map(&color).join}"
-    ui.space
-  end
-
-  color = ->(i) { "[[bg#{i.to_s(16)}]] #{i.to_s.rjust(3)} " }
-  ui.msg '6x6x6 Color Cube', glyph: '[[27]]◉' do
-    [16, 22, 28].each do |b|
-      b.step(b + 185, by: 36) do |i|
-        left = i.upto(i + 5).map(&color).join
-        right = (i + 18).upto(i + 23).map(&color).join
-        ui.puts "[[#ff]]#{left}[[bg_default]]  #{right}"
-      end
-      ui.space
-    end
-  end
-
-  ui.msg 'Grayscale', glyph: '[[27]]◉' do
-    ui.puts "[[#ff]]#{232.upto(243).map(&color).join}"
-    ui.puts "[[#ff]]#{244.upto(255).map(&color).join}"
-    ui.space
-  end
-end
-
-def colors_24bit
-  ui.puts <<~TEXT
-    Modern terminal applications support 24-bit colors for foreground and background
-    RGB-color values. Here are just some samples:
-
-  TEXT
-  RGB_COLORS.each { ui.puts _1.map { |v| " [[#{v}]]#{v}[[/]] " }.join }
+ui.page do
+  ui.space
+  ui.h1 'NattyUI: Examples'
   ui.space
-  RGB_COLORS.each { ui.puts _1.map { |v| " [[on:#{v}]]#{v}[[/]] " }.join }
-end
 
-def sections
-  ui.section do
-    ui.puts 'Sections can be stacked'
-    ui.section do
-      ui.puts TEXT_MID
-      ui.framed do
-        ui.puts TEXT_MID
-        next unless block_given?
-        ui.space
-        ui.hr
-        ui.space
-        yield
-      end
+  ruby =
+    ENV.fetch('RUBY') do
+      require('rbconfig')
+      File.join(
+        RbConfig::CONFIG['bindir'],
+        "#{RbConfig::CONFIG['ruby_install_name']}#{RbConfig::CONFIG['EXEEXT']}"
+      ).sub(/.*\s.*/m, '"\&"')
     end
-  end
-end
-
-def heading
-  ui.h1 'This Is A H1 Heading'
-  ui.h2 'This Is A H2 Heading'
-  ui.h3 'This Is A H3 Heading'
-  ui.h4 'This Is A H4 Heading'
-  ui.h5 'This Is A H5 Heading'
-end
+  run = ->(name) { system(ruby, File.join(__dir__, "#{name}.rb")) }
+  run['illustration']
 
-def messages
-  ui.info 'Informative Message', TEXT_MID
-  ui.warning 'Warning Message', TEXT_MID
-  ui.error 'Error Message', TEXT_MID
-  ui.message '[[italic #fad]]Custom Message', TEXT_MID, glyph: '💡'
-  ui.failed 'Fail Message', TEXT_MID
-end
-
-def list_in_columns
-  ui.ls TEXT_LINES
-  ui.hr
-  ui.ls TEXT_LINES, compact: false
-end
+  ui.space
 
-def tasks
-  ui.task('Initialize') { something }
-  ui.task('Establish server connection') do
-    ui.task('Open connection') { something }
-    ui.task('Send HELO') { something }
-    ui.task('Receive OLEH') { something }
-    ui.task('Send credentials') { something }
-    ui.task('Credentials accepted') { something }
+  choices = {}
+  examples = {}
+  {
+    '1' => ['attributes', 'ANSI Attributes'],
+    '2' => ['message', 'Message Types'],
+    '3' => ['3bit-colors', '3/4-bit Color Support'],
+    '4' => ['8bit-colors', '8-bit Color Support'],
+    '5' => ['24bit-colors', '24-bit Color Support'],
+    '6' => ['ls', 'Print In Columns'],
+    '7' => %w[table Tables],
+    '8' => ['animate', 'Text Line Animation'],
+    '9' => ['progress', 'Progress Indication'],
+    '0' => ['query', 'User Queries'],
+    'ESC' => [nil, 'Exit Demo']
+  }.each_pair do |key, (name, descr)|
+    examples[key] = name
+    choices[key] = descr
   end
-  ui.task 'Loading files' do
-    %w[readme.txt main.css main.html sub.html].each do |name|
-      ui.msg "Load file [[bright_yellow]]./source/#{name}[[/]]..."
-      something
-    end
-    ui.done 'Files loaded'
-  end
-  progress = ui.progress('Compress files', max_value: 11)
-  11.times do
-    progress.step
-    something
-  end
-  progress.done 'All compressed'
-end
-
-def table
-  ui.table { |tab| TEXT.each_line(chomp: true).each_slice(5) { tab.add(*_1) } }
-end
 
-# just simulate some work
-def something = sleep(0.5)
-def some = sleep(0.15)
-
-TEXT = <<~LOREM
-  Lorem [[yellow]]ipsum[[/]] dolor sit
-  amet, consectetur adipisicing
-  elit, sed do eiusmod tempor
-  incididunt ut labore et
-  dolore [[red]]magna[[/]] aliqua. Ut
-  enim ad minim veniam, quis
-  nostrud exercitation ullamco
-  laboris nisi ut aliquip ex
-  ea commodo [[bold]]consequat[[/]]. Duis
-  aute irure [[bold green]]dolor[[/]] in
-  reprehenderit in voluptate
-  velit [[underline]]esse cillum[[/]] dolore eu
-  fugiat nulla pariatur.
-  Excepteur sint occaecat
-  cupidatat non proident,
-  sunt in culpa qui officia
-  deserunt mollit anim id
-  est laborum.
-LOREM
-TEXT_LINES = TEXT.lines(chomp: true)
-TEXT_MID = TEXT_LINES.take(8).join(' ')
-TEXT_BIG = TEXT_LINES.join(' ')
-RGB_COLORS = <<~RGB_COLORS.lines(chomp: true).map!(&:split)
-  #800000 #8b0000 #a52a2a #b22222 #dc143c #ff0000 #ff6347 #ff7f50
-  #cd5c5c #f08080 #e9967a #fa8072 #ffa07a #ff4500 #ff8c00 #ffa500
-  #ffd700 #b8860b #daa520 #eee8aa #bdb76b #f0e68c #808000 #ffff00
-  #9acd32 #556b2f #6b8e23 #7cfc00 #7fff00 #adff2f #006400 #008000
-  #228b22 #00ff00 #32cd32 #90ee90 #98fb98 #8fbc8f #00fa9a #00ff7f
-  #2e8b57 #66cdaa #3cb371 #20b2aa #2f4f4f #008080 #008b8b #00ffff
-  #00ffff #e0ffff #00ced1 #40e0d0 #48d1cc #afeeee #7fffd4 #b0e0e6
-  #5f9ea0 #4682b4 #6495ed #00bfff #1e90ff #add8e6 #87ceeb #87cefa
-RGB_COLORS
-
-ui.page do
-  ui.h1 'NattyUI Demo'
   loop do
-    ui.space
-    choice, title =
+    choice =
       ui.query(
-        'Which Demo part do you like to see?',
-        :a => 'Attributes',
-        '3' => '3-bit and 4-bit Colors',
-        '8' => '8-bit Colors',
-        '2' => '24-bit colors',
-        'l' => 'List in Columns',
-        's' => 'Sections',
-        'S' => 'Sections with lists',
-        'z' => 'Sections with table',
-        't' => 'Tasks',
-        :q => 'Quit Demo',
-        :result => :all,
-        :display => :compact
-      )
-    break if choice.nil? || choice == 'q'
-    ui.cls.h2(title).space
-    case choice
-    when 'a'
-      attributes
-    when '3'
-      colors_3bit
-    when '8'
-      colors_8bit
-    when '2'
-      colors_24bit
-    when 't'
-      tasks
-    when 'l'
-      list_in_columns
-    when 's'
-      sections { messages }
-    when 'S'
-      sections { list_in_columns }
-    when 'z'
-      sections { table }
-    end
+        'Which example do you like to watch?',
+        display: :compact,
+        **choices
+      ) or break
+    example = examples[choice] or break
+    ui.cls
+    run[example]
   end
 end

data/examples/illustration.rb

@@ -1,26 +1,30 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
-ui.space
-ui.msg('Natty UI', glyph: '⭐️') { ui.puts <<~TEXT }
-  This is the [[c4]]beautiful[[/]], [[c5]]nice[[/]], [[c6]]nifty[[/]], [[c7]]fancy[[/]], [[c8]]neat[[/]], [[c9]]pretty[[/]],  [[ca]]cool[[/]],
-  [[cb]]lovely[[/]], [[cc]]natty[[/]] [[bold]]user interface[[/]] you like to have for your command
-  line applications. It contains [[italic]]elegant[[/]], [[italic]]simple[[/]] and [[italic]]beautiful[[/]]
-  tools that enhance your command line interfaces functionally and
-  aesthetically.
-TEXT
-ui.msg('Features', glyph: '⭐️') { ui.ls(<<~FEATURES.lines(chomp: true)) }
-  [[bold red]]T[[/]] text attributes
-  🌈 text coloring
-  🎩 heading elements
-  📏 horizontal rulers
-  📝 message blocks
-  ✅ task blocks
-  [[bold blue]]""[[/]] quote blocks
-  🖼️ framed blocks
-  [[yellow]]┼┼[[/]] tables
-  💯 progress bars
-  [[bold red]]?[[/]] ask question
-  [[bold bright_white]]>[[bright_red]]_[[/]] user input
-FEATURES
+ui.framed do
+  ui.msg('Natty UI', <<~TEXT.tr("\n", ' '), glyph: '⭐️')
+    This is the [[c4]]beautiful[[/]], [[c5]]nice[[/]], [[c6]]nifty[[/]],
+    [[c7]]fancy[[/]], [[c8]]neat[[/]], [[c9]]pretty[[/]],  [[ca]]cool[[/]],
+    [[cb]]lovely[[/]], [[cc]]natty[[/]] [[bold]]user interface[[/]] you like to
+    have for your command line applications. It contains
+    [[curly_underline ul_c4]]elegant[[/]], [[italic]]simple[[/]] and
+    [[double_underline ul_cc]]beautiful[[/]] tools that enhance your command
+    line interfaces functionally and aesthetically.
+  TEXT
+
+  ui.msg('Features', glyph: '⭐️') { ui.ls(<<~FEATURES.lines(chomp: true)) }
+    [[bold red]]T[[/]]  text attributes
+    🌈 text coloring
+    🔦 text animation
+    🎩 heading elements
+    📏 horizontal rulers
+    📝 messages
+    [[bold blue]]""[[/]] quote blocks
+    [[yellow]]🄵[[/]]  framed blocks
+    ✅ tasks
+    [[bold green]]…[[/]]  progress bars
+    [[blue]]┼┼[[/]] tables
+    [[bold bright_white]]>[[bright_red]]_[[/]] user input
+  FEATURES
+end

data/examples/{list_in_columns.rb → ls.rb}

@@ -1,8 +1,12 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
-LOREM = <<~LOREM
+ui.space
+ui.h1 'NattyUI: Print In Columns'
+ui.space
+
+LOREM = <<~IPSUM.lines(chomp: true)
   Lorem ipsum dolor sit
   amet, consectetur adipisicing
   elit, sed do eiusmod tempor
@@ -21,16 +25,12 @@ LOREM = <<~LOREM
   sunt in culpa qui officia
   deserunt mollit anim id
   est laborum.
-LOREM
-
-ui.space
-ui.h1 'Print a list in columns'
-ui.space
+IPSUM
 
-ui.h2 'Lorem ipsum lines (compact)'
-ui.ls LOREM.lines(chomp: true), glyph: 1
+ui.h2 'Compact Display'
+ui.ls LOREM, glyph: 1
 ui.space
 
-ui.h2 'Lorem ipsum lines (row-wise)'
-ui.ls LOREM.lines(chomp: true), glyph: 1, compact: false
+ui.h2 'Traditional Display'
+ui.ls LOREM, glyph: 1, compact: false
 ui.space

data/examples/message.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative '../lib/natty-ui'
+
+ui.space
+ui.h1 'NattyUI: Message Types'
+ui.space
+
+TEXT = <<~TEXT.tr("\n", ' ')
+  Lorem [[yellow]]ipsum[[/]] dolor sit amet, consectetur adipisicing elit, sed
+  do eiusmod tempor incididunt ut labore et dolore [[red]]magna[[/]] aliqua.
+  Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+  aliquip ex ea commodo [[bold]]consequat[[/]].
+TEXT
+
+IMPORTANT =
+  '[[red]]>>>[[/]] [[italic]]Here some important information[[/]] [[red]]<<<'
+
+ui.framed do
+  ui.info 'Informative Message', TEXT
+  ui.warning 'Warning Message' do
+    ui.puts TEXT
+    ui.framed { ui.puts IMPORTANT }
+  end
+  ui.error 'Error Message', TEXT
+  ui.failed 'Fail Message', TEXT
+  ui.message '[[italic #fad]]Custom Message', TEXT, glyph: '💡'
+end
+
+ui.space

data/examples/progress.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
 ui.space
-ui.h1 'NattyUI Progress Indication Demo'
+ui.h1 'NattyUI: Progress Indication'
 ui.space
 
 # just simulate some work

data/examples/query.rb

@@ -1,19 +1,21 @@
 # frozen_string_literal: true
 
-require 'natty-ui'
+require_relative '../lib/natty-ui'
 
 ui.space
-ui.h1 'NattyUI Query Demo'
+ui.h1 'NattyUI: User Queries'
 ui.space
 
 # little helper
 def abort!
   ui.failed 'aborted'
+  ui.space
   exit
 end
 
 unless ui.ask('Do you like to continute? (Y|n): ')
   ui.info 'ok, try later!'
+  ui.space
   exit
 end
 
@@ -35,3 +37,5 @@ ui.info "Your answer: #{answer.inspect}"
 answer = ui.request('What is your current password?:', password: true)
 abort! unless answer
 ui.info "I'll keep your secret!"
+
+ui.space

data/examples/read_key.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative '../lib/natty-ui'
+
+ui.puts '⌨️ Display Keyboard Input [[bright_black]](Exit with Ctrl+C)'
+
+ui.section prefix: '[[blue]]:[[/]] ' do
+  while true
+    raw, name = NattyUI.read_key(mode: :both)
+    ui.puts "[[yellow]]#{raw.inspect}[[/]] [[bold bright_green]]#{name}[[/]]"
+    break if name == 'Ctrl+C'
+  end
+end