opal 0.0.1 → 0.1.0

data/opals/foundation/lib/foundation/core/observable_array.rb

@@ -0,0 +1,30 @@
+# 
+# observable_array.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+# Key value coding..
+class Array
+  
+end

data/opals/foundation/lib/foundation/core/responder.rb

@@ -0,0 +1,85 @@
+# 
+# responder.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  # Should not be directly instantiated. Subclasses of CherryKit::Responder can
+  # become part of the responder chain (for events etc)
+  # 
+  class Responder
+    
+    # Getter/setter for the next_responder in the responder chain
+    attr_accessor :next_responder
+    
+    def first_responder?
+      false
+    end
+    
+    # Returns true if the receiver can become the first responder, false
+    # otherwise. Default implementation always returns false.
+    # 
+    # @returns {true|false}
+    # 
+    def accepts_first_responder?
+      false
+    end
+    
+    # ========================
+    # = Mouse event handling =
+    # ========================
+    
+    def mouse_down(event)
+      @next_responder.mouse_down event
+    end
+    
+    # ========================
+    # = Touch event handling =
+    # ========================
+    
+    
+    # Informs the receiver that one or more touches occured within the view
+    # or window.
+    # 
+    # @param {Array} touches array of Touch instances representing the event
+    # @param {Event} event encapsulating all the given touch events
+    # 
+    def touches_began(touches, event)
+      puts "in responder with touches_began!"
+    end
+    
+    def touches_ended(touches, event)
+      
+    end
+    
+    def touches_moved(touches, event)
+      
+    end
+    
+    def touched_cancelled(touches, event)
+      
+    end
+  end
+end

data/opals/foundation/lib/foundation/core/run_loop.rb

@@ -0,0 +1,89 @@
+# 
+# run_loop.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  class RunLoop
+    
+    # A new loop of the run loop. All actions, view drawing etc should be caught
+    # within this runloop and then run one completion
+    def self.run(&block)
+      # 1. make a new runloop
+      run_loop = current_run_loop
+      
+      # 2. run the event/trigger
+      res = `#{block}.apply(#{block}.__self__);`
+      
+      # 3. now run all rendering etc for the runloop
+      @current_run_loop.flush_queue
+      
+      # puts "======= finished run loop"
+      
+      # make sure we destroy our current run loop ready for a new one
+      @current_run_loop = nil
+      
+      # return result of our event handler
+      res
+    end
+    
+    def self.current_run_loop
+      @current_run_loop ||= new
+    end
+    
+    def initialize
+      # object => [task list]
+      @tasks_to_perform = {}
+      # array of tasks in REVERSE order [target, action] - this makes it easier
+      # to loop over all tasks by popping them from the end of the array
+      @ordered_tasks = []
+    end
+    
+    # add the action for the given target
+    # we could splat some args as well to take unlimited args...
+    def add_task(target, action)
+      
+      # puts "adding task for #{target} as #{action}"
+      
+      object_tasks = (@tasks_to_perform[target] || @tasks_to_perform[target] = [])
+      # only do it once..
+      unless object_tasks.include? action
+        object_tasks << action
+        @ordered_tasks.unshift [target, action]
+      end
+      
+      self
+    end
+    
+    # flush the queue
+    def flush_queue
+      `while ((#{task = @ordered_tasks.pop}).r){`
+        task[0].__send__ task[1]
+      `}`
+      
+      @tasks_to_perform = {}
+    end
+  end
+end

data/opals/foundation/lib/foundation/core/touch.rb

@@ -0,0 +1,95 @@
+# 
+# touch.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  class Touch
+    
+    attr_accessor :event
+    
+    attr_accessor :view
+    
+    attr_writer :window
+    
+    # Create a touch object from the native touch object, that will most
+    # probably be gathered straight from the event which created it
+    def self.from_native(native_touch_object)
+      `var result = #{allocate};
+      result.__touch__ = #{native_touch_object};
+      result.__identifier__ = #{native_touch_object}.identifier;
+      var target = #{native_touch_object}.target;
+      //console.log("original target:");
+      //console.log(target.className);
+      while (target) {
+        if (!target.id) {
+          target = target.parentNode; 
+        } else {
+          break;
+        }
+      }
+      
+      //target.style.webkitTransform = "translate3d(0px, 0px, 0px)";
+      
+      result.__target__ = target;
+      
+      result.__pageX__ = #{native_touch_object}.pageX;
+      result.__pageY__ = #{native_touch_object}.pageY;
+            
+      return result;`
+    end
+    
+    def identifier
+      `return #{self}.__identifier__;`
+    end
+    
+    def view
+      return @view if @view
+      element = `#{self}.__target__`
+      @view = CherryKit::View[`#{element}.id`]
+    end
+    
+    def window      
+      @window = view.window
+    end
+    
+    def location_in_client
+      return @location_in_client if @location_in_client
+      
+      @location_in_client = Browser::Point.new `#{self}.__touch__.pageX`, `#{self}.__touch__.pageY`
+    end
+    
+    def location_in_view(view)
+      offset = view.render_context.element.element_offset
+      client = location_in_client
+      
+      Browser::Point.new(client.x - offset.x, client.y - offset.y)
+    end
+    
+    def location_in_window(window)
+      
+    end
+  end
+end

data/opals/foundation/lib/foundation/gestures/gesture_recognizer.rb

@@ -0,0 +1,35 @@
+# 
+# gesture_recognizer.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  class GestureRecognizer
+    
+    def initialize(&action)
+      @action = action
+    end
+  end
+end

data/opals/foundation/lib/foundation/rendering/render_context.rb

@@ -0,0 +1,100 @@
+# 
+# render_context.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  # RenderContext. For now this interacts directly with the DOM. VERY 
+  # inefficient, but enough to get us going
+  # 
+  class RenderContext
+        
+    def initialize(tag_name)
+      @element = Browser::Element.new tag_name
+    end
+    
+    def add_class_name(class_name)
+      if @element.class_name == ""
+        @element.class_name = class_name
+      else
+        @element.class_name = [@element.class_name, class_name].join(" ")
+      end
+    end
+    
+    def id=(id)
+      @element.id = id
+      self
+    end
+    
+    def class_name=(class_name)
+      @element.class_name = class_name
+      self
+    end
+    
+    def <<(string)
+      `#{@element}.__element__.innerHTML += #{string};`
+    end
+    
+    def label(&block)
+      label_context = RenderContext.new :label
+       `#{block}.__fun__(#{label_context});`
+      @element << label_context.element
+    end
+    
+    # hash of class names to true/false values. if true, make sure it is set, if
+    # false unset it
+    # 
+    # @param {Hash} class_names to set/unset
+    # 
+    def set_class_names(class_names)
+      current = @element.class_name.split ' '
+      # puts "need to set_class_names for #{current.inspect}"
+      
+      class_names.each do |class_name, flag|
+        if current.include? class_name.to_s
+          unless flag
+            # need to remove class_name from current array
+            current.delete class_name
+          end
+        else
+          if flag
+            current << class_name
+          end
+        end
+      end
+      
+      @element.class_name = current.join ' '
+    end
+    
+    def css(styles)
+      @element.css styles
+    end
+    
+    def element
+      @element
+    end
+    
+  end
+end

data/opals/foundation/lib/foundation/rendering/renderer.rb

@@ -0,0 +1,137 @@
+# 
+# renderer.rb
+# vienna
+# 
+# Created by Adam Beynon.
+# Copyright 2010 Adam Beynon.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+module CherryKit
+  
+  # Base Renderer class. This is the base class of all renderers. It should be
+  # used for rendering views to the DOM. There are two key methods: render()
+  # which is used for the initial render, and update() which is used to update
+  # a rendering context.
+  # 
+  class Renderer
+    
+    # Renderer initializer. The renderer takes a single parameter, view. The
+    # view is the owner of the renderer and is used by renderers to reference
+    # the view to get updates needed for display, such as the current title etc
+    # 
+    # @param {CherryKit::View} view renderer owner
+    # @param {CherryKit::Theme} theme that this renderer belongs to
+    # 
+    def initialize(view, theme)
+      # puts "in base renderer with view: #{view}"
+      @view = view
+      @theme = theme
+      @class_names = []
+    end
+    
+    def element
+      @element
+    end
+    
+    # Core method to render to the given context. Default action is to do
+    # nothing. The root theme overrides this for the basic behaviour.
+    # 
+    # @param {CherryKit::RenderContext} render_context to render into
+    # @returns {Renderer} self
+    # 
+    def render(render_context)
+      # do nothing
+    end
+    
+    # Core method for updating the render context. Again, default is to do
+    # nothing, but root theme overrides this.
+    # 
+    # We do not take a param because we interact with the DOM directly. We only
+    # use a render context when first making the view, i.e. in render()
+    # 
+    def update()
+      
+    end
+    
+    # Theme attribute.
+    # 
+    # This method is used to define some theme values that the views might need
+    # access to for calculating various proerpties. For example, a slider will
+    # need to know how much the track is indented from the boundry of the view,
+    # and so this method will allow a simple and easy customization for that
+    # property to make theme independant values.
+    # 
+    # values can either be a hash:
+    # 
+    #     theme_attribute :control_size,
+    #       :small    => 10,
+    #       :regular  => 20,
+    #       :large    => 30
+    # 
+    # which will define the following methods:
+    # 
+    #     def theme_attribute_for_control_size_small
+    #       10
+    #     end
+    # 
+    #     def theme_attribute_for_control_size_regular
+    #       20
+    #     end
+    # 
+    # or a single value
+    #   
+    #     theme_attribute :min_size, 100
+    # 
+    # which will define the following method
+    # 
+    #     def theme_attribute_for_min_size
+    #       100
+    #     end
+    # 
+    # These will be accessed by the views using either
+    # 
+    #     renderer.theme_attribute_for :control_size, :regular
+    # 
+    # or..
+    # 
+    #     renderer.theme_attribute_for :min_size
+    # 
+    # Any method which you need custom code to calculate values, simply just
+    # create a method matching the previous formats so that it will be called
+    # instead.
+    # 
+    def self.theme_attribute(attribute_name, values)
+      
+    end
+    
+    # get theme attribute
+    def theme_attribute_for(name, second)
+      `if (!#{second}) #{second} = #{nil};`
+      
+      if second
+        __send__ "theme_attribute_for_#{name}_#{second}"
+      else
+        __send__ "theme_attribute_for_#{name}"
+      end
+    end
+
+  end
+end