cura 0.0.1

data/lib/cura/component/textbox.rb

@@ -0,0 +1,118 @@
+if Kernel.respond_to?(:require)
+  require "cura/component/label"
+  require "cura/key"
+end
+
+module Cura
+  module Component
+    
+    # A component containing editable text.
+    class Textbox < Label
+      
+      on_event(:focus) do
+        set_cursor_position
+        
+        cursor.show
+      end
+      
+      on_event(:unfocus) { cursor.hide }
+      
+      on_event(:key_down) do |event|
+        if event.target == self
+          if event.name == :backspace
+            self.text = text[0..-2] # TODO: Should delete the charactor before the cursor when it is movable
+          elsif event.name == :space
+            text << " "
+          # elsif event.name == :enter # TODO: if multiline?
+          #   self.text << "\n"
+          elsif event.printable?
+            text << event.character
+          end
+
+          set_cursor_position
+        end
+      end
+      
+      def initialize(attributes={})
+        @focusable = true
+        @foreground = Cura::Color.black
+        @background = Cura::Color.white
+        
+        super
+        
+        # TODO
+        # @width  = 1 if @width != :auto && @width < 1
+        # @height = 1 if @height != :auto && @height < 1
+      end
+      
+      # Clear all characters within this textbox.
+      #
+      # @return [Textbox]
+      def clear
+        @text = ""
+        
+        set_cursor_position
+        
+        self
+      end
+      
+      # Get the mask character for this textbox.
+      #
+      # @return [String]
+      attr_reader :mask_character
+      
+      # Set the mask character for this textbox.
+      # Set to anything for a "password" textbox. Only the first character of whatever is given is used.
+      #
+      # @param [#to_s] value
+      # @return [String]
+      def mask_character=(value)
+        value = value.to_s.strip[0]
+        value = nil if value.empty?
+        
+        @mask_character = value
+      end
+      
+      # Set the width of this textbox.
+      #
+      # @param [#to_i] value
+      # @return [Integer]
+      def width=(value)
+        super
+        
+        @width = 1 if @width < 1
+      end
+      
+      # Set the height of this textbox.
+      #
+      # @param [#to_i] value
+      # @return [Integer]
+      def height=(value)
+        super
+        
+        @height = 1 if @height < 1
+      end
+      
+      protected
+      
+      def text_to_draw
+        return text if text.length <= width
+
+        focused? ? text[-width..-1] : text[0...width]
+      end
+      
+      def character_to_draw(character)
+        @mask_character.nil? ? character : @mask_character
+      end
+      
+      def set_cursor_position
+        last_line_length = lines.last.nil? ? 0 : lines.last.length
+        
+        cursor.x = absolute_x + offsets.left + (text.length < width ? last_line_length : width - 1)
+        cursor.y = absolute_y + offsets.top + text_height - 1
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/cursor.rb

@@ -0,0 +1,77 @@
+if Kernel.respond_to?(:require)
+  require "cura/attributes/has_initialize"
+  require "cura/attributes/has_application"
+  require "cura/attributes/has_coordinates"
+end
+
+module Cura
+  
+  # The text cursor controller.
+  #
+  # Should only ever have one single Cursor instance at one time.
+  # TODO: Rename Cursor::Text, need Cursor::Mouse
+  class Cursor
+    
+    include Attributes::HasInitialize
+    include Attributes::HasApplication
+    include Attributes::HasCoordinates
+    
+    def initialize(attributes={})
+      @hidden = true
+      
+      super
+      
+      raise ArgumentError, "application must be set" if application.nil?
+    end
+    
+    # Check if the cursor is hidden.
+    #
+    # @return [Boolean]
+    def hidden?
+      !!@hidden
+    end
+    
+    # Set if the cursor is hidden.
+    #
+    # @param [Boolean] value
+    # @return [Boolean]
+    def hidden=(value)
+      value = !!value
+      
+      @hidden = value
+    end
+    
+    # Show the cursor.
+    #
+    # @return [Cursor]
+    def show
+      @hidden = false
+      
+      self
+    end
+    
+    # Hide the cursor.
+    #
+    # @return [Cursor]
+    def hide
+      @hidden = true
+      
+      self
+    end
+    
+    # Draw (set) the cursor.
+    #
+    # @return [Cursor]
+    def update # TODO: Refactor for speed, this can't be effecient
+      if @hidden
+        application.adapter.hide_cursor
+      else
+        application.adapter.set_cursor(@x, @y)
+      end
+      
+      self
+    end
+    
+  end
+  
+end

data/lib/cura/error/base.rb

@@ -0,0 +1,10 @@
+module Cura
+  module Error
+    
+    # The base class for errors.
+    class Base < StandardError
+      
+    end
+    
+  end
+end

data/lib/cura/error/invalid_adapter.rb

@@ -0,0 +1,18 @@
+if Kernel.respond_to?(:require)
+  require "cura/error/base"
+end
+
+module Cura
+  module Error
+    
+    # Raised when an adapter is invalid.
+    class InvalidAdapter < Base
+      
+      def to_s
+        "The adapter is invalid." # TODO: Better message
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/error/invalid_application.rb

@@ -0,0 +1,18 @@
+if Kernel.respond_to?(:require)
+  require "cura/error/base"
+end
+
+module Cura
+  module Error
+    
+    # Raised when an application is invalid.
+    class InvalidApplication < Base
+      
+      def to_s
+        "must nil or be a Cura::Application"
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/error/invalid_color.rb

@@ -0,0 +1,18 @@
+if Kernel.respond_to?(:require)
+  require "cura/error/base"
+end
+
+module Cura
+  module Error
+    
+    # Raised when a color is invalid.
+    class InvalidColor < Base
+      
+      def to_s
+        "must be a Cura::Color or :inherit"
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/error/invalid_component.rb

@@ -0,0 +1,18 @@
+if Kernel.respond_to?(:require)
+  require "cura/error/base"
+end
+
+module Cura
+  module Error
+    
+    # Raised when a component is invalid.
+    class InvalidComponent < Base
+      
+      def to_s
+        "must be a Cura::Component::Base"
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/error/invalid_middleware.rb

@@ -0,0 +1,18 @@
+if Kernel.respond_to?(:require)
+  require "cura/error/base"
+end
+
+module Cura
+  module Error
+    
+    # Raised when middleware is invalid.
+    class InvalidMiddleware < Base
+      
+      def to_s
+        "must respond to #call."
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/event.rb

@@ -0,0 +1,38 @@
+module Cura
+  
+  # The container for Event::Base and it's subclasses.
+  module Event
+    class << self
+      
+      # Get all Event::Base subclasses.
+      #
+      # @return [Array<Class>]
+      def all
+        @all ||= []
+      end
+      
+      # Find an Event::Base subclass by it's name.
+      #
+      # @param [#to_sym] name The name of the event. For example, `SomeAction` would be `:some_action`.
+      # @return [nil, Class] The Event::Base subclass.
+      def find_by_name(name)
+        name = name.to_sym
+        
+        all.find { |event_class| event_class.name == name }
+      end
+      
+      # Initialize an Event::Base subclass by it's name.
+      #
+      # @param [#to_sym] name The name of the event class.
+      def new_from_name(name, attributes={})
+        # TODO: name should be a string formatted like so 'mouse:button:down' which would correspond to Cura::Event::Mouse::Button::Down
+        event_class = find_by_name(name)
+        raise ArgumentError, "Unknown event name '#{name}'" if event_class.nil?
+        
+        event_class.new(attributes)
+      end
+      
+    end # << self
+  end
+  
+end

data/lib/cura/event/base.rb

@@ -0,0 +1,108 @@
+if Kernel.respond_to?(:require)
+  require "cura/attributes/has_initialize"
+  require "cura/attributes/has_attributes"
+  require "cura/attributes/has_events"
+  
+  require "cura/event"
+end
+
+module Cura
+  module Event
+    
+    # The base class for all events.
+    class Base
+      
+      class << self
+        
+        # Get the name of this class as a symbol.
+        # For example, `SomeAction` would be `:some_action`.
+        #
+        # @return [Symbol]
+        def name
+          # Note: 1.3 times faster but relys on Regexp and is the only usage of regexp throughout cura.
+          #       Using non regexp version until multiple usages of regexp occur within cura.
+          # to_s.split(/::/).last.gsub(/([a-z])([A-Z])/, '\1_\2').downcase.to_sym
+          
+          # Note: MRuby does not have a #chars method so this is now 2.6 times slower instead of 1.3
+          caps = ("A".."Z")
+          index = 0
+          to_s.split("::").last.split("").each_with_object("") { |char, memo|
+            memo << "_" if index > 0 && caps.include?(char)
+            memo << char
+            index += 1
+          }.downcase.to_sym
+        end
+        
+        # Add the subclass to `Event.all`, when inherited.
+        def inherited(subclass)
+          Event.all << subclass
+        end
+        
+      end # << self
+      
+      include Attributes::HasInitialize
+      include Attributes::HasAttributes
+      
+      def initialize(attributes={})
+        @created_at = Time.now
+        
+        super
+      end
+      
+      # Get the time this event was created.
+      #
+      # @return [Time]
+      attr_reader :created_at
+      
+      # Get the target this event was dispatched to.
+      # TODO: Rename to source.
+      #       The source is the component the event was originally sent to.
+      #       The target is the component the event is currently being handled by. <- Needed?
+      #
+      # @return [Cura::Attributes::HasEvents]
+      attr_reader :target
+      
+      # Set the target this event was dispatched to.
+      #
+      # @param [Cura::Attributes::HasEvents] value
+      # @return [Cura::Attributes::HasEvents]
+      def target=(value)
+        raise TypeError, "target must be a Cura::Attributes::HasEvents" unless value.is_a?(Cura::Attributes::HasEvents) # TODO: Error::Event::InvalidTarget
+        
+        @target = value
+      end
+      
+      # Get this event as a Hash.
+      #
+      # @return [Hash]
+      def to_h
+        { name: self.class.name }
+      end
+      
+      # Check if something is equivalent to this event.
+      #
+      # @param [Object] other The object to check equivalence with.
+      # @return [Boolean]
+      def ==(other)
+        # TODO: Below is needed?
+        # object_equivalence = super
+        # return true if object_equivalence
+        
+        other = other.to_h if other.respond_to?(:to_h)
+        
+        other == to_h
+      end
+      
+      # Dispatches this event directly to it's target.
+      #
+      # @return [Event::Base] This event.
+      def dispatch
+        target.event_handler.handle(self)
+        
+        self
+      end
+      
+    end
+    
+  end
+end