sproutcore 1.11.0.rc3 → 1.11.0

data/lib/frameworks/sproutcore/frameworks/media/views/controls.js

@@ -34,7 +34,7 @@ SC.MediaControlsView = SC.View.extend(
     icon: 'play',
     layout: { top: 0, left: 0, width: 20, height:20},
     action: "playPause",
-    targetBinding: "*owner.target"
+    targetBinding: ".parentView.target"
   }),
 
   progressView: SC.MediaSlider.extend({
@@ -42,15 +42,15 @@ SC.MediaControlsView = SC.View.extend(
     value:0,
     minimum: 0,
     step:0.1,
-    valueBinding: "*owner.target.currentTime" ,
-    maximumBinding: "*owner.target.duration",
-    mediaViewBinding: "*owner.target"
+    valueBinding: ".parentView*target.currentTime" ,
+    maximumBinding: ".parentView*target.duration",
+    mediaViewBinding: ".parentView.target"
   }),
 
   timeView: SC.LabelView.extend({
     layout: { top: 0, right: 160, width: 60, height:20},
     classNames: 'time',
-    valueBinding: '*owner.target.time'
+    valueBinding: '.parentView*target.time'
   }),
 
   theaterButton: SC.ButtonView.extend({
@@ -59,7 +59,7 @@ SC.MediaControlsView = SC.View.extend(
     titleMinWidth: 35,
     layout: { top: 0, right: 140, width: 20, height:20},
     action: "fullScreen",
-    targetBinding: "*owner.target"
+    targetBinding: ".parentView.target"
   }),
 
   minusLabelView: SC.LabelView.extend({
@@ -71,7 +71,7 @@ SC.MediaControlsView = SC.View.extend(
   volumeView: SC.MediaSlider.extend({
     layout: { top: 0, right: 25, width: 90, height:20},
     value:0,
-    valueBinding: "*owner.target.volume" ,
+    valueBinding: ".parentView*target.volume" ,
     minimum: 0,
     maximum: 1,
     step: 0.01

data/lib/frameworks/sproutcore/frameworks/media/views/mini_controls.js

@@ -34,7 +34,7 @@ SC.MiniMediaControlsView = SC.View.extend(
     noStyle: YES,
     layout: { top: 0, left: 0, width: 20, height:20},
     action: "playPause",
-    targetBinding: "*owner.target",
+    targetBinding: ".parentView.target",
     renderStyle: 'renderImage',
     theme: ''
   }),
@@ -42,7 +42,7 @@ SC.MiniMediaControlsView = SC.View.extend(
   timeView: SC.LabelView.design({
     layout: { top: 0, left: 20, width: 60, height:20},
     classNames: 'time',
-    valueBinding: '*owner.target.time'
+    valueBinding: '.parentView*target.time'
   }),
 
   minusLabelView: SC.LabelView.design({
@@ -54,7 +54,7 @@ SC.MiniMediaControlsView = SC.View.extend(
   volumeView: SC.MediaSlider.design({
     layout: { top: 0, left: 100, right: 10, height:20},
     value:0,
-    valueBinding: "*owner.target.volume" ,
+    valueBinding: ".parentView*target.volume" ,
     minimum: 0,
     maximum: 1,
     step: 0.01

data/lib/frameworks/sproutcore/frameworks/media/views/simple_controls.js

@@ -14,11 +14,11 @@ SC.SimpleMediaControlsView = SC.View.extend(
 /** @scope SC.SimpleMediaControlsView.prototype */{
 
   target: null,
-  
+
   childViews: ['playButton', 'progressView'],
-  
+
   classNames: ['sc-media-controls'],
-  
+
   playObserver: function(){
     if(this.getPath('target.paused')){
       this.get('playButton').set('icon', 'play');
@@ -26,23 +26,23 @@ SC.SimpleMediaControlsView = SC.View.extend(
       this.get('playButton').set('icon', 'stop');
     }
   }.observes('*target.paused'),
-  
+
   playButton: SC.ButtonView.design({
     title: '',
     titleMinWidth: 35,
     icon: 'play',
     layout: { top: 0, left: 0, width: 20, height:20 },
     action: "playPause",
-    targetBinding: "*owner.target"
+    targetBinding: ".parentView.target"
   }),
-  
+
   progressView: SC.MediaSlider.design({
     layout: { top: 0, left: 25, right: 10, height:20 },
     value:0,
     minimum: 0,
     step:0.1,
-    valueBinding: "*owner.target.currentTime" ,
-    maximumBinding: "*owner.target.duration",
-    mediaViewBinding: "*owner.target"
+    valueBinding: ".parentView*target.currentTime" ,
+    maximumBinding: ".parentView*target.duration",
+    mediaViewBinding: ".parentView.target"
   })
 });

data/lib/frameworks/sproutcore/frameworks/runtime/core.js

@@ -39,7 +39,7 @@ window.SproutCore = window.SproutCore || SC;
 // rest of the methods go into the mixin defined below.
 
 /**
-  @version 1.11.0.rc3
+  @version 1.11.0
   @namespace
 
   All SproutCore methods and functions are defined
@@ -56,7 +56,7 @@ window.SproutCore = window.SproutCore || SC;
 */
 SC = window.SC; // This is dumb but necessary for jsdoc to get it right
 
-SC.VERSION = '1.11.0.rc3';
+SC.VERSION = '1.11.0';
 
 /**
   @private

data/lib/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/insertAt.js

@@ -34,7 +34,7 @@ SC.ArraySuite.define(function(T) {
     try {
       obj.insertAt(200, T.expected(1));
     } catch (e) {
-      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      equals(e.message, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
       didThrow = YES ;
     }
     ok(didThrow, 'should raise exception');
@@ -73,7 +73,7 @@ SC.ArraySuite.define(function(T) {
     try {
       obj.insertAt(200, T.expected(1));
     } catch (e) {
-      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      equals(e.message, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
       didThrow = YES ;
     }
     ok(didThrow, 'should raise exception');

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

@@ -35,7 +35,7 @@ SC.ArraySuite.define(function(T) {
     try {
       obj.removeAt(200);
     } catch (e) {
-      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      equals(e.message, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
       didThrow = YES ;
     }
     ok(didThrow, 'should raise exception');

data/lib/frameworks/sproutcore/frameworks/runtime/ext/array.js

@@ -16,7 +16,7 @@ SC.mixin(Array.prototype,
 
   // primitive for array support.
   replace: function (idx, amt, objects) {
-    if (this.isFrozen) { throw SC.FROZEN_ERROR; }
+    if (this.isFrozen) { throw new Error(SC.FROZEN_ERROR); }
 
     var args;
     var len = objects ? (objects.get ? objects.get('length') : objects.length) : 0;

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

@@ -138,7 +138,7 @@ SC.CoreArray = /** @lends SC.Array.prototype */ {
     @param {Object} object object to insert
   */
   insertAt: function (idx, object) {
-    if (idx > this.get('length')) throw SC.OUT_OF_RANGE_EXCEPTION;
+    if (idx > this.get('length')) throw new Error(SC.OUT_OF_RANGE_EXCEPTION);
     this.replace(idx, 0, [object]);
     return this;
   },
@@ -162,7 +162,7 @@ SC.CoreArray = /** @lends SC.Array.prototype */ {
     if (typeof start === SC.T_NUMBER) {
 
       if ((start < 0) || (start >= this.get('length'))) {
-        throw SC.OUT_OF_RANGE_EXCEPTION;
+        throw new Error(SC.OUT_OF_RANGE_EXCEPTION);
       }
 
       // fast case

data/lib/frameworks/sproutcore/frameworks/runtime/mixins/freezable.js

@@ -11,7 +11,7 @@
 
   @type Error
 */
-SC.FROZEN_ERROR = new Error("Cannot modify a frozen object");
+SC.FROZEN_ERROR = "Cannot modify a frozen object";
 
 /**
   @class
@@ -48,7 +48,7 @@ SC.FROZEN_ERROR = new Error("Cannot modify a frozen object");
 
           // swaps the names
           swapNames: function() {
-            if (this.get('isFrozen')) throw SC.FROZEN_ERROR;
+            if (this.get('isFrozen')) throw new Error(SC.FROZEN_ERROR);
             var tmp = this.get('firstName');
             this.set('firstName', this.get('lastName'));
             this.set('lastName', tmp);

data/lib/frameworks/sproutcore/frameworks/runtime/mixins/observable.js

@@ -918,18 +918,79 @@ SC.Observable = /** @scope SC.Observable.prototype */ {
     an expensive action until someone begins observing a particular property
     on the object.
 
+    Optionally, you may pass a target and method to check for the
+    presence of a particular observer. You can use this to avoid creating
+    duplicate observers in situations where that's likely.
+
     @param {String} key key to check
+    @param {Object} [target] the target that the observer uses
+    @param {Function|String} [method]) the method on the target that the observer uses
     @returns {Boolean}
   */
-  hasObserverFor: function (key) {
+  hasObserverFor: function (key, target, method) {
     SC.Observers.flush(this); // hookup as many observers as possible.
 
     var observers = this[SC.keyFor('_kvo_observers', key)],
-      locals = this[SC.keyFor('_kvo_local', key)];
+        chains = this._kvo_for(SC.keyFor('_kvo_chains', key)),
+        locals = this[SC.keyFor('_kvo_local', key)],
+        isChain = key.indexOf('.') >= 0;
+
+    // Fast path: no target/method.
+    if (target === undefined) {
+      if (isChain) {
+        if (chains && chains.length > 0) return YES;
+      } else {
+        // Found locally.
+        if (locals && locals.length > 0) return YES;
+        if (observers && observers.getMembers().length > 0) return YES;
+      }
+      return NO;
+
+    // Slow path: target/method.
+    } else {
+      if (method === undefined) {
+        method = target;
+        target = this;
+      }
+      if (typeof method === "string") method = target[method];
+      if (!method) throw new Error("Developer Error: If present, the `method` argument of hasObserverFor must be (or refer to) a function.");
+
+      // Declare our iterators.
+      var i, len;
+
+      // Check remote chains.
+      if (isChain) {
+        if (!chains || !chains.length) return NO;
+        len = chains.length;
+        for (i = 0; i < len; i++) {
+          if (chains[i].masterTarget === target && chains[i].masterMethod === method) return YES;
+        }
+        return NO;
+
+      // Check locals.
+      } else if (target === this) {
+        if (!locals) return NO;
+        len = locals.length;
+        for (i = 0; i < len; i++) {
+          if (this[locals[i]] === method) return YES;
+        }
+        return NO;
 
-    if (locals && locals.length > 0) return YES;
-    if (observers && observers.getMembers().length > 0) return YES;
-    return NO;
+      // Check remotes.
+      } else {
+        if (!observers || !observers.members) return NO;
+
+        len = observers.members.length;
+        var member;
+        for (i = 0; i < len; i++) {
+          member = observers.members[i];
+          // If this is a non-chained observer, the first item is the target and the second is the method.
+          if (member[0] === target && member[1] === method) return YES;
+        }
+        return NO;
+      }
+      // TODO: Remote chains.
+    }
   },
 
   /**

data/lib/frameworks/sproutcore/frameworks/runtime/mixins/tree.js

@@ -0,0 +1,44 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/** @private */
+SC.Tree = /** @scope SC.Tree.prototype */ {
+
+  /** @private Call the method recursively on all child views. */
+  invoke: function (methodName, isTopDown, context) {
+    var childView,
+      childViews = this.get('childViews'),
+      method,
+      shouldContinue;
+
+    for (var i = childViews.length - 1; i >= 0; i--) {
+      childView = childViews[i];
+
+      // We allow missing childViews in the array so ignore them.
+      if (!childView) { continue; }
+
+      // Look up the method on the child.
+      method = childView[methodName];
+
+      // Call the method on this view *before* its children.
+      if (isTopDown === undefined || isTopDown) {
+        shouldContinue = method.call(childView, context);
+      }
+
+      // Recurse.
+      if (shouldContinue === undefined || shouldContinue) {
+        childView._callOnChildViews(methodName, isTopDown, context);
+      }
+
+      // Call the method on this view *after* its children.
+      if (isTopDown === false) {
+        method.call(childView, context);
+      }
+    }
+  }
+
+};

data/lib/frameworks/sproutcore/frameworks/runtime/private/observer_queue.js

@@ -81,7 +81,10 @@ SC.Observers = {
     // it is fastest to set to null then loop over again to collapse, but for all other browsers
     // it is not. Plus, this code shouldn't get hit very often anyway (it may not ever get hit
     // for some apps).
-    idx = this.queue.length; queue = this.queue, newQueue = undefined;
+    idx = this.queue.length;
+    queue = this.queue;
+
+    var newQueue;
     while(--idx >= 0) {
       item = queue[idx];
 

data/lib/frameworks/sproutcore/frameworks/runtime/system/binding.js

@@ -967,31 +967,6 @@ SC.Binding = /** @scope SC.Binding.prototype */{
     });
   },
 
-  /**
-    Adds a transform that will return YES if the value is equal to equalValue, NO otherwise.
-
-      isVisibleBinding: SC.Binding.oneWay("MyApp.someController.title").equalTo(comparisonValue)
-
-    Or:
-
-      isVisibleBinding: SC.Binding.equalTo("MyApp.someController.title", comparisonValue)
-
-    @param {String} fromPath from path or null
-    @param {Object} equalValue the value to compare with
-    @returns {SC.Binding} this
-  */
-  equalTo: function(fromPath, equalValue) {
-    // Normalize arguments.
-    if (equalValue === undefined) {
-      equalValue = fromPath;
-      fromPath = null;
-    }
-
-    return this.from(fromPath).transform(function(value, binding) {
-       return value === equalValue;
-     });
-  },
-
   /**
     Adds a transform that will *always* return an integer Number value. Null and undefined values will
     return 0 while String values will be transformed using the parseInt method (according to the

data/lib/frameworks/sproutcore/frameworks/runtime/system/enumerator.js

@@ -57,7 +57,7 @@ SC.Enumerator.prototype = /** @scope SC.Enumerator.prototype */{
   */
   reset: function() {
     var e = this.enumerable ;
-    if (!e) throw SC.$error("Enumerator has been destroyed");
+    if (!e) SC.throw("Enumerator has been destroyed");
     this._length = e.get ? e.get('length') : e.length ;
     var len = this._length;
     this._index = 0;

data/lib/frameworks/sproutcore/frameworks/runtime/system/error.js

@@ -32,7 +32,7 @@ sc_require('ext/function');
   set isError to YES, then calling SC.ok(obj) on your object will return NO.
   If isError is YES, then SC.val(obj) will return your errorValue property
   instead of the receiver.
-  
+
   When using SC.typeOf(obj), SC.T_ERROR will only be returned if the obj
   is an instance of SC.Error
 
@@ -76,6 +76,27 @@ SC.Error = SC.Object.extend(
     return this;
   }.property().cacheable(),
 
+  /**
+    Throw the error.
+
+    @type SC.Error
+  */
+  'throw': function() {
+    var error = this.toString();
+    SC.Logger.error(error);
+
+    throw new Error(error);
+  },
+
+  /**
+    The error stacktrace.
+
+    @type SC.Error
+  */
+  trace: function() {
+    return (new Error()).trace;
+  }.property().cacheable(),
+
   /**
     Human readable name of the item with the error.
 
@@ -94,37 +115,68 @@ SC.Error = SC.Object.extend(
     @type Boolean
   */
   isError: YES
-}) ;
+});
+
+SC.Error.mixin({
+
+  /**
+    Creates a new SC.Error instance with the passed description, label, and
+    code.  All parameters are optional.
+
+    @param description {String} human readable description of the error
+    @param label {String} human readable name of the item with the error
+    @param code {Number} an error code to use for testing.
+    @returns {SC.Error} new error instance.
+  */
+  desc: function(description, label, value, code) {
+    var opts = { message: description } ;
+    if (label !== undefined) opts.label = label ;
+    if (code !== undefined) opts.code = code ;
+    if (value !== undefined) opts.errorValue = value ;
+    return this.create(opts) ;
+  },
+
+  /**
+    Throw a new SC.Error instance with the passed description, label, and
+    code.  All parameters are optional.
+
+    @param description {String} human readable description of the error
+    @param label {String} human readable name of the item with the error
+    @param code {Number} an error code to use for testing.
+    @returns {SC.Error} new error instance.
+  */
+  'throw': function(description, label, value, code) {
+    this.desc.apply(this, arguments).throw();
+  }
+
+});
 
 /**
-  Creates a new SC.Error instance with the passed description, label, and
-  code.  All parameters are optional.
+  Shorthand form of the SC.Error.desc method.
 
   @param description {String} human readable description of the error
   @param label {String} human readable name of the item with the error
   @param code {Number} an error code to use for testing.
   @returns {SC.Error} new error instance.
 */
-SC.Error.desc = function(description, label, value, code) {
-  var opts = { message: description } ;
-  if (label !== undefined) opts.label = label ;
-  if (code !== undefined) opts.code = code ;
-  if (value !== undefined) opts.errorValue = value ;
-  return this.create(opts) ;
-} ;
+SC.$error = function(description, label, value, c) {
+  return SC.Error.desc(description, label, value, c);
+};
 
 /**
-  Shorthand form of the SC.Error.desc method.
+  Shorthand form of the SC.Error.throw method.
 
   @param description {String} human readable description of the error
   @param label {String} human readable name of the item with the error
   @param code {Number} an error code to use for testing.
   @returns {SC.Error} new error instance.
 */
+SC.throw = function(description, label, value, c) {
+  SC.Error.throw(description, label, value, c);
+};
 
-SC.$error = function(description, label, value, c) {  
-  return SC.Error.desc(description,label, value, c);
-} ;
+/** @private */
+SC.$throw = SC.throw;
 
 /**
   Returns NO if the passed value is an error object or false.