puffer 0.0.12 → 0.0.13

data/lib/puffer/base.rb

@@ -5,9 +5,12 @@ module Puffer
     include Puffer::Controller::Mutate
     include Puffer::Controller::Helpers
     include Puffer::Controller::Dsl
+    include Puffer::Controller::Mapping
     include Puffer::Controller::Config
     include Puffer::Controller::Generated
 
+    define_fields :index, :show, :form, :create, :update
+
     respond_to :html, :js
 
     def index

data/lib/puffer/controller/dsl.rb

@@ -5,14 +5,6 @@ module Puffer
       def self.included base
         base.class_eval do
           extend ClassMethods
-          include ActionMethods
-          extend ActionMethods
-
-          %w(index show form create update).each do |action|
-            class_attribute "_#{action}_fields"
-            send "_#{action}_fields=", Puffer::Fields.new unless send("_#{action}_fields?")
-            helper_method "#{action}_fields"
-          end
 
           class_attribute :_members
           self._members = Puffer::Controller::Actions.new
@@ -37,11 +29,27 @@ module Puffer
           block.bind(_collections).call if block_given?
         end
 
-        %w(index show form create update).each do |action|
-          define_method action do |&block|
-            @_fields = send("_#{action}_fields=", Puffer::Fields.new)
-            block.call if block
-            remove_instance_variable :@_fields
+        def define_fields *actions
+          actions.each do |action|
+            class_attribute "_#{action}_fields"
+            send "_#{action}_fields=", Puffer::Fields.new unless send("_#{action}_fields?")
+            helper_method "#{action}_fields"
+
+            self.class.instance_eval do
+              define_method action do |&block|
+                @_fields = send("_#{action}_fields=", Puffer::Fields.new)
+                block.call if block
+                remove_instance_variable :@_fields
+              end
+
+              define_method "#{action}_fields" do
+                send "_#{action}_fields"
+              end
+            end
+
+            define_method "#{action}_fields" do
+              self.class.send "#{action}_fields"
+            end
           end
         end
 
@@ -53,30 +61,6 @@ module Puffer
 
       end
 
-      module ActionMethods
-
-        def index_fields
-          _index_fields
-        end
-
-        def show_fields
-          _show_fields.presence || _index_fields
-        end
-
-        def form_fields
-          _form_fields
-        end
-
-        def create_fields
-          _create_fields.presence || _form_fields
-        end
-
-        def update_fields
-          _update_fields.presence || _form_fields
-        end
-
-      end
-
     end
   end
 end

data/lib/puffer/controller/generated.rb

@@ -23,7 +23,7 @@ module Puffer
           end
 
           collection do
-            get "associated_#{field}_choosing"
+            get "associated_#{field}_choosing", :display => false
           end
         end
 
@@ -44,8 +44,8 @@ module Puffer
           end
 
           collection do
-            get "associated_#{field}"
-            get "associated_#{field}_choosing"
+            get "associated_#{field}", :display => false
+            get "associated_#{field}_choosing", :display => false
           end
         end
 

data/lib/puffer/controller/helpers.rb

@@ -18,7 +18,7 @@ module Puffer
         end
 
         def model
-          @model ||= model_name.classify.constantize rescue nil
+          @model ||= model_name.classify.constantize
         end
 
       end

data/lib/puffer/controller/mapping.rb

@@ -0,0 +1,37 @@
+module Puffer
+  module Controller
+    module Mapping
+
+      def self.included base
+        base.class_eval do
+          extend ClassMethods
+        end
+      end
+
+      module ClassMethods
+
+        def index_fields
+          _index_fields
+        end
+
+        def show_fields
+          _show_fields.presence || _index_fields
+        end
+
+        def form_fields
+          _form_fields
+        end
+
+        def create_fields
+          _create_fields.presence || _form_fields
+        end
+
+        def update_fields
+          _update_fields.presence || _form_fields
+        end
+
+      end
+
+    end
+  end
+end

data/lib/puffer/controller/mutate.rb

@@ -24,6 +24,14 @@ module Puffer
           self.view_paths = temp
         end
 
+        def view_paths_fallbacks_prepend *args
+          view_paths_fallbacks args, view_paths._fallbacks
+        end
+
+        def view_paths_fallbacks_append *args
+          view_paths_fallbacks view_paths._fallbacks, args
+        end
+
         def puffer?; true; end
 
       end

data/lib/puffer/extensions/form.rb

@@ -2,7 +2,12 @@ module Puffer
   module Extensions
     module FormBuilder
 
-      def puffer_field field
+      def puffer_field *args
+        field = if args.first.is_a? Puffer::Fields::Field
+          args.first
+        else
+          Puffer::Fields::Field.new object.class, *args
+        end
         input = Puffer::Inputs.map_field field
         input.new(self, @template, field).render
       end

data/lib/puffer/fields/field.rb

@@ -47,7 +47,7 @@ module Puffer
       end
 
       def input_options
-        {}
+        options[:html] || {}
       end
 
       def model

data/lib/puffer/resource.rb

@@ -94,9 +94,12 @@ module Puffer
       end
     end
 
+    def collection_scope
+      parent ? parent.member.send(model_name.pluralize) : model
+    end
+
     def collection
-      scope = parent ? parent.member.send(model_name.pluralize) : model
-      scope.includes(includes).where(searches(params[:search])).order(order).paginate :page => params[:page]
+      collection_scope.includes(includes).where(searches(params[:search])).order(order).paginate :page => params[:page]
     end
 
     def member

data/puffer.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{puffer}
-  s.version = "0.0.12"
+  s.version = "0.0.13"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["pyromaniac"]
-  s.date = %q{2011-02-05}
+  s.date = %q{2011-02-07}
   s.description = %q{In Soviet Russia puffer admins you}
   s.email = %q{kinwizard@gmail.com}
   s.extra_rdoc_files = [
@@ -61,6 +61,7 @@ Gem::Specification.new do |s|
     "lib/puffer/controller/dsl.rb",
     "lib/puffer/controller/generated.rb",
     "lib/puffer/controller/helpers.rb",
+    "lib/puffer/controller/mapping.rb",
     "lib/puffer/controller/mutate.rb",
     "lib/puffer/engine.rb",
     "lib/puffer/extensions/activerecord.rb",

data/spec/dummy/public/puffer/javascripts/puffer.js

@@ -1,5 +1,5 @@
 var association_done = function(event) {
-  current = this.first('li.current')
+  current = this.first('li.current');
   this.input.next('input[type=hidden]').value(current.get('data-id'));
   this.input.value(current.find('.title').first().html().stripTags()).disable();
 }

data/spec/dummy/public/puffer/javascripts/right-autocompleter.js

@@ -4,15 +4,618 @@
  *
  * Copyright (C) 2010 Nikolay Nemshilov
  */
-var Autocompleter=RightJS.Autocompleter=function(h,c){function l(a,b,d,e){if(c.Fx)if(d===undefined){d=a.options.fxName;if(e===undefined){e={duration:a.options.fxDuration,onFinish:c(a.fire).bind(a,b)};if(b==="hide")e.duration=(c.Fx.Durations[e.duration]||e.duration)/2}}if(!c.Fx||!d)a.fire(b);return a.$super(d,e)}function m(a,b,d){var e=(this.reAnchor||(this.reAnchor=new c.Element("div",{"class":"rui-re-anchor"})).insert(this)).insertTo(a,"after").position(),f=a.dimensions(),i=parseInt(a.getStyle("borderTopWidth")),
-j=parseInt(a.getStyle("borderLeftWidth")),q=parseInt(a.getStyle("borderRightWidth")),r=parseInt(a.getStyle("borderBottomWidth"));a=f.top-e.y+i;e=f.left-e.x+j;j=f.width-j-q;f=f.height-i-r;this.setStyle("visibility:hidden").show(null);if(b==="right")e+=j-this.size().x;else a+=f;this.moveTo(e,a);if(d)b==="left"||b==="right"?this.setHeight(f):this.setWidth(j);this.setStyle("visibility:visible").hide(null)}var g=c,n=c.$,s=c.$w,t=c.Xhr,o=c.RegExp,u=c.isArray,p=new c.Class(c.Element,{initialize:function(a){this.$super("div",
-{"class":"rui-spinner"});this.dots=[];for(var b=0;b<(a||4);b++)this.dots.push(new c.Element("div"));this.dots[0].addClass("glowing");this.insert(this.dots);c(this.shift).bind(this).periodical(300)},shift:function(){if(this.visible()){var a=this.dots.pop();this.dots.unshift(a);this.insert(a,"top")}}}),k=new (function(a,b){if(!b){b=a;a="DIV"}var d=new c.Class(c.Element.Wrappers[a]||c.Element,{initialize:function(e,f){this.key=e;var i=[{"class":"rui-"+e}];this instanceof c.Input||this instanceof c.Form||
-i.unshift(a);this.$super.apply(this,i);if(c.isString(f))f=c.$(f);if(f instanceof c.Element){this._=f._;if("$listeners"in f)f.$listeners=f.$listeners;f={}}this.setOptions(f,this);return c.Wrapper.Cache[c.$uid(this._)]=this},setOptions:function(e,f){f=f||this;c.Options.setOptions.call(this,c.Object.merge(e,eval("("+(f.get("data-"+this.key)||"{}")+")")));return this}});d=new c.Class(d,b);c.Observer.createShortcuts(d.prototype,d.EVENTS||[]);return d})("UL",{include:{show:function(a,b){this.constructor.current=
-this;return l(this,"show",a,b)},hide:function(a,b){this.constructor.current=null;return l(this,"show",a,b)},showAt:function(a,b,d){this.hide(null).shownAt=a=c.$(a);m.call(this,a,b,d);return this.show()},toggleAt:function(a,b,d){return this.hidden()?this.showAt(a,b,d):this.hide()}},extend:{version:"2.2.0",EVENTS:s("show hide update load select done"),Options:{url:h.location.href,param:"search",method:"get",minLength:1,threshold:200,cache:true,local:null,fxName:"slide",fxDuration:"short",spinner:"native",
-cssRule:"input[data-autocompleter]"}},initialize:function(a,b){this.input=n(a);this.$super("autocompleter",b).addClass("rui-dd-menu").onMousedown(this.clicked);this.input.autocompleter=this},destroy:function(){delete this.input.autocompleter;return this},prev:function(){return this.pick("prev")},next:function(){return this.pick("next")},done:function(a){if(a=a||this.first("li.current")){a.radioClass("current");this.input.setValue(g(a.html()).stripTags());this.fire("done")}return this.hide()},setOptions:function(a){this.$super(a,
-this.input);a=this.options;g(a.url).includes("%{search}")||(a.url+=(g(a.url).includes("?")?"&":"?")+a.param+"=%{search}")},pick:function(a){var b=this.children(),d=b.first("hasClass","current"),e=b.indexOf(d);if(a=="prev")d=e<1?b.last():b[e<0?0:e-1];else if(a=="next")d=e<0||e==b.length-1?b.first():b[e+1];return this.fire("select",{item:d.radioClass("current")})},clicked:function(a){this.done(a.stop().find("li"))},keypressed:function(){if(this.input.value().length>=this.options.minLength){this.timeout&&
-this.timeout.cancel();this.timeout=g(this.trigger).bind(this).delay(this.options.threshold)}else return this.hide()},trigger:function(){this.timeout=null;this.cache=this.cache||{};var a=this.input.value(),b=this.options;if(a.length<b.minLength)return this.hide();if(this.cache[a])this.suggest(this.cache[a],a);else if(u(b.local))this.suggest(this.findLocal(a),a);else this.request=t.load(b.url.replace("%{search}",encodeURIComponent(a)),{method:b.method,spinner:this.getSpinner(),onComplete:g(function(d){this.fire("load").suggest(d.text,
-a)}).bind(this)})},suggest:function(a,b){if(this.options.cache)this.cache[b]=a;if(g(a).blank())this.hide();else{this.update(a.replace(/<ul[^>]*>|<\/ul>/im,""));this.fire("update");if(!this._connected||this.hidden()){this.showAt(this.input,"bottom","resize");this._connected=true}}return this},findLocal:function(a){var b=new o("("+o.escape(a)+")","ig");return g(this.options.local).map(function(d){if(d.match(b))return"<li>"+d.replace(b,"<strong>$1</strong>")+"</li>"}).compact().join("")},getSpinner:function(){var a=
-this.options,b=a.spinner;if(b=="native"){b=a.spinner=(new p(3)).insertTo(this);b.addClass("rui-autocompleter-spinner")}b instanceof p&&m.call(b,this.input,"right","resize");return b}});n(h).on({focus:function(a){if((a=a.target)&&a instanceof c.Element&&(a.autocompleter||a.match(k.Options.cssRule)))a.autocompleter||new k(a)},blur:function(a){(a=a.target?a.target.autocompleter:null)&&a.visible()&&a.hide()},keydown:function(a){var b=a.target?a.target.autocompleter:null;if(b&&b.visible()){var d={27:"hide",
-38:"prev",40:"next",13:"done"}[a.keyCode];if(d){a.stop();b[d]()}}},keyup:function(a){var b=a.target?a.target.autocompleter:null;b&&!g([9,27,37,38,39,40,13]).include(a.keyCode)&&b.keypressed(a)}});(function(){var a=h.createElement("style"),b=h.createTextNode(" *.rui-dd-menu, *.rui-dd-menu li{margin:0;padding:0;border:none;background:none;list-style:none;font-weight:normal;float:none} *.rui-dd-menu{display:none;position:absolute;z-index:9999;background:white;border:1px solid #BBB;border-radius:.2em;-moz-border-radius:.2em;-webkit-border-radius:.2em;box-shadow:#DDD .2em .2em .4em;-moz-box-shadow:#DDD .2em .2em .4em;-webkit-box-shadow:#DDD .2em .2em .4em} *.rui-dd-menu li{padding:.2em .4em;border-top:none;border-bottom:none;cursor:pointer} *.rui-dd-menu li.current{background:#DDD} *.rui-dd-menu li:hover{background:#EEE}dl.rui-dd-menu dt{padding:.3em .5em;cursor:default;font-weight:bold;font-style:italic;color:#444;background:#EEE}dl.rui-dd-menu dd li{padding-left:1.5em}div.rui-spinner,div.rui-spinner div{margin:0;padding:0;border:none;background:none;list-style:none;font-weight:normal;float:none;display:inline-block; *display:inline; *zoom:1;border-radius:.12em;-moz-border-radius:.12em;-webkit-border-radius:.12em}div.rui-spinner{text-align:center;white-space:nowrap;background:#EEE;border:1px solid #DDD;height:1.2em;padding:0 .2em}div.rui-spinner div{width:.4em;height:70%;background:#BBB;margin-left:1px}div.rui-spinner div:first-child{margin-left:0}div.rui-spinner div.glowing{background:#777}div.rui-re-anchor{margin:0;padding:0;background:none;border:none;float:none;display:inline;position:absolute;z-index:9999}.rui-autocompleter{border-top-color:#DDD !important;border-top-left-radius:0 !important;border-top-right-radius:0 !important;-moz-border-radius-topleft:0 !important;-moz-border-radius-topright:0 !important;-webkit-border-top-left-radius:0 !important;-webkit-border-top-right-radius:0 !important}.rui-autocompleter-spinner{border:none !important;background:none !important;position:absolute;z-index:9999}.rui-autocompleter-spinner div{margin-top:.2em !important; *margin-top:0.1em !important}");
-a.type="text/css";if(a.styleSheet)a.styleSheet.cssText=b.nodeValue;else a.appendChild(b);h.getElementsByTagName("head")[0].appendChild(a)})();return k}(document,RightJS);
+var Autocompleter = RightJS.Autocompleter = (function(document, RightJS) {
+/**
+ * This module defines the basic widgets constructor
+ * it creates an abstract proxy with the common functionality
+ * which then we reuse and override in the actual widgets
+ *
+ * Copyright (C) 2010-2011 Nikolay Nemshilov
+ */
+
+/**
+ * Autocompleter initializer
+ *
+ * Copyright (C) 2010 Nikolay Nemshilov
+ */
+var R       = RightJS,
+    $       = RightJS.$,
+    $w      = RightJS.$w,
+    $E      = RightJS.$E,
+    Xhr     = RightJS.Xhr,
+    RegExp  = RightJS.RegExp,
+    isArray = RightJS.isArray;
+
+
+
+
+
+
+
+
+/**
+ * The widget units constructor
+ *
+ * @param String tag-name or Object methods
+ * @param Object methods
+ * @return Widget wrapper
+ */
+function Widget(tag_name, methods) {
+  if (!methods) {
+    methods = tag_name;
+    tag_name = 'DIV';
+  }
+
+  /**
+   * An Abstract Widget Unit
+   *
+   * Copyright (C) 2010 Nikolay Nemshilov
+   */
+  var AbstractWidget = new RightJS.Class(RightJS.Element.Wrappers[tag_name] || RightJS.Element, {
+    /**
+     * The common constructor
+     *
+     * @param Object options
+     * @param String optional tag name
+     * @return void
+     */
+    initialize: function(key, options) {
+      this.key = key;
+      var args = [{'class': 'rui-' + key}];
+
+      // those two have different constructors
+      if (!(this instanceof RightJS.Input || this instanceof RightJS.Form)) {
+        args.unshift(tag_name);
+      }
+      this.$super.apply(this, args);
+
+      if (RightJS.isString(options)) {
+        options = RightJS.$(options);
+      }
+
+      // if the options is another element then
+      // try to dynamically rewrap it with our widget
+      if (options instanceof RightJS.Element) {
+        this._ = options._;
+        if ('$listeners' in options) {
+          options.$listeners = options.$listeners;
+        }
+        options = {};
+      }
+      this.setOptions(options, this);
+
+      return (RightJS.Wrapper.Cache[RightJS.$uid(this._)] = this);
+    },
+
+  // protected
+
+    /**
+     * Catches the options
+     *
+     * @param Object user-options
+     * @param Element element with contextual options
+     * @return void
+     */
+    setOptions: function(options, element) {
+      element = element || this;
+      RightJS.Options.setOptions.call(this,
+        RightJS.Object.merge(options, eval("("+(
+          element.get('data-'+ this.key) || '{}'
+        )+")"))
+      );
+      return this;
+    }
+  });
+
+  /**
+   * Creating the actual widget class
+   *
+   */
+  var Klass = new RightJS.Class(AbstractWidget, methods);
+
+  // creating the widget related shortcuts
+  RightJS.Observer.createShortcuts(Klass.prototype, Klass.EVENTS || []);
+
+  return Klass;
+}
+
+
+/**
+ * A shared module to create textual spinners
+ *
+ * Copyright (C) 2010-2011 Nikolay Nemshilov
+ */
+var Spinner = new RightJS.Class(RightJS.Element, {
+  /**
+   * Constructor
+   *
+   * @param Number optional spinner size (4 by default)
+   * @return void
+   */
+  initialize: function(size) {
+    this.$super('div', {'class': 'rui-spinner'});
+    this.dots = [];
+
+    for (var i=0; i < (size || 4); i++) {
+      this.dots.push(new RightJS.Element('div'));
+    }
+
+    this.dots[0].addClass('glowing');
+    this.insert(this.dots);
+    RightJS(this.shift).bind(this).periodical(300);
+  },
+
+  /**
+   * Shifts the spinner elements
+   *
+   * @return void
+   */
+  shift: function() {
+    if (this.visible()) {
+      var dot = this.dots.pop();
+      this.dots.unshift(dot);
+      this.insert(dot, 'top');
+    }
+  }
+});
+
+
+/**
+ * A shared module that toggles a widget visibility status
+ * in a uniformed way according to the options settings
+ *
+ * Copyright (C) 2010-2011 Nikolay Nemshilov
+ */
+var Toggler = {
+  /**
+   * Shows the element
+   *
+   * @param String fx-name
+   * @param Object fx-options
+   * @return Element this
+   */
+  show: function(fx_name, fx_options) {
+    this.constructor.current = this;
+    return Toggler_toggle(this, 'show', fx_name, fx_options);
+  },
+
+  /**
+   * Hides the element
+   *
+   * @param String fx-name
+   * @param Object fx-options
+   * @return Element this
+   */
+  hide: function(fx_name, fx_options) {
+    this.constructor.current = null;
+    return Toggler_toggle(this, 'show', fx_name, fx_options);
+  },
+
+  /**
+   * Toggles the widget at the given element
+   *
+   * @param Element the related element
+   * @param String position right/bottom (bottom is the default)
+   * @param Boolean marker if the element should be resized to the element size
+   * @return Widget this
+   */
+  showAt: function(element, where, resize) {
+    this.hide(null).shownAt = element = RightJS.$(element);
+
+    // moves this element at the given one
+    Toggler_re_position.call(this, element, where, resize);
+
+    return this.show();
+  },
+
+  /**
+   * Toggles the widget at the given element
+   *
+   * @param Element the related element
+   * @param String position top/left/right/bottom (bottom is the default)
+   * @param Boolean marker if the element should be resized to the element size
+   * @return Widget this
+   */
+  toggleAt: function(element, where, resize) {
+    return this.hidden() ? this.showAt(element, where, resize) : this.hide();
+  }
+};
+
+
+/**
+ * toggles the element's state according to the current settings
+ *
+ * @param event String 'show' or 'hide' the event name
+ * @param String an optional fx-name
+ * @param Object an optional fx-options hash
+ * @return void
+ */
+function Toggler_toggle(element, event, fx_name, fx_options) {
+  if (RightJS.Fx) {
+    if (fx_name === undefined) {
+      fx_name = element.options.fxName;
+
+      if (fx_options === undefined) {
+        fx_options = {
+          duration: element.options.fxDuration,
+          onFinish: RightJS(element.fire).bind(element, event)
+        };
+
+        // hide on double time
+        if (event === 'hide') {
+          fx_options.duration = (RightJS.Fx.Durations[fx_options.duration] ||
+            fx_options.duration) / 2;
+        }
+      }
+    }
+  }
+
+  // manually trigger the event if no fx were specified
+  if (!RightJS.Fx || !fx_name) { element.fire(event); }
+
+  return element.$super(fx_name, fx_options);
+}
+
+/**
+ * Relatively positions the current element
+ * against the specified one
+ *
+ * NOTE: this function is called in a context
+ *       of another element
+ *
+ * @param Element the target element
+ * @param String position 'right' or 'bottom'
+ * @param Boolean if `true` then the element size will be adjusted
+ * @return void
+ */
+function Toggler_re_position(element, where, resize) {
+  var anchor = this.reAnchor || (this.reAnchor =
+        new RightJS.Element('div', {'class': 'rui-re-anchor'}))
+        .insert(this),
+
+      pos  = anchor.insertTo(element, 'after').position(),
+      dims = element.dimensions(), target = this,
+
+      border_top    = parseInt(element.getStyle('borderTopWidth')),
+      border_left   = parseInt(element.getStyle('borderLeftWidth')),
+      border_right  = parseInt(element.getStyle('borderRightWidth')),
+      border_bottom = parseInt(element.getStyle('borderBottomWidth')),
+
+      top    = dims.top    - pos.y       + border_top,
+      left   = dims.left   - pos.x       + border_left,
+      width  = dims.width  - border_left - border_right,
+      height = dims.height - border_top  - border_bottom;
+
+  // making the element to appear so we could read it's sizes
+  target.setStyle('visibility:hidden').show(null);
+
+  if (where === 'right') {
+    left += width - target.size().x;
+  } else {  // bottom
+    top  += height;
+  }
+
+  target.moveTo(left, top);
+
+  if (resize) {
+    if (where === 'left' || where === 'right') {
+      target.setHeight(height);
+    } else {
+      target.setWidth(width);
+    }
+  }
+
+  // rolling the invisibility back
+  target.setStyle('visibility:visible').hide(null);
+}
+
+/**
+ * The RightJS UI Autocompleter unit base class
+ *
+ * Copyright (C) 2009-2011 Nikolay Nemshilov
+ */
+var Autocompleter = new Widget('UL', {
+  include: Toggler,
+
+  extend: {
+    version: '2.2.0',
+
+    EVENTS: $w('show hide update load select done'),
+
+    Options: {
+      url:        document.location.href,
+      param:      'search',
+      method:     'get',
+
+      minLength:  1,         // the minimal length when it starts work
+      threshold:  200,       // the typing pause threshold
+
+      cache:      true,      // use the results cache
+      local:      null,      // an optional local search results list
+
+      fxName:     'slide',   // list appearance fx name
+      fxDuration: 'short',   // list appearance fx duration
+
+      spinner:    'native',  // spinner element reference
+
+      cssRule:    'input[data-autocompleter]' // the auto-initialization css-rule
+    }
+  },
+
+  /**
+   * basic constructor
+   *
+   * @param mixed the input element reference, a string id or the element instance
+   * @param Object options
+   */
+  initialize: function(input, options) {
+    this.input = $(input); // KEEP IT before the super call
+
+    this
+      .$super('autocompleter', options)
+      .addClass('rui-dd-menu')
+      .onMousedown(this.clicked);
+
+    this.input.autocompleter = this;
+  },
+
+  /**
+   * Destructor
+   *
+   * @return Autocompleter this
+   */
+  destroy: function() {
+    delete(this.input.autocompleter);
+    return this;
+  },
+
+  /**
+   * picks the next item on the list
+   *
+   * @return Autocompleter this
+   */
+  prev: function() {
+    return this.pick('prev');
+  },
+
+  /**
+   * picks the next item on the list
+   *
+   * @return Autocompleter this
+   */
+  next: function() {
+    return this.pick('next');
+  },
+
+  /**
+   * triggers the done event, sets up the value and closes the list
+   *
+   * @return Autocompleter this
+   */
+  done: function(current) {
+    current = current || this.first('li.current');
+
+    if (current) {
+      current.radioClass('current');
+      this.input.setValue(R(current.html()).stripTags());
+      this.fire('done');
+    }
+
+    return this.hide();
+  },
+
+// protected
+
+  // preprocessing the urls a bit
+  setOptions: function(options) {
+    this.$super(options, this.input);
+
+    options = this.options;
+
+    // building the correct url template with a placeholder
+    if (!R(options.url).includes('%{search}')) {
+      options.url += (R(options.url).includes('?') ? '&' : '?') + options.param + '=%{search}';
+    }
+  },
+
+  // works with the 'prev' and 'next' methods
+  pick: function(which_one) {
+    var items   = this.children(),
+        current = items.first('hasClass', 'current'),
+        index   = items.indexOf(current);
+
+    if (which_one == 'prev') {
+      current = index < 1 ? items.last() : items[index < 0 ? 0 : (index-1)];
+    } else if (which_one == 'next') {
+      current = index < 0 || index == (items.length - 1) ?
+        items.first() : items[index + 1];
+    }
+
+    return this.fire('select', {item: current.radioClass('current')});
+  },
+
+  // handles mouse clicks on the list element
+  clicked: function(event) {
+    this.done(event.stop().find('li'));
+  },
+
+  // handles the key-press events
+  keypressed: function(event) {
+    if (this.input.value().length >= this.options.minLength) {
+      if (this.timeout) {
+        this.timeout.cancel();
+      }
+      this.timeout = R(this.trigger).bind(this).delay(this.options.threshold);
+    } else {
+      return this.hide();
+    }
+  },
+
+  // triggers the actual action
+  trigger: function() {
+    this.timeout = null;
+
+    this.cache = this.cache || {};
+    var search = this.input.value(), options = this.options;
+
+    if (search.length < options.minLength) { return this.hide(); }
+
+    if (this.cache[search]) {
+      this.suggest(this.cache[search], search);
+    } else if (isArray(options.local)) {
+      this.suggest(this.findLocal(search), search);
+    } else {
+      this.request = Xhr.load(options.url.replace('%{search}', encodeURIComponent(search)), {
+        method:  options.method,
+        spinner: this.getSpinner(),
+        onComplete: R(function(response) {
+          this.fire('load').suggest(response.text, search);
+        }).bind(this)
+      });
+    }
+  },
+
+  // updates the suggestions list
+  suggest: function(result_text, search) {
+    // saving the result in cache
+    if (this.options.cache) {
+      this.cache[search] = result_text;
+    }
+
+    if (!R(result_text).blank()) {
+      this.update(result_text.replace(/<ul[^>]*>|<\/ul>/im, ''));
+      this.fire('update');
+      if (!this._connected || this.hidden()) {
+        this.showAt(this.input, 'bottom', 'resize');
+        this._connected = true;
+      }
+    } else {
+      this.hide();
+    }
+
+    return this;
+  },
+
+  // performs the locals search
+  findLocal: function(search) {
+    var regexp  = new RegExp("("+RegExp.escape(search)+")", 'ig');
+
+    return R(this.options.local).map(function(option) {
+      if (option.match(regexp)) {
+        return '<li>'+ option.replace(regexp, '<strong>$1</strong>') +'</li>';
+      }
+    }).compact().join('');
+  },
+
+  // builds a native textual spinner if necessary
+  getSpinner: function() {
+    var options = this.options, spinner = options.spinner;
+
+    if (spinner == 'native') {
+      spinner = options.spinner = new Spinner(3).insertTo(this);
+      spinner.addClass('rui-autocompleter-spinner');
+    }
+
+    // positioning the native spinner
+    if (spinner instanceof Spinner) {
+      Toggler_re_position.call(spinner, this.input, 'right', 'resize');
+    }
+
+    return spinner;
+  }
+});
+
+
+/**
+ * The document events hooking
+ *
+ * Copyright (C) 2009-2010 Nikolay Nemshilov
+ */
+$(document).on({
+  /**
+   * Initializes autocompleters on-focus
+   *
+   * @param Event focus
+   * @return void
+   */
+  focus: function(event) {
+    var target = event.target;
+
+    if (target && (target instanceof RightJS.Element) && (target.autocompleter || target.match(Autocompleter.Options.cssRule))) {
+      if (!target.autocompleter) {
+        new Autocompleter(target);
+      }
+    }
+  },
+
+  /**
+   * Hides autocompleters on-blur
+   *
+   * @param Event blur
+   * @return void
+   */
+  blur: function(event) {
+    var autocompleter = event.target ? event.target.autocompleter : null;
+
+    if (autocompleter && autocompleter.visible()) {
+      autocompleter.hide();
+    }
+  },
+
+  /**
+   * Catching the basic keyboard events
+   * to navigate through the autocompletion list
+   *
+   * @param Event keydown
+   * @return void
+   */
+  keydown: function(event) {
+    var autocompleter = event.target ? event.target.autocompleter : null;
+
+    if (autocompleter && autocompleter.visible()) {
+      var method_name = ({
+        27: 'hide', // Esc
+        38: 'prev', // Up
+        40: 'next', // Down
+        13: 'done'  // Enter
+      })[event.keyCode];
+
+      if (method_name) {
+        event.stop();
+        autocompleter[method_name]();
+      }
+    }
+  },
+
+  /**
+   * Catches the input fields keyup events
+   * and tries to make the autocompleter to show some suggestions
+   *
+   * @param Event keyup
+   * @return void
+   */
+  keyup: function(event) {
+    var autocompleter = event.target ? event.target.autocompleter : null;
+
+    if (autocompleter && !R([9, 27, 37, 38, 39, 40, 13]).include(event.keyCode)) {
+      autocompleter.keypressed(event);
+    }
+  }
+});
+(function() {
+        var style = document.createElement('style'),
+            rules = document.createTextNode(" *.rui-dd-menu, *.rui-dd-menu li{margin:0;padding:0;border:none;background:none;list-style:none;font-weight:normal;float:none} *.rui-dd-menu{display:none;position:absolute;z-index:9999;background:white;border:1px solid #BBB;border-radius:.2em;-moz-border-radius:.2em;-webkit-border-radius:.2em;box-shadow:#DDD .2em .2em .4em;-moz-box-shadow:#DDD .2em .2em .4em;-webkit-box-shadow:#DDD .2em .2em .4em} *.rui-dd-menu li{padding:.2em .4em;border-top:none;border-bottom:none;cursor:pointer} *.rui-dd-menu li.current{background:#DDD} *.rui-dd-menu li:hover{background:#EEE}dl.rui-dd-menu dt{padding:.3em .5em;cursor:default;font-weight:bold;font-style:italic;color:#444;background:#EEE}dl.rui-dd-menu dd li{padding-left:1.5em}div.rui-spinner,div.rui-spinner div{margin:0;padding:0;border:none;background:none;list-style:none;font-weight:normal;float:none;display:inline-block; *display:inline; *zoom:1;border-radius:.12em;-moz-border-radius:.12em;-webkit-border-radius:.12em}div.rui-spinner{text-align:center;white-space:nowrap;background:#EEE;border:1px solid #DDD;height:1.2em;padding:0 .2em}div.rui-spinner div{width:.4em;height:70%;background:#BBB;margin-left:1px}div.rui-spinner div:first-child{margin-left:0}div.rui-spinner div.glowing{background:#777}div.rui-re-anchor{margin:0;padding:0;background:none;border:none;float:none;display:inline;position:absolute;z-index:9999}.rui-autocompleter{border-top-color:#DDD !important;border-top-left-radius:0 !important;border-top-right-radius:0 !important;-moz-border-radius-topleft:0 !important;-moz-border-radius-topright:0 !important;-webkit-border-top-left-radius:0 !important;-webkit-border-top-right-radius:0 !important}.rui-autocompleter-spinner{border:none !important;background:none !important;position:absolute;z-index:9999}.rui-autocompleter-spinner div{margin-top:.2em !important; *margin-top:0.1em !important}");
+
+        style.type = 'text/css';
+
+        if(style.styleSheet) {
+          style.styleSheet.cssText = rules.nodeValue;
+        } else {
+          style.appendChild(rules);
+        }
+
+        document.getElementsByTagName('head')[0].appendChild(style);
+      })();
+
+return Autocompleter;
+})(document, RightJS);