sproutcore 0.9.0

data/frameworks/sproutcore/Core.js

@@ -0,0 +1,378 @@
+//@license
+// ==========================================================================
+// SproutCore -- JavaScript Application Framework
+// copyright 2006-2007, Sprout Systems, Inc. and contributors.
+//
+// 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
+//
+//
+// ==========================================================================
+//@license
+
+// ==========================================================================
+// Utility Classes
+// Author: Charles Jolley
+// copyright 2006, Sprout Systems, Inc.
+//
+// This file contains a number of utility methods and classes used throughout
+// SproutCore. This should be loaded after your load Prototype but before you
+// load any other SproutCore objects.  In general, this is the only
+// dependency most SproutCore objects will have.
+//
+// ==========================================================================
+
+// All objects live in the SproutCore namespace, which is also availabe in the
+// abreviation SC.
+SproutCore = {} ; SC = SproutCore ;
+
+// this makes for some nicer to read code
+var YES = true ; var NO = false ;
+
+// this is used by the JavascriptCompile class on the server side.  You can
+// use this to automatically determine the order javascript files need to be
+// included in.  On the client side, this is a NOP.
+function require(file) { return null ; }
+
+// implement window.console.log() for IE.
+if (!window.console) { 
+ window.console = { 
+   _output: [],
+   log: function(str) { this._output.push(str) ; },
+   tail: function(lines) { 
+     if (!lines) lines = 1 ;
+     var loc = this._output.length - lines ;
+     if (loc < 0) loc = 0 ;
+     var ret = [] ;
+     while(loc < this._output.length) {
+       ret.push(this._output[loc]) ; loc++ ;
+     }
+     return ret.join("\n");
+   }  
+ } ;
+}
+window.logCount = 0 ;
+
+// ........................................
+// GENERAL UTILITIES
+// 
+
+Object.extend(SC,{
+
+  _downloadFrames: 0, // count of download frames inserted into document
+  
+	download: function(path) {
+    var tempDLIFrame=document.createElement('iframe');
+    var frameId = 'DownloadFrame_' + this._downloadFrames;
+    tempDLIFrame.setAttribute('id',frameId);
+    tempDLIFrame.style.border='10px';
+    tempDLIFrame.style.width='0px';
+    tempDLIFrame.style.height='0px';
+    tempDLIFrame.style.position='absolute';
+    tempDLIFrame.style.top='-10000px';
+    tempDLIFrame.style.left='-10000px';    
+    // Don't set the iFrame content yet if this is Safari
+    if (!(SC.isSafari())) {
+      tempDLIFrame.setAttribute('src',path);    
+    }
+    document.getElementsByTagName('body')[0].appendChild(tempDLIFrame);
+    if (SC.isSafari()) {
+      tempDLIFrame.setAttribute('src',path);    
+    }
+    this._downloadFrames = this._downloadFrames + 1;
+    if (!(SC.isSafari())) {
+      var r = function() { 
+        document.body.removeChild(document.getElementById(frameId)); 
+      } ;
+      var t = setTimeout(r,2000);
+    }
+	},
+		
+  // Call this method during setup of your app to queue up methods to be 
+  // called once the entire document has finished loading.  If you call this
+  // method once the document has already loaded, then the function will be
+  // called immediately.
+  callOnLoad: function(func) { 
+    if (SC._onloadQueueFlushed) func.call(document);
+    var queue = SC._onloadQueue || [] ;
+    queue.push(func) ; SC._onloadQueue = queue ;
+  },
+
+  // To flush the callOnLoad queue, you need to set window.onload=SC.didLoad
+  didLoad: function() { 
+    
+    SC.app = SC.Application.create();
+    SC.app.run();
+    
+    // set the current language
+    var b = $tag('body');
+    Element.addClassName(b, String.currentLanguage().toLowerCase()) ;
+
+    // call the onloadQueue.
+    var queue ;
+    if (window.callOnLoad) {
+      if (window.callOnLoad instanceof Array) {
+        queue = window.callOnLoad ;
+      } else if (window.callOnLoad instanceof Function) {
+        queue = [window.callOnLoad] ;
+      }
+    } else queue = [] ;
+    queue = queue.concat(SC._onloadQueue) ;
+    var func = null ;
+    while(func = queue.shift()) func.call(document) ;
+    SC._onloadQueueFlushed = true ;
+        
+    // start the app; call main.
+    if (window.main && (main instanceof Function)) main() ; // start app.
+    
+    // finally handle any routes if any.
+    if (typeof Routes != 'undefined') {
+      Routes.doRoutes() ; // old style.
+    } else if (typeof SC.Routes != 'undefined') {
+      SC.Routes.ping() ; // handle routes, if modules is installed.
+    }
+
+  },
+  
+  // this will take a URL of any type and convert it to a fully qualified URL.
+  normalizeURL: function(url) {
+    if (url.slice(0,1) == '/') {
+      url = window.location.protocol + '//' + window.location.host + url ;
+    } else if ((url.slice(0,5) == 'http:') || (url.slice(0,6) == 'https:')) {
+      // no change
+    } else {
+      url = window.location + '/' + url ;
+    }
+    return url ;
+  },
+  
+  // use this instead of typeOf() to get the type of item.  The return values
+  // are: 'string', 'number', 'function', 'class', 'object', 'hash', 'null', 
+  // 'undefined', 'boolean'.  
+  // 'object' will be returned for any items inheriting from SC.Object. 'hash' 
+  // is any other type of object.
+  typeOf: function(item) {
+    if (item === undefined) return T_UNDEFINED ;
+    if (item === null) return T_NULL ; 
+    var ret = typeof(item) ;
+    if (ret == "object") {
+      if (item instanceof Array) {
+        ret = T_ARRAY ;
+      } else if (item instanceof Function) {
+        ret = (item.isClass) ? T_CLASS : T_FUNCTION ;
+      } else if (item instanceof SC.Error) {
+        ret = T_ERROR ;        
+      } else if (item.isObject == true) {
+        ret = T_OBJECT ;
+      } else ret = T_HASH ;
+    } else if (ret == T_FUNCTION) ret = (item.isClass) ? T_CLASS : T_FUNCTION;
+    return ret ;
+  },
+  
+  // this will compare two values to see if they are equal.  If you have two 
+  // values of unknown type, this is faster across all browsers than ===.
+  isEqual: function(a,b) {
+    if (a === null) {
+      return b === null ;
+    } else if (a === undefined) {
+      return b === undefined ;
+    } else if (typeof(a) == typeof(b)) {
+      return a == b ;
+    }
+  },
+  
+  isArray: function( obj )
+  {
+    return ($type(obj) == T_ARRAY) || (obj && obj.objectAt);
+  },
+  
+  _nextGUID: 0,
+  getGUID: function( obj )
+  {
+    if (obj == null) return 0 ;
+    return obj._guid ? obj._guid : (obj._guid = SC._nextGUID++);
+  },
+
+  /** Browser and Platform info. */
+  Platform: {
+    
+    /** The current IE version number or 0 if not IE. */
+    IE: function() {
+      if (Prototype.Browser.IE) {
+        return (navigator.appVersion.match(/\bMSIE.*7\.\b/)) ? 7 : 6 ;
+      } else return 0 ;
+    }(),
+    
+    /** The current Safari major version number of 0 if not Safari */
+    Safari: function() {
+      if (Prototype.Browser.WebKit) {
+        var vers = parseInt(navigator.appVersion.replace(/^.*?AppleWebKit\/(\d+).*?$/,'$1'),0) ;
+        return (vers > 420) ? 3 : 2 ;
+      } return 0 ;
+    }(),
+    
+    /** The current Firefox major version number or 0 if not Firefox */
+    Firefox: function() {
+      if (Prototype.Browser.Gecko) {
+        var ret = parseFloat((navigator.userAgent.match(/Firefox\/(.)/)[1]) || 0);
+        if (ret < 1) ret = 1;
+        return ret ;
+      } else return 0 ;
+    }(),
+    
+    isWindows: function() {
+      return !!(navigator.appVersion.match(/(Windows)/)) ;
+    }(),
+    
+    isMac: function() {
+      if(Prototype.Browser.Gecko) {
+        return !!(navigator.appVersion.match(/(Macintosh)/));
+      } else {
+        return !!(navigator.appVersion.match(/(Mac OS X)/)) ;    
+      }
+    }()
+    
+  },
+  
+  // DEPRECATED.  here for compatibility only.
+  /** @private */
+  isIE: function() { 
+    return SC.Platform.IE > 0 ;
+  },
+
+  /** @private */
+  isSafari: function() {
+    return SC.Platform.Safari > 0 ;
+  },
+  
+  /** @private */
+  isSafari3: function() {
+    return SC.Platform.Safari >= 3 ;
+  },
+  
+  /** @private */
+  isIE7: function() {
+    return SC.Platform.IE >= 7 ;
+  },
+
+  /** @private */
+  isIE6: function() {
+    return (SC.Platform.IE >= 6) && (SC.Platform.IE < 7) ;
+  },
+
+  /** @private */
+  isWindows: function() {
+    return SC.Platform.isWindows;
+  },
+
+  /** @private */
+  isMacOSX: function() {
+    return SC.Platform.isMac ;
+  },
+  
+  /** @private */
+  isFireFox: function() {
+    return SC.Platform.Firefox > 0 ;
+  },
+  
+  /** @private */
+  isFireFox2: function() {
+    return SC.Platform.Firefox >= 2 ;
+  }
+  
+});
+
+// Save the Platform.Browser name.
+SC.Platform.Browser = function() {
+  if (SC.Platform.IE >0) {
+    return 'IE';
+  } else if (SC.Platform.Safari > 0) {
+    return 'Safari';
+  } else if (SC.Platform.Firefox >0) {
+    return 'Firefox'; 
+  }
+}() ;
+
+T_ERROR = 'error' ;
+T_OBJECT = 'object' ;
+T_NULL = 'null';
+T_CLASS = 'class' ;
+T_HASH = 'hash' ;
+T_FUNCTION = 'function' ;
+T_UNDEFINED = 'undefined' ;
+T_NUMBER = 'number' ;
+T_BOOL = 'boolean' ;
+T_ARRAY = 'array' ;
+T_STRING = 'string' ;
+
+$type = function(item) { return SC.typeOf(item); }; 
+
+Object.extend(Object,{
+
+  // this will serialize a general JSON object into a URI.
+  serialize: function(obj) {
+    var ret = [] ;
+    for(var key in obj) {
+      var value = obj[key] ;
+      if (typeof value == 'number') { value = '' + value ; }
+      if (!(typeof value == 'string')) { value = value.join(','); }
+      ret.push(encodeURIComponent(key) + "=" + encodeURIComponent(value)) ;
+    }
+    return ret.join('&') ;
+  }
+  
+}) ;
+
+
+// This will add or remove the class name based on the flag, allowing you to
+// treat it like a bool setting.  Simplifies the common case where you need
+// to make a class name match a bool.
+Element.setClassName = function(element,className,flag) {
+  if (flag) { 
+    element.addClassName(className); 
+  } else {
+    element.removeClassName(className) ;
+  }
+} ;
+
+// ........................................
+// EVENT EXTENSIONS
+// 
+Object.extend(Event,{
+  // get the character code for key pressed events.
+  getCharCode: function(e) {
+    return (e.keyCode) ? e.keyCode : ((e.which)?e.which:0) ; 
+  },
+  
+  // get the pressed char as a string.
+  getCharString: function(e) {
+    return String.fromCharCode(Event.getCharCode(e)) ;
+  },
+  
+  pointerLocation: function(e) {
+    return { x: Event.pointerX(e), y: Event.pointerY(e) };
+  },
+  
+  ALT_KEY: '_ALT',
+  CTRL_KEY: '_CTRL',
+  SHIFT_KEY: '_SHIFT'
+  
+});
+

data/frameworks/sproutcore/README

@@ -0,0 +1,3 @@
+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.
+
+  

data/frameworks/sproutcore/controllers/array.js

@@ -0,0 +1,236 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2007 Sprout Systems, Inc.
+// ========================================================================
+
+require('controllers/controller') ;
+require('foundation/array') ;
+
+/** @class
+
+An Array Controller provides a way to project the contents of an array
+out to a view.  You can use this object any place you might use an
+array.  Changes to the array will not propogate to the content array
+until you call commitChanges().
+
+@extends SC.Controller
+@extends SC.Array
+
+*/
+SC.ArrayController = SC.Controller.extend(SC.Array, 
+/** @scope SC.ArrayController.prototype */
+{
+  /**
+  * The array content that is being managed by the controller.
+  * @property
+  * @type {Array}
+  */
+  content: function( key, value )
+  {
+    if (!this._content) this._content = [];
+    if (value !== undefined) 
+    {
+      // only allow arrays... or array-like objects...
+      this._content = ($type(value) == T_ARRAY) || (value && value.objectAt) ? value : [];
+    }
+    return this._content;
+  }.property(),
+  
+  /**
+  * Watches changes to the content property updates the contentClone.
+  * @private
+  * @observes content
+  **/
+  _contentObserver: function()
+  {
+    this.contentCloneReset();
+  }.observes('content'),
+  
+
+  /**
+  * A log of calls to the replace method that will be played back to the content property on commit.
+  * @private
+  * @property
+  * @type {SC.Array}
+  */
+  changelog: function( key, value )
+  {
+    if (!this._changelog) this._changelog = [];
+    if (value !== undefined) this._changelog = value;
+    return this._changelog;
+  }.property(),
+
+  /**
+  * A collection of all the objects that have been removed using removeObject.
+  * On commit, they are deleted.
+  * @private
+  * @property
+  * @type {SC.Array}
+  */
+  deletions: function( key, value )
+  {
+    if (!this._deletions) this._deletions = [];
+    if (value !== undefined) this._deletions = value;
+    return this._deletions;
+  }.property(),
+
+  /**
+  * The array content that (when committed) will be merged back into the content property.
+  * All array methods will take place on this object.
+  * @private
+  * @property
+  * @type {SC.Array}
+  */
+  contentClone: function( key, value )
+  {
+    if (value !== undefined)
+    {
+      this._contentClone = value;
+      this.arrayContentDidChange();
+    }
+    return this._contentClone;
+  }.property(),
+
+  /**
+  * Clones the content property into the contentClone property.
+  * @private
+  **/
+  contentCloneReset: function()
+  {
+    this.set('changelog', []);
+    this.set('deletions', []);
+    this.set('contentClone', null);
+  },
+
+  /**
+  * SC.Array interface implimentation.
+  * 
+  * @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)
+  {
+    if (this.get('contentClone') == undefined) this.set('contentClone', this.get('content').clone());
+
+    for (var i=0; i < amt; i++)
+    {
+      this.get('deletions').push( this._getSourceContent().objectAt(idx + i) );
+    }
+
+    this.get('changelog').push({ idx: idx, amt: amt, objects: objects });
+    this.get('contentClone').replace(idx, amt, objects);
+    
+    for (var i=idx, n=idx+amt; i < n; i++)
+    {
+      if ( this._objControllers && this._objControllers[i] ) 
+      {
+        this._objControllers[i] = null;
+      }
+    }
+    
+    this.editorDidChange() ;
+    this.arrayContentDidChange();
+    
+    return this;
+  },
+  /**
+  * SC.Array interface implimentation.
+  * 
+  * @param {Number} idx
+  *   The index of the item to return.  If idx exceeds the current length, 
+  *   return null.
+  */
+  objectAt: function(idx)
+  {
+    var obj = this._getSourceContent().objectAt(idx);
+    
+    if ( !this._objControllers ) this._objControllers = [];
+    if ( !this._objControllers[idx] ) this._objControllers[idx] = this.controllerForValue(obj);
+    
+    return this._objControllers[idx];
+  },
+  /**
+  * SC.Array interface implimentation.
+  * @property
+  * @type {integer}
+  */
+  length: function( key, value )
+  {
+    return this._getSourceContent().get('length');
+  }.property(),
+
+  indexOf: function( obj )
+  {
+    return this._getSourceContent().indexOf(obj);
+  },
+  _getSourceContent: function()
+  {
+    return this.get('contentClone') || this.get('content');
+  },
+
+
+
+  
+  /** 
+  * @private
+  */
+  performCommitChanges: function()
+  {
+    var content = this.get('content');
+    var ret     = true;
+    
+    // cannot commit changes to null content.  Return an error.
+    if (!content)
+    {
+      return $error("No Content");
+    }
+    
+    if (content.beginPropertyChanges) content.beginPropertyChanges();
+
+
+    // apply all the changes made to the clone
+    this.get('changelog').each(function(change)
+    {
+      content.replace( change.idx, change.amt, change.objects );
+    });
+    this.get('deletions').each(function(obj)
+    {
+      if (obj.instanceOf(SC.ObjectController)) obj = obj.get('content');
+      if (obj && obj.destroy) 
+      {
+        obj.destroy();
+      }
+    });
+
+
+    if (content.endPropertyChanges) content.endPropertyChanges();
+    if (content.commitChanges) ret = content.commitChanges();
+    
+    if ($ok(ret))
+    {
+      this.contentCloneReset();
+      this.editorDidClearChanges();
+    }
+    
+    return ret;
+  },
+  /** 
+  * @private
+  */
+  performDiscardChanges: function()
+  {
+    this.contentCloneReset();
+    this.editorDidClearChanges();
+    return true;
+  }
+
+});