vedeu 0.6.27 → 0.6.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f676ea7902c40adea7f5844815c2bd92cc0524ca
-  data.tar.gz: 55d28506df00da6be9d8db123c9f5cc3475b154a
+  metadata.gz: 8e78a39e26891252b15013c3ee2e5b3d9255a824
+  data.tar.gz: 72ae82abfadbc68b4877b21379d086ddd552249d
 SHA512:
-  metadata.gz: 2ad1f1eb8361880265d53dcc03a62684ef9485c967c40022e012e08080135255da79b44365388e05f8947018f73bc4aa121ba5f0bb96885c1936d7dc7f56ca53
-  data.tar.gz: a49319ea6f19f09d106606a076b5db4a2985caacaa67572173a7495e156e8f4319feb8d1afd3580eb161328f7dddc9d30df171fe30703fd4e271359904db5789
+  metadata.gz: 06071e418374792ba1b007ececa0d47b04e8ef53290a821b1e8fe99283cac3e872f09c667a911a0f6f54e3c01490bacbfbcae47180b373244a678967f0d5c6c4
+  data.tar.gz: 09d5fe864aff632e25baf9b1ff0a0b0215e6e5ba5c5874fac7e4950ed4293b7410fc25229b54e31340d00c484e3a5e325f47ed69720d3190034fc38f1c00dc0f

data/docs/cursor.md

@@ -4,15 +4,75 @@
 Each interface defined in Vedeu will have a separate cursor named,
 conveniently after the interface itself.
 
-- The cursor can moved left, right, up or down via events.
+- The cursor can moved left, right, up or down via events; whether
+  visible or not.
 - The cursor can be shown or hidden (independently of the interface).
 - The cursor may not be drawn on the border of the interface if a
   border is defined and visible for any side of the interface.
-- The cursor may not be drawn outside of the geometry of the interface
-  if a border is not defined or is invisible for the interface.
+- The cursor may not be drawn outside of the geometry of the
+  interface, even if a border is not defined or is invisible for the
+  interface.
+- The cursor may not be drawn outside of the boundary of the visible
+  terminal.
 - The position of the cursor is remembered for each interface.
 - The cursor determines that which is shown in the interface via its
   offset (this allows content to be larger than the interface size and
   therefore 'scrolling').
 - The cursor can be refreshed independently of the interface meaning
   the content of the interface can change position if needed.
+
+
+## Cursor Events
+
+Note: 'name' is a Symbol unless mentioned otherwise, and can be
+substituted for 'Vedeu.focus' to use the interface currently in focus.
+
+### :\_cursor_origin_
+This event moves the cursor to the interface origin; the top left
+corner of the named interface.
+
+    Vedeu.trigger(:_cursor_origin_, name)
+    Vedeu.trigger(:_cursor_reset_, name)
+
+### :\_cursor_position_
+To ascertain the position of a cursor in a named interface, use the
+following event (substituting 'name' for the interface name):
+
+    Vedeu.trigger(:_cursor_position_, name)
+
+If you want to know where the cursor is without knowing the interface
+name, you can check which interface is in focus:
+
+    Vedeu.trigger(:_cursor_position_, Vedeu.focus)
+
+### :\_cursor_reposition_
+Moves the cursor to a relative position inside the interface.
+
+    Vedeu.trigger(:_cursor_reposition_, name, y, x)
+
+## Cursor Movement Events
+
+Adjusts the position of the named cursor or view in the direction
+specified. If 'name' is unknown, using 'Vedeu.focus' will use the
+interface currently in focus.
+
+### :\_cursor_left_
+
+    Vedeu.trigger(:_cursor_left_, name)
+    Vedeu.trigger(:_cursor_left_, Vedeu.focus)
+
+### :\_cursor_down_
+
+    Vedeu.trigger(:_cursor_down_, name)
+    Vedeu.trigger(:_cursor_down_, Vedeu.focus)
+
+### :\_cursor_up_
+
+    Vedeu.trigger(:_cursor_up_, name)
+    Vedeu.trigger(:_cursor_up_, Vedeu.focus)
+
+### :\_cursor_right_
+
+    Vedeu.trigger(:_cursor_right_, name)
+    Vedeu.trigger(:_cursor_right_, Vedeu.focus)
+

data/docs/events/application.md

@@ -2,7 +2,7 @@
 
 ## Application Events
 
-### :_goto_
+### :\_goto_
 Call a client application controller's action with parameters.
 
     Vedeu.trigger(:_goto_,

data/docs/events/document.md

@@ -4,29 +4,29 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_editor_execute_
+### :\_editor_execute_
 
     Vedeu.trigger(:_editor_execute_, name)
 
-### :_editor_delete_character_
+### :\_editor_delete_character_
 This event attempts to delete the character in the named
 document at the current virtual cursor position.
 
     Vedeu.trigger(:_editor_delete_character_, name)
 
-### :_editor_delete_line_
+### :\_editor_delete_line_
 This event attempts to delete the line in the named document
 at the current virtual cursor position.
 
     Vedeu.trigger(:_editor_delete_line_, name)
 
-### :_editor_down_
+### :\_editor_down_
 This event attempts to move the virtual cursor down by one
 line in the named document.
 
     Vedeu.trigger(:_editor_down_, name)
 
-### :_editor_insert_character_
+### :\_editor_insert_character_
 This event attempts to insert the given character in the named
 document at the current virtual cursor position.
 
@@ -34,25 +34,25 @@ Note: 'character' is a string.
 
     Vedeu.trigger(:_editor_insert_character_, name, character)
 
-### :_editor_insert_line_
+### :\_editor_insert_line_
 This event attempts to insert a new line in the named document
 at the current virtual cursor position.
 
     Vedeu.trigger(:_editor_insert_line_, name)
 
-### :_editor_left_
+### :\_editor_left_
 This event attempts to move the virtual cursor left by one
 character in the named document.
 
     Vedeu.trigger(:_editor_left_, name)
 
-### :_editor_right_
+### :\_editor_right_
 This event attempts to move the virtual cursor right by one
 character in the named document.
 
     Vedeu.trigger(:_editor_right_, name)
 
-### :_editor_up_
+### :\_editor_up_
 This event attempts to move the virtual cursor up by one line
 in the named document.
 

data/docs/events/drb.md

@@ -2,7 +2,7 @@
 
 ## DRB Events
 
-### :_drb_input_
+### :\_drb_input_
 Triggering this event will send input to the running application as
 long as it has the DRb server running.
 
@@ -10,11 +10,11 @@ Note: See {Vedeu::Distributed::Server#input} for parameter details.
 
     Vedeu.trigger(:_drb_input_, data, type)
 
-### :_drb_retrieve_output_
+### :\_drb_retrieve_output_
 
     Vedeu.trigger(:_drb_retrieve_output_)
 
-### :_drb_store_output_
+### :\_drb_store_output_
 Triggering this event with 'data' will push data into the running
 application's virtual buffer.
 
@@ -22,25 +22,25 @@ Note: See {Vedeu::Terminal::Buffer#write} for parameter details.
 
     Vedeu.trigger(:_drb_store_output_, data)
 
-### :_drb_restart_
+### :\_drb_restart_
 Use the DRb server to request the client application to restart.
 
     Vedeu.trigger(:_drb_restart_)
     Vedeu.drb_restart
 
-### :_drb_start_
+### :\_drb_start_
 Use the DRb server to request the client application to start.
 
     Vedeu.trigger(:_drb_start_)
     Vedeu.drb_start
 
-### :_drb_status_
+### :\_drb_status_
 Use the DRb server to request the status of the client application.
 
     Vedeu.trigger(:_drb_status_)
     Vedeu.drb_status
 
-### :_drb_stop_
+### :\_drb_stop_
 Use the DRb server to request the client application to stop.
 
     Vedeu.trigger(:_drb_stop_)

data/docs/events/focus.md

@@ -4,21 +4,21 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_focus_by_name_
+### :\_focus_by_name_
 When triggered with an interface name will focus that interface and
 restore the cursor position and visibility.
 
     Vedeu.trigger(:_focus_by_name_, name) # or
     Vedeu.focus_by_name(name)
 
-### :_focus_next_
+### :\_focus_next_
 When triggered will focus the next visible interface and restore the
 cursor position and visibility.
 
     Vedeu.trigger(:_focus_next_) # or
     Vedeu.focus_next
 
-### :_focus_prev_
+### :\_focus_prev_
 When triggered will focus the previous visible interface and restore
 the cursor position and visibility.
 

data/docs/events/menu.md

@@ -4,55 +4,55 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_menu_bottom_
+### :\_menu_bottom_
 Makes the last menu item the current menu item.
 
     Vedeu.trigger(:_menu_bottom_, name)
 
-### :_menu_current_
+### :\_menu_current_
 Returns the current menu item.
 
     Vedeu.trigger(:_menu_current_, name)
 
-### :_menu_deselect_
+### :\_menu_deselect_
 Deselects all menu items.
 
     Vedeu.trigger(:_menu_deselect_, name)
 
-### :_menu_items_
+### :\_menu_items_
 Returns all the menu items with respective `current` or `selected`
 boolean indicators.
 
     Vedeu.trigger(:_menu_items_, name)
 
-### :_menu_next_
+### :\_menu_next_
 Makes the next menu item the current menu item, until it reaches the
 last item.
 
     Vedeu.trigger(:_menu_next_, name)
 
-### :_menu_prev_
+### :\_menu_prev_
 Makes the previous menu item the current menu item, until it reaches
 the first item.
 
     Vedeu.trigger(:_menu_prev_, name)
 
-### :_menu_selected_
+### :\_menu_selected_
 Returns the selected menu item.
 
     Vedeu.trigger(:_menu_selected_, name)
 
-### :_menu_select_
+### :\_menu_select_
 Makes the current menu item also the selected menu item.
 
     Vedeu.trigger(:_menu_select_, name)
 
-### :_menu_top_
+### :\_menu_top_
 Makes the first menu item the current menu item.
 
     Vedeu.trigger(:_menu_top_, name)
 
-### :_menu_view_
+### :\_menu_view_
 Returns a subset of the menu items; starting at the current item to
 the last item.
 

data/docs/events/movement.md

@@ -4,50 +4,11 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_cursor_origin_
-This event moves the cursor to the interface origin; the top left
-corner of the named interface.
+For cursor related movement events, please refer to
+{file:docs/cursor.md} Cursors.
 
-    Vedeu.trigger(:_cursor_origin_, name)
-    Vedeu.trigger(:_cursor_reset_, name)
 
-### :_cursor_position_
-When triggered will return the current position of the cursor.
-
-    Vedeu.trigger(:_cursor_position_, name)
-
-### :_cursor_reposition_
-Moves the cursor to a relative position inside the interface.
-
-    Vedeu.trigger(:_cursor_reposition_, name, y, x)
-
-### :_cursor_(up, down, left, right)_
-Adjusts the position of the cursor or view.
-
-When a name is not given, the cursor in the interface which is
-currently in focus should move in the direction specified.
-
-    Vedeu.trigger(:_cursor_left_, name)
-    Vedeu.trigger(:_cursor_left_)
-    Vedeu.trigger(:_cursor_right_)
-    Vedeu.trigger(:_cursor_up_)
-    Vedeu.trigger(:_cursor_down_)
-
-- The cursor or view may not be visible, but it will still move if
-  requested.
-- The cursor will not exceed the border or boundary of the interface,
-  or boundary of the visible terminal.
-- The cursor will move freely within the bounds of the interface,
-  irrespective of content.
-- The view will not exceed the boundary of the visible terminal,
-  though its offset may (this means content will appear to have
-  scrolled).
-- The view will move freely within the bounds of the interface,
-  irrespective of content.
-
-### :_view_(up, down, left, right)_
-
-See {file:docs/events.md#\_cursor__up_down_left_right_}
+### :\_view_(up, down, left, right)_
 
 Please note that the name of the view is required for these events.
 
@@ -56,4 +17,4 @@ Please note that the name of the view is required for these events.
     Vedeu.trigger(:_view_right_, name)
     Vedeu.trigger(:_view_up_, name)
 
-Each of the :_view_* events has an alias, :_geometry_* if you prefer.
+Each of the :\_view_* events has an alias, :\_geometry_* if you prefer.

data/docs/events/refresh.md

@@ -4,7 +4,7 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_refresh_
+### :\_refresh_
 Refreshes all registered interfaces.
 
 The interfaces will be refreshed in z-index order, meaning that
@@ -14,28 +14,28 @@ will be still refreshed in memory but not shown.
 
     Vedeu.trigger(:_refresh_)
 
-### :_refresh_border_
+### :\_refresh_border_
 Will cause the named border to refresh.
 
     Vedeu.trigger(:_refresh_border_, name)
 
-### :_refresh_cursor_
+### :\_refresh_cursor_
 Will cause the named cursor to refresh, or the cursor of the interface
 which is currently in focus.
 
     Vedeu.trigger(:_refresh_cursor_, name)
 
-### :_refresh_group_
+### :\_refresh_group_
 Will cause all interfaces in the named group to refresh.
 
     Vedeu.trigger(:_refresh_group_, name)
 
-### :_refresh_view_
+### :\_refresh_view_
 Will cause the named view to refresh.
 
     Vedeu.trigger(:_refresh_view_, name)
 
-### :_refresh_view_content_
+### :\_refresh_view_content_
 Will cause only the content of the named view to refresh.
 
     Vedeu.trigger(:_refresh_view_content_, name)

data/docs/events/system.md

@@ -2,7 +2,7 @@
 
 ## System Events
 
-### :_cleanup_
+### :\_cleanup_
 Vedeu triggers this event when `:_exit_` is triggered. You can hook
 into this to perform a special action before the application
 terminates. Saving the user's work, session or preferences might be
@@ -10,13 +10,13 @@ popular here.
 
     Vedeu.trigger(:_exit_)
 
-### :_command_
+### :\_command_
 Will cause the triggering of the `:command` event; which you should
 define to 'do things'.
 
     Vedeu.trigger(:_command_, command)
 
-### :_editor_
+### :\_editor_
 This event is called by {Vedeu::Input::Capture#read}. When
 invoked, the key will be passed to the editor for currently
 focussed view.
@@ -26,21 +26,21 @@ represented by Symbols.
 
     Vedeu.trigger(:_editor_, key)
 
-### :_exit_
+### :\_exit_
 When triggered, Vedeu will trigger a `:cleanup` event which you can
 define (to save files, etc) and attempt to exit.
 
     Vedeu.trigger(:_exit_)
     Vedeu.exit
 
-### :_initialize_
+### :\_initialize_
 Vedeu triggers this event when it is ready to enter the main loop.
 Client applications can listen for this event and perform some
 action(s), like render the first screen, interface or make a sound.
 
     Vedeu.trigger(:_initialize_)
 
-### :_keypress_
+### :\_keypress_
 Will cause the triggering of the `:key` event; which you should define
 to 'do things'. If the `escape` key is pressed, then `key` is
 triggered with the argument `:escape`, also an internal event
@@ -50,7 +50,7 @@ can be found here: {Vedeu::Input::Capture}.
 
     Vedeu.trigger(:_keypress_, key)
 
-### :_log_
+### :\_log_
 When triggered with a message will cause Vedeu to log the message if
 logging is enabled in the configuration.
 
@@ -58,7 +58,7 @@ Note: 'message' is a String.
 
     Vedeu.trigger(:_log_, message)
 
-### :_mode_switch_
+### :\_mode_switch_
 When triggered (by default, after the user presses `escape`), Vedeu
 switches between modes of the terminal. The idea here being
 that the raw mode is for single keypress actions, whilst fake and

data/docs/events/view.md

@@ -4,20 +4,20 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_maximise_
+### :\_maximise_
 Maximising an interface.
 
     Vedeu.trigger(:_maximise_, name)
 
 See {Vedeu::Geometry::Geometry#maximise}
 
-### :_resize_
+### :\_resize_
 When triggered will cause Vedeu to trigger the `:_clear_` and
 `:_refresh_` events. Please see those events for their behaviour.
 
     Vedeu.trigger(:_resize_)
 
-### :_unmaximise_
+### :\_unmaximise_
 Unmaximising an interface.
 
     Vedeu.trigger(:_unmaximise_, name)

data/docs/events/visibility.md

@@ -4,32 +4,32 @@
 
 Note: 'name' is a Symbol unless mentioned otherwise.
 
-### :_clear_
+### :\_clear_
 Clears the whole terminal space.
 
     Vedeu.trigger(:_clear_)
     Vedeu.clear
 
-### :_clear_group_
+### :\_clear_group_
 Clears the spaces occupied by the interfaces belonging to the named
 group.
 
     Vedeu.trigger(:_clear_group_, name)
     Vedeu.clear_by_group(name)
 
-### :_clear_view_
+### :\_clear_view_
 Clears the named view/interface area.
 
     Vedeu.trigger(:_clear_view_, name)
     Vedeu.clear_by_name(name)
 
-### :_clear_view_content_
+### :\_clear_view_content_
 Clears only the content of the named view/interface area.
 
     Vedeu.trigger(:_clear_view_content_, name)
     Vedeu.clear_content_by_name(name)
 
-### :_hide_cursor_
+### :\_hide_cursor_
 Hide the cursor of the named interface or when a name is not given,
 the interface currently in focus.
 
@@ -37,19 +37,19 @@ the interface currently in focus.
     Vedeu.trigger(:_cursor_hide_, name)
     Vedeu.hide_cursor(name)
 
-### :_hide_group_
+### :\_hide_group_
 Hiding a group of interfaces.
 
     Vedeu.trigger(:_hide_group_, name)
     Vedeu.hide_group(name)
 
-### :_hide_interface_
+### :\_hide_interface_
 Hide an interface by name.
 
     Vedeu.trigger(:_hide_interface_, name)
     Vedeu.hide_interface(name)
 
-### :_show_cursor_
+### :\_show_cursor_
 Show the cursor of the named interface or when a name is not given,
 the interface currently in focus.
 
@@ -57,31 +57,31 @@ the interface currently in focus.
     Vedeu.trigger(:_cursor_show_, name)
     Vedeu.show_cursor(name)
 
-### :_show_group_
+### :\_show_group_
 Showing a group of interfaces.
 
     Vedeu.trigger(:_show_group_, name)
     Vedeu.show_group(name)
 
-### :_show_interface_
+### :\_show_interface_
 Show an interface by name.
 
     Vedeu.trigger(:_show_interface_, name)
     Vedeu.show_interface(name)
 
-### :_toggle_cursor_
+### :\_toggle_cursor_
 Toggling a cursor.
 
     Vedeu.trigger(:_toggle_cursor_, name)
     Vedeu.toggle_cursor(name)
 
-### :_toggle_group_
+### :\_toggle_group_
 Toggling a group of interfaces.
 
     Vedeu.trigger(:_toggle_group_, name)
     Vedeu.toggle_group(name)
 
-### :_toggle_interface_
+### :\_toggle_interface_
 Toggling an interface.
 
     Vedeu.trigger(:_toggle_interface_, name)

data/docs/geometry.md

@@ -24,5 +24,5 @@ of the terminal.
 - Geometry can be maximised- to use all the available terminal space.
 - It can also be unmaximised- to return to the pre-defined dimensions
   as mentioned above.
-- Geometry like a {file:docs/cursorr.md} Cursor, via events can be
+- Geometry like a {file:docs/cursor.md Cursor}, via events can be
   moved; left, right, up or down.

data/docs/interfaces.md

@@ -6,7 +6,7 @@ Think of interfaces as being discrete sections of the terminal space.
 - It has a name, which all other aspects of Vedeu will be related.
 - It has a size, in terms of a width and height, determined by
   {file:docs/geometry.md Geometry}.
-- It can have a {file:docs/border.md} Border.
+- It can have a {file:docs/border.md Border}.
 - It can be part of a {file:docs/group.md Group}.
 - An interface is empty unless it has an associated
   {file:docs/view.md View}.

data/examples/hello_worlds.rb

@@ -13,7 +13,10 @@ require 'vedeu'
 #
 class HelloWorldsApp
 
-  Vedeu.bind(:_initialize_) { Vedeu.trigger(:_refresh_) }
+  Vedeu.bind(:_initialize_) {
+    Vedeu.trigger(:_show_view_, :hello)
+    Vedeu.trigger(:_refresh_)
+  }
 
   Vedeu.configure do
     # Empty configure block is needed.
@@ -69,6 +72,7 @@ class HelloWorldsApp
           line
           line { centre "Press 'q' to exit,",     width: 24 }
           line { centre " 'w' to switch worlds.", width: 24 }
+          line { centre "#{Vedeu.trigger(:_cursor_position_, Vedeu.focus)" }
         end
       end
     end

data/lib/vedeu/bindings/all.rb

@@ -21,6 +21,7 @@ module Vedeu
 end # Vedeu
 
 require 'vedeu/bindings/application'
+require 'vedeu/bindings/cursors'
 require 'vedeu/bindings/document'
 require 'vedeu/bindings/drb'
 require 'vedeu/bindings/menus'

data/lib/vedeu/bindings/bindings.rb

@@ -11,6 +11,7 @@ module Vedeu
       Vedeu::Events::Repository.reset!
 
       Vedeu::Bindings::Application.setup!
+      Vedeu::Bindings::Cursors.setup!
       Vedeu::Bindings::Document.setup!
       Vedeu::Bindings::DRB.setup!
       Vedeu::Bindings::Focus.setup!
@@ -30,6 +31,7 @@ module Vedeu
     # @return [TrueClass]
     def setup_aliases!
       Vedeu::Bindings::Application.setup_aliases!
+      Vedeu::Bindings::Cursors.setup_aliases!
       Vedeu::Bindings::Movement.setup_aliases!
       Vedeu::Bindings::Visibility.setup_aliases!
 

data/lib/vedeu/bindings/cursors.rb

@@ -0,0 +1,101 @@
+module Vedeu
+
+  module Bindings
+
+    # System events relating to movement of cursors.
+    #
+    module Cursors
+
+      extend self
+
+      # Setup events relating to movement. This method is called by
+      # Vedeu.
+      #
+      # @return [TrueClass]
+      def setup!
+        cursor_left!
+        cursor_down!
+        cursor_up!
+        cursor_right!
+        cursor_origin!
+        cursor_position!
+        cursor_reposition!
+      end
+
+      # @return [TrueClass]
+      def setup_aliases!
+        Vedeu.bind_alias(:_cursor_reset_, :_cursor_origin_)
+      end
+
+      private
+
+      # :nocov:
+
+      # See {file:docs/cursors.md}
+      def cursor_left!
+        Vedeu.bind(:_cursor_left_) do |name|
+          Vedeu.cursors.by_name(name).move_left
+
+          Vedeu.trigger(:_refresh_cursor_, name)
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_down!
+        Vedeu.bind(:_cursor_down_) do |name|
+          Vedeu.cursors.by_name(name).move_down
+
+          Vedeu.trigger(:_refresh_cursor_, name)
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_up!
+        Vedeu.bind(:_cursor_up_) do |name|
+          Vedeu.cursors.by_name(name).move_up
+
+          Vedeu.trigger(:_refresh_cursor_, name)
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_right!
+        Vedeu.bind(:_cursor_right_) do |name|
+          Vedeu.cursors.by_name(name).move_right
+
+          Vedeu.trigger(:_refresh_cursor_, name)
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_origin!
+        Vedeu.bind(:_cursor_origin_) do |name|
+          Vedeu.cursors.by_name(name).move_origin
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_position!
+        Vedeu.bind(:_cursor_position_) do |name|
+          Vedeu.cursors.by_name(name).to_a
+        end
+      end
+
+      # See {file:docs/cursors.md}
+      def cursor_reposition!
+        Vedeu.bind(:_cursor_reposition_) do |name, y, x|
+          Vedeu.cursors.by_name(name).reposition(y, x)
+
+          Vedeu.trigger(:_clear_view_, name)
+          Vedeu.trigger(:_refresh_view_, name)
+          Vedeu.trigger(:_refresh_cursor_, name)
+        end
+      end
+
+      # :nocov:
+
+    end # Cursors
+
+  end # Bindings
+
+end # Vedeu

data/lib/vedeu/bindings/movement.rb

@@ -2,7 +2,7 @@ module Vedeu
 
   module Bindings
 
-    # System events relating to movement of cursors or interfaces.
+    # System events relating to movement of interfaces.
     #
     module Movement
 
@@ -13,9 +13,6 @@ module Vedeu
       #
       # @return [TrueClass]
       def setup!
-        cursor_origin!
-        cursor_position!
-        cursor_reposition!
         directional!
       end
 
@@ -25,23 +22,15 @@ module Vedeu
           Vedeu.bind_alias(:"_geometry_#{direction}_",
                            :"_view_#{direction}_")
         end
-
-        Vedeu.bind_alias(:_cursor_reset_, :_cursor_origin_)
       end
 
       private
 
       # :nocov:
 
-      # See {file:docs/events/movement.md#\_cursor_up_down_left_right_}
+      # See {file:docs/events/movement.md#\_view_up_down_left_right_}
       def directional!
         %w(down left right up).each do |direction|
-          Vedeu.bind(:"_cursor_#{direction}_") do |name|
-            Vedeu.cursors.by_name(name).send("move_#{direction}")
-
-            Vedeu.trigger(:_refresh_cursor_, name)
-          end
-
           Vedeu.bind(:"_view_#{direction}_") do |name|
             Vedeu.geometries.by_name(name).send("move_#{direction}")
 
@@ -53,31 +42,6 @@ module Vedeu
         end
       end
 
-      # See {file:docs/events/movement.md#\_cursor_origin_}
-      def cursor_origin!
-        Vedeu.bind(:_cursor_origin_) do |name|
-          Vedeu.cursors.by_name(name).move_origin
-        end
-      end
-
-      # See {file:docs/events/movement.md#\_cursor_position_}
-      def cursor_position!
-        Vedeu.bind(:_cursor_position_) do |name|
-          Vedeu.cursors.by_name(name).position
-        end
-      end
-
-      # See {file:docs/events/movement.md#\_cursor_reposition_}
-      def cursor_reposition!
-        Vedeu.bind(:_cursor_reposition_) do |name, y, x|
-          Vedeu.cursors.by_name(name).reposition(y, x)
-
-          Vedeu.trigger(:_clear_view_, name)
-          Vedeu.trigger(:_refresh_view_, name)
-          Vedeu.trigger(:_refresh_cursor_, name)
-        end
-      end
-
       # :nocov:
 
     end # Movement

data/lib/vedeu/cursors/cursor.rb

@@ -82,6 +82,9 @@ module Vedeu
 
       # Moves the cursor down by one row.
       #
+      #   Vedeu.trigger(:_cursor_down_, name)
+      #   Vedeu.trigger(:_cursor_down_, Vedeu.focus)
+      #
       # @return [Vedeu::Cursors::Cursor]
       def move_down
         @oy += 1
@@ -92,6 +95,9 @@ module Vedeu
 
       # Moves the cursor left by one column.
       #
+      #   Vedeu.trigger(:_cursor_left_, name)
+      #   Vedeu.trigger(:_cursor_left_, Vedeu.focus)
+      #
       # @return [Vedeu::Cursors::Cursor]
       def move_left
         @ox -= 1
@@ -102,6 +108,9 @@ module Vedeu
 
       # Moves the cursor to the top left of the named interface.
       #
+      #   Vedeu.trigger(:_cursor_origin_, name)
+      #   Vedeu.trigger(:_cursor_origin_, Vedeu.focus)
+      #
       # @return [Vedeu::Cursors::Cursor]
       def move_origin
         Vedeu::Cursors::Cursor.store(
@@ -110,6 +119,9 @@ module Vedeu
 
       # Moves the cursor right by one column.
       #
+      #   Vedeu.trigger(:_cursor_right_, name)
+      #   Vedeu.trigger(:_cursor_right_, Vedeu.focus)
+      #
       # @return [Vedeu::Cursors::Cursor]
       def move_right
         @ox += 1
@@ -120,6 +132,9 @@ module Vedeu
 
       # Moves the cursor up by one row.
       #
+      #   Vedeu.trigger(:_cursor_up_, name)
+      #   Vedeu.trigger(:_cursor_up_, Vedeu.focus)
+      #
       # @return [Vedeu::Cursors::Cursor]
       def move_up
         @oy -= 1
@@ -150,6 +165,11 @@ module Vedeu
           new_attributes(coordinate.y_position, coordinate.x_position, oy, ox))
       end
 
+      # @return [Array<Fixnum>]
+      def to_a
+        position.to_a
+      end
+
       # Returns an escape sequence to position the cursor and set its
       # visibility. When passed a block, will position the cursor,
       # yield and return the original position.
@@ -166,7 +186,10 @@ module Vedeu
       # currently focussed interface.
       #
       # @example
+      #   Vedeu.trigger(:_hide_cursor_, name)
+      #   Vedeu.trigger(:_hide_cursor_, Vedeu.focus)
       #   Vedeu.hide_cursor(name)
+      #   Vedeu.hide_cursor(Vedeu.focus)
       #
       # @return [Vedeu::Models::Escape]
       def hide
@@ -198,7 +221,10 @@ module Vedeu
       # currently focussed interface.
       #
       # @example
+      #   Vedeu.trigger(:_show_cursor_, name)
+      #   Vedeu.trigger(:_show_cursor_, Vedeu.focus)
       #   Vedeu.show_cursor(name)
+      #   Vedeu.show_cursor(Vedeu.focus)
       #
       # @return [Vedeu::Models::Escape]
       def show

data/lib/vedeu/dsl/view.rb

@@ -244,11 +244,7 @@ module Vedeu
 
         model.add(model.member.build(attributes, &block))
       end
-
-      # @return [Vedeu::Views::Line]
-      def line(value = '')
-        lines { line(value) }
-      end
+      alias_method :line, :lines
 
     end # View
 

data/lib/vedeu/groups/group.rb

@@ -156,7 +156,7 @@ module Vedeu
           members:    Set.new,
           name:       '',
           repository: Vedeu.groups,
-          visible:    false,
+          visible:    true,
         }
       end
 

data/lib/vedeu/models/interface.rb

@@ -116,7 +116,7 @@ module Vedeu
           parent:     nil,
           repository: Vedeu.interfaces,
           style:      :normal,
-          visible:    false,
+          visible:    true,
           zindex:     0,
         }
       end

data/lib/vedeu/version.rb

@@ -1,6 +1,6 @@
 module Vedeu
 
   # The current version of Vedeu.
-  VERSION = '0.6.27'.freeze
+  VERSION = '0.6.28'.freeze
 
 end

data/test/lib/vedeu/bindings/cursors_test.rb

@@ -0,0 +1,24 @@
+require 'test_helper'
+
+module Vedeu
+
+  module Bindings
+
+    describe Cursors do
+
+      context 'the movement events are defined' do
+        it { Vedeu.bound?(:_cursor_down_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_left_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_origin_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_position_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_reposition_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_reset_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_right_).must_equal(true) }
+        it { Vedeu.bound?(:_cursor_up_).must_equal(true) }
+      end
+
+    end # Cursors
+
+  end # Bindings
+
+end # Vedeu

data/test/lib/vedeu/bindings/movement_test.rb

@@ -7,14 +7,6 @@ module Vedeu
     describe Movement do
 
       context 'the movement events are defined' do
-        it { Vedeu.bound?(:_cursor_down_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_left_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_origin_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_position_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_reposition_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_reset_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_right_).must_equal(true) }
-        it { Vedeu.bound?(:_cursor_up_).must_equal(true) }
         it { Vedeu.bound?(:_geometry_down_).must_equal(true) }
         it { Vedeu.bound?(:_geometry_left_).must_equal(true) }
         it { Vedeu.bound?(:_geometry_right_).must_equal(true) }

data/test/lib/vedeu/cursors/cursor_test.rb

@@ -250,6 +250,13 @@ module Vedeu
         it { subject.oy.must_equal(3) }
       end
 
+      describe '#to_a' do
+        subject { instance.to_a }
+
+        it { subject.must_be_instance_of(Array) }
+        it { subject.must_equal([8, 19]) }
+      end
+
       describe '#to_s' do
         let(:visible) { true }
 

data/vedeu.gemspec

@@ -37,5 +37,4 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'ruby-prof', '0.15.8'
   spec.add_dependency 'thor',      '0.19.1'
   spec.add_dependency 'vedeu_cli', '0.0.7'
-
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vedeu
 version: !ruby/object:Gem::Version
-  version: 0.6.27
+  version: 0.6.28
 platform: ruby
 authors:
 - Gavin Laking
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-06 00:00:00.000000000 Z
+date: 2015-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: guard
@@ -299,6 +299,7 @@ files:
 - lib/vedeu/bindings/all.rb
 - lib/vedeu/bindings/application.rb
 - lib/vedeu/bindings/bindings.rb
+- lib/vedeu/bindings/cursors.rb
 - lib/vedeu/bindings/document.rb
 - lib/vedeu/bindings/drb.rb
 - lib/vedeu/bindings/focus.rb
@@ -501,6 +502,7 @@ files:
 - test/lib/vedeu/application/view_test.rb
 - test/lib/vedeu/bindings/application_test.rb
 - test/lib/vedeu/bindings/bindings_test.rb
+- test/lib/vedeu/bindings/cursors_test.rb
 - test/lib/vedeu/bindings/document_test.rb
 - test/lib/vedeu/bindings/drb_test.rb
 - test/lib/vedeu/bindings/focus_test.rb
@@ -714,6 +716,7 @@ test_files:
 - test/lib/vedeu/application/view_test.rb
 - test/lib/vedeu/bindings/application_test.rb
 - test/lib/vedeu/bindings/bindings_test.rb
+- test/lib/vedeu/bindings/cursors_test.rb
 - test/lib/vedeu/bindings/document_test.rb
 - test/lib/vedeu/bindings/drb_test.rb
 - test/lib/vedeu/bindings/focus_test.rb