spade 0.0.1

data/sproutcore/frameworks/runtime/debug/test_suites/array/removeAt.js

@@ -0,0 +1,100 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("removeAt"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("[X].removeAt(0) => [] + notify", function() {
+
+    var before = T.expected(1);
+    obj.replace(0,0, before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(0) ;
+    T.validateAfter(obj, [], observer, YES);
+  });
+  
+  test("[].removeAt(200) => OUT_OF_RANGE_EXCEPTION exception", function() {
+    var didThrow = NO ;
+    try {
+      obj.removeAt(200);
+    } catch (e) {
+      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      didThrow = YES ;
+    }
+    ok(didThrow, 'should raise exception');
+  });
+
+  test("[A,B].removeAt(0) => [B] + notify", function() {
+    var before = T.expected(2), 
+        after   = [before[1]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(0);
+    T.validateAfter(obj, after, observer, YES);
+  });
+
+  test("[A,B].removeAt(1) => [A] + notify", function() {
+    var before = T.expected(2), 
+        after   = [before[0]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(1);
+    T.validateAfter(obj, after, observer, YES);
+  });
+
+  test("[A,B,C].removeAt(1) => [A,C] + notify", function() {
+    var before = T.expected(3), 
+        after   = [before[0], before[2]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(1);
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+  test("[A,B,C,D].removeAt(1,2) => [A,D] + notify", function() {
+    var before = T.expected(4), 
+        after   = [before[0], before[3]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(1,2);
+    T.validateAfter(obj, after, observer, YES);
+  });
+
+  test("[A,B,C,D].removeAt(IndexSet<0,2-3>) => [B] + notify", function() {
+    var before = T.expected(4), 
+        after   = [before[1]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeAt(SC.IndexSet.create(0).add(2,2));
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});
+

data/sproutcore/frameworks/runtime/debug/test_suites/array/removeObject.js

@@ -0,0 +1,49 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("removeObject"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("should return receiver", function() {
+    obj = T.newObject(3);
+    equals(obj.removeObject(obj.objectAt(0)), obj, 'should return receiver');
+  });
+  
+  test("[A,B,C].removeObject(B) => [A,C] + notify", function() {
+
+    var before = T.expected(3),
+        after  = [before[0], before[2]];
+    obj.replace(0,0, before);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeObject(before[1]) ;
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+  test("[A,B,C].removeObject(D) => [A,B,C]", function() {
+    var exp = T.expected(4),
+        extra = exp.pop();
+    obj.replace(0,0,exp);
+    observer.observe('[]', 'length') ;
+    
+    obj.removeObject(extra);
+    T.validateAfter(obj, exp, observer, NO, NO);
+  });
+  
+});

data/sproutcore/frameworks/runtime/debug/test_suites/array/replace.js

@@ -0,0 +1,94 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("replace"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+  
+  test("[].replace(0,0,'X') => ['X'] + notify", function() {
+
+    var exp = T.expected(1);
+    
+    observer.observe('[]', 'length') ;
+    obj.replace(0,0,exp) ;
+
+    T.validateAfter(obj, exp, observer, YES);
+  });
+
+  test("[A,B,C,D].replace(1,2,X) => [A,X,D] + notify", function() {
+    
+    var exp = T.expected(5), 
+        before = exp.slice(0,4),
+        replace = exp.slice(4),
+        after = [before[0], replace[0], before[3]];
+        
+    obj.replace(0,0, before) ; // precond
+    observer.observe('[]', 'length') ;
+
+    obj.replace(1,2,replace) ;
+
+    T.validateAfter(obj, after, observer, YES);
+  });
+
+  test("[A,B,C,D].replace(1,2,[X,Y]) => [A,X,Y,D] + notify", function() {
+    
+    // setup the before, after, and replace arrays.  Use generated objects
+    var exp  = T.expected(6),
+        before  = exp.slice(0, 4),
+        replace = exp.slice(4),
+        after   = [before[0], replace[0], replace[1], before[3]]; 
+        
+    obj.replace(0,0, before) ;
+    observer.observe('[]', 'length') ;
+
+    obj.replace(1,2, replace) ;
+
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+  test("[A,B].replace(1,0,[X,Y]) => [A,X,Y,B] + notify", function() {
+
+    // setup the before, after, and replace arrays.  Use generated objects
+    var exp  = T.expected(4),
+        before  = exp.slice(0, 2),
+        replace = exp.slice(2),
+        after   = [before[0], replace[0], replace[1], before[1]] ;
+
+    obj.replace(0,0, before);
+    observer.observe('[]', 'length') ;
+  
+    obj.replace(1,0, replace) ;
+    
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+  test("[A,B,C,D].replace(2,2) => [A,B] + notify", function() {
+
+    // setup the before, after, and replace arrays.  Use generated objects
+    var before  = T.expected(4),
+        after   = [before[0], before[1]];
+
+    obj.replace(0,0, before);
+    observer.observe('[]', 'length') ;
+  
+    obj.replace(2,2) ;
+    
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});

data/sproutcore/frameworks/runtime/debug/test_suites/array/shiftObject.js

@@ -0,0 +1,50 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("shiftObject"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("[].shiftObject() => [] + returns undefined + NO notify", function() {
+    observer.observe('[]', 'length') ;
+    equals(obj.shiftObject(), undefined, 'should return undefined') ;
+    T.validateAfter(obj, [], observer, NO, NO);
+  });
+
+  test("[X].shiftObject() => [] + notify", function() {
+    var exp = T.expected(1)[0];
+    
+    obj.replace(0,0, [exp]);
+    observer.observe('[]', 'length') ;
+
+    equals(obj.shiftObject(), exp, 'should return shifted object') ;
+    T.validateAfter(obj, [], observer, YES, YES);
+  });
+
+  test("[A,B,C].shiftObject() => [B,C] + notify", function() {
+    var before  = T.expected(3),
+        value   = before[0],
+        after   = before.slice(1);
+        
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    equals(obj.shiftObject(), value, 'should return shifted object') ;
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});

data/sproutcore/frameworks/runtime/debug/test_suites/array/unshiftObject.js

@@ -0,0 +1,47 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("unshiftObject"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("returns unshifted object", function() {
+    var exp = T.expected(1)[0];
+    equals(obj.pushObject(exp), exp, 'should return receiver');
+  });
+  
+
+  test("[].unshiftObject(X) => [X] + notify", function() {
+    var exp = T.expected(1);
+    observer.observe('[]', 'length') ;
+    obj.unshiftObject(exp[0]) ;
+    T.validateAfter(obj, exp, observer, YES);
+  });
+
+  test("[A,B,C].unshiftObject(X) => [X,A,B,C] + notify", function() {
+    var after  = T.expected(4),
+        before = after.slice(1),
+        value  = after[0];
+        
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    obj.unshiftObject(value) ;
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});

data/sproutcore/frameworks/runtime/license.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * ==========================================================================
+ * SproutCore Costello -- Property Observing Library
+ * Copyright ©2006-2011, Strobe Inc. and contributors.
+ * Portions copyright ©2008-2010 Apple Inc. All rights reserved.
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a 
+ * copy of this software and associated documentation files (the "Software"), 
+ * to deal in the Software without restriction, including without limitation 
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+ * and/or sell copies of the Software, and to permit persons to whom the 
+ * Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in 
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+ * DEALINGS IN THE SOFTWARE.
+ * 
+ * For more information about SproutCore, visit http://www.sproutcore.com
+ * 
+ * ==========================================================================
+ */

data/sproutcore/frameworks/runtime/mixins/array.js

@@ -0,0 +1,658 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+// note: SC.Observable also enhances array.  make sure we are called after
+// SC.Observable so our version of unknownProperty wins.
+sc_require('mixins/observable');
+sc_require('mixins/enumerable');
+sc_require('system/range_observer');
+
+SC.OUT_OF_RANGE_EXCEPTION = "Index out of range" ;
+
+/**
+  @namespace
+
+  This module implements Observer-friendly Array-like behavior.  This mixin is
+  picked up by the Array class as well as other controllers, etc. that want to
+  appear to be arrays.
+
+  Unlike SC.Enumerable, this mixin defines methods specifically for
+  collections that provide index-ordered access to their contents.  When you
+  are designing code that needs to accept any kind of Array-like object, you
+  should use these methods instead of Array primitives because these will
+  properly notify observers of changes to the array.
+
+  Although these methods are efficient, they do add a layer of indirection to
+  your application so it is a good idea to use them only when you need the
+  flexibility of using both true JavaScript arrays and "virtual" arrays such
+  as controllers and collections.
+
+  You can use the methods defined in this module to access and modify array
+  contents in a KVO-friendly way.  You can also be notified whenever the
+  membership if an array changes by changing the syntax of the property to
+  .observes('*myProperty.[]') .
+
+  To support SC.Array in your own class, you must override two
+  primitives to use it: replace() and objectAt().
+
+  Note that the SC.Array mixin also incorporates the SC.Enumerable mixin.  All
+  SC.Array-like objects are also enumerable.
+
+  @extends SC.Enumerable
+  @since SproutCore 0.9.0
+*/
+SC.Array = {
+
+  /**
+    Walk like a duck - use isSCArray to avoid conflicts
+  */
+  isSCArray: YES,
+
+  /**
+    @field {Number} length
+
+    Your array must support the length property.  Your replace methods should
+    set this property whenever it changes.
+  */
+  // length: 0,
+
+  /**
+    This is one of the primitves you must implement to support SC.Array.  You
+    should replace amt objects started at idx with the objects in the passed
+    array.  You should also call this.enumerableContentDidChange() ;
+
+    @param {Number} idx
+      Starting index in the array to replace.  If idx >= length, then append to
+      the end of the array.
+
+    @param {Number} amt
+      Number of elements that should be removed from the array, starting at
+      *idx*.
+
+    @param {Array} objects
+      An array of zero or more objects that should be inserted into the array at
+      *idx*
+  */
+  replace: function(idx, amt, objects) {
+    throw "replace() must be implemented to support SC.Array" ;
+  },
+
+  /**
+    This is one of the primitives you must implement to support SC.Array.
+    Returns the object at the named index.  If your object supports retrieving
+    the value of an array item using get() (i.e. myArray.get(0)), then you do
+    not need to implement this method yourself.
+
+    @param {Number} idx
+      The index of the item to return.  If idx exceeds the current length,
+      return null.
+  */
+  objectAt: function(idx) {
+    if (idx < 0) return undefined ;
+    if (idx >= this.get('length')) return undefined;
+    return this.get(idx);
+  },
+
+  /**
+    @field []
+
+    This is the handler for the special array content property.  If you get
+    this property, it will return this.  If you set this property it a new
+    array, it will replace the current content.
+
+    This property overrides the default property defined in SC.Enumerable.
+  */
+  '[]': function(key, value) {
+    if (value !== undefined) {
+      this.replace(0, this.get('length'), value) ;
+    }
+    return this ;
+  }.property(),
+
+  /**
+    This will use the primitive replace() method to insert an object at the
+    specified index.
+
+    @param {Number} idx index of insert the object at.
+    @param {Object} object object to insert
+  */
+  insertAt: function(idx, object) {
+    if (idx > this.get('length')) throw SC.OUT_OF_RANGE_EXCEPTION ;
+    this.replace(idx,0,[object]) ;
+    return this ;
+  },
+
+  /**
+    Remove an object at the specified index using the replace() primitive
+    method.  You can pass either a single index, a start and a length or an
+    index set.
+
+    If you pass a single index or a start and length that is beyond the
+    length this method will throw an SC.OUT_OF_RANGE_EXCEPTION
+
+    @param {Number|SC.IndexSet} start index, start of range, or index set
+    @param {Number} length length of passing range
+    @returns {Object} receiver
+  */
+  removeAt: function(start, length) {
+
+    var delta = 0, // used to shift range
+        empty = [];
+
+    if (typeof start === SC.T_NUMBER) {
+
+      if ((start < 0) || (start >= this.get('length'))) {
+        throw SC.OUT_OF_RANGE_EXCEPTION;
+      }
+
+      // fast case
+      if (length === undefined) {
+        this.replace(start,1,empty);
+        return this ;
+      } else {
+        start = SC.IndexSet.create(start, length);
+      }
+    }
+
+    this.beginPropertyChanges();
+    start.forEachRange(function(start, length) {
+      start -= delta ;
+      delta += length ;
+      this.replace(start, length, empty); // remove!
+    }, this);
+    this.endPropertyChanges();
+
+    return this ;
+  },
+
+  /**
+    Search the array of this object, removing any occurrences of it.
+    @param {object} obj object to remove
+  */
+  removeObject: function(obj) {
+    var loc = this.get('length') || 0;
+    while(--loc >= 0) {
+      var curObject = this.objectAt(loc) ;
+      if (curObject == obj) this.removeAt(loc) ;
+    }
+    return this ;
+  },
+
+  /**
+    Search the array for the passed set of objects and remove any occurrences
+    of the.
+
+    @param {SC.Enumerable} objects the objects to remove
+    @returns {SC.Array} receiver
+  */
+  removeObjects: function(objects) {
+    this.beginPropertyChanges();
+    objects.forEach(function(obj) { this.removeObject(obj); }, this);
+    this.endPropertyChanges();
+    return this;
+  },
+
+  /**
+    Push the object onto the end of the array.  Works just like push() but it
+    is KVO-compliant.
+  */
+  pushObject: function(obj) {
+    this.insertAt(this.get('length'), obj) ;
+    return obj ;
+  },
+
+
+  /**
+    Add the objects in the passed numerable to the end of the array.  Defers
+    notifying observers of the change until all objects are added.
+
+    @param {SC.Enumerable} objects the objects to add
+    @returns {SC.Array} receiver
+  */
+  pushObjects: function(objects) {
+    this.beginPropertyChanges();
+    objects.forEach(function(obj) { this.pushObject(obj); }, this);
+    this.endPropertyChanges();
+    return this;
+  },
+
+  /**
+    Pop object from array or nil if none are left.  Works just like pop() but
+    it is KVO-compliant.
+  */
+  popObject: function() {
+    var len = this.get('length') ;
+    if (len === 0) return null ;
+
+    var ret = this.objectAt(len-1) ;
+    this.removeAt(len-1) ;
+    return ret ;
+  },
+
+  /**
+    Shift an object from start of array or nil if none are left.  Works just
+    like shift() but it is KVO-compliant.
+  */
+  shiftObject: function() {
+    if (this.get('length') === 0) return null ;
+    var ret = this.objectAt(0) ;
+    this.removeAt(0) ;
+    return ret ;
+  },
+
+  /**
+    Unshift an object to start of array.  Works just like unshift() but it is
+    KVO-compliant.
+  */
+  unshiftObject: function(obj) {
+    this.insertAt(0, obj) ;
+    return obj ;
+  },
+
+
+  /**
+    Adds the named objects to the beginning of the array.  Defers notifying
+    observers until all objects have been added.
+
+    @param {SC.Enumerable} objects the objects to add
+    @returns {SC.Array} receiver
+  */
+  unshiftObjects: function(objects) {
+    this.beginPropertyChanges();
+    objects.forEach(function(obj) { this.unshiftObject(obj); }, this);
+    this.endPropertyChanges();
+    return this;
+  },
+
+  /**
+    Compares each item in the array.  Returns true if they are equal.
+  */
+  isEqual: function(ary) {
+    if (!ary) return false ;
+    if (ary == this) return true;
+
+    var loc = ary.get('length') ;
+    if (loc != this.get('length')) return false ;
+
+    while(--loc >= 0) {
+      if (!SC.isEqual(ary.objectAt(loc), this.objectAt(loc))) return false ;
+    }
+    return true ;
+  },
+
+  /**
+    Generates a new array with the contents of the old array, sans any null
+    values.
+
+    @returns {Array}
+  */
+  compact: function() { return this.without(null); },
+
+  /**
+    Generates a new array with the contents of the old array, sans the passed
+    value.
+
+    @param {Object} value
+    @returns {Array}
+  */
+  without: function(value) {
+    if (this.indexOf(value)<0) return this; // value not present.
+    var ret = [] ;
+    this.forEach(function(k) {
+      if (k !== value) ret[ret.length] = k;
+    }) ;
+    return ret ;
+  },
+
+  /**
+    Generates a new array with only unique values from the contents of the
+    old array.
+
+    @returns {Array}
+  */
+  uniq: function() {
+    var ret = [] ;
+    this.forEach(function(k){
+      if (ret.indexOf(k)<0) ret[ret.length] = k;
+    });
+    return ret ;
+  },
+
+  /**
+    Returns the largest Number in an array of Numbers. Make sure the array
+    only contains values of type Number to get expected result.
+
+    Note: This only works for dense arrays.
+
+    @returns {Number}
+  */
+  max: function() {
+    return Math.max.apply(Math, this);
+  },
+
+  /**
+    Returns the smallest Number in an array of Numbers. Make sure the array
+    only contains values of type Number to get expected result.
+
+    Note: This only works for dense arrays.
+
+    @returns {Number}
+  */
+  min: function() {
+    return Math.min.apply(Math, this);
+  },
+
+  rangeObserverClass: SC.RangeObserver,
+
+  /**
+    Returns YES if object is in the array
+
+    @param {Object} object to look for
+    @returns {Boolean}
+  */
+  contains: function(obj){
+    return this.indexOf(obj) >= 0;
+  },
+
+  /**
+    Creates a new range observer on the receiver.  The target/method callback
+    you provide will be invoked anytime any property on the objects in the
+    specified range changes.  It will also be invoked if the objects in the
+    range itself changes also.
+
+    The callback for a range observer should have the signature:
+
+    {{{
+      function rangePropertyDidChange(array, objects, key, indexes, context)
+    }}}
+
+    If the passed key is '[]' it means that the object itself changed.
+
+    The return value from this method is an opaque reference to the
+    range observer object.  You can use this reference to destroy the
+    range observer when you are done with it or to update its range.
+
+    @param {SC.IndexSet} indexes indexes to observe
+    @param {Object} target object to invoke on change
+    @param {String|Function} method the method to invoke
+    @param {Object} context optional context
+    @returns {SC.RangeObserver} range observer
+  */
+  addRangeObserver: function(indexes, target, method, context) {
+    var rangeob = this._array_rangeObservers;
+    if (!rangeob) rangeob = this._array_rangeObservers = SC.CoreSet.create() ;
+
+    // The first time a range observer is added, cache the current length so
+    // we can properly notify observers the first time through
+    if (this._array_oldLength===undefined) {
+      this._array_oldLength = this.get('length') ;
+    }
+
+    var C = this.rangeObserverClass ;
+    var isDeep = NO; //disable this feature for now
+    var ret = C.create(this, indexes, target, method, context, isDeep) ;
+    rangeob.add(ret);
+
+    // first time a range observer is added, begin observing the [] property
+    if (!this._array_isNotifyingRangeObservers) {
+      this._array_isNotifyingRangeObservers = YES ;
+      this.addObserver('[]', this, this._array_notifyRangeObservers);
+    }
+
+    return ret ;
+  },
+
+  /**
+    Moves a range observer so that it observes a new range of objects on the
+    array.  You must have an existing range observer object from a call to
+    addRangeObserver().
+
+    The return value should replace the old range observer object that you
+    pass in.
+
+    @param {SC.RangeObserver} rangeObserver the range observer
+    @param {SC.IndexSet} indexes new indexes to observe
+    @returns {SC.RangeObserver} the range observer (or a new one)
+  */
+  updateRangeObserver: function(rangeObserver, indexes) {
+    return rangeObserver.update(this, indexes);
+  },
+  
+  /**
+    Removes a range observer from the receiver.  The range observer must
+    already be active on the array.
+
+    The return value should replace the old range observer object.  It will
+    usually be null.
+
+    @param {SC.RangeObserver} rangeObserver the range observer
+    @returns {SC.RangeObserver} updated range observer or null
+  */
+  removeRangeObserver: function(rangeObserver) {
+    var ret = rangeObserver.destroy(this);
+    var rangeob = this._array_rangeObservers;
+    if (rangeob) rangeob.remove(rangeObserver) ; // clear
+    return ret ;
+  },
+
+  /**
+    Updates observers with content change.  To support range observers,
+    you must pass three change parameters to this method.  Otherwise this
+    method will assume the entire range has changed.
+
+    This also assumes you have already updated the length property.
+    @param {Number} start the starting index of the change
+    @param {Number} amt the final range of objects changed
+    @param {Number} delta if you added or removed objects, the delta change
+    @param {Array} addedObjects the objects that were added
+    @param {Array} removedObjects the objects that were removed
+    @returns {SC.Array} receiver
+  */
+  enumerableContentDidChange: function(start, amt, delta, addedObjects, removedObjects) {
+    var rangeob = this._array_rangeObservers,
+        oldlen  = this._array_oldLength,
+        newlen, length, changes ;
+
+    this.beginPropertyChanges();
+    this.notifyPropertyChange('length'); // flush caches
+
+    // schedule info for range observers
+    if (rangeob && rangeob.length>0) {
+
+      // if no oldLength has been cached, just assume 0
+      if (oldlen === undefined) oldlen = 0;
+      this._array_oldLength = newlen = this.get('length');
+
+      // normalize input parameters
+      // if delta was not passed, assume it is the different between the
+      // new and old length.
+      if (start === undefined) start = 0;
+      if (delta === undefined) delta = newlen - oldlen ;
+      if (delta !== 0 || amt === undefined) {
+        length = newlen - start ;
+        if (delta<0) length -= delta; // cover removed range as well
+      } else {
+        length = amt ;
+      }
+
+      changes = this._array_rangeChanges;
+      if (!changes) changes = this._array_rangeChanges = SC.IndexSet.create();
+      changes.add(start, length);
+    }
+
+    this._setupEnumerableObservers(addedObjects, removedObjects);
+    this.notifyPropertyChange('[]') ;
+    this.endPropertyChanges();
+
+    return this ;
+  },
+
+  /**  @private
+    Observer fires whenever the '[]' property changes.  If there are
+    range observers, will notify observers of change.
+  */
+  _array_notifyRangeObservers: function() {
+    var rangeob = this._array_rangeObservers,
+        changes = this._array_rangeChanges,
+        len     = rangeob ? rangeob.length : 0,
+        idx, cur;
+
+    if (len > 0 && changes && changes.length > 0) {
+      for(idx=0;idx<len;idx++) rangeob[idx].rangeDidChange(changes);
+      changes.clear(); // reset for later notifications
+    }
+  }
+
+} ;
+
+// Add SC.Array to the built-in array before we add SC.Enumerable to SC.Array
+// since built-in Array's are already enumerable.
+SC.mixin(Array.prototype, SC.Array) ;
+SC.Array = SC.mixin({}, SC.Enumerable, SC.Array) ;
+
+// Add any extra methods to SC.Array that are native to the built-in Array.
+/**
+  Returns a new array that is a slice of the receiver.  This implementation
+  uses the observable array methods to retrieve the objects for the new
+  slice.
+
+  @param beginIndex {Integer} (Optional) index to begin slicing from.
+  @param endIndex {Integer} (Optional) index to end the slice at.
+  @returns {Array} New array with specified slice
+*/
+SC.Array.slice = function(beginIndex, endIndex) {
+  var ret = [];
+  var length = this.get('length') ;
+  if (SC.none(beginIndex)) beginIndex = 0 ;
+  if (SC.none(endIndex) || (endIndex > length)) endIndex = length ;
+  while(beginIndex < endIndex) ret[ret.length] = this.objectAt(beginIndex++) ;
+  return ret ;
+}  ;
+
+/**
+  Returns the index for a particular object in the index.
+
+  @param {Object} object the item to search for
+  @param {NUmber} startAt optional starting location to search, default 0
+  @returns {Number} index of -1 if not found
+*/
+SC.Array.indexOf = function(object, startAt) {
+  var idx, len = this.get('length');
+
+  if (startAt === undefined) startAt = 0;
+  else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
+  if (startAt < 0) startAt += len;
+
+  for(idx=startAt;idx<len;idx++) {
+    if (this.objectAt(idx, YES) === object) return idx ;
+  }
+  return -1;
+};
+
+// Some browsers do not support indexOf natively.  Patch if needed
+if (!Array.prototype.indexOf) Array.prototype.indexOf = SC.Array.indexOf;
+
+/**
+  Returns the last index for a particular object in the index.
+
+  @param {Object} object the item to search for
+  @param {NUmber} startAt optional starting location to search, default 0
+  @returns {Number} index of -1 if not found
+*/
+SC.Array.lastIndexOf = function(object, startAt) {
+  var idx, len = this.get('length');
+
+  if (startAt === undefined) startAt = len-1;
+  else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
+  if (startAt < 0) startAt += len;
+
+  for(idx=startAt;idx>=0;idx--) {
+    if (this.objectAt(idx) === object) return idx ;
+  }
+  return -1;
+};
+
+// Some browsers do not support lastIndexOf natively.  Patch if needed
+if (!Array.prototype.lastIndexOf) {
+  Array.prototype.lastIndexOf = SC.Array.lastIndexOf;
+}
+
+// ......................................................
+// ARRAY SUPPORT
+//
+// Implement the same enhancements on Array.  We use specialized methods
+// because working with arrays are so common.
+(function() {
+  SC.mixin(Array.prototype, {
+
+    // primitive for array support.
+    replace: function(idx, amt, objects) {
+      var removedObjects;
+
+      if (this.isFrozen) throw SC.FROZEN_ERROR ;
+      if (!objects || objects.length === 0) {
+        removedObjects = this.splice(idx, amt) ;
+      } else {
+        var args = [idx, amt].concat(objects) ;
+        removedObjects = this.splice.apply(this,args) ;
+      }
+
+      // if we replaced exactly the same number of items, then pass only the
+      // replaced range.  Otherwise, pass the full remaining array length
+      // since everything has shifted
+      var len = objects ? (objects.get ? objects.get('length') : objects.length) : 0;
+      this.enumerableContentDidChange(idx, amt, len - amt, objects, removedObjects) ;
+      return this ;
+    },
+
+    // If you ask for an unknown property, then try to collect the value
+    // from member items.
+    unknownProperty: function(key, value) {
+      var ret = this.reducedProperty(key, value) ;
+      if ((value !== undefined) && ret === undefined) {
+        ret = this[key] = value;
+      }
+      return ret ;
+    }
+
+  });
+
+  // If browser did not implement indexOf natively, then override with
+  // specialized version
+  var indexOf = Array.prototype.indexOf;
+  if (!indexOf || (indexOf === SC.Array.indexOf)) {
+    Array.prototype.indexOf = function(object, startAt) {
+      var idx, len = this.length;
+
+      if (startAt === undefined) startAt = 0;
+      else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
+      if (startAt < 0) startAt += len;
+
+      for(idx=startAt;idx<len;idx++) {
+        if (this[idx] === object) return idx ;
+      }
+      return -1;
+    } ;
+  }
+
+  var lastIndexOf = Array.prototype.lastIndexOf ;
+  if (!lastIndexOf || (lastIndexOf === SC.Array.lastIndexOf)) {
+    Array.prototype.lastIndexOf = function(object, startAt) {
+      var idx, len = this.length;
+
+      if (startAt === undefined) startAt = len-1;
+      else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt);
+      if (startAt < 0) startAt += len;
+
+      for(idx=startAt;idx>=0;idx--) {
+        if (this[idx] === object) return idx ;
+      }
+      return -1;
+    };
+  }
+
+})();