rasputin 0.9.1 → 0.10.0

data/vendor/assets/javascripts/sproutcore-utils.js

@@ -0,0 +1,73 @@
+(function(exports) {
+// ==========================================================================
+// Project:   SproutCore
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+var slice = Array.prototype.slice;
+
+var respondsTo = function(obj, methodName) {
+  return !!(obj[methodName] instanceof Function);
+};
+
+/**
+  @param {Object} obj The object to check for the method
+  @param {String} methodName The method name to check for
+*/
+SC.respondsTo = respondsTo;
+
+SC.Object.reopen(
+/** @scope SC.Object.prototype */{
+
+  respondsTo: function() {
+    var args = slice.call(arguments);
+    args.unshift(this);
+    return SC.respondsTo.apply(SC, args);
+  }
+
+});
+
+// ==========================================================================
+// Project:   SproutCore
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+var slice = Array.prototype.slice;
+
+var tryToPerform = function(obj, methodName) {
+  var args = slice.call(arguments);
+  args.shift(); args.shift();
+  return SC.respondsTo(obj, methodName) && (obj[methodName].apply(obj, args) !== false);
+};
+
+/**
+  Checks to see if the `methodName` exists on the `obj`,
+  and if it does, invokes it with the arguments passed.
+
+  @function
+
+  @param {Object} obj The object to check for the method
+  @param {String} methodName The method name to check for
+  @param {Object...} args The arguments to pass to the method
+
+  @returns {Boolean} true if the method does not return false
+  @returns {Boolean} false otherwise
+*/
+SC.tryToPerform = tryToPerform;
+
+SC.Object.reopen(
+/** @scope SC.Object.prototype */{
+
+  tryToPerform: function() {
+    var args = slice.call(arguments);
+    args.unshift(this);
+    return SC.tryToPerform.apply(SC, args);
+  }
+
+});
+
+})({})

data/vendor/assets/javascripts/sproutcore.js

@@ -1,3 +1,4 @@
+//=require metamorph
 
 (function(exports) {
 // lib/handlebars/base.js
@@ -3579,8 +3580,10 @@ function beforeKey(eventName) {
 function xformForArgs(args) {
   return function (target, method, params) {
     var obj = params[0], keyName = changeKey(params[1]), val;
+    var copy_args = args.slice();
     if (method.length>2) val = SC.getPath(obj, keyName);
-    method.apply(target, [obj, keyName, val].concat(args));
+    copy_args.unshift(obj, keyName, val);
+    method.apply(target, copy_args);
   }
 }
 
@@ -7989,7 +7992,7 @@ if (SC.EXTEND_PROTOTYPES) {
   /**
     @see SC.String.dasherize
   */
-  String.prototype.dashersize = function() {
+  String.prototype.dasherize = function() {
     return dasherize(this);
   };
 }
@@ -10159,6 +10162,8 @@ SC._RenderBuffer = SC.Object.extend(
   */
   replaceWithBuffer: function(newBuffer) {
     var parent = get(this, 'parentBuffer');
+    if (!parent) { return; }
+
     var childBuffers = get(parent, 'childBuffers');
 
     var index = childBuffers.indexOf(this);
@@ -10259,37 +10264,43 @@ SC._RenderBuffer = SC.Object.extend(
         content = '',
         styleBuffer = [], prop;
 
-    var openTag = ["<" + tag];
+    if (tag) {
+      var openTag = ["<" + tag];
 
-    if (id) { openTag.push('id="' + id + '"'); }
-    if (classes.length) { openTag.push('class="' + classes.join(" ") + '"'); }
+      if (id) { openTag.push('id="' + id + '"'); }
+      if (classes.length) { openTag.push('class="' + classes.join(" ") + '"'); }
 
-    if (!jQuery.isEmptyObject(style)) {
-      for (prop in style) {
-        if (style.hasOwnProperty(prop)) {
-          styleBuffer.push(prop + ':' + style[prop] + ';');
+      if (!jQuery.isEmptyObject(style)) {
+        for (prop in style) {
+          if (style.hasOwnProperty(prop)) {
+            styleBuffer.push(prop + ':' + style[prop] + ';');
+          }
         }
-      }
 
-      openTag.push('style="' + styleBuffer.join("") + '"');
-    }
+        openTag.push('style="' + styleBuffer.join("") + '"');
+      }
 
-    for (prop in attrs) {
-      if (attrs.hasOwnProperty(prop)) {
-        openTag.push(prop + '="' + attrs[prop] + '"');
+      for (prop in attrs) {
+        if (attrs.hasOwnProperty(prop)) {
+          openTag.push(prop + '="' + attrs[prop] + '"');
+        }
       }
-    }
 
-    openTag = openTag.join(" ") + '>';
+      openTag = openTag.join(" ") + '>';
+    }
 
     var childBuffers = get(this, 'childBuffers');
 
     childBuffers.forEach(function(buffer) {
       var stringy = typeof buffer === 'string';
-      content = content + (stringy ? buffer : buffer.string());
+      content += (stringy ? buffer : buffer.string());
     });
 
-    return openTag + content + "</" + tag + ">";
+    if (tag) {
+      return openTag + content + "</" + tag + ">";
+    } else {
+      return content;
+    }
   }
 
 });
@@ -10610,6 +10621,22 @@ queues.insertAt(queues.indexOf('actions')+1, 'render');
 var get = SC.get, set = SC.set, addObserver = SC.addObserver;
 var getPath = SC.getPath, meta = SC.meta, fmt = SC.String.fmt;
 
+var childViewsProperty = SC.computed(function() {
+  var childViews = get(this, '_childViews');
+
+  var ret = [];
+
+  childViews.forEach(function(view) {
+    if (view.isVirtual) {
+      ret = ret.concat(get(view, 'childViews'));
+    } else {
+      ret.push(view);
+    }
+  });
+
+  return ret;
+}).property('_childViews.@each').cacheable();
+
 /**
   @static
 
@@ -10719,7 +10746,17 @@ SC.View = SC.Object.extend(
     @type SC.View
     @default null
   */
-  parentView: null,
+  _parentView: null,
+
+  parentView: function() {
+    var parent = get(this, '_parentView');
+
+    if (parent && parent.isVirtual) {
+      return get(parent, 'parentView');
+    } else {
+      return parent;
+    }
+  }.property('_parentView'),
 
   /**
     If false, the view will appear hidden in DOM.
@@ -10737,7 +10774,9 @@ SC.View = SC.Object.extend(
     @type Array
     @default []
   */
-  childViews: [],
+  childViews: childViewsProperty,
+
+  _childViews: [],
 
   /**
     Return the nearest ancestor that is an instance of the provided
@@ -10747,11 +10786,11 @@ SC.View = SC.Object.extend(
     @returns SC.View
   */
   nearestInstanceOf: function(klass) {
-    var view = this.parentView;
+    var view = get(this, 'parentView');
 
     while (view) {
       if(view instanceof klass) { return view; }
-      view = view.parentView;
+      view = get(view, 'parentView');
     }
   },
 
@@ -10762,11 +10801,11 @@ SC.View = SC.Object.extend(
     @returns SC.View
   */
   nearestWithProperty: function(property) {
-    var view = this.parentView;
+    var view = get(this, 'parentView');
 
     while (view) {
       if (property in view) { return view; }
-      view = view.parentView;
+      view = get(view, 'parentView');
     }
   },
 
@@ -10778,11 +10817,11 @@ SC.View = SC.Object.extend(
     @returns SC.View
   */
   nearestChildOf: function(klass) {
-    var view = this.parentView;
+    var view = get(this, 'parentView');
 
     while (view) {
-      if(view.parentView instanceof klass) { return view; }
-      view = view.parentView;
+      if(get(view, 'parentView') instanceof klass) { return view; }
+      view = get(view, 'parentView');
     }
   },
 
@@ -10827,7 +10866,7 @@ SC.View = SC.Object.extend(
       view.propertyDidChange('itemView');
       view.propertyDidChange('contentView');
     });
-  }.observes('parentView'),
+  }.observes('_parentView'),
 
   /**
     Called on your view when it should push strings of HTML into a
@@ -10911,9 +10950,9 @@ SC.View = SC.Object.extend(
     // we re-render.
 
     // VIEW-TODO: Unit test this path.
-    var childViews = get(this, 'childViews');
+    var childViews = get(this, '_childViews');
     for (var i=lengthAfter-1; i>=lengthBefore; i--) {
-      childViews[i] && childViews[i].destroy();
+      if (childViews[i]) { childViews[i].destroy(); }
     }
   },
 
@@ -11084,7 +11123,7 @@ SC.View = SC.Object.extend(
     } else {
       return this.invokeForState('getElement');
     }
-  }.property('parentView', 'state').cacheable(),
+  }.property('_parentView', 'state').cacheable(),
 
   /**
     Returns a jQuery object for this view's element. If you pass in a selector
@@ -11103,7 +11142,7 @@ SC.View = SC.Object.extend(
 
   /** @private */
   mutateChildViews: function(callback) {
-    var childViews = get(this, 'childViews'),
+    var childViews = get(this, '_childViews'),
         idx = get(childViews, 'length'),
         view;
 
@@ -11117,7 +11156,7 @@ SC.View = SC.Object.extend(
 
   /** @private */
   forEachChildView: function(callback) {
-    var childViews = get(this, 'childViews'),
+    var childViews = get(this, '_childViews'),
         len = get(childViews, 'length'),
         view, idx;
 
@@ -11240,7 +11279,10 @@ SC.View = SC.Object.extend(
     @returns {SC.RenderBuffer}
   */
   renderBuffer: function(tagName) {
-    return SC.RenderBuffer(tagName || get(this, 'tagName') || 'div');
+    tagName = tagName || get(this, 'tagName');
+    if (tagName == null) { tagName = tagName || 'div'; }
+
+    return SC.RenderBuffer(tagName);
   },
 
   /**
@@ -11423,7 +11465,10 @@ SC.View = SC.Object.extend(
     // provided buffer operation (for example, `insertAfter` will
     // insert a new buffer after the "parent buffer").
     if (parentBuffer) {
-      buffer = parentBuffer[bufferOperation](get(this, 'tagName') || 'div');
+      var tagName = get(this, 'tagName');
+      tagName = tagName == null ? 'div' : tagName;
+
+      buffer = parentBuffer[bufferOperation](tagName);
     } else {
       buffer = this.renderBuffer();
     }
@@ -11431,16 +11476,23 @@ SC.View = SC.Object.extend(
     viewMeta.buffer = buffer;
     this.transitionTo('inBuffer');
 
-    viewMeta.lengthBeforeRender = getPath(this, 'childViews.length');
+    viewMeta.lengthBeforeRender = getPath(this, '_childViews.length');
 
-    this.applyAttributesToBuffer(buffer);
+    this.beforeRender(buffer);
     this.render(buffer);
+    this.afterRender(buffer);
 
-    viewMeta.lengthAfterRender = getPath(this, 'childViews.length');
+    viewMeta.lengthAfterRender = getPath(this, '_childViews.length');
 
     return buffer;
   },
 
+  beforeRender: function(buffer) {
+    this.applyAttributesToBuffer(buffer);
+  },
+
+  afterRender: SC.K,
+
   /**
     @private
   */
@@ -11584,7 +11636,7 @@ SC.View = SC.Object.extend(
   init: function() {
     set(this, 'state', 'preRender');
 
-    var parentView = get(this, 'parentView');
+    var parentView = get(this, '_parentView');
 
     this._super();
 
@@ -11592,27 +11644,16 @@ SC.View = SC.Object.extend(
     // SC.RootResponder to dispatch incoming events.
     SC.View.views[get(this, 'elementId')] = this;
 
-    var childViews = get(this, 'childViews').slice();
+    var childViews = get(this, '_childViews').slice();
     // setup child views. be sure to clone the child views array first
-    set(this, 'childViews', childViews);
+    set(this, '_childViews', childViews);
 
-    this.mutateChildViews(function(viewName, idx) {
-      var view;
-
-      if ('string' === typeof viewName) {
-        view = get(this, viewName);
-        view = this.createChildView(view);
-        childViews[idx] = view;
-        set(this, viewName, view);
-      } else if (viewName.isClass) {
-        view = this.createChildView(viewName);
-        childViews[idx] = view;
-      }
-    });
 
     this.classNameBindings = get(this, 'classNameBindings').slice();
     this.classNames = get(this, 'classNames').slice();
 
+    this.set('domManager', this.domManagerClass.create({ view: this }));
+
     meta(this)["SC.View"] = {};
   },
 
@@ -11628,10 +11669,10 @@ SC.View = SC.Object.extend(
   */
   removeChild: function(view) {
     // update parent node
-    set(view, 'parentView', null);
+    set(view, '_parentView', null);
 
     // remove view from childViews array.
-    var childViews = get(this, 'childViews');
+    var childViews = get(this, '_childViews');
     childViews.removeObject(view);
 
     return this;
@@ -11661,7 +11702,7 @@ SC.View = SC.Object.extend(
     @returns {SC.View} receiver
   */
   removeFromParent: function() {
-    var parent = get(this, 'parentView');
+    var parent = get(this, '_parentView');
 
     // Remove DOM element from parent
     this.remove();
@@ -11682,8 +11723,8 @@ SC.View = SC.Object.extend(
     // calling this._super() will nuke computed properties and observers,
     // so collect any information we need before calling super.
     var viewMeta   = meta(this)['SC.View'],
-        childViews = get(this, 'childViews'),
-        parent     = get(this, 'parentView'),
+        childViews = get(this, '_childViews'),
+        parent     = get(this, '_parentView'),
         elementId  = get(this, 'elementId'),
         childLen   = childViews.length;
 
@@ -11723,10 +11764,10 @@ SC.View = SC.Object.extend(
   */
   createChildView: function(view, attrs) {
     if (SC.View.detect(view)) {
-      view = view.create(attrs || {}, { parentView: this });
+      view = view.create(attrs || {}, { _parentView: this });
     } else {
       sc_assert('must pass instance of View', view instanceof SC.View);
-      set(view, 'parentView', this);
+      set(view, '_parentView', this);
     }
     return view;
   },
@@ -11785,12 +11826,41 @@ SC.View = SC.Object.extend(
   // are done on the DOM element.
 
 SC.View.reopen({
-  states: SC.View.states
+  states: SC.View.states,
+  domManagerClass: SC.Object.extend({
+    view: this,
+
+    replace: function() {
+      var view = get(this, 'view');
+      var element = get(view, 'element');
+
+      set(view, 'element', null);
+
+      view._insertElementLater(function() {
+        SC.$(element).replaceWith(get(view, 'element'));
+      });
+    },
+
+    remove: function() {
+      var view = get(this, 'view');
+      var elem = get(view, 'element');
+
+      set(view, 'element', null);
+
+      SC.$(elem).remove();
+    }
+  })
 });
 
 // Create a global view hash.
 SC.View.views = {};
 
+// If someone overrides the child views computed property when
+// defining their class, we want to be able to process the user's
+// supplied childViews and then restore the original computed property
+// at view initialization time. This happens in SC.ContainerView's init
+// method.
+SC.View.childViewsProperty = childViewsProperty;
 
 })({});
 
@@ -11914,7 +11984,7 @@ SC.View.states.inBuffer = {
     var buffer = meta(view)['SC.View'].buffer;
 
     childView = this.createChildView(childView, options);
-    view.childViews.pushObject(childView);
+    get(view, '_childViews').pushObject(childView);
     childView.renderToBuffer(buffer);
     return childView;
   },
@@ -11974,7 +12044,7 @@ SC.View.states.inDOM = {
   getElement: function(view) {
     var parent = get(view, 'parentView');
     if (parent) { parent = get(parent, 'element'); }
-    if (parent) { return ret = view.findElementInParentElement(parent); }
+    if (parent) { return view.findElementInParentElement(parent); }
   },
 
   setElement: function(view, value) {
@@ -11983,7 +12053,7 @@ SC.View.states.inDOM = {
       view.invalidateRecursively('element');
       view.transitionTo('preRender');
     } else {
-      throw "You cannot set an element to a non-null value when the element is already in the DOM."
+      throw "You cannot set an element to a non-null value when the element is already in the DOM.";
     }
 
     return value;
@@ -11992,29 +12062,21 @@ SC.View.states.inDOM = {
   // once the view has been inserted into the DOM, rerendering is
   // deferred to allow bindings to synchronize.
   rerender: function(view) {
-    var element = get(view, 'element');
-
     view.clearRenderedChildren();
-    set(view, 'element', null);
 
-    view._insertElementLater(function() {
-      SC.$(element).replaceWith(get(view, 'element'));
-    });
+    get(view, 'domManager').replace();
+    return view;
   },
 
   // once the view is already in the DOM, destroying it removes it
   // from the DOM, nukes its element, and puts it back into the
   // preRender state.
   destroyElement: function(view) {
-    var elem = get(this, 'element');
-
     view.invokeRecursively(function(view) {
       this.willDestroyElement();
     });
 
-    set(view, 'element', null);
-
-    SC.$(elem).remove();
+    get(view, 'domManager').remove();
     return view;
   },
 
@@ -12087,7 +12149,35 @@ SC.View.states.destroyed = {
 
 var get = SC.get, set = SC.set, meta = SC.meta;
 
+var childViewsProperty = SC.computed(function() {
+  return get(this, '_childViews');
+}).property('_childViews').cacheable();
+
 SC.ContainerView = SC.View.extend({
+
+  init: function() {
+    var childViews = get(this, 'childViews');
+    SC.defineProperty(this, 'childViews', childViewsProperty);
+
+    this._super();
+
+    var _childViews = get(this, '_childViews');
+
+    childViews.forEach(function(viewName, idx) {
+      var view;
+
+      if ('string' === typeof viewName) {
+        view = get(this, viewName);
+        view = this.createChildView(view);
+        set(this, viewName, view);
+      } else {
+        view = this.createChildView(viewName);
+      }
+
+      _childViews[idx] = view;
+    }, this);
+  },
+
   /**
     Extends SC.View's implementation of renderToBuffer to
     set up an array observer on the child views array. This
@@ -12901,6 +12991,57 @@ SC.TextArea.KEY_EVENTS = {
 
 
 
+})({});
+
+
+(function(exports) {
+
+
+var set = SC.set, get = SC.get, getPath = SC.getPath;
+
+SC.MetamorphView = SC.View.extend({
+  isVirtual: true,
+  tagName: '',
+
+  init: function() {
+    this._super();
+    set(this, 'morph', Metamorph());
+  },
+
+  beforeRender: function(buffer) {
+    var morph = get(this, 'morph');
+    buffer.push(morph.startTag());
+  },
+
+  afterRender: function(buffer) {
+    var morph = get(this, 'morph');
+    buffer.push(morph.endTag());
+  },
+
+  domManagerClass: SC.Object.extend({
+    // It is not possible for a user to directly remove
+    // a metamorph view as it is not in the view hierarchy.
+    remove: SC.K,
+
+    replace: function() {
+      var view = get(this, 'view');
+      var morph = getPath(this, 'view.morph');
+
+      view.transitionTo('preRender');
+      view.clearRenderedChildren();
+      var buffer = view.renderToBuffer();
+
+      SC.run.schedule('render', this, function() {
+        // FIXME: patch metamorph
+        morph.html(buffer.string());
+        //morph.replaceWith(buffer.string());
+        view.transitionTo('inDOM');
+      });
+    }
+  })
+});
+
+
 })({});
 
 
@@ -12914,6 +13055,7 @@ SC.TextArea.KEY_EVENTS = {
 
 var get = SC.get, set = SC.set, getPath = SC.getPath;
 
+
 /**
   @ignore
   @private
@@ -12927,19 +13069,9 @@ var get = SC.get, set = SC.set, getPath = SC.getPath;
   context set up. When the associated property changes, just the template for 
   this view will re-render.
 */
-SC._BindableSpanView = SC.View.extend(
+SC._BindableSpanView = SC.MetamorphView.extend(
 /** @scope SC._BindableSpanView.prototype */{
 
-  /**
-   The type of HTML tag to use. To ensure compatibility with
-   Internet Explorer 7, a `<span>` tag is used to ensure that inline elements are
-   not rendered with display: block.
-
-   @type String
-   @default 'span'
-  */
-  tagName: 'span',
-
   /**
     The function used to determine if the `displayTemplate` or
     `inverseTemplate` should be rendered. This should be a function that takes
@@ -13061,6 +13193,13 @@ SC._BindableSpanView = SC.View.extend(
     }
 
     return this._super(buffer);
+  },
+
+  destroy: function() {
+    var removeObserver = get(this, 'removeObserver');
+    removeObserver();
+
+    this._super();
   }
 });
 
@@ -13076,7 +13215,8 @@ SC._BindableSpanView = SC.View.extend(
 /*globals Handlebars */
 
 
-var get = SC.get, getPath = SC.getPath, fmt = SC.String.fmt;
+
+var get = SC.get, getPath = SC.getPath, set = SC.set, fmt = SC.String.fmt;
 
 (function() {
   // Binds a property into the DOM. This will create a hook in DOM that the
@@ -13100,32 +13240,22 @@ var get = SC.get, getPath = SC.getPath, fmt = SC.String.fmt;
         inverseTemplate: inverse,
         property: property,
         previousContext: ctx,
-        isEscaped: options.hash.escaped,
-	tagName: options.hash.tagName || 'span'
+        isEscaped: options.hash.escaped
       });
 
-      var observer, invoker;
-
       view.appendChild(bindView);
 
-      observer = function() {
-        if (get(bindView, 'element')) {
-          bindView.rerender();
-        } else {
-          // If no layer can be found, we can assume somewhere
-          // above it has been re-rendered, so remove the
-          // observer.
-          SC.removeObserver(ctx, property, invoker);
-        }
+      var observer = function() {
+        SC.run.once(function() { bindView.rerender(); });
       };
 
-      invoker = function() {
-        SC.run.once(observer);
-      };
+      set(bindView, 'removeObserver', function() {
+        SC.removeObserver(ctx, property, observer);
+      });
 
       // Observes the given property on the context and
       // tells the SC._BindableSpan to re-render.
-      SC.addObserver(ctx, property, invoker);
+      SC.addObserver(ctx, property, observer);
     } else {
       // The object is not observable, so just render it out and
       // be done with it.
@@ -13782,9 +13912,9 @@ Handlebars.registerHelper('debugger', function() {
 /*globals Handlebars */
 
 // Find templates stored in the head tag as script tags and make them available
-// to SC.CoreView in the global SC.TEMPLATES object.
-
-SC.$(document).ready(function() {
+// to SC.CoreView in the global SC.TEMPLATES object. This will be run as as
+// jQuery DOM-ready callback.
+SC.Handlebars.bootstrap = function() {
   SC.$('script[type="text/html"], script[type="text/x-handlebars"]')
     .each(function() {
     // Get a reference to the script tag
@@ -13831,7 +13961,9 @@ SC.$(document).ready(function() {
       });
     }
   });
-});
+};
+
+SC.$(document).ready(SC.Handlebars.bootstrap);
 
 })({});
 
@@ -13843,6 +13975,7 @@ SC.$(document).ready(function() {
 // License:   Licensed under MIT license (see license.js)
 // ==========================================================================
 
+
 })({});