spade 0.0.1

data/sproutcore/frameworks/desktop/english.lproj/well.css

@@ -0,0 +1,71 @@
+.sc-well-view .top-right-edge {
+  position: absolute;
+  width: 7px;
+  height: 7px;
+  top: 0px;
+  right: 0px;
+}
+
+.sc-well-view .top-left-edge {
+  position: absolute;
+  width: 7px;
+  height: 7px;
+  top: 0px;
+  left: 0px;
+}
+
+.sc-well-view .bottom-left-edge {
+  position: absolute;
+  width: 7px;
+  height: 7px;
+  bottom: 0px;
+  left: 0px;
+}
+
+.sc-well-view .bottom-right-edge {
+  position: absolute;
+  width: 7px;
+  height: 7px;
+  bottom: 0px;
+  right: 0px;
+}
+
+.sc-well-view .top-edge {
+  position: absolute;
+  height: 5px;
+  top: 0px;
+  right: 7px;
+  left: 7px;
+}
+
+.sc-well-view .bottom-edge {
+  position: absolute;
+  height: 5px;
+  bottom: 0px;
+  right: 7px;
+  left: 7px;
+}
+
+.sc-well-view .left-edge {
+  position: absolute;
+  width: 7px;
+  top: 7px;
+  bottom: 7px;
+  left: 0px;
+}
+
+.sc-well-view .right-edge {
+  position: absolute;
+  width: 7px;
+  top: 7px;
+  bottom: 7px;
+  right: 0px;
+}
+
+.sc-well-view .content-background {
+  position: absolute;
+  top: 5px;
+  bottom: 5px;
+  right: 7px;
+  left: 7px;
+}

data/sproutcore/frameworks/desktop/mixins/border.js

@@ -0,0 +1,151 @@
+// ========================================================================
+// SproutCore -- JavaScript Application Framework
+// Copyright ©2006-2011, Strobe Inc. and contributors.
+// Portions copyright ©2008 Apple Inc.  All rights reserved.
+// ========================================================================
+
+SC.BORDER_BEZEL  = 'sc-bezel-border';
+SC.BORDER_BLACK  = 'sc-black-border';
+SC.BORDER_GRAY   = 'sc-gray-border';
+SC.BORDER_TOP    = 'sc-top-border';
+SC.BORDER_BOTTOM = 'sc-bottom-border';
+SC.BORDER_NONE   = null ;
+
+/**
+  @namespace
+
+  The Border mixin can be applied to any view to give it a visual border.
+  In addition to specifying the mixin itself, you should specify the border
+  style with the borderStyle property on your view.
+
+  Border style can be any predefined CSS class name or a border color.
+
+  If you specify a CSS class name, it must end in "-border". Additionally,
+  you should set the borderTop, borderRight, borderBottom, and borderLeft
+  properties so SproutCore can accurately account for the size of your view.
+
+  SproutCore pre-defines several useful border styles including:
+
+- SC.BORDER_BEZEL  - displays an inlaid bezel
+- SC.BORDER_BLACK  - displays a black border
+- SC.BORDER_GRAY   - displays a gray border
+- SC.BORDER_TOP    - displays a border on the top only
+- SC.BORDER_BOTTOM - displays a border on the bottom only
+- SC.BORDER_NONE   - disables the border
+
+  @since SproutCore 1.0
+*/
+SC.Border = {
+  /**
+    The thickness of the top border.
+
+    @property {Number}
+    @commonTask Border Dimensions
+  */
+  borderTop: 0,
+
+  /**
+    The thickness of the right border.
+
+    @property {Number}
+    @commonTask Border Dimensions
+  */
+  borderRight: 0,
+
+  /**
+    The thickness of the bottom border.
+
+    @property {Number}
+    @commonTask Border Dimensions
+  */
+  borderBottom: 0,
+
+  /**
+    The thickness of the left border.
+
+    @property {Number}
+    @commonTask Border Dimensions
+  */
+  borderLeft: 0,
+
+  /**
+    The style of the border. You may specify a color string (like 'red' or
+    '#fff'), a CSS class name, or one of:
+- SC.BORDER_BEZEL
+- SC.BORDER_BLACK
+- SC.BORDER_GRAY
+- SC.BORDER_TOP
+- SC.BORDER_BOTTOM
+- SC.BORDER_NONE
+
+    If you specify a CSS class name, it must end in "-border".
+  */
+  borderStyle: SC.BORDER_GRAY,
+
+  /**
+    Walk like a duck
+
+    @private
+  */
+  hasBorder: YES,
+
+  /**
+    Make sure we re-render if the borderStyle property changes.
+    @private
+  */
+  displayProperties: ['borderStyle'],
+
+  /** @private */
+  _BORDER_REGEXP: (/-border$/),
+
+  /** @private */
+  initMixin: function() {
+    console.warn("SC.Border is deprecated, please set border in your layout");
+    this._sc_border_borderStyleDidChange();
+    this._sc_border_borderDimensionsDidChange();
+  },
+
+  /** @private */
+  renderMixin: function(context, firstTime) {
+    var style = this.get('borderStyle');
+    if (style) {
+      if (this._BORDER_REGEXP.exec(style)) {
+        context.addClass(style);
+      } else context.addStyle('border', '1px '+style+' solid');
+    }
+  },
+
+  /** @private */
+  _sc_border_borderStyleDidChange: function() {
+    var borderStyle = this.get('borderStyle'),
+        borderSize = SC.Border.dimensions[borderStyle];
+
+    if (borderSize) {
+      this.beginPropertyChanges();
+      this.set('borderTop', borderSize);
+      this.set('borderRight', borderSize);
+      this.set('borderBottom', borderSize);
+      this.set('borderLeft', borderSize);
+      this.endPropertyChanges();
+    }
+  },
+
+  _sc_border_borderDimensionsDidChange: function(){
+    var borderTop     = this.get('borderTop'),
+        borderRight   = this.get('borderRight'),
+        borderBottom  = this.get('borderBottom'),
+        borderLeft    = this.get('borderLeft');
+    this.adjust({ borderTop: borderTop, borderRight: borderRight, borderBottom: borderBottom, borderLeft: borderLeft });
+  }.observes('borderTop', 'borderRight', 'borderBottom', 'borderLeft')
+
+};
+
+SC.mixin(SC.Border, {
+  dimensions: {
+    'sc-bezel-border': 1,
+    'sc-black-border': 1,
+    'sc-gray-border': 1,
+    'sc-top-border': 1,
+    'sc-bottom-border': 1
+  }
+});

data/sproutcore/frameworks/desktop/mixins/collection_fast_path.js

@@ -0,0 +1,694 @@
+/** 
+  An experimental CollectionView mixin that makes it extremely fast under
+  certain circumstances, including for mobile devices.
+*/
+SC.CollectionFastPath = {
+  //
+  // ITEM VIEW CLASS/INSTANCE MANAGEMENT
+  //
+  initMixin: function() {
+    this._indexMap = {};
+  },
+  
+  /**
+    Returns the pool for a given example view.
+    
+    The pool is calculated based on the guid for the example view class.
+  */
+  poolForExampleView: function(exampleView) {
+    var poolKey = "_pool_" + SC.guidFor(exampleView);
+    if (!this[poolKey]) this[poolKey] = [];
+    return this[poolKey];
+  },
+  
+  /**
+    Creates an item view from a given example view, configuring it with basic settings
+    and the supplied attributes.
+  */
+  createItemViewFromExampleView: function(exampleView, attrs) {
+    // create the example view
+    var ret = this.createItemView(exampleView, null, attrs);
+    
+    // for our pooling, if it is poolable, mark the view as poolable and
+    // give it a reference to its pool.
+    if (ret.isPoolable) {
+      ret.owningPool = this.poolForExampleView(exampleView);
+    }
+    
+    // we will sometimes need to know what example view created the item view
+    ret.createdFromExampleView = exampleView;
+
+    // and now, return (duh)
+    return ret;
+  },
+  
+  configureItemView: function(itemView, attrs) {
+    // set settings. Self explanatory.
+    itemView.beginPropertyChanges();
+    itemView.setIfChanged('content', attrs.content);
+    itemView.setIfChanged('contentIndex', attrs.contentIndex);
+    itemView.setIfChanged('parentView', attrs.parentView);
+    itemView.setIfChanged('layerId', attrs.layerId);
+    itemView.setIfChanged('isEnabled', attrs.isEnabled);
+    itemView.setIfChanged('isSelected', attrs.isSelected);
+    itemView.setIfChanged('outlineLevel', attrs.outlineLevel);
+    itemView.setIfChanged('layout', attrs.layout);
+    itemView.setIfChanged('disclosureState', attrs.disclosureState);
+    itemView.setIfChanged('isVisibleInWindow', attrs.isVisibleInWindow);
+    itemView.setIfChanged('isGroupView', attrs.isGroupView);
+    itemView.setIfChanged('page', this.page);
+    itemView.endPropertyChanges();
+  },
+  
+  /**
+    Configures a pooled view, calling .awakeFromPool if it is defined.
+  */
+  wakePooledView: function(itemView, attrs) {
+    // configure
+    this.configureItemView(itemView, attrs);
+    
+    // awake from the pool, etc.
+    if (itemView.awakeFromPool) itemView.awakeFromPool(itemView.owningPool, this);
+  },
+  
+  /**
+    Gets an item view from an example view, from a pool if possible, and otherwise
+    by generating it.
+  */
+  allocateItemView: function(exampleView, attrs) {
+    // we will try to get it from a pool. This will fill ret. If ret is not
+    // filled, then we'll know to generate one.
+    var ret;
+    
+    // if it is poolable, we just grab from the pool.
+    if (exampleView.prototype.isPoolable) {
+      var pool = this.poolForExampleView(exampleView);
+      if (pool.length > 0) {
+        ret = pool.pop();
+        this.wakePooledView(ret, attrs);
+      }
+    }
+    
+    if (!ret) {
+      ret = this.createItemViewFromExampleView(exampleView, attrs);
+    }
+    
+    return ret;
+  },
+  
+  /**
+    Releases an item view. If the item view is pooled, it puts it into the pool;
+    otherwise, this calls .destroy().
+    
+    This is called for one of two purposes: to release a view that is no longer displaying,
+    or to release an older cached version of a view that needed to be replaced because the
+    example view changed.
+  */
+  releaseItemView: function(itemView) {
+    // if it is not poolable, there is not much we can do.
+    if (!itemView.isPoolable) {
+      itemView.destroy();
+      return;
+    }
+    
+    // otherwise, we need to return to view
+    var pool = itemView.owningPool;
+    pool.push(itemView);
+    if (itemView.hibernateInPool) itemView.hibernateInPool(pool, this);
+  },
+  
+  /**
+    Returns YES if the item at the index is a group.
+    
+    @private
+  */
+  contentIndexIsGroup: function(view, content, index) {
+    var contentDelegate = this.get("contentDelegate");
+    
+    // setup our properties
+    var groupIndexes = this.get('_contentGroupIndexes'), isGroupView = NO;
+    
+    // and do our checking
+    isGroupView = groupIndexes && groupIndexes.contains(index);
+    if (isGroupView) isGroupView = contentDelegate.contentIndexIsGroup(this, this.get("content"), index);
+    
+    // and return
+    return isGroupView;
+  },
+  
+  /**
+    @private
+    Determines the example view for a content index. There are two optional parameters that will
+    speed things up: contentObject and isGroupView. If you don't supply them, they must be computed.
+  */
+  exampleViewForItem: function(item, index) {
+    var del = this.get('contentDelegate'),
+        groupIndexes = this.get('_contentGroupIndexes'),
+        key, ExampleView,
+        isGroupView = this.contentIndexIsGroup(this, this.get('content'), index);
+
+    if (isGroupView) {
+      // so, if it is indeed a group view, we go that route to get the example view
+      key = this.get('contentGroupExampleViewKey');
+      if (key && item) ExampleView = item.get(key);
+      if (!ExampleView) ExampleView = this.get('groupExampleView') || this.get('exampleView');
+    } else {
+      // otherwise, we go through the normal example view
+      key = this.get('contentExampleViewKey');
+      if (key && item) ExampleView = item.get(key);
+      if (!ExampleView) ExampleView = this.get('exampleView');
+    }
+    
+    return ExampleView;
+  },
+  
+  /**
+    This may seem somewhat awkward, but it is for memory performance: this fills in a hash
+    YOU provide with the properties for the given content index.
+    
+    Properties include both the attributes given to the view and some CollectionView tracking
+    properties, most importantly the exampleView.
+    
+    
+    @private
+  */
+  setAttributesForItem: function(item, index, attrs) {
+    var del = this.get('contentDelegate'), 
+        isGroupView = this.contentIndexIsGroup(this, this.get('content'), index),
+        ExampleView = this.exampleViewForItem(item, index),
+        content = this.get("content");
+    
+    // 
+    // FIGURE OUT "NORMAL" ATTRIBUTES
+    //
+    attrs.createdFromExampleView = ExampleView;
+    attrs.parentView = this.get('containerView') || this;
+    attrs.contentIndex = index;
+    attrs.owner = attrs.displayDelegate = this;
+    attrs.content = item;
+    attrs.page = this.page;
+    attrs.layerId = this.layerIdFor(index);
+    attrs.isEnabled = del.contentIndexIsEnabled(this, content, index);
+    attrs.isSelected = del.contentIndexIsSelected(this, content, index);
+    attrs.outlineLevel = del.contentIndexOutlineLevel(this, content, index);
+    attrs.disclosureState = del.contentIndexDisclosureState(this, content, index);
+    attrs.isVisibleInWindow = this.get('isVisibleInWindow');
+    attrs.isGroupView = isGroupView;
+    attrs.layout = this.layoutForContentIndex(index);
+    if (!attrs.layout) attrs.layout = ExampleView.prototype.layout;
+  },
+  
+  
+  
+  
+  //
+  // ITEM LOADING/DOM MANAGEMENT
+  //
+  
+  /**
+    @private
+    Returns mapped item views for the supplied item.
+  */
+  mappedViewsForItem: function(item, map) {
+    if (!map) map = this._viewMap;
+    return map[SC.guidFor(item)];
+  },
+  
+  /**
+    @private
+    Returns the mapped view for an item at the specified index. 
+  */
+  mappedViewForItem: function(item, idx, map) {
+    if (!map) map = this._viewMap;
+    var m = map[SC.guidFor(item)];
+    if (!m) return undefined;
+    return m[idx];
+  },
+  
+  /**
+    @private
+    Maps a view to an item/index combination.
+  */
+  mapView: function(item, index, view, map) {
+    // get the default view map if a map was not supplied
+    if (!map) map = this._viewMap;
+    
+    // get the item map
+    var g = SC.guidFor(item),
+        imap = map[g];
+    if (!imap) imap = map[g] = {_length: 0};
+    
+    // fill in the index
+    imap[index] = view;
+    imap._length++;
+  },
+  
+  /**
+    Unmaps a view from an item/index combination.
+  */
+  unmapView: function(item, index, map) {
+    if (!map) map = this._viewMap;
+    var g = SC.guidFor(item),
+        imap = map[g];
+    
+    // return if there is nothing to do
+    if (!imap) return;
+    
+    // remove
+    if (imap[index]) {
+      var v = imap[index];
+      delete imap[index];
+      
+      imap._length--;
+      if (imap._length <= 0) delete map[g];
+    }
+  },
+  
+  /**
+    Returns the item view for the given content index.
+    NOTE: THIS WILL ADD THE VIEW TO DOM TEMPORARILY (it will be cleaned if
+          it is not used). As such, use sparingly.
+  */
+  itemViewForContentIndex: function(index) {
+    var content = this.get("content");
+    if (!content) return;
+    
+    var item = content.objectAt(index);
+    if (!item) return null;
+    
+    var exampleView = this.exampleViewForItem(item, index),
+        view = this._indexMap[index];
+    
+    if (view && view.createdFromExampleView !== exampleView) {
+      this.removeItemView(view);
+      this.unmapView(item, index);
+      view = null;
+    }
+    
+    if (!view) {
+      view = this.addItemView(exampleView, item, index);
+    }
+    
+    return view;
+  },
+  
+  /**
+    @private
+    Returns the nearest item view index to the supplied index mapped to the item.
+  */
+  nearestMappedViewIndexForItem: function(item, index, map) {
+    var m = this.mappedViewsForItem(item, map);
+    if (!m) return null;
+    
+    // keep track of nearest and the nearest distance
+    var nearest = null, ndist = -1, dist = 0;
+    
+    // loop through
+    for (var idx in m) {
+      idx = parseInt(idx, 10);
+      if (isNaN(idx)) continue;
+      // get distance
+      dist = Math.abs(index - idx);
+      
+      // compare to nearest distance
+      if (ndist < 0 || dist < ndist) {
+        ndist = dist;
+        nearest = idx;
+      }
+    }
+    
+    return nearest;
+  },
+  
+  /**
+    @private
+    Remaps the now showing views to their new indexes (if they have moved).
+  */
+  remapItemViews: function(nowShowing) {
+    // reset the view map, but keep the old for removing
+    var oldMap = this._viewMap || {},
+        newMap = (this._viewMap = {}),
+        indexMap = (this._indexMap = {}),
+        mayExist = [],
+        content = this.get("content"), item;
+
+    if (!content) return;
+    var itemsToAdd = this._itemsToAdd;
+
+    // first, find items which we can (that already exist, etc.)
+    nowShowing.forEach(function(idx) {
+      item = content.objectAt(idx);
+      
+      // determine if we have view(s) in the old map for the item
+      var possibleExistingViews = this.mappedViewsForItem(item, oldMap);
+      if (possibleExistingViews) {
+        
+        // if it is the same index, we just take it. End of story.
+        if (possibleExistingViews[idx]) {
+          var v = possibleExistingViews[idx];
+          this.unmapView(item, idx, oldMap);
+          this.mapView(item, idx, v, newMap);
+          indexMap[idx] = v;
+        } else {
+          // otherwise, we must investigate later
+          mayExist.push(idx);
+        }
+      } else {
+        // if it is in now showing but we didn't find a view, it needs to be created.
+        itemsToAdd.push(idx);
+      }
+    }, this);
+    
+    // now there are also some items which _could_ exist (but might not!)
+    for (var idx = 0, len = mayExist.length; idx < len; idx++) {
+      var newIdx = mayExist[idx];
+      item = content.objectAt(newIdx);
+      var nearestOldIndex = this.nearestMappedViewIndexForItem(item, newIdx, oldMap),
+          nearestView;
+      
+      if (!SC.none(nearestOldIndex)) {
+        nearestView = this.mappedViewForItem(item, nearestOldIndex, oldMap);
+        var newExampleView = this.exampleViewForItem(item, newIdx);
+        if (newExampleView === nearestView.createdFromExampleView) {
+          // if there is a near one, use it, and remove it from the map
+          this.unmapView(item, nearestOldIndex, oldMap);
+          this.mapView(item, newIdx, nearestView, newMap);
+          indexMap[newIdx] = nearestView;
+        } else {
+          itemsToAdd.push(newIdx);
+        }
+      } else {
+        // otherwise, we need to create it.
+        itemsToAdd.push(newIdx);
+      }
+    }
+    
+    return oldMap;
+  },
+  
+  /**
+    Reloads.
+  */
+  reloadIfNeeded: function(nowShowing, scrollOnly) {
+    var content = this.get("content"), invalid;
+    
+    // we use the nowShowing to determine what should and should not be showing.
+    if (!nowShowing || !nowShowing.isIndexSet) nowShowing = this.get('nowShowing');
+    
+    // we only update if this is a non-scrolling update.
+    // don't worry: we'll actually update after the fact, and the invalid indexes should
+    // be queued up nicely.
+    if (!scrollOnly) {
+      invalid = this._invalidIndexes;
+      if (!invalid || !this.get('isVisibleInWindow')) return this;
+      this._invalidIndexes = NO; 
+      
+      // tell others we will be reloading
+      if (invalid.isIndexSet && invalid.contains(nowShowing)) invalid = YES ;
+      if (this.willReload) this.willReload(invalid === YES ? null : invalid);
+    }
+    
+    // get arrays of items to add/remove
+    var itemsToAdd = this._itemsToAdd || (this._itemsToAdd = []);
+    
+    // remap
+    var oldMap = this.remapItemViews(nowShowing);
+    
+    // The oldMap has the items to remove, so supply it to processRemovals
+    this.processRemovals(oldMap);
+    
+    // handle the invalid set (if it is present)
+    if (invalid) {
+      this.processUpdates(invalid === YES ? nowShowing : invalid);
+    }
+    
+    // process items to add
+    this.processAdds();
+    
+    // only clear the DOM pools if this is not during scrolling. Adding/removing is a
+    // bad idea while scrolling :)
+    if (!scrollOnly) this.clearDOMPools();
+    
+    // clear the lists
+    itemsToAdd.length = 0;
+    
+    // and if this is a full reload, we need to adjust layout
+    if (!scrollOnly) {
+      var layout = this.computeLayout();
+      if (layout) this.adjust(layout);
+      if (this.didReload) this.didReload(invalid === YES ? null : invalid);
+    }
+    
+    return this;
+  },
+  
+  /**
+    Loops through remove queue and removes.
+  */
+  processRemovals: function(oldMap) {
+    var content = this.get("content");
+    for (var guid in oldMap) {
+      var imap = oldMap[guid];
+      for (var itemIdx in imap) {
+        itemIdx = parseInt(itemIdx, 10);
+        if (isNaN(itemIdx)) continue;
+        
+        var view = imap[itemIdx];
+        
+        if (this._indexMap[itemIdx] === view) delete this._indexMap[itemIdx];
+        
+        view._isInCollection = NO;
+        this.removeItemView(view);
+      }
+    }
+  },
+  
+  /**
+    @private
+    Loops through update queue and... updates.
+  */
+  processUpdates: function(invalid) {
+    var u = this._itemsToUpdate, content = this.get("content"), item, view;
+    invalid.forEach(function(idx) {
+      item = content.objectAt(idx);
+      if (view = this.mappedViewForItem(item, idx)) {
+        if (!view._isInCollection) return;
+        var ex = this.exampleViewForItem(item, idx);
+        this.updateItemView(view, ex, item, idx);
+      }
+    }, this);
+  },
+  
+  /**
+    @private
+    Loops through add queue and, well, adds.
+  */
+  processAdds: function() {
+    var content = this.get("content");
+    
+    var add = this._itemsToAdd, idx, len = add.length, itemIdx, item;
+    for (idx = 0; idx < len; idx++) {
+      itemIdx = add[idx]; item = content.objectAt(itemIdx);
+      
+      // get example view and create item view
+      var exampleView = this.exampleViewForItem(item, itemIdx);
+      var view = this.addItemView(exampleView, item, itemIdx);
+    }
+  },
+  
+  /**
+  @private
+    Clear all DOM pools.
+  */
+  clearDOMPools: function() {
+    var pools = this._domPools || (this._domPools = {});
+    for (var p in pools) {
+      this.clearDOMPool(pools[p]);
+    }
+  },
+  
+  domPoolSize: 10,
+  
+  /**
+  @private
+    Clears a specific DOM pool.
+  */
+  clearDOMPool: function(pool) {
+    var idx, len = pool.length, item;
+    
+    // we skip one because there is a buffer area of one while scrolling
+    for (idx = this.domPoolSize; idx < len; idx++) {
+      item = pool[idx];
+
+      // remove from DOM
+      this.removeChild(item);
+      
+      // release the item
+      this.releaseItemView(item);
+    }
+    
+    // pool is cleared.
+    pool.length = Math.min(pool.length, this.domPoolSize);
+  },
+  
+  /**
+  @private
+    Returns the DOM pool for the given exampleView.
+  */
+  domPoolForExampleView: function(exampleView) {
+    var pools = this._domPools || (this._domPools = {}), guid = SC.guidFor(exampleView);
+    var pool = pools[guid];
+    if (!pool) pool = pools[guid] = [];
+    return pool;
+  },
+  
+  /**
+  @private
+    Tries to find an item for the given example view in a dom pool.
+    If one could not be found, returns null.
+  */
+  itemFromDOMPool: function(exampleView) {
+    var pool = this.domPoolForExampleView(exampleView);
+    if (pool.length < 1) return null;
+    var view = pool.shift();
+    if (view.wakeFromDOMPool) view.wakeFromDOMPool();
+    return view;
+  },
+  
+  /**
+    @private
+    Sends a view to a DOM pool.
+  */
+  sendToDOMPool: function(view) {
+    var pool = this.domPoolForExampleView(view.createdFromExampleView);
+    pool.push(view);
+    var f = view.get("frame");
+    view.adjust({ top: -f.height });
+    view.set("layerId", SC.guidFor(view));
+    if (view.sleepInDOMPool) view.sleepInDOMPool();
+  },
+  
+  /**
+  @private
+    Adds an item view (grabbing the actual item from one of the pools if possible).
+  */
+  addItemView: function(exampleView, object, index) {
+    var view, attrs = this._TMP_ATTRS || (this._TMP_ATTRS = {});
+    
+    // in any case, we need attributes
+    this.setAttributesForItem(object, index, attrs);
+    
+    // try to get from DOM pool first
+    if (view = this.itemFromDOMPool(exampleView)) {
+      // set attributes
+      this.configureItemView(view, attrs);
+      
+      // set that it is in the collection
+      view._isInCollection = YES;
+      
+      // add to view map (if not used, it will be removed)
+      this.mapView(object, index, view);
+      this._indexMap[index] = view;
+      
+      // and that should have repositioned too
+      return view;
+    }
+    
+    // otherwise, just allocate a view
+    view = this.allocateItemView(exampleView, attrs);
+    
+    // and then, add it
+    this.appendChild(view);
+    
+    // set that it is in the collection.
+    view._isInCollection = YES;
+    
+    // add to view map (if not used, it will be removed)
+    this.mapView(object, index, view);
+    this._indexMap[index] = view;
+    
+    return view;
+  },
+  
+  /**
+  @private
+    Removes an item view.
+  */
+  removeItemView: function(current) {
+    if (current.get("layerIsCacheable")) {
+      this.sendToDOMPool(current);
+    } else {
+      this.removeChild(current);
+    }
+    current._isInCollection = NO;
+  },
+  
+  /**
+    Updates the specified item view. If the view is not "layer cacheable" or the
+    example view has changed, it will be redrawn.
+    
+    Otherwise, nothing will happen.
+  */
+  updateItemView: function(current, exampleView, object, index) {
+    if (!current.get("layerIsCacheable") || current.createdFromExampleView !== exampleView) {
+      // unmap old and remove
+      this.unmapView(current, index);
+      delete this._indexMap[index];
+      this.removeItemView(current, object, index);
+      
+      // add new and map
+      var newView = this.addItemView(exampleView, object, index);
+    } else {
+      var attrs = this._TMP_ATTRS || (this._TMP_ATTRS = {});
+
+      this.setAttributesForItem(object, index, attrs);
+      this.configureItemView(current, attrs);
+    }
+  },
+  
+  
+  /**
+    Tells ScrollView that this should receive live updates during touch scrolling.
+    We are so fast, aren't we?
+  */
+  _lastTopUpdate: 0,
+  _lastLeftUpdate: 0,
+  _tolerance: 100,
+  
+  /**
+    The fast-path that computes a special 
+  */
+  touchScrollDidChange: function(left, top) {
+    // prevent getting too many in close succession.
+    if (Date.now() - this._lastTouchScrollTime < 25) return;
+    
+    var clippingFrame = this.get('clippingFrame');
+    
+    var cf = this._inScrollClippingFrame || (this._inScrollClippingFrame = {x: 0, y: 0, width: 0, height: 0});
+    cf.x = clippingFrame.x; cf.y = clippingFrame.y; cf.width = clippingFrame.width; cf.height = clippingFrame.height;
+    
+    // update
+    cf.x = left;
+    cf.y = top;
+    
+    var r = this.contentIndexesInRect(cf);
+    if (!r) return; // no rect, do nothing.
+    
+    var len = this.get('length'), 
+        max = r.get('max'), min = r.get('min');
+
+    if (max > len || min < 0) {
+      r = r.copy();
+      r.remove(len, max-len).remove(min, 0-min).freeze();
+    }
+    
+    if (this._lastNowShowing) {
+      if (r.contains(this._lastNowShowing) && this._lastNowShowing.contains(r)) return;
+    }
+    this._lastNowShowing = r;
+    this.reloadIfNeeded(r, YES);
+    
+    this._lastTouchScrollTime = Date.now();
+  }
+  
+};