yap-rawline 0.3.5 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d79b164cb6b3ae9d4466e30f1597b238f125d125
-  data.tar.gz: f3f078c0e1bc30afbd66ab83fe189a8dc7515c05
+  metadata.gz: b3cf478bbbaca65f44353988eb4f3a6522dff7db
+  data.tar.gz: b6b4edd7affe941e8ea350bcf8aa0d660481de25
 SHA512:
-  metadata.gz: 656851a08f73fb8843df4a5641f98f5c509649f5777db197519e3726d282a007f54d655ca92b165794f425d5ff61a4fdaae9e28dbb8d4bbd4c6ec9ab65a22ddf
-  data.tar.gz: fd867c4e039e5d09bbff714bd92514d01a293f45a052fd4ec1de46a91fcad6fc8bef36666f34cc21a181fedf29067ffa24b65bdca4a6f181303eeabbc4fa34d2
+  metadata.gz: 63b4b7ab19f77f8a6c4d57d40aa7bc5e3def8509700d67cb25559655bb2c24f3d1017232ce4a6da11b52e4fff86566108dd21cfca3fdf20dd85978e7f6cf81f7
+  data.tar.gz: d73ad94f1951fc5eb7254b0c998b53233ba757bd5a2846d32593b427c05e797c203fd2a7cb29cd851fe76505172aead24ca765f96268e2f2a6511bfa0d57c3be

data/lib/rawline.rb

@@ -50,7 +50,9 @@ require "#{dir}/rawline/prompt"
 require "#{dir}/rawline/completer"
 require "#{dir}/rawline/event_loop"
 require "#{dir}/rawline/event_registry"
+require "#{dir}/rawline/key_bindings"
 require "#{dir}/rawline/keycode_parser"
+require "#{dir}/rawline/line_editor"
 require "#{dir}/rawline/non_blocking_input"
 require "#{dir}/rawline/renderer"
 require "#{dir}/rawline/dom_tree"

data/lib/rawline/dom_tree.rb

@@ -4,6 +4,8 @@ module RawLine
   class DomTree < TerminalLayout::Box
     attr_accessor :prompt_box, :input_box, :content_box
 
+    attr_accessor :focused_input_box
+
     def initialize(children: nil)
       unless children
         @prompt_box = TerminalLayout::Box.new(content: "default-prompt>", style: {display: :inline})
@@ -12,7 +14,20 @@ module RawLine
         super(style: {}, children: [@prompt_box, @input_box, @content_box])
       else
         super(style: {}, children: children)
+        @input_box = find_child_of_type(TerminalLayout::InputBox)
       end
+      focus_input_box(@input_box)
+    end
+
+    def focus_input_box(box)
+      @focused_input_box.remove_focus! if @focused_input_box
+      @focused_input_box = box
+      @focused_input_box.focus! if @focused_input_box
+    end
+
+    def input_box=(box)
+      @input_box = box
+      focus_input_box(@input_box)
     end
   end
 end

data/lib/rawline/editor.rb

@@ -49,7 +49,7 @@ module RawLine
     attr_accessor :dom
 
     # TODO: dom traversal for lookup rather than assignment
-    attr_accessor :prompt_box, :input_box, :content_box
+    attr_accessor :prompt_box, :input_box, :content_box, :focused_input_box
 
     def self.create(dom: nil, &blk)
       terminal = nil
@@ -76,6 +76,8 @@ module RawLine
         height: terminal.height
       )
 
+      KeyBindings.default_terminal = terminal
+
       new(
         dom: dom,
         input: NonBlockingInput.new(input),
@@ -87,13 +89,15 @@ module RawLine
 
     class Environment
       attr_accessor :keys, :completion_class, :history, :word_separator
+      attr_accessor :keyboard_input_processors
 
       # * <tt>@history_size</tt> - the size of the editor history buffer (30).
       # * <tt>@keys</tt> - the keys (arrays of character codes) bound to specific actions.
       # * <tt>@line_history_size</tt> - the size of the editor line history buffer (50).
       def initialize(env: nil)
         @env = env
-        @keys = {}
+        @keys = KeyBindings.new
+        @keyboard_input_processors = []
 
         @completion_class = Completer
 
@@ -139,7 +143,7 @@ module RawLine
       @match_hidden_files = false
       set_default_keys
       @add_history = false
-      @keyboard_input_processors = [self]
+      push_keyboard_input_processor self
       yield self if block_given?
       update_word_separator
       @char = nil
@@ -154,11 +158,14 @@ module RawLine
     def env ; @env_stack.last ; end
     def new_env ; Environment.new ; end
     def push_env(env) ; @env_stack.push env ; end
-    def pop_env(env) ; @env_stack.pop ; end
+    def pop_env ; @env_stack.pop ; end
+    def keyboard_input_processor ; env.keyboard_input_processors.last ; end
+    def push_keyboard_input_processor(kip) ; env.keyboard_input_processors.push kip ; end
+    def pop_keyboard_input_processor ; env.keyboard_input_processors.pop ; end
 
-    def completion_class ; env.completion_class ; end
-    def history ; env.history ; end
-    def keys ; env.keys ; end
+    def completion_class ; @env_stack.first.completion_class ; end
+    def history ; @env_stack.first.history ; end
+    def keys ; @env_stack.first.keys ; end
 
     #
     # Return the current RawLine version
@@ -174,10 +181,12 @@ module RawLine
     def prompt=(text)
       return if @line && @line.prompt == text
       @prompt = Prompt.new(text)
+      Treefell['editor'].puts "prompt=#{prompt.inspect}"
       @dom.prompt_box.content = @prompt
     end
 
     def redraw_prompt
+      Treefell['editor'].puts "redrawing prompt=#{prompt.inspect} reset=true"
       render(reset: true)
     end
 
@@ -185,6 +194,7 @@ module RawLine
     def terminal_height ; @terminal.height ; end
 
     def content_box ; @dom.content_box ; end
+    def focused_input_box ; @dom.focused_input_box ; end
     def input_box ; @dom.input_box ; end
     def prompt_box ; @dom.prompt_box ; end
 
@@ -201,11 +211,14 @@ module RawLine
       at_exit { @terminal.cooked! }
 
       Signal.trap("SIGWINCH") do
+        Treefell['editor'].puts "terminal-resized trap=SIGWINCH"
         @event_loop.add_event name: "terminal-resized", source: self
       end
 
       @event_registry.subscribe("terminal-resized") do
-        @renderer.update_dimensions(width: terminal_width, height: terminal_height)
+        width, height = terminal_width, terminal_height
+        Treefell['editor'].puts "terminal-resizing width=#{width} height=#{height}"
+        @renderer.update_dimensions(width: width, height: height)
         @event_loop.add_event name: "render", source: self
       end
 
@@ -232,7 +245,7 @@ module RawLine
     def check_for_keyboard_input
       bytes = @input.read
       if bytes.any?
-        @keyboard_input_processors.last.read_bytes(bytes)
+        keyboard_input_processor.read_bytes(bytes)
       end
       @event_loop.add_event name: 'check_for_keyboard_input', source: self
     end
@@ -244,28 +257,32 @@ module RawLine
       key_code_sequences = parse_key_code_sequences(bytes)
       key_code_sequences.each do |sequence|
         @char = sequence
-        process_character
-
-        new_position = @line.position
-
         if @char == @terminal.keys[:enter] || !@char
           process_line
+        else
+          process_character
+          new_position = @line.position
         end
       end
     end
 
     def process_line
       @event_loop.add_event(name: "process_line", source: self) do
+        add_to_history
+
         @terminal.snapshot_tty_attrs
         @terminal.pseudo_cooked!
 
-        move_to_beginning_of_input
+        @terminal.move_to_beginning_of_row
         @terminal.puts
       end
 
-      @event_loop.add_event name: "line_read", source: self, payload: { line: @line.text.without_ansi.dup }
+      @event_loop.add_event(name: "line_read", source: self, payload: { line: @line.text.without_ansi.dup })
+      @event_loop.add_event(name: "prepare_new_line", source: self) do
+        move_to_beginning_of_input
+      end
       @event_loop.add_event(name: "restore_tty_attrs", source: self) { @terminal.restore_tty_attrs }
-      @event_loop.add_event name: "render", source: self, payload: { reset: true }
+      @event_loop.add_event(name: "render", source: self, payload: { reset: true })
     end
 
     #
@@ -299,59 +316,18 @@ module RawLine
     # * The value can be a Fixnum, a String or an Array.
     #
     def bind(key, &block)
-      case key.class.to_s
-      when 'Symbol' then
-        raise BindingException, "Unknown key or key sequence '#{key.to_s}' (#{key.class.to_s})" unless @terminal.keys[key]
-        keys[@terminal.keys[key]] = block
-      when 'Array' then
-        raise BindingException, "Unknown key or key sequence '#{key.join(", ")}' (#{key.class.to_s})" unless @terminal.keys.has_value? key
-        keys[key] = block
-      when 'Fixnum' then
-        raise BindingException, "Unknown key or key sequence '#{key.to_s}' (#{key.class.to_s})" unless @terminal.keys.has_value? [key]
-        keys[[key]] = block
-      when 'String' then
-        if key.length == 1 then
-          keys[[key.ord]] = block
-        else
-          bind_hash({:"#{key}" => key}, block)
-        end
-      when 'Hash' then
-        raise BindingException, "Cannot bind more than one key or key sequence at once" unless key.values.length == 1
-        bind_hash(key, block)
-      else
-        raise BindingException, "Unable to bind '#{key.to_s}' (#{key.class.to_s})"
-      end
-      @terminal.update
+      keys.bind(key, &block)
     end
 
     def unbind(key)
-      block = case key.class.to_s
-        when 'Symbol' then
-          keys.delete @terminal.keys[key]
-        when 'Array' then
-          keys.delete keys[key]
-        when 'Fixnum' then
-          keys.delete[[key]]
-        when 'String' then
-          if key.length == 1 then
-            keys.delete([key.ord])
-          else
-            raise NotImplementedError, "This is no implemented yet. It needs to return the previously bound block"
-            bind_hash({:"#{key}" => key}, block)
-          end
-        when 'Hash' then
-          raise BindingException, "Cannot bind more than one key or key sequence at once" unless key.values.length == 1
-          bind_hash(key, -> { })
-        end
-      @terminal.update
-      block
+      keys.unbind(key)
     end
 
     #
     # Return true if the last character read via <tt>read</tt> is bound to an action.
     #
     def key_bound?
-      keys[@char] ? true : false
+      keys.bound?(@char)
     end
 
     #
@@ -403,14 +379,14 @@ module RawLine
     # This action is bound to ctrl+k by default.
     #
     def clear_line
+      Treefell['editor'].puts "clear_line"
       add_to_line_history
-      @line.text = ""
-      @line.position = 0
-      @dom.input_box.position = @line.position
+      @line_editor.clear_line
       history.clear_position
     end
 
     def clear_screen
+      Treefell['editor'].puts "clear_screen"
       @terminal.clear_screen
       render(reset: true)
     end
@@ -422,21 +398,19 @@ module RawLine
     # This action is bound to the backspace key by default.
     #
     def delete_left_character(no_line_history=false)
-      if move_left then
-        delete_character(no_line_history)
+      Treefell['editor'].puts "delete_left_character"
+      if @line_editor.delete_left_character
+        add_to_line_history unless no_line_history
+        history.clear_position
       end
     end
 
     def delete_n_characters(number_of_characters_to_delete, no_line_history=false)
-      number_of_characters_to_delete.times do |n|
-        @line[@line.position] = ''
-        @line.left
+      Treefell['editor'].puts "delete_n_characters n=#{number_of_characters_to_delete}"
+      if @line_editor.delete_n_characters(number_of_characters_to_delete)
+        add_to_line_history unless no_line_history
+        history.clear_position
       end
-
-      @dom.input_box.position = @line.position
-      @dom.input_box.content = @line.text
-      add_to_line_history unless no_line_history
-      history.clear_position
     end
 
     #
@@ -446,37 +420,54 @@ module RawLine
     # This action is bound to the delete key by default.
     #
     def delete_character(no_line_history=false)
-      unless @line.position > @line.eol
-        # save characters to shift
-        chars = (@line.eol?) ? ' ' : select_characters_from_cursor(1)
-        #remove character from line
-        @line[@line.position] = ''
-        @dom.input_box.content = @line.text
-        @dom.input_box.position = @line.position
+      Treefell['editor'].puts "delete_character"
+      if @line_editor.delete_character
         add_to_line_history unless no_line_history
         history.clear_position
       end
     end
 
     def highlight_text_up_to(text, position)
-      ANSIString.new("\e[1m#{text[0...position]}\e[0m#{text[position..-1]}")
+      Treefell['editor'].puts "highlight_text_up_to text=#{text} position=#{position}"
+      @line_editor.highlight_text_up_to(text, position)
+    end
+
+    #
+    # Inserts a string at the current line position, shifting characters
+    # to right if necessary.
+    #
+    def insert(string, add_to_line_history: true)
+      Treefell['editor'].puts "insert string=#{string} add_to_line_history=#{add_to_line_history}"
+      if @line_editor.insert(string)
+        self.add_to_line_history if add_to_line_history
+      end
     end
 
     def kill_forward
-      killed_text = @line.text[@line.position..-1]
-      @line.text[@line.position..-1] = ANSIString.new("")
-      @dom.input_box.content = line.text
-      @dom.input_box.position = @line.position
-      history.clear_position
-      killed_text
+      Treefell['editor'].puts "kill_forward"
+      @line_editor.kill_forward.tap do
+        add_to_line_history(allow_empty: true)
+        history.clear_position
+      end
+    end
+
+    #
+    # Write a string starting from the cursor position ovewriting any character
+    # at the current position if necessary.
+    #
+    def write(string, add_to_line_history: true)
+      Treefell['editor'].puts "write string=#{string}"
+      if @line_editor.write(string)
+        self.add_to_line_history if add_to_line_history
+      end
     end
 
     def yank_forward(text)
-      @line.text[line.position] = text
-      @line.position = line.position + text.length
-      @dom.input_box.content = line.text
-      @dom.input_box.position = @line.position
-      history.clear_position
+      Treefell['editor'].puts "yank_forward"
+      @line_editor.yank_forward(text).tap do
+        add_to_line_history
+        history.clear_position
+      end
     end
 
     #
@@ -485,12 +476,8 @@ module RawLine
     # This action is bound to the left arrow key by default.
     #
     def move_left
-      unless @line.bol? then
-        @line.left
-        @dom.input_box.position = @line.position
-        return true
-      end
-      false
+      Treefell['editor'].puts "move_left"
+      @line_editor.move_left
     end
 
     #
@@ -500,28 +487,25 @@ module RawLine
     # This action is bound to the right arrow key by default.
     #
     def move_right
-      unless @line.position > @line.eol then
-        @line.right
-        @dom.input_box.position = @line.position
-        return true
-      end
-      false
+      Treefell['editor'].puts "move_right"
+      @line_editor.move_right
     end
 
     def move_to_beginning_of_input
-      @line.position = @line.bol
-      @dom.input_box.position = @line.position
+      Treefell['editor'].puts "move_to_beginning_of_input"
+      @line_editor.move_to_beginning_of_input
     end
 
     def move_to_end_of_input
-      @line.position = @line.length
-      @dom.input_box.position = @line.position
+      Treefell['editor'].puts "move_to_end_of_input"
+      @line_editor.move_to_end_of_input
     end
 
     #
     # Move the cursor to <tt>pos</tt>.
     #
     def move_to_position(pos)
+      Treefell['editor'].puts "move_to_position position=#{pos}"
       rows_to_move = current_terminal_row - terminal_row_for_line_position(pos)
       if rows_to_move > 0
         # rows_to_move.times { @output.print @terminal.term_info.control_string("cuu1") }
@@ -533,20 +517,7 @@ module RawLine
       column = (@line.prompt.length + pos) % terminal_width
       # @output.print @terminal.term_info.control_string("hpa", column)
       # @terminal.move_to_column((@line.prompt.length + pos) % terminal_width)
-      @line.position = pos
-      @dom.input_box.position = @line.position
-    end
-
-    def move_to_end_of_line
-      rows_to_move_down = number_of_terminal_rows - current_terminal_row
-      # rows_to_move_down.times { @output.print @terminal.term_info.control_string("cud1") }
-      # @terminal.move_down_n_rows rows_to_move_down
-      @line.position = @line.length
-      @dom.input_box.position = @line.position
-
-      column = (@line.prompt.length + @line.position) % terminal_width
-      # @output.print @terminal.term_info.control_string("hpa", column)
-      # @terminal.move_to_column((@line.prompt.length + @line.position) % terminal_width)
+      @line_editor.position = pos
     end
 
     #
@@ -555,22 +526,14 @@ module RawLine
     # <tt>position</tt>.
     #
     def overwrite_line(new_line, position=nil, options={})
-      text = @line.text
-      @highlighting = false
-
-      if options[:highlight_up_to]
-        @highlighting = true
-        new_line = highlight_text_up_to(new_line, options[:highlight_up_to])
+      Treefell['editor'].puts "overwrite_line new_line=#{new_line} position=#{position} options=#{options.inspect}"
+      if @line_editor.overwrite_line(new_line, position, options)
+        @event_loop.add_event name: "render", source: focused_input_box
       end
-
-      @line.position = position || new_line.length
-      @line.text = new_line
-      @dom.input_box.content = @line.text
-      @dom.input_box.position = @line.position
-      @event_loop.add_event name: "render", source: @dom.input_box
     end
 
     def reset_line
+      Treefell['editor'].puts "reset_line"
       initialize_line
       render(reset: true)
     end
@@ -599,32 +562,6 @@ module RawLine
       render(reset: true)
     end
 
-    #
-    # Inserts a string at the current line position, shifting characters
-    # to right if necessary.
-    #
-    def insert(string, add_to_line_history: true)
-      @line.text.insert @line.position, string
-      string.length.times { @line.right }
-      @dom.input_box.position = @line.position
-      @dom.input_box.content = @line.text
-
-      self.add_to_line_history if add_to_line_history
-    end
-
-    #
-    # Write a string starting from the cursor position ovewriting any character
-    # at the current position if necessary.
-    #
-    def write(string, add_to_line_history: true)
-      @line.text[@line.position] = string
-      string.length.times { @line.right }
-      @dom.input_box.position = @line.position
-      @dom.input_box.content = @line.text
-
-      self.add_to_line_history if add_to_line_history
-    end
-
     ############################################################################
     #
     #                             COMPLETION
@@ -643,7 +580,7 @@ module RawLine
     # pressed again.
     #
     def complete
-      @dom.input_box.cursor_off
+      focused_input_box.cursor_off
       completer = completion_class.new(
         char: @char,
         line: @line,
@@ -660,15 +597,15 @@ module RawLine
         done: -> (*leftover_bytes){
           completion_done
           leftover_bytes = leftover_bytes.flatten
-          @keyboard_input_processors.pop
+          pop_keyboard_input_processor
           if leftover_bytes.any?
-            @keyboard_input_processors.last.read_bytes(leftover_bytes)
+            keyboard_input_processor.read_bytes(leftover_bytes)
           end
-          @dom.input_box.cursor_on
+          focused_input_box.cursor_on
         },
         keys: terminal.keys
       )
-      @keyboard_input_processors.push(completer)
+      push_keyboard_input_processor(completer)
       completer.read_bytes(@char)
     end
 
@@ -826,15 +763,21 @@ module RawLine
     # line history, to allow undo/redo
     # operations.
     #
-    def add_to_line_history
-      @line.history << @line.text.dup unless @line.text == ""
+    def add_to_line_history(allow_empty: false)
+      if allow_empty || !@line.text.empty?
+        Treefell['editor'].puts "add_to_line_history text=#{@line.text}"
+        @line.history << @line.text.dup
+      end
     end
 
     #
     # Add the current line (<tt>@line.text</tt>) to the editor history.
     #
-    def add_to_history
-      history << @line.text.dup if @add_history && @line.text != ""
+    def add_to_history(allow_empty: false)
+      if @add_history && (allow_empty || !@line.text.empty?)
+        Treefell['editor'].puts "add_to_history text=#{@line.text}"
+        history << @line.text.dup
+      end
     end
 
     ############################################################################
@@ -861,6 +804,11 @@ module RawLine
       overwrite_line(text, pos)
     end
 
+    def focus_input_box(box)
+      @dom.focus_input_box(box)
+      @renderer.render_cursor
+    end
+
     private
 
     def initialize_events
@@ -870,14 +818,24 @@ module RawLine
       end
       @event_loop = Rawline::EventLoop.new(registry: @event_registry)
 
+      @dom.on(:content_changed) do |*args|
+        Treefell['editor'].puts 'DOM content changed, re-rendering'
+        @event_loop.add_event name: "render"
+      end
+
       @dom.on(:child_changed) do |*args|
         Treefell['editor'].puts 'DOM child changed, re-rendering'
-        @event_loop.add_event name: "render", source: @dom#, target: event[:target]
+        @event_loop.add_event name: "render"
       end
 
       @dom.on :position_changed do |*args|
         Treefell['editor'].puts 'DOM position changed, rendering cursor'
-        @renderer.render_cursor(@dom.input_box)
+        @renderer.render
+      end
+
+      @dom.on :focus_changed do |*args|
+        Treefell['editor'].puts 'DOM focused changed, re-rendering'
+        @renderer.render
       end
 
       @event_registry.subscribe :render, -> (_) { render(reset: false) }
@@ -889,13 +847,17 @@ module RawLine
     end
 
     def initialize_line
-      @dom.input_box.content = ""
+      focused_input_box.content = ""
       update_word_separator
       @add_history = true
       @line = env.initialize_line do |l|
         l.prompt = @dom.prompt_box.content
         l.word_separator = @word_separator
       end
+      @line_editor = LineEditor.new(
+        @line,
+        sync_with: -> { focused_input_box }
+      )
       add_to_line_history
       @allow_prompt_updates = true
     end
@@ -911,32 +873,10 @@ module RawLine
       @word_separator = /(?<!\\)[#{chars.join}]/
     end
 
-    def bind_hash(key, block)
-      key.each_pair do |j,k|
-        raise BindingException, "'#{k[0].chr}' is not a legal escape code for '#{@terminal.class.to_s}'." unless k.length > 1 && @terminal.escape_codes.include?(k[0].ord)
-        code = []
-        case k.class.to_s
-        when 'Fixnum' then
-          code = [k]
-        when 'String' then
-          k.each_byte { |b| code << b }
-        when 'Array' then
-          code = k
-        else
-          raise BindingException, "Unable to bind '#{k.to_s}' (#{k.class.to_s})"
-        end
-        @terminal.keys[j] = code
-        keys[code] = block
-      end
-    end
-
-    def select_characters_from_cursor(offset=0)
-      select_characters(:right, @line.length-@line.position, offset)
-    end
-
     def generic_history_back(history)
       unless history.empty?
         history.back
+        Treefell['editor'].puts "generic_history_back position=#{history.position} history=#{history.to_a.inspect}"
         line = history.get
         return unless line
 
@@ -947,6 +887,7 @@ module RawLine
 
     def generic_history_forward(history)
       if history.forward
+        Treefell['editor'].puts "generic_history_back position=#{history.position} history=#{history.to_a.inspect}"
         line = history.get
         return unless line
 
@@ -955,14 +896,6 @@ module RawLine
       end
     end
 
-    def select_characters(direction, n, offset=0)
-      if direction == :right then
-        @line.text[@line.position+offset..@line.position+offset+n]
-      elsif direction == :left then
-        @line.text[@line.position-offset-n..@line.position-offset]
-      end
-    end
-
     def set_default_keys
       bind(:space) { insert(' ') }
       bind(:enter) { newline }

data/lib/rawline/key_bindings.rb

@@ -0,0 +1,109 @@
+module RawLine
+  class KeyBindings
+    attr_reader :keys
+
+    class << self
+      attr_accessor :default_terminal
+    end
+
+    def initialize(terminal: self.class.default_terminal)
+      @terminal = terminal
+      @keys = {}
+    end
+
+    def [](char)
+      keys[char]
+    end
+
+    #
+    # Bind a key to an action specified via <tt>block</tt>.
+    # <tt>key</tt> can be:
+    #
+    # * A Symbol identifying a character or character sequence defined for the current terminal
+    # * A Fixnum identifying a character defined for the current terminal
+    # * An Array identifying a character or character sequence defined for the current terminal
+    # * A String identifying a character or character sequence, even if it is not defined for the current terminal
+    # * An Hash identifying a character or character sequence, even if it is not defined for the current terminal
+    #
+    # If <tt>key</tt> is a hash, then:
+    #
+    # * It must contain only one key/value pair
+    # * The key identifies the name of the character or character sequence
+    # * The value identifies the code(s) corresponding to the character or character sequence
+    # * The value can be a Fixnum, a String or an Array.
+    #
+    def bind(key, &block)
+      case key.class.to_s
+      when 'Symbol' then
+        raise BindingException, "Unknown key or key sequence '#{key.to_s}' (#{key.class.to_s})" unless @terminal.keys[key]
+        keys[@terminal.keys[key]] = block
+      when 'Array' then
+        raise BindingException, "Unknown key or key sequence '#{key.join(", ")}' (#{key.class.to_s})" unless @terminal.keys.has_value? key
+        keys[key] = block
+      when 'Fixnum' then
+        raise BindingException, "Unknown key or key sequence '#{key.to_s}' (#{key.class.to_s})" unless @terminal.keys.has_value? [key]
+        keys[[key]] = block
+      when 'String' then
+        if key.length == 1 then
+          keys[[key.ord]] = block
+        else
+          bind_hash({:"#{key}" => key}, block)
+        end
+      when 'Hash' then
+        raise BindingException, "Cannot bind more than one key or key sequence at once" unless key.values.length == 1
+        bind_hash(key, block)
+      else
+        raise BindingException, "Unable to bind '#{key.to_s}' (#{key.class.to_s})"
+      end
+      @terminal.update
+    end
+
+    def bound?(char)
+      keys[char] ? true : false
+    end
+
+    def unbind(key)
+      block = case key.class.to_s
+        when 'Symbol' then
+          keys.delete @terminal.keys[key]
+        when 'Array' then
+          keys.delete keys[key]
+        when 'Fixnum' then
+          keys.delete[[key]]
+        when 'String' then
+          if key.length == 1 then
+            keys.delete([key.ord])
+          else
+            raise NotImplementedError, "This is no implemented yet. It needs to return the previously bound block"
+            bind_hash({:"#{key}" => key}, block)
+          end
+        when 'Hash' then
+          raise BindingException, "Cannot bind more than one key or key sequence at once" unless key.values.length == 1
+          bind_hash(key, -> { })
+        end
+      @terminal.update
+      block
+    end
+
+    private
+
+    def bind_hash(key, block)
+      key.each_pair do |j,k|
+        raise BindingException, "'#{k[0].chr}' is not a legal escape code for '#{@terminal.class.to_s}'." unless k.length > 1 && @terminal.escape_codes.include?(k[0].ord)
+        code = []
+        case k.class.to_s
+        when 'Fixnum' then
+          code = [k]
+        when 'String' then
+          k.each_byte { |b| code << b }
+        when 'Array' then
+          code = k
+        else
+          raise BindingException, "Unable to bind '#{k.to_s}' (#{k.class.to_s})"
+        end
+        @terminal.keys[j] = code
+        keys[code] = block
+      end
+    end    
+  end
+end

data/lib/rawline/line.rb

@@ -32,7 +32,7 @@ module RawLine
     # * <tt>@position</tt> - the current cursor position within the line.
     # * <tt>@prompt</tt> - a prompt to prepend to the line text.
     #
-    def initialize(history_size)
+    def initialize(history_size=30)
       @text = ANSIString.new("")
       @history_size = history_size
       @position = 0

data/lib/rawline/line_editor.rb

@@ -0,0 +1,194 @@
+module RawLine
+  class LineEditor
+    def initialize(line, sync_with: -> {})
+      @line = line
+      @sync_with_proc = sync_with
+    end
+
+    #
+    # Clear the current line, i.e.
+    # <tt>@line.text</tt> and <tt>@line.position</tt>.
+    # This action is bound to ctrl+k by default.
+    #
+    def clear_line
+      @line.text = ""
+      @line.position = 0
+      sync!
+      true
+    end
+
+    #
+    # Delete the character at the left of the cursor.
+    # If <tt>no_line_hisytory</tt> is set to true, the deletion won't be
+    # recorded in the line history.
+    # This action is bound to the backspace key by default.
+    #
+    def delete_left_character
+      if move_left then
+        delete_character
+        sync!
+        return true
+      end
+      false
+    end
+
+    def delete_n_characters(number_of_characters_to_delete)
+      number_of_characters_to_delete.times do |n|
+        @line[@line.position] = ''
+        @line.left
+      end
+      sync!
+      true
+    end
+
+    #
+    # Delete the character under the cursor.
+    # If <tt>no_line_hisytory</tt> is set to true, the deletion won't be
+    # recorded in the line history.
+    # This action is bound to the delete key by default.
+    #
+    def delete_character(no_line_history=false)
+      unless @line.position > @line.eol
+        # save characters to shift
+        chars = (@line.eol?) ? ' ' : select_characters_from_cursor(1)
+        #remove character from line
+        @line[@line.position] = ''
+        sync!
+        return true
+      end
+      false
+    end
+
+    def highlight_text_up_to(text, position)
+      ANSIString.new("\e[1m#{text[0...position]}\e[0m#{text[position..-1]}")
+    end
+
+    #
+    # Inserts a string at the current line position, shifting characters
+    # to right if necessary.
+    #
+    def insert(string)
+      return false if string.empty?
+      @line.text.insert @line.position, string
+      string.length.times { @line.right }
+      sync!
+      true
+    end
+
+    def kill_forward
+      @line.text[@line.position..-1].tap do
+        @line.text[@line.position..-1] = ANSIString.new("")
+        sync!
+      end
+    end
+
+    #
+    # Write a string starting from the cursor position ovewriting any character
+    # at the current position if necessary.
+    #
+    def write(string)
+      if @line.eol?
+        @line.text[@line.position] = string
+      else
+        @line.text << string
+      end
+      string.length.times { @line.right }
+      sync!
+      true
+    end
+
+    def yank_forward(text)
+      @line.text[@line.position...@line.position] = text
+      @line.position = @line.position + text.length
+      sync!
+      @line.text
+    end
+
+    #
+    # Move the cursor left (if possible) by printing a
+    # backspace, updating <tt>@line.position</tt> accordingly.
+    # This action is bound to the left arrow key by default.
+    #
+    def move_left
+      unless @line.bol? then
+        @line.left
+        sync!
+        return true
+      end
+      false
+    end
+
+    def move_right
+      unless @line.position > @line.eol then
+        @line.right
+        sync!
+        return true
+      end
+      false
+    end
+
+    def move_to_beginning_of_input
+      @line.position = @line.bol
+      sync!
+      true
+    end
+
+    def move_to_end_of_input
+      @line.position = @line.length
+      sync!
+      true
+    end
+
+    #
+    # Overwrite the current line (<tt>@line.text</tt>)
+    # with <tt>new_line</tt>, and optionally reset the cursor position to
+    # <tt>position</tt>.
+    #
+    def overwrite_line(new_line, position=nil, options={})
+      text = @line.text
+      @highlighting = false
+
+      if options[:highlight_up_to]
+        @highlighting = true
+        new_line = highlight_text_up_to(new_line, options[:highlight_up_to])
+      end
+
+      @line.position = position || new_line.length
+      @line.text = new_line
+      sync!
+      true
+    end
+
+    def position=(position)
+      @line.position = position
+      sync!
+    end
+
+    def text
+      @line.text
+    end
+
+    private
+
+    def select_characters_from_cursor(offset=0)
+      select_characters(:right, @line.length-@line.position, offset)
+    end
+
+    def select_characters(direction, n, offset=0)
+      if direction == :right then
+        @line.text[@line.position+offset..@line.position+offset+n]
+      elsif direction == :left then
+        @line.text[@line.position-offset-n..@line.position-offset]
+      end
+    end
+
+    def sync!
+      positionable_object = @sync_with_proc.call
+      if positionable_object
+        positionable_object.position = @line.position
+        positionable_object.content = @line.text
+      end
+    end
+
+  end
+end

data/lib/rawline/renderer.rb

@@ -17,8 +17,8 @@ module RawLine
       @renderer.render(@render_tree, reset: reset)
     end
 
-    def render_cursor(input_box)
-      @renderer.render_cursor(input_box)
+    def render_cursor
+      @renderer.render_cursor(@dom.focused_input_box)
     end
 
     def update_dimensions(width:, height:)

data/lib/rawline/terminal.rb

@@ -129,6 +129,10 @@ module RawLine
       term_info.control "el1"
     end
 
+    def clear_to_end_of_line
+      term_info.control "el"
+    end
+
     def clear_screen
       term_info.control "clear"
     end
@@ -137,6 +141,14 @@ module RawLine
       term_info.control "ed"
     end
 
+    def hide_cursor
+      term_info.control_string "civis"
+    end
+
+    def show_cursor
+      term_info.control_string "cnorm"
+    end
+
     def move_to_beginning_of_row
       move_to_column 0
     end

data/lib/rawline/version.rb

@@ -1,3 +1,3 @@
 module RawLine
-  VERSION = "0.3.5"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yap-rawline
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.4.0
 platform: ruby
 authors:
 - Fabio Cevasco
@@ -37,14 +37,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: term-ansicolor
   requirement: !ruby/object:Gem::Requirement
@@ -110,8 +110,10 @@ files:
 - lib/rawline/event_loop.rb
 - lib/rawline/event_registry.rb
 - lib/rawline/history_buffer.rb
+- lib/rawline/key_bindings.rb
 - lib/rawline/keycode_parser.rb
 - lib/rawline/line.rb
+- lib/rawline/line_editor.rb
 - lib/rawline/non_blocking_input.rb
 - lib/rawline/prompt.rb
 - lib/rawline/renderer.rb