sproutcore 0.9.3 → 0.9.4

data/frameworks/sproutcore/README

@@ -1,3 +1 @@
-SproutCore is a framework for building JavaScript applications.  It contains a number of components you can use to enable traditional desktop-like functions using only javascript.  SproutCore relies on Prototype and works with Scriptaculous, jQuery or any other toolkit you like to use.
-
-  
+SproutCore is a framework for building applications in JavaScript.  It eliminates much of the glue code you would often write to build applications on the web so you can focus on building features. To get started using SproutCore, visit the website at http://www.sproutcore.com, where you can find documentation and tutorials.

data/frameworks/sproutcore/controllers/array.js

@@ -24,14 +24,14 @@ SC.ArrayController = SC.Controller.extend(SC.Array, SC.SelectionSupport,
 {
   /**
     Provides compatibility with CollectionControllers.
-    @property
+    @field
     @type {SC.ArrayController}
   */
   arrangedObjects: function() { return this; }.property('content'),
 
   /**
     The array content that is being managed by the controller.
-    @property
+    @field
     @type {Array}
   */
   content: null,
@@ -42,7 +42,7 @@ SC.ArrayController = SC.Controller.extend(SC.Array, SC.SelectionSupport,
     deleted.  This is a convenient way to manage lists of items owned
     by a parent record object.
     
-    @property
+    @field
     @type {Boolean}
   */
   destroyOnRemoval: false,
@@ -65,7 +65,7 @@ SC.ArrayController = SC.Controller.extend(SC.Array, SC.SelectionSupport,
     The array content that (when committed) will be merged back into the content property.
     All array methods will take place on this object.
 
-    @property
+    @field
     @type {SC.Array}
   */
   contentClone: null,
@@ -144,7 +144,7 @@ SC.ArrayController = SC.Controller.extend(SC.Array, SC.SelectionSupport,
   },
   /**
   * SC.Array interface implimentation.
-  * @property
+  * @field
   * @type {integer}
   */
   length: function( key, value ) {

data/frameworks/sproutcore/drag/drag.js

@@ -344,6 +344,8 @@ SC.Drag = SC.Object.extend(
     
     if (target && target.prepareForDragOperation(op, this)) {
       op = target.performDragOperation(op, this) ;  
+    } else {
+      op = SC.DRAG_NONE;
     }
     
     // create cleanupFunc.  This function will be called at the end of this

data/frameworks/sproutcore/english.lproj/panes.css

@@ -1,4 +1,4 @@
-
+/* @override http://localhost:4020/static/sproutcore/en/_cache/panes-1206750928.css */
 
 /* @group Core */
 
@@ -16,25 +16,25 @@
 .sc-theme #panes .pane-wrapper h1 {
 	font-size: 16px;
 	margin:  0;
-	margin-bottom: 10px;	
-	border-bottom: 1px #aaa dotted;
+	padding: 0;
+}
+
+.sc-theme #panes .pane-wrapper p {
+	margin: 8px 0;
 }
 
 .sc-theme #panes .pane-wrapper .buttons {
-	border-top: 1px #aaa dotted;
 	text-align: right ;
-	padding-top: 12px;
-	margin-top: 10px;
-	margin-left: -16px;
-	margin-right: -16px;
-	padding-right: 16px;
-	padding-left: 16px;
+	margin-left: -20px;
+	margin-right: -20px;
+	padding-right: 20px;
+	padding-left: 20px;
 }
 
 .sc-theme .pane .shadow {
 	position: relative ;
 	border: none ;
-	background: #e8e8e8 static_url('panels/background-thin') repeat-x left -1px; 
+	background: #e8e8e8 url('/static/sproutcore/_src/english.lproj/panels/background-thin.png') repeat-x left -1px; 
 	border-top: 1px #ddd solid;
 }
 
@@ -113,7 +113,8 @@
 
 /* @group Panels */
 
-.sc-theme .panel-pane {
+.sc-theme .panel-pane,
+.sc-theme .dialog-pane {
 	position: absolute ;
 	top: 0;
 	left:  0;
@@ -122,34 +123,14 @@
 	background: static_url('panels/overlay') repeat;
 }
 
-.sc-theme .panel-pane .pane-wrapper {
+.sc-theme .panel-pane .pane-wrapper,
+.sc-theme .dialog-pane .pane-wrapper {
 	top: 50px;
 	margin-left: auto;
 	margin-right: auto;
-	padding: 11px 16px;
+	padding: 16px 24px;
 }
 
 /* @end */
 
-/* @group Dialogs */
-
-.sc-theme .dialog-pane {
-	position: absolute ;
-	top: 0;
-	left:  0;
-	width: 100%;
-	height: 100%;
-	background-color: rgba(255,255,255,0.63);
-}
-
-.sc-theme .dialog-pane .pane-wrapper {
-	margin-left: auto ;
-	margin-right: auto ;
-	border: 6px #888 solid ;
-	background: #e8e8e8 static_url('panels/background-thin') repeat-x left -1px; 
-	padding: 10px 14px;
-	position: relative ;
-	top: 75px;
-}
 
-/* @end */

data/frameworks/sproutcore/foundation/application.js

@@ -1,3 +1,8 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2008 Sprout Systems, Inc.
+// ========================================================================
+
 require('Core');
 require('foundation/responder');
 
@@ -13,14 +18,19 @@ require('foundation/responder');
   @extends SC.Responder
   @author Skip Baney
   @copyright 2006-2008, Sprout Systems, Inc. and contributors.
-  @version 0.1
+  @since SproutCore 1.0
 */
 SC.Application = SC.Responder.extend( 
 /** @scope SC.Application.prototype */ {
-  
+
   /**
-  * The pane that is currently receiving key events.
-  * @return {SC.PaneView}
+    The pane that is currently receiving key events.
+    
+    This is most often the SC.window object but if you display a popup or 
+    some other such element, you may set this to some other value.
+    
+    @field
+    @type {SC.View}
   */
   keyPane: function( key, value )
   {
@@ -36,8 +46,14 @@ SC.Application = SC.Responder.extend(
   }.property(),
 
   /**
-  * The primary pane for the application.
-  * @return {SC.PaneView}
+    The main pane for the application.  
+    
+    The main pane is usually the primary pane you expect users to work in. 
+    It receives keyboard equivalent events and other operations even when
+    another key pane is positioned over it.
+    
+    @field
+    @type {SC.View}
   */
   mainPane: function( key, value )
   {
@@ -53,8 +69,13 @@ SC.Application = SC.Responder.extend(
   }.property(),
 
   /**
-  * Starts the application
-  * @return {void}
+    Starts the SproutCore application.
+    
+    Typically this will simply setup the SC.window object so that it starts
+    to receive keyboard and mouse events and then makes the window both
+    main and key pane.
+    
+    @returns {void}
   */
   run: function()
   {

data/frameworks/sproutcore/foundation/object.js

@@ -302,6 +302,7 @@ Object.extend(SC.Object,
     var bindings = (ext._bindings) ? null : (base._bindings || []).slice() ;
     var observers = (ext._observers) ? null : (base._observers || []).slice();
     var properties = (ext._properties) ? null : (base._properties || []).slice() ;
+    var outlets = (ext.outlets) ? null : (base.outlets || []).slice() ;
     
     // now copy properties, add superclass to func.
     for(var key in ext) {
@@ -320,12 +321,14 @@ Object.extend(SC.Object,
       if (bindings && (key.slice(keyLen-7,keyLen) == "Binding")) {
         bindings.push(key) ;
         
-      // Also add observers and properties for functions...
+      // Also add observers, outlets, and properties for functions...
       } else if (value && (value instanceof Function)) {
         if (observers && value.propertyPaths) {
           observers.push(key) ;
         } else if (properties && value.dependentKeys) {
           properties.push(key) ;
+        } else if (outlets && value.autoconfiguredOutlet) {
+          outlets.push(key) ;
         }
       }
 
@@ -337,6 +340,7 @@ Object.extend(SC.Object,
     if (bindings) base._bindings = bindings;
     if (observers) base._observers = observers ;
     if (properties) base._properties = properties ;
+    if (outlets && outlets.length > 0) base.outlets = outlets ;
 
     //console.log('bindings: %@ -- observers: %@ -- properties: %@'.format(base._bindings,base._observers,base._properties)) ;
     

data/frameworks/sproutcore/foundation/run_loop.js

@@ -59,6 +59,66 @@ require('Core') ;
 */
 SC.runLoop = SC.Object.create({
   
+  /**
+    Maximum time we allow things to run before taking a break.
+  */
+  maxRunTime: 3000,
+  
+  /**
+    Called by an observable object to schedule an observer to be notified.
+    
+    @param target {Object} the target object
+    @param action {Function} the method to call
+    @param args {Array} array of arguments to pass on
+    @returns {void}
+  */
+  notifyObserver: function(target, action, args) {
+    if (!this._notifications) this._notifications = [] ;
+    this._notifications.push({ target: target, action: action, args: args });
+  },
+  
+  /**
+    Tries to flush observer notifications.  The idea is that this will
+    continue to remove observers until all of the notifications have flushed
+    or until the max execution time has passed.  Called automatically from
+    endRunLoop().
+    
+    The way this works, it does not unshift pending notifications but
+    instead just sets them to null until the entire queue is flushed.  Then
+    it will reset the queue to a new array.  This is faster than shifting().
+    
+    @returns {void}
+  */
+  deliverNotifications: function() {
+    if (!this._notifications || this._notifications.length <=0) return;
+    if (this._notifying) return ; // do not allow recursion
+    this._notifying = YES ;
+    
+    var start = this.get('startTime') ;
+    var max = start + this.get('maxRunTime') ;
+    var loc = 0;
+    while((Date.now() < max) && (loc < this._notifications.length)) {
+      var notify = this._notifications[loc] ;
+      this._notifications[loc] = null;
+      loc++ ; // IMPORTANT: Make sure you increment so that we always go on.
+
+      if (notify) {
+        var args = notify.args;
+        notify.action.call(notify.target, args[0], args[1], args[2], args[3]);
+      }
+    }
+    
+    // if we made it through and the queue is empty, reset it
+    // otherwise, leave the queue in place and schedule another runloop.
+    if (loc >= this._notifications.length) {
+      this._notifications = [];
+    } else {
+      this.invokeLater(this.deliverNotifications) ;
+    }
+    
+    this._notifying = NO ;
+  },
+  
   /**
     Call this method whenver you begin executing code.  
   
@@ -82,7 +142,10 @@ SC.runLoop = SC.Object.create({
     @returns {void}
   */
   endRunLoop: function() {
-    // flush any expired timers, possibly cancelling the timout.
+    // send any pending notifications.
+    //this.deliverNotifications() ;
+    
+    // flush any expired timers, possibly cancelling the timeout.
     this._flushExpiredTimers() ;
     this._start = null ;
   },
@@ -216,7 +279,7 @@ SC.runLoop = SC.Object.create({
   _flushExpiredTimers: function() {
     if (!this._timers) this._timers = {} ;
     var now = this.get('startTime') ;
-    var max = now + 3000;  // max time we are allowed to run timers
+    var max = now + this.get('maxRunTime');  // max time we are allowed to run timers
 
     this._flushing = YES ;
     

data/frameworks/sproutcore/foundation/timer.js

@@ -4,6 +4,7 @@
 // ========================================================================
 
 require('Core') ;
+require('foundation/object');
 
 /**
   @class

data/frameworks/sproutcore/globals/window.js

@@ -71,12 +71,16 @@ SC.window = SC.PaneView.extend({
   autoresizesChildViews: true,
   
   _onresize: function(evt) {
+    SC.runLoop.beginRunLoop();
+    
     var oldSize = Object.clone(this.get('size')) ;
     this._size = null ;
     var newSize = this.get('size') ;
     if ((newSize.width != oldSize.width) || (newSize.height != oldSize.height)) {
       this.resizeChildrenWithOldSize(oldSize) ;
     }
+    
+    SC.runLoop.endRunLoop() ;
   },
   
   // ........................................................................
@@ -133,17 +137,21 @@ SC.window = SC.PaneView.extend({
 
   _sendEvent: function( sctype, evt )
   {
+    SC.runLoop.beginRunLoop();
+    
     evt._type = sctype;
     evt._stopWhenHandled = (evt._stopWhenHandled !== undefined) ? evt._stopWhenHandled : true;
     
     var handler = SC.app.sendEvent( evt );
     
+    var ret = true;
     if (handler && evt._stopWhenHandled) {
       Event.stop(evt);
-      return false;
-    } else {
-      return true;
+      ret = false;
     }
+    
+    SC.runLoop.endRunLoop();
+    return ret ; 
   },
 
   // util code factored out of keypress and keydown handlers
@@ -173,6 +181,8 @@ SC.window = SC.PaneView.extend({
   
   _onmousedown: function(evt)
   {
+    SC.runLoop.beginRunLoop();
+
     // make sure the view gets focus no matter what.  FF is inconsistant 
     // about this.
     this._onfocus(); 
@@ -189,26 +199,15 @@ SC.window = SC.PaneView.extend({
     evt._stopWhenHandled = (evt._stopWhenHandled !== undefined) ? evt._stopWhenHandled : true;
 
     this._mouseDownView = SC.app.sendEvent( evt );
+    var ret = true ;
     if (this._mouseDownView && evt._stopWhenHandled)
     {
       Event.stop(evt);
+      ret = false ;
     }
 
-    // find the view to handle the mouseDown.  go up the chain till you find
-    // one that implements didMouseDown or mouseDown && returns true.
-/*    var view = this.firstViewForEvent(evt) ;
-    var handled = false ;
-    while(view && (view != this) && !handled) {
-      var func = view.mouseDown || view.didMouseDown;
-      if (func) handled = func.call(view, evt) ;
-      
-      if (!handled) view = view.get('nextResponder');
-    }
-    if (view == this) view = null;
-    this._mouseDownView = view ;
-    
-    if (handled) Event.stop(evt) ;
-*/
+    SC.runLoop.endRunLoop();
+    return ret ;
   },
   
   // mouseUp only gets delivered to the view that handled the mouseDown evt.
@@ -218,6 +217,7 @@ SC.window = SC.PaneView.extend({
   // send.
   _onmouseup: function(evt)
   {
+    SC.runLoop.beginRunLoop();
     var handler = null;
 
     this._lastMouseUpAt = Date.now();
@@ -246,6 +246,7 @@ SC.window = SC.PaneView.extend({
     }
     
     this._mouseDownView = null;
+    SC.runLoop.endRunLoop() ;
   },
   
   _lastHovered: null,
@@ -260,6 +261,8 @@ SC.window = SC.PaneView.extend({
   //
   _onmousemove: function(evt) {
 
+    SC.runLoop.beginRunLoop();
+
     // make sure the view gets focus no matter what.  FF is inconsistant 
     // about this.
     this._onfocus(); 
@@ -300,6 +303,8 @@ SC.window = SC.PaneView.extend({
     if (this._mouseDownView && this._mouseDownView.mouseDragged) {
       this._mouseDownView.mouseDragged(evt) ;
     }
+    
+    SC.runLoop.endRunLoop();
   },
   
   // remove event observers.