ultimate-base 0.3.0 → 0.3.1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ultimate-base (0.3.0)
+    ultimate-base (0.3.1)
 
 GEM
   remote: http://rubygems.org/

data/app/assets/javascripts/ultimate/backbone/base.js.coffee

@@ -2,10 +2,9 @@
 #    jquery ~> 1.7.0
 #    underscore ~> 1.3.0
 
+#= require ultimate/base
 #= require ultimate/helpers
 
-@Ultimate ||= {}
-
 @Ultimate.Backbone =
 
   debugMode: false

data/app/assets/javascripts/ultimate/backbone/collection.js.coffee

@@ -1,5 +1,7 @@
 #= require ./base
 
+# TODO ready options
+
 class Ultimate.Backbone.Collection extends Backbone.Collection
 
   constructor: ->

data/app/assets/javascripts/ultimate/backbone/lib/backbone.js

@@ -18,8 +18,11 @@
   // restored later on, if `noConflict` is used.
   var previousBackbone = root.Backbone;
 
-  // Create a local reference to splice.
-  var splice = Array.prototype.splice;
+  // Create a local reference to array methods.
+  var ArrayProto = Array.prototype;
+  var push = ArrayProto.push;
+  var slice = ArrayProto.slice;
+  var splice = ArrayProto.splice;
 
   // The top-level namespace. All public Backbone classes and modules will
   // be attached to this. Exported for both CommonJS and the browser.
@@ -183,7 +186,7 @@
     attributes || (attributes = {});
     if (options && options.collection) this.collection = options.collection;
     if (options && options.parse) attributes = this.parse(attributes);
-    if (defaults = getValue(this, 'defaults')) {
+    if (defaults = _.result(this, 'defaults')) {
       attributes = _.extend({}, defaults, attributes);
     }
     this.attributes = {};
@@ -336,9 +339,7 @@
       options.success = function(resp, status, xhr) {
         if (!model.set(model.parse(resp, xhr), options)) return false;
         if (success) success(model, resp, options);
-        model.trigger('sync', model, resp, options);
       };
-      options.error = Backbone.wrapError(options.error, model, options);
       return this.sync('read', this, options);
     },
 
@@ -383,11 +384,9 @@
         if (options.wait) serverAttrs = _.extend(attrs || {}, serverAttrs);
         if (!model.set(serverAttrs, options)) return false;
         if (success) success(model, resp, options);
-        model.trigger('sync', model, resp, options);
       };
 
       // Finish configuring and sending the Ajax request.
-      options.error = Backbone.wrapError(options.error, model, options);
       var xhr = this.sync(this.isNew() ? 'create' : 'update', this, options);
 
       // When using `wait`, reset attributes to original values unless
@@ -415,7 +414,6 @@
       options.success = function(resp) {
         if (options.wait || model.isNew()) destroy();
         if (success) success(model, resp, options);
-        if (!model.isNew()) model.trigger('sync', model, resp, options);
       };
 
       if (this.isNew()) {
@@ -423,7 +421,6 @@
         return false;
       }
 
-      options.error = Backbone.wrapError(options.error, model, options);
       var xhr = this.sync('delete', this, options);
       if (!options.wait) destroy();
       return xhr;
@@ -433,7 +430,7 @@
     // using Backbone's restful methods, override this to change the endpoint
     // that will be called.
     url: function() {
-      var base = getValue(this, 'urlRoot') || getValue(this.collection, 'url') || urlError();
+      var base = _.result(this, 'urlRoot') || _.result(this.collection, 'url') || urlError();
       if (this.isNew()) return base;
       return base + (base.charAt(base.length - 1) === '/' ? '' : '/') + encodeURIComponent(this.id);
     },
@@ -527,8 +524,8 @@
 
     // Check if the model is currently in a valid state. It's only possible to
     // get into an *invalid* state if you're using silent changes.
-    isValid: function() {
-      return !this.validate || !this.validate(this.attributes);
+    isValid: function(options) {
+      return !this.validate || !this.validate(this.attributes, options);
     },
 
     // Run validation against the next complete set of model attributes,
@@ -539,11 +536,8 @@
       attrs = _.extend({}, this.attributes, attrs);
       var error = this.validate(attrs, options);
       if (!error) return true;
-      if (options && options.error) {
-        options.error(this, error, options);
-      } else {
-        this.trigger('error', this, error, options);
-      }
+      if (options && options.error) options.error(this, error, options);
+      this.trigger('error', this, error, options);
       return false;
     }
 
@@ -561,7 +555,10 @@
     if (options.comparator !== void 0) this.comparator = options.comparator;
     this._reset();
     this.initialize.apply(this, arguments);
-    if (models) this.reset(models, {silent: true, parse: options.parse});
+    if (models) {
+      if (options.parse) models = this.parse(models);
+      this.reset(models, {silent: true, parse: options.parse});
+    }
   };
 
   // Define the Collection's inheritable methods.
@@ -589,59 +586,51 @@
     // Add a model, or list of models to the set. Pass **silent** to avoid
     // firing the `add` event for every new model.
     add: function(models, options) {
-      var i, index, length, model, cid, id, cids = {}, ids = {}, dups = [];
-      options || (options = {});
+      var i, args, length, model, existing;
+      var at = options && options.at;
       models = _.isArray(models) ? models.slice() : [models];
 
       // Begin by turning bare objects into model references, and preventing
-      // invalid models or duplicate models from being added.
+      // invalid models from being added.
       for (i = 0, length = models.length; i < length; i++) {
-        if (!(model = models[i] = this._prepareModel(models[i], options))) {
-          throw new Error("Can't add an invalid model to a collection");
-        }
-        cid = model.cid;
-        id = model.id;
-        if (cids[cid] || this._byCid[cid] || ((id != null) && (ids[id] || this._byId[id]))) {
-          dups.push(i);
-          continue;
-        }
-        cids[cid] = ids[id] = model;
+        if (models[i] = this._prepareModel(models[i], options)) continue;
+        throw new Error("Can't add an invalid model to a collection");
       }
 
-      // Remove duplicates.
-      i = dups.length;
-      while (i--) {
-        dups[i] = models.splice(dups[i], 1)[0];
-      }
+      for (i = models.length - 1; i >= 0; i--) {
+        model = models[i];
+        existing = model.id != null && this._byId[model.id];
 
-      // Listen to added models' events, and index models for lookup by
-      // `id` and by `cid`.
-      for (i = 0, length = models.length; i < length; i++) {
-        (model = models[i]).on('all', this._onModelEvent, this);
+        // If a duplicate is found, splice it out and optionally merge it into
+        // the existing model.
+        if (existing || this._byCid[model.cid]) {
+          if (options && options.merge && existing) {
+            existing.set(model, options);
+          }
+          models.splice(i, 1);
+          continue;
+        }
+
+        // Listen to added models' events, and index models for lookup by
+        // `id` and by `cid`.
+        model.on('all', this._onModelEvent, this);
         this._byCid[model.cid] = model;
         if (model.id != null) this._byId[model.id] = model;
       }
 
-      // Insert models into the collection, re-sorting if needed, and triggering
-      // `add` events unless silenced.
-      this.length += length;
-      index = options.at != null ? options.at : this.models.length;
-      splice.apply(this.models, [index, 0].concat(models));
-
-      // Merge in duplicate models.
-      if (options.merge) {
-        for (i = 0, length = dups.length; i < length; i++) {
-          if (model = this._byId[dups[i].id]) model.set(dups[i], options);
-        }
-      }
+      // Update `length` and splice in new models.
+      this.length += models.length;
+      args = [at != null ? at : this.models.length, 0];
+      push.apply(args, models);
+      splice.apply(this.models, args);
 
       // Sort the collection if appropriate.
-      if (this.comparator && options.at == null) this.sort({silent: true});
+      if (this.comparator && at == null) this.sort({silent: true});
 
-      if (options.silent) return this;
-      for (i = 0, length = this.models.length; i < length; i++) {
-        if (!cids[(model = this.models[i]).cid]) continue;
-        options.index = i;
+      if (options && options.silent) return this;
+
+      // Trigger `add` events.
+      while (model = models.shift()) {
         model.trigger('add', model, this, options);
       }
 
@@ -735,35 +724,35 @@
     // normal circumstances, as the set will maintain sort order as each item
     // is added.
     sort: function(options) {
-      options || (options = {});
-      if (!this.comparator) throw new Error('Cannot sort a set without a comparator');
-      var boundComparator = _.bind(this.comparator, this);
-      if (this.comparator.length === 1) {
-        this.models = this.sortBy(boundComparator);
+      if (!this.comparator) {
+        throw new Error('Cannot sort a set without a comparator');
+      }
+
+      if (_.isString(this.comparator) || this.comparator.length === 1) {
+        this.models = this.sortBy(this.comparator, this);
       } else {
-        this.models.sort(boundComparator);
+        this.models.sort(_.bind(this.comparator, this));
       }
-      if (!options.silent) this.trigger('reset', this, options);
+
+      if (!options || !options.silent) this.trigger('reset', this, options);
       return this;
     },
 
     // Pluck an attribute from each model in the collection.
     pluck: function(attr) {
-      return _.map(this.models, function(model){ return model.get(attr); });
+      return _.invoke(this.models, 'get', attr);
     },
 
     // When you have more items than you want to add or remove individually,
     // you can reset the entire set with a new list of models, without firing
     // any `add` or `remove` events. Fires `reset` when finished.
     reset: function(models, options) {
-      models  || (models = []);
-      options || (options = {});
       for (var i = 0, l = this.models.length; i < l; i++) {
         this._removeReference(this.models[i]);
       }
       this._reset();
-      this.add(models, _.extend({silent: true}, options));
-      if (!options.silent) this.trigger('reset', this, options);
+      if (models) this.add(models, _.extend({silent: true}, options));
+      if (!options || !options.silent) this.trigger('reset', this, options);
       return this;
     },
 
@@ -778,9 +767,7 @@
       options.success = function(resp, status, xhr) {
         collection[options.add ? 'add' : 'reset'](collection.parse(resp, xhr), options);
         if (success) success(collection, resp, options);
-        collection.trigger('sync', collection, resp, options);
       };
-      options.error = Backbone.wrapError(options.error, collection, options);
       return this.sync('read', this, options);
     },
 
@@ -788,14 +775,14 @@
     // collection immediately, unless `wait: true` is passed, in which case we
     // wait for the server to agree.
     create: function(model, options) {
-      var coll = this;
+      var collection = this;
       options = options ? _.clone(options) : {};
       model = this._prepareModel(model, options);
       if (!model) return false;
-      if (!options.wait) coll.add(model, options);
+      if (!options.wait) collection.add(model, options);
       var success = options.success;
       options.success = function(model, resp, options) {
-        if (options.wait) coll.add(model, options);
+        if (options.wait) collection.add(model, options);
         if (success) success(model, resp, options);
       };
       model.save(null, options);
@@ -864,16 +851,32 @@
   });
 
   // Underscore methods that we want to implement on the Collection.
-  var methods = ['forEach', 'each', 'map', 'reduce', 'reduceRight', 'find',
-    'detect', 'filter', 'select', 'reject', 'every', 'all', 'some', 'any',
-    'include', 'contains', 'invoke', 'max', 'min', 'sortBy', 'sortedIndex',
-    'toArray', 'size', 'first', 'initial', 'rest', 'last', 'without', 'indexOf',
-    'shuffle', 'lastIndexOf', 'isEmpty', 'groupBy'];
+  var methods = ['forEach', 'each', 'map', 'collect', 'reduce', 'foldl',
+    'inject', 'reduceRight', 'foldr', 'find', 'detect', 'filter', 'select',
+    'reject', 'every', 'all', 'some', 'any', 'include', 'contains', 'invoke',
+    'max', 'min', 'sortedIndex', 'toArray', 'size', 'first', 'head', 'take',
+    'initial', 'rest', 'tail', 'last', 'without', 'indexOf', 'shuffle',
+    'lastIndexOf', 'isEmpty'];
 
   // Mix in each Underscore method as a proxy to `Collection#models`.
   _.each(methods, function(method) {
     Collection.prototype[method] = function() {
-      return _[method].apply(_, [this.models].concat(_.toArray(arguments)));
+      var args = slice.call(arguments);
+      args.unshift(this.models);
+      return _[method].apply(_, args);
+    };
+  });
+
+  // Underscore methods that take a property name as an argument.
+  var attributeMethods = ['groupBy', 'countBy', 'sortBy'];
+
+  // Use attributes instead of properties.
+  _.each(attributeMethods, function(method) {
+    Collection.prototype[method] = function(value, context) {
+      var iterator = _.isFunction(value) ? value : function(model) {
+        return model.get(value);
+      };
+      return _[method](this.models, iterator, context);
     };
   });
 
@@ -909,7 +912,6 @@
     //     });
     //
     route: function(route, name, callback) {
-      Backbone.history || (Backbone.history = new History);
       if (!_.isRegExp(route)) route = this._routeToRegExp(route);
       if (!callback) callback = this[name];
       Backbone.history.route(route, _.bind(function(fragment) {
@@ -962,16 +964,23 @@
 
   // Handles cross-browser history management, based on URL fragments. If the
   // browser does not support `onhashchange`, falls back to polling.
-  var History = Backbone.History = function(options) {
+  var History = Backbone.History = function() {
     this.handlers = [];
     _.bindAll(this, 'checkUrl');
-    this.location = options && options.location || root.location;
-    this.history = options && options.history || root.history;
+
+    // #1653 - Ensure that `History` can be used outside of the browser.
+    if (typeof window !== 'undefined') {
+      this.location = window.location;
+      this.history = window.history;
+    }
   };
 
-  // Cached regex for cleaning leading hashes and slashes .
+  // Cached regex for cleaning leading hashes and slashes.
   var routeStripper = /^[#\/]/;
 
+  // Cached regex for stripping leading and trailing slashes.
+  var rootStripper = /^\/+|\/+$/g;
+
   // Cached regex for detecting MSIE.
   var isExplorer = /msie [\w.]+/;
 
@@ -1001,7 +1010,7 @@
       if (fragment == null) {
         if (this._hasPushState || !this._wantsHashChange || forcePushState) {
           fragment = this.location.pathname;
-          var root = this.options.root.replace(trailingSlash, '');
+          var root = this.root.replace(trailingSlash, '');
           if (!fragment.indexOf(root)) fragment = fragment.substr(root.length);
         } else {
           fragment = this.getHash();
@@ -1019,6 +1028,7 @@
       // Figure out the initial configuration. Do we need an iframe?
       // Is pushState desired ... is it available?
       this.options          = _.extend({}, {root: '/'}, this.options, options);
+      this.root             = this.options.root;
       this._wantsHashChange = this.options.hashChange !== false;
       this._wantsPushState  = !!this.options.pushState;
       this._hasPushState    = !!(this.options.pushState && this.history && this.history.pushState);
@@ -1026,8 +1036,8 @@
       var docMode           = document.documentMode;
       var oldIE             = (isExplorer.exec(navigator.userAgent.toLowerCase()) && (!docMode || docMode <= 7));
 
-      // Normalize root to always include trailing slash
-      if (!trailingSlash.test(this.options.root)) this.options.root += '/';
+      // Normalize root to always include a leading and trailing slash.
+      this.root = ('/' + this.root + '/').replace(rootStripper, '/');
 
       if (oldIE && this._wantsHashChange) {
         this.iframe = Backbone.$('<iframe src="javascript:0" tabindex="-1" />').hide().appendTo('body')[0].contentWindow;
@@ -1048,13 +1058,13 @@
       // opened by a non-pushState browser.
       this.fragment = fragment;
       var loc = this.location;
-      var atRoot = (loc.pathname.replace(/[^/]$/, '$&/') === this.options.root) && !loc.search;
+      var atRoot = (loc.pathname.replace(/[^/]$/, '$&/') === this.root) && !loc.search;
 
       // If we've started off with a route from a `pushState`-enabled browser,
       // but we're currently in a browser that doesn't support it...
       if (this._wantsHashChange && this._wantsPushState && !this._hasPushState && !atRoot) {
         this.fragment = this.getFragment(null, true);
-        this.location.replace(this.options.root + this.location.search + '#' + this.fragment);
+        this.location.replace(this.root + this.location.search + '#' + this.fragment);
         // Return immediately as browser will do redirect to new url
         return true;
 
@@ -1062,7 +1072,7 @@
       // in a browser where it could be `pushState`-based instead...
       } else if (this._wantsPushState && this._hasPushState && atRoot && loc.hash) {
         this.fragment = this.getHash().replace(routeStripper, '');
-        this.history.replaceState({}, document.title, loc.protocol + '//' + loc.host + this.options.root + this.fragment);
+        this.history.replaceState({}, document.title, this.root + this.fragment);
       }
 
       if (!this.options.silent) return this.loadUrl();
@@ -1118,10 +1128,10 @@
     navigate: function(fragment, options) {
       if (!History.started) return false;
       if (!options || options === true) options = {trigger: options};
-      var frag = (fragment || '').replace(routeStripper, '');
-      if (this.fragment === frag) return;
-      this.fragment = frag;
-      var url = (frag.indexOf(this.options.root) !== 0 ? this.options.root : '') + frag;
+      fragment = this.getFragment(fragment || '');
+      if (this.fragment === fragment) return;
+      this.fragment = fragment;
+      var url = this.root + fragment;
 
       // If pushState is available, we use it to set the fragment as a real URL.
       if (this._hasPushState) {
@@ -1130,13 +1140,13 @@
       // If hash changes haven't been explicitly disabled, update the hash
       // fragment to store history.
       } else if (this._wantsHashChange) {
-        this._updateHash(this.location, frag, options.replace);
-        if (this.iframe && (frag !== this.getFragment(this.getHash(this.iframe)))) {
+        this._updateHash(this.location, fragment, options.replace);
+        if (this.iframe && (fragment !== this.getFragment(this.getHash(this.iframe)))) {
           // Opening and closing the iframe tricks IE7 and earlier to push a
           // history entry on hash-tag change.  When replace is true, we don't
           // want this.
           if(!options.replace) this.iframe.document.open().close();
-          this._updateHash(this.iframe.location, frag, options.replace);
+          this._updateHash(this.iframe.location, fragment, options.replace);
         }
 
       // If you've told us that you explicitly don't want fallback hashchange-
@@ -1151,14 +1161,19 @@
     // a new one to the browser history.
     _updateHash: function(location, fragment, replace) {
       if (replace) {
-        location.replace(location.href.replace(/(javascript:|#).*$/, '') + '#' + fragment);
+        var href = location.href.replace(/(javascript:|#).*$/, '');
+        location.replace(href + '#' + fragment);
       } else {
-        location.hash = fragment;
+        // #1649 - Some browsers require that `hash` contains a leading #.
+        location.hash = '#' + fragment;
       }
     }
 
   });
 
+  // Create the default Backbone.history.
+  Backbone.history = new History;
+
   // Backbone.View
   // -------------
 
@@ -1201,9 +1216,19 @@
       return this;
     },
 
+    // Clean up references to this view in order to prevent latent effects and
+    // memory leaks.
+    dispose: function() {
+      this.undelegateEvents();
+      if (this.model) this.model.off(null, null, this);
+      if (this.collection) this.collection.off(null, null, this);
+      return this;
+    },
+
     // Remove this view from the DOM. Note that the view isn't present in the
     // DOM by default, so calling this method may be a no-op.
     remove: function() {
+      this.dispose();
       this.$el.remove();
       return this;
     },
@@ -1246,7 +1271,7 @@
     // This only works for delegate-able events: not `focus`, `blur`, and
     // not `change`, `submit`, and `reset` in Internet Explorer.
     delegateEvents: function(events) {
-      if (!(events || (events = getValue(this, 'events')))) return;
+      if (!(events || (events = _.result(this, 'events')))) return;
       this.undelegateEvents();
       for (var key in events) {
         var method = events[key];
@@ -1289,10 +1314,10 @@
     // an element from the `id`, `className` and `tagName` properties.
     _ensureElement: function() {
       if (!this.el) {
-        var attrs = _.extend({}, getValue(this, 'attributes'));
-        if (this.id) attrs.id = getValue(this, 'id');
-        if (this.className) attrs['class'] = getValue(this, 'className');
-        this.setElement(this.make(getValue(this, 'tagName'), attrs), false);
+        var attrs = _.extend({}, _.result(this, 'attributes'));
+        if (this.id) attrs.id = _.result(this, 'id');
+        if (this.className) attrs['class'] = _.result(this, 'className');
+        this.setElement(this.make(_.result(this, 'tagName'), attrs), false);
       } else {
         this.setElement(this.el, false);
       }
@@ -1300,14 +1325,6 @@
 
   });
 
-  // The self-propagating extend function that Backbone classes use.
-  var extend = function(protoProps, classProps) {
-    return inherits(this, protoProps, classProps);
-  };
-
-  // Set up inheritance for the model, collection, and view.
-  Model.extend = Collection.extend = Router.extend = View.extend = extend;
-
   // Backbone.sync
   // -------------
 
@@ -1345,7 +1362,7 @@
 
     // Ensure that we have a URL.
     if (!options.url) {
-      params.url = getValue(model, 'url') || urlError();
+      params.url = _.result(model, 'url') || urlError();
     }
 
     // Ensure that we have the appropriate request data.
@@ -1377,6 +1394,18 @@
       params.processData = false;
     }
 
+    var success = options.success;
+    options.success = function(resp, status, xhr) {
+      if (success) success(resp, status, xhr);
+      model.trigger('sync', model, resp, options);
+    };
+
+    var error = options.error;
+    options.error = function(xhr, status, thrown) {
+      if (error) error(model, xhr, options);
+      model.trigger('error', model, xhr, options);
+    };
+
     // Make the request, allowing the user to override any Ajax options.
     return Backbone.ajax(_.extend(params, options));
   };
@@ -1386,69 +1415,47 @@
     return Backbone.$.ajax.apply(Backbone.$, arguments);
   };
 
-  // Wrap an optional error callback with a fallback error event.
-  Backbone.wrapError = function(onError, originalModel, options) {
-    return function(model, resp) {
-      resp = model === originalModel ? resp : model;
-      if (onError) {
-        onError(originalModel, resp, options);
-      } else {
-        originalModel.trigger('error', originalModel, resp, options);
-      }
-    };
-  };
-
   // Helpers
   // -------
 
-  // Shared empty constructor function to aid in prototype-chain creation.
-  var ctor = function(){};
-
   // Helper function to correctly set up the prototype chain, for subclasses.
   // Similar to `goog.inherits`, but uses a hash of prototype properties and
   // class properties to be extended.
-  var inherits = function(parent, protoProps, staticProps) {
+  var extend = function(protoProps, staticProps) {
+    var parent = this;
     var child;
 
     // The constructor function for the new subclass is either defined by you
     // (the "constructor" property in your `extend` definition), or defaulted
     // by us to simply call the parent's constructor.
-    if (protoProps && protoProps.hasOwnProperty('constructor')) {
+    if (protoProps && _.has(protoProps, 'constructor')) {
       child = protoProps.constructor;
     } else {
       child = function(){ parent.apply(this, arguments); };
     }
 
-    // Inherit class (static) properties from parent.
-    _.extend(child, parent);
-
     // Set the prototype chain to inherit from `parent`, without calling
     // `parent`'s constructor function.
-    ctor.prototype = parent.prototype;
-    child.prototype = new ctor();
+    function Surrogate(){ this.constructor = child; };
+    Surrogate.prototype = parent.prototype;
+    child.prototype = new Surrogate;
 
     // Add prototype properties (instance properties) to the subclass,
     // if supplied.
     if (protoProps) _.extend(child.prototype, protoProps);
 
     // Add static properties to the constructor function, if supplied.
-    if (staticProps) _.extend(child, staticProps);
+    _.extend(child, parent, staticProps);
 
-    // Correctly set child's `prototype.constructor`.
-    child.prototype.constructor = child;
-
-    // Set a convenience property in case the parent's prototype is needed later.
+    // Set a convenience property in case the parent's prototype is needed
+    // later.
     child.__super__ = parent.prototype;
 
     return child;
   };
 
-  // Helper function to get a value from a Backbone object as a property
-  // or as a function.
-  var getValue = function(object, prop) {
-    if (!(object && object[prop])) return null;
-    return _.isFunction(object[prop]) ? object[prop]() : object[prop];
-  };
+  // Set up inheritance for the model, collection, router, and view.
+  Model.extend = Collection.extend = Router.extend = View.extend = extend;
 
   // Throw an error when a URL is needed, and none is supplied.
   var urlError = function() {

data/app/assets/javascripts/ultimate/base.js.coffee

@@ -0,0 +1,11 @@
+#= require ./helpers
+
+@Ultimate =
+
+  debugMode: false
+
+  debug: ->
+    if @debugMode
+      a = ["info", "Ultimate"]
+      Array::push.apply a, arguments  if arguments.length > 0
+      cout.apply @, a

data/app/assets/javascripts/ultimate/helpers/asset_tag.js.coffee

@@ -23,7 +23,7 @@
       if matches = size.match(/^(\d+)x(\d+)$/)
         options['width']  = matches[1]
         options['height'] = matches[2]
-    Ultimate.Helpers.Tag.tag 'img', options
+    Ultimate.Helpers.Tag.tag('img', options)
 
   image_alt: (src) ->
     _.string.capitalize @without_extension(@basename(src)).replace(/-[A-Fa-f0-9]{32}/, '')
@@ -47,16 +47,16 @@
     source
 
   rewrite_extension: (source, ext) ->
-    "#{@without_extension source}.#{ext}"
+    "#{@without_extension(source)}.#{ext}"
 
   without_extension: (source) ->
-    source.replace /^(.+)(\.\w+)$/, '$1'
+    source.replace(/^(.+)(\.\w+)$/, '$1')
 
   ASSET_ID: ''
   asset_ids_cache: {}
   # Use the ASSET_ID inscope variable or the random hash as its cache-busting asset id.
   asset_id: (source) ->
-    if _.isString @ASSET_ID
+    if _.isString(@ASSET_ID)
       @ASSET_ID
     else
       @asset_ids_cache[source] or (@asset_ids_cache[source] = 10000000 + Math.floor(Math.random() * 90000000))

data/app/assets/javascripts/ultimate/helpers/base.js.coffee

@@ -1,3 +1,3 @@
-@Ultimate ||= {}
+#= require ultimate/base
 
 @Ultimate.Helpers ||= {}

data/app/assets/javascripts/ultimate/helpers/translation.js.coffee

@@ -0,0 +1,97 @@
+#= require ./base
+#= require ./tag
+
+#module I18n
+#  class ExceptionHandler
+#    include Module.new {
+#      def call(exception, locale, key, options)
+#        exception.is_a?(MissingTranslation) && options[:rescue_format] == :html ? super.html_safe : super
+#      end
+#    }
+#  end
+#end
+
+@Ultimate.Helpers.Translation =
+
+  ###**
+  * Delegates to <tt>I18n#translate</tt> but also performs three additional functions.
+  *
+  * First, it'll pass the <tt>:rescue_format => :html</tt> option to I18n so that any
+  * thrown +MissingTranslation+ messages will be turned into inline spans that
+  *
+  *   * have a "translation-missing" class set,
+  *   * contain the missing key as a title attribute and
+  *   * a titleized version of the last key segment as a text.
+  *
+  * E.g. the value returned for a missing translation key :"blog.post.title" will be
+  * <span class="translation_missing" title="translation missing: en.blog.post.title">Title</span>.
+  * This way your views will display rather reasonable strings but it will still
+  * be easy to spot missing translations.
+  *
+  * Second, it'll scope the key by the current partial if the key starts
+  * with a period. So if you call <tt>translate(".foo")</tt> from the
+  * <tt>people/index.html.erb</tt> template, you'll actually be calling
+  * <tt>I18n.translate("people.index.foo")</tt>. This makes it less repetitive
+  * to translate many keys within the same partials and gives you a simple framework
+  * for scoping them consistently. If you don't prepend the key with a period,
+  * nothing is converted.
+  *
+  * Third, it'll mark the translation as safe HTML if the key has the suffix
+  * "_html" or the last element of the key is the word "html". For example,
+  * calling translate("footer_html") or translate("footer.html") will return
+  * a safe HTML string that won't be escaped by other HTML helper methods. This
+  * naming convention helps to identify translations that include HTML tags so that
+  * you know what kind of output to expect when you call translate in a template.
+  ###
+  translate: (key, options = {}) ->
+    _.extend(options, rescue_format: 'html')  unless _.has(options, 'rescue_format')
+    options['default'] = @wrap_translate_defaults(options['default'])  if options['default']
+    if @html_safe_translation_key(key)
+      html_safe_options = _.clone(options)
+      options.except(I18n.RESERVED_KEYS).each do |name, value|
+        unless name == :count && value.is_a?(Numeric)
+          html_safe_options[name] = ERB::Util.html_escape(value.to_s)
+        end
+      end
+      translation = I18n.translate(scope_key_by_partial(key), html_safe_options)
+
+      translation.respond_to?(:html_safe) ? translation.html_safe : translation
+    else
+      I18n.translate(scope_key_by_partial(key), options)
+    end
+  end
+  alias :t :translate
+
+  # Delegates to <tt>I18n.localize</tt> with no additional functionality.
+  #
+  # See http://rubydoc.info/github/svenfuchs/i18n/master/I18n/Backend/Base:localize
+  # for more information.
+  localize: ->
+    I18n.localize(arguments...)
+
+  l: -> @localize(arguments...)
+
+  # private
+
+  scope_key_by_partial: (key) ->
+    if /^\./.test(key)
+      if @virtual_path?
+        @virtual_path.replace(/_/g, ".") + key
+      else
+        throw new Error("Cannot use t(#{key.inspect}) shortcut because path is not available")
+    else
+      key
+
+  html_safe_translation_key: (key) ->
+    /(\b|_|\.)html$/.test(key)
+
+  wrap_translate_defaults: (defaults) ->
+    new_defaults = []
+    defaults     = _.toArray(defaults)
+    while key = defaults.shift()
+      if _.isString(key)
+        new_defaults.push (_, options) -> @translate(key, _.extend(options, default: defaults))
+        break
+      else
+        new_defaults.push key
+    new_defaults

data/app/assets/javascripts/ultimate/jquery-plugin-adapter.js.coffee

@@ -0,0 +1,63 @@
+#= require ./base
+
+###*
+ * Make $.fn.pluginName() as adapter to plugin object (instance of Ultimate.Plugin or Backbone.View).
+ * First call on jQuery object invoke View functionality for the first element in the set of matched elements.
+ * Subsequent calls forwarding on view methods or return view property.
+ * If last argument {Boolean} true, then returns {Plugin or View}.
+ * @usage
+ *   construction    .pluginName([Object options = {}])           : {jQuery} jContainer
+ *   updateOptions   .pluginName({Object} options)                : {Object} view options
+ *   get options     .pluginName("options")                       : {Object} view options
+ *   some method     .pluginName("methodName", *methodArguments)  : {jQuery} chanin object or {AnotherType} method result
+###
+
+Ultimate.createJQueryPlugin = (pluginName, pluginClass) ->
+  Ultimate.debug(".createJQueryPlugin()", pluginName, pluginClass)  if _.isFunction(Ultimate.debug)
+  jQuery.fn[pluginName] = -> @ultimatePluginAdapter pluginName, pluginClass, arguments
+
+
+
+do ($ = jQuery) ->
+
+  $.fn.ultimatePluginAdapter = (pluginName, pluginClass, pluginArgs) ->
+    args = _.toArray(pluginArgs)
+    # Shall return the Plugin, if have arguments and last argument of the call is a Boolean true.
+    _returnPlugin =
+      if args.length and _.isBoolean(_.last(args))
+        args.pop()
+      else
+        false
+    unless @length
+      return if _returnPlugin then null else @
+    # get the first
+    jContainer = @first()
+    # try to get the plugin object, controlling everything that happens in our magical container
+    plugin = jContainer.data(pluginName)
+    if plugin? and plugin.$el[0] is jContainer[0]
+      command = null
+      if args.length and _.isString(args[0])
+        command = args.shift()
+      else
+        if args.length and $.isPlainObject(args[0])
+          command = "_configure"
+        else
+          return if _returnPlugin then plugin else jContainer
+      if command of plugin
+        value = plugin[command]
+        return if _.isFunction(value)
+            plugin.$el.removeData(pluginName)  if command is "destroy"
+            result = value.apply(plugin, args)
+            if command is "_configure" then plugin.options else result
+          else
+            value
+      else
+        $.error "Command [#{command}] does not exist on jQuery.#{pluginName}()"
+    else
+      options = args[0] or {}
+      if $.isPlainObject(options)
+        plugin = new pluginClass(_.extend(options, el: jContainer[0]))
+        plugin.$el.data(pluginName, plugin)
+      else
+        $.error "First argument of jQuery.#{pluginName}() must be plain object"
+    if _returnPlugin then plugin else jContainer

data/app/assets/javascripts/ultimate/jquery-plugin-class.js.coffee

@@ -0,0 +1,104 @@
+# `pluginClass` must store propery `$el` as jQuery object wrapped on the target DOM-object in his instance.
+
+#= require ./base
+
+class Ultimate.Plugin
+  $el: null
+  nodes: {}
+  events: {}
+
+  options: {}
+
+  locale: "en"
+  translations: {}
+
+  constructor: (options) ->
+    @$el = $(options.el)
+    @delegateEvents()
+    @findNodes()
+
+  findNodes: (jRoot = @$el, nodes = @nodes) ->
+    jNodes = {}
+    nodes = nodes()  if _.isFunction(nodes)
+    if _.isObject(nodes)
+      for nodeName, selector of nodes
+        _isObject = _.isObject(selector)
+        if _isObject
+          nestedNodes = selector
+          selector = _.outcasts.delete(nestedNodes, "selector")
+        jNodes[nodeName] = @[nodeName] = jRoot.find(selector)
+        if _isObject
+          _.extend jNodes, @findNodes(jNodes[nodeName], nestedNodes)
+    jNodes
+
+  undelegateEvents: ->
+    @$el.unbind ".delegateEvents#{@cid}"
+
+  # Cached regex to split keys for `delegate`, from backbone.js.
+  delegateEventSplitter = /^(\S+)\s*(.*)$/
+
+  # delegateEvents() from backbone.js
+  _delegateEvents: (events = _.result(@, "events")) ->
+    return  unless events
+    @undelegateEvents()
+    for key, method of events
+      method = @[events[key]]  unless _.isFunction(method)
+      throw new Error("Method \"#{events[key]}\" does not exist")  unless method
+      [[], eventName, selector] = key.match(delegateEventSplitter)
+      method = _.bind(method, @)
+      eventName += ".delegateEvents#{@cid}"
+      if selector is ''
+        @$el.bind(eventName, method)
+      else
+        @$el.delegate(selector, eventName, method)
+
+  # Overload and proxy parent method Backbone.View.delegateEvents() as hook for normalizeEvents().
+  delegateEvents: (events) ->
+    args = []
+    Array::push.apply args, arguments  if arguments.length > 0
+    args[0] = @normalizeEvents(events)
+    @_delegateEvents args...
+
+  normalizeEvents: (events) ->
+    events = _.result(@, "events")  unless events
+    if events
+      normalizedEvents = {}
+      for key, method of events
+        [[], eventName, selector] = key.match(delegateEventSplitter)
+        selector = _.result(@, selector)
+        selector = selector.selector if selector instanceof jQuery
+        if _.isString(selector)
+          key = "#{eventName} #{selector}"
+        normalizedEvents[key] = method
+      events = normalizedEvents
+    events
+
+  _configure: (options) ->
+    _.extend @options, options
+    @initTranslations()
+    @reflectOptions()
+
+  reflectOptions: (viewOptions = _.result(@, "viewOptions"), options = @options) ->
+    @[attr] = options[attr]  for attr in viewOptions  when typeof options[attr] isnt "undefined"
+    @[attr] = value  for attr, value of options  when typeof @[attr] isnt "undefined"
+    @
+
+  # use I18n, and modify locale and translations in options
+  # modify and return merged data
+  initTranslations: (options = @options) ->
+    # if global compatible I18n
+    if I18n? and I18n.locale and I18n.t
+      options["locale"] ||= I18n.locale
+      if options["locale"] is I18n.locale
+        # pointing to defaults locales of language specified in I18n
+        _defaultLocales = @constructor.defaultLocales?[I18n.locale] ||= {}
+        unless _defaultLocales["loaded"]
+          _defaultLocales["loaded"] = true
+          # try read localized strings
+          if _localesFromI18n = I18n.t(options["i18nKey"] or _.underscored(@constructor.pluginName or @constructor.name))
+            # fill it from I18n
+            _.extend _defaultLocales, _localesFromI18n
+    @locale = options["locale"]  if options["locale"]
+    translations = if @locale then @constructor.defaultLocales?[@locale] or {} else {}
+    $.extend true, options, translations: translations, options
+    options

data/lib/ultimate/base/version.rb

@@ -1,5 +1,5 @@
 module Ultimate
   module Base
-    VERSION = "0.3.0"
+    VERSION = "0.3.1"
   end
 end

data/test/javascripts/tests/helpers/translation_test.js.coffee

@@ -0,0 +1,140 @@
+###
+require 'abstract_unit'
+
+class TranslationHelperTest < ActiveSupport::TestCase
+  include ActionView::Helpers::TagHelper
+  include ActionView::Helpers::TranslationHelper
+
+  attr_reader :request, :view
+
+  def setup
+    I18n.backend.store_translations(:en,
+      :translations => {
+        :templates => {
+          :found => { :foo => 'Foo' },
+          :array => { :foo => { :bar => 'Foo Bar' } },
+          :default => { :foo => 'Foo' }
+        },
+        :foo => 'Foo',
+        :hello => '<a>Hello World</a>',
+        :html => '<a>Hello World</a>',
+        :hello_html => '<a>Hello World</a>',
+        :interpolated_html => '<a>Hello %{word}</a>',
+        :array_html => %w(foo bar),
+        :array => %w(foo bar),
+        :count_html => {
+          :one   => '<a>One %{count}</a>',
+          :other => '<a>Other %{count}</a>'
+        }
+      }
+    )
+    @view = ::ActionView::Base.new(ActionController::Base.view_paths, {})
+  end
+
+  def test_delegates_to_i18n_setting_the_rescue_format_option_to_html
+    I18n.expects(:translate).with(:foo, :locale => 'en', :rescue_format => :html).returns("")
+    translate :foo, :locale => 'en'
+  end
+
+  def test_delegates_localize_to_i18n
+    @time = Time.utc(2008, 7, 8, 12, 18, 38)
+    I18n.expects(:localize).with(@time)
+    localize @time
+  end
+
+  def test_returns_missing_translation_message_wrapped_into_span
+    expected = '<span class="translation_missing" title="translation missing: en.translations.missing">Missing</span>'
+    assert_equal expected, translate(:"translations.missing")
+    assert_equal true, translate(:"translations.missing").html_safe?
+  end
+
+  def test_returns_missing_translation_message_using_nil_as_rescue_format
+    expected = 'translation missing: en.translations.missing'
+    assert_equal expected, translate(:"translations.missing", :rescue_format => nil)
+    assert_equal false, translate(:"translations.missing", :rescue_format => nil).html_safe?
+  end
+
+  def test_i18n_translate_defaults_to_nil_rescue_format
+    expected = 'translation missing: en.translations.missing'
+    assert_equal expected, I18n.translate(:"translations.missing")
+    assert_equal false, I18n.translate(:"translations.missing").html_safe?
+  end
+
+  def test_translation_returning_an_array
+    expected = %w(foo bar)
+    assert_equal expected, translate(:"translations.array")
+  end
+
+  def test_finds_translation_scoped_by_partial
+    assert_equal 'Foo', view.render(:file => 'translations/templates/found').strip
+  end
+
+  def test_finds_array_of_translations_scoped_by_partial
+    assert_equal 'Foo Bar', @view.render(:file => 'translations/templates/array').strip
+  end
+
+  def test_default_lookup_scoped_by_partial
+    assert_equal 'Foo', view.render(:file => 'translations/templates/default').strip
+  end
+
+  def test_missing_translation_scoped_by_partial
+    expected = '<span class="translation_missing" title="translation missing: en.translations.templates.missing.missing">Missing</span>'
+    assert_equal expected, view.render(:file => 'translations/templates/missing').strip
+  end
+
+  def test_translate_does_not_mark_plain_text_as_safe_html
+    assert_equal false, translate(:'translations.hello').html_safe?
+  end
+
+  def test_translate_marks_translations_named_html_as_safe_html
+    assert translate(:'translations.html').html_safe?
+  end
+
+  def test_translate_marks_translations_with_a_html_suffix_as_safe_html
+    assert translate(:'translations.hello_html').html_safe?
+  end
+
+  def test_translate_escapes_interpolations_in_translations_with_a_html_suffix
+    assert_equal '<a>Hello &lt;World&gt;</a>', translate(:'translations.interpolated_html', :word => '<World>')
+    assert_equal '<a>Hello &lt;World&gt;</a>', translate(:'translations.interpolated_html', :word => stub(:to_s => "<World>"))
+  end
+
+  def test_translate_with_html_count
+    assert_equal '<a>One 1</a>', translate(:'translations.count_html', :count => 1)
+    assert_equal '<a>Other 2</a>', translate(:'translations.count_html', :count => 2)
+    assert_equal '<a>Other &lt;One&gt;</a>', translate(:'translations.count_html', :count => '<One>')
+  end
+
+  def test_translation_returning_an_array_ignores_html_suffix
+    assert_equal ["foo", "bar"], translate(:'translations.array_html')
+  end
+
+  def test_translate_with_default_named_html
+    translation = translate(:'translations.missing', :default => :'translations.hello_html')
+    assert_equal '<a>Hello World</a>', translation
+    assert_equal true, translation.html_safe?
+  end
+
+  def test_translate_with_two_defaults_named_html
+    translation = translate(:'translations.missing', :default => [:'translations.missing_html', :'translations.hello_html'])
+    assert_equal '<a>Hello World</a>', translation
+    assert_equal true, translation.html_safe?
+  end
+
+  def test_translate_with_last_default_named_html
+    translation = translate(:'translations.missing', :default => [:'translations.missing', :'translations.hello_html'])
+    assert_equal '<a>Hello World</a>', translation
+    assert_equal true, translation.html_safe?
+  end
+
+  def test_translate_with_string_default
+    translation = translate(:'translations.missing', default: 'A Generic String')
+    assert_equal 'A Generic String', translation
+  end
+
+  def test_translate_with_array_of_string_defaults
+    translation = translate(:'translations.missing', default: ['A Generic String', 'Second generic string'])
+    assert_equal 'A Generic String', translation
+  end
+end
+###

data/test/javascripts/tests/jquery-plugin-adapter_test.js.coffee

@@ -0,0 +1,11 @@
+#= require ultimate/underscore/underscore
+#= require ultimate/jquery-plugin-class
+#= require ultimate/jquery-plugin-adapter
+
+module "jquery-plugin-adapter"
+
+class TestPlugin extends Ultimate.Plugin
+
+test "Ultimate.createJQueryPlugin", ->
+  testPlugin = Ultimate.createJQueryPlugin("testPlugin", TestPlugin)
+  ok _.isFunction(testPlugin)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ultimate-base
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-10 00:00:00.000000000 Z
+date: 2012-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &18599780 !ruby/object:Gem::Requirement
+  requirement: &21906680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 3.2.8
   type: :development
   prerelease: false
-  version_requirements: *18599780
+  version_requirements: *21906680
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &18599360 !ruby/object:Gem::Requirement
+  requirement: &21906240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *18599360
+  version_requirements: *21906240
 - !ruby/object:Gem::Dependency
   name: coffee-rails
-  requirement: &16981960 !ruby/object:Gem::Requirement
+  requirement: &21905660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,7 +43,7 @@ dependencies:
         version: 3.2.1
   type: :development
   prerelease: false
-  version_requirements: *16981960
+  version_requirements: *21905660
 description: Ultimate UI core, base helpers and improves for Ruby on Rails Front-end
 email:
 - koderfunk@gmail.com
@@ -63,13 +63,13 @@ files:
 - app/assets/javascripts/ultimate/backbone/base.js.coffee
 - app/assets/javascripts/ultimate/backbone/collection.js.coffee
 - app/assets/javascripts/ultimate/backbone/extra/jquery-ext.js.coffee
-- app/assets/javascripts/ultimate/backbone/extra/jquery-plugin-adapter.js.coffee
 - app/assets/javascripts/ultimate/backbone/lib/backbone.js
 - app/assets/javascripts/ultimate/backbone/model.js.coffee
 - app/assets/javascripts/ultimate/backbone/router.js.coffee
 - app/assets/javascripts/ultimate/backbone/view.js.coffee
 - app/assets/javascripts/ultimate/backbone/views/slider.js.coffee
 - app/assets/javascripts/ultimate/backbone/views/typed-fields.js.coffee
+- app/assets/javascripts/ultimate/base.js.coffee
 - app/assets/javascripts/ultimate/experimental/_inflections/inflections.js.coffee
 - app/assets/javascripts/ultimate/experimental/_inflections/plur.js
 - app/assets/javascripts/ultimate/experimental/fuzzy-json-generator.js.coffee
@@ -80,6 +80,7 @@ files:
 - app/assets/javascripts/ultimate/helpers/number.js.coffee
 - app/assets/javascripts/ultimate/helpers/record_tag.js.coffee
 - app/assets/javascripts/ultimate/helpers/tag.js.coffee
+- app/assets/javascripts/ultimate/helpers/translation.js.coffee
 - app/assets/javascripts/ultimate/helpers/url.js.coffee
 - app/assets/javascripts/ultimate/improves/datepicker.js.coffee
 - app/assets/javascripts/ultimate/improves/devise.js.coffee
@@ -89,6 +90,8 @@ files:
 - app/assets/javascripts/ultimate/improves/magic-radios.js.coffee
 - app/assets/javascripts/ultimate/improves/tablesorter.js
 - app/assets/javascripts/ultimate/improves/typed-fields.js.coffee
+- app/assets/javascripts/ultimate/jquery-plugin-adapter.js.coffee
+- app/assets/javascripts/ultimate/jquery-plugin-class.js.coffee
 - app/assets/javascripts/ultimate/jquery.base.js.coffee
 - app/assets/javascripts/ultimate/underscore/underscore.inflection.js
 - app/assets/javascripts/ultimate/underscore/underscore.js
@@ -167,9 +170,11 @@ files:
 - test/javascripts/tests/helpers/number_test.js.coffee
 - test/javascripts/tests/helpers/record_tag_test.js.coffee
 - test/javascripts/tests/helpers/tag_test.js.coffee
+- test/javascripts/tests/helpers/translation_test.js.coffee
 - test/javascripts/tests/helpers/url_test.js.coffee
 - test/javascripts/tests/helpers_test.js.coffee
 - test/javascripts/tests/improves/i18n-lite_test.js.coffee
+- test/javascripts/tests/jquery-plugin-adapter_test.js.coffee
 - test/javascripts/tests/underscore/underscore.outcasts.test.js.coffee
 - test/stylesheets/test_helper.css
 - ultimate-base.gemspec

data/app/assets/javascripts/ultimate/backbone/extra/jquery-plugin-adapter.js.coffee

@@ -1,60 +0,0 @@
-#= require ./jquery-ext
-
-do ($ = jQuery) ->
-  $.fn.ultimateBackboneViewPluginAdapter = (pluginName, viewClass, pluginArgs) ->
-    a = []
-    Array::push.apply a, pluginArgs  if pluginArgs.length > 0
-    argsLength = a.length
-    # Shall return the View, if have arguments and last argument of the call is a Boolean true.
-    _returnView =
-      if argsLength and _.isBoolean(_.last(a))
-        argsLength--
-        a.pop()
-      else
-        false
-    unless @length
-      return if _returnView then undefined else @
-    # get the first   TODO analize, maybe each?
-    jContainer = @first()
-    # try to get the View-object, controlling everything that happens in our magical container
-    view = jContainer.getView(viewClass)
-    if view and view.$el[0] is jContainer[0]
-      command = null
-      if argsLength and _.isString(a[0])
-        command = a.shift()
-      else
-        return view  if _returnView
-        return jContainer  unless argsLength
-        command = "_configure"
-      if view[command]
-        return _.result(view, command)
-      else
-        $.error "Command [#{command}] does not exist on jQuery.#{pluginName}()"
-    else
-      options = if argsLength then a[0] else {}
-      if $.isPlainObject(options)
-        view = new viewClass(_.extend({}, options, el: jContainer[0]))
-      else
-        $.error "First argument of jQuery.#{pluginName}() must be plain object"
-    if _returnView then view else jContainer
-
-
-###*
- * Make $.fn.pluginName() as wrapper under Backbone.View.
- * First call on jQuery object invoke View functionality for the first element in the set of matched elements.
- * Subsequent calls forwarding on view methods or return view property.
- * If last argument {Boolean} true, then returns {View}.
- * @usage
- *   construction    .pluginName([Object options = {}])           : {jQuery} jContainer
- *   updateOptions   .pluginName({Object} options)                : {Object} view options
- *   get options     .pluginName("options")                       : {Object} view options
- *   some method     .pluginName("methodName", *methodArguments)  : {jQuery} chanin object || {AnotherType} method result
-###
-
-Ultimate.Backbone.createJQueryPlugin = (pluginName, viewClass) ->
-  Ultimate.Backbone.debug ".createJQueryPlugin()", pluginName, viewClass
-  if Ultimate.Backbone.isViewClass(viewClass)
-    viewClass.pluginName = pluginName
-    jQuery.fn[pluginName] = -> @ultimateBackboneViewPluginAdapter pluginName, viewClass, arguments
-  else
-    jQuery.error "Second argument of Ultimate.Backbone.createJQueryPlugin() must be View class inherited from Backbone.View"