sproutcore 0.9.0

data/frameworks/sproutcore/foundation/date.js

@@ -0,0 +1,357 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2007 Sprout Systems, Inc.
+// ========================================================================
+
+// Extensions to the Date object. Comes from JavaScript Toolbox at:
+// http://www.mattkruse.com/javascript/date/source.html
+
+// ------------------------------------------------------------------
+// These functions use the same 'format' strings as the 
+// java.text.SimpleDateFormat class, with minor exceptions.
+// The format string consists of the following abbreviations:
+// 
+// Field        | Full Form          | Short Form
+// -------------+--------------------+-----------------------
+// Year         | yyyy (4 digits)    | yy (2 digits), y (2 or 4 digits)
+// Month        | MMM (name or abbr.)| MM (2 digits), M (1 or 2 digits)
+//              | NNN (abbr.)        |
+// Day of Month | dd (2 digits)      | d (1 or 2 digits)
+// Day of Week  | EE (name)          | E (abbr)
+// Hour (1-12)  | hh (2 digits)      | h (1 or 2 digits)
+// Hour (0-23)  | HH (2 digits)      | H (1 or 2 digits)
+// Hour (0-11)  | KK (2 digits)      | K (1 or 2 digits)
+// Hour (1-24)  | kk (2 digits)      | k (1 or 2 digits)
+// Minute       | mm (2 digits)      | m (1 or 2 digits)
+// Second       | ss (2 digits)      | s (1 or 2 digits)
+// AM/PM        | a                  |
+//
+// NOTE THE DIFFERENCE BETWEEN MM and mm! Month=MM, not mm!
+// Examples:
+//  "MMM d, y" matches: January 01, 2000
+//                      Dec 1, 1900
+//                      Nov 20, 00
+//  "M/d/yy"   matches: 01/20/00
+//                      9/2/00
+//  "MMM dd, yyyy hh:mm:ssa" matches: "January 01, 2000 12:30:45AM"
+// ------------------------------------------------------------------
+
+var MONTH_NAMES=new Array('January','February','March','April','May','June','July','August','September','October','November','December','Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec');
+var DAY_NAMES=new Array('Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sun','Mon','Tue','Wed','Thu','Fri','Sat');
+function LZ(x) {return(x<0||x>9?"":"0")+x;}
+
+Object.extend(Date,{
+  
+  // returns the current time as an offset
+  now: function() {
+    return new Date().getTime() ;
+  },
+  
+  // ------------------------------------------------------------------
+  // isDate ( date_string, format_string )
+  // Returns true if date string matches format of format string and
+  // is a valid date. Else returns false.
+  // It is recommended that you trim whitespace around the value before
+  // passing it to this function, as whitespace is NOT ignored!
+  // ------------------------------------------------------------------
+  isDate: function(val,format) {
+  	var date = Date.getDateFromFormat(val,format);
+  	if (date==0) { return false; }
+  	return true;
+	},
+
+  // -------------------------------------------------------------------
+  // compareDates(date1,date1format,date2,date2format)
+  //   Compare two date strings to see which is greater.
+  //   Returns:
+  //   1 if date1 is greater than date2
+  //   0 if date2 is greater than date1 of if they are the same
+  //  -1 if either of the dates is in an invalid format
+  // -------------------------------------------------------------------
+  compareDates: function(date1,dateformat1,date2,dateformat2) {
+  	var d1= Date.getDateFromFormat(date1,dateformat1);
+  	var d2= Date.getDateFromFormat(date2,dateformat2);
+  	if (d1==0 || d2==0) {
+  		return -1;
+  		}
+  	else if (d1 > d2) {
+  		return 1;
+  		}
+  	return 0;
+	},
+	
+  // ------------------------------------------------------------------
+  // getDateFromFormat( date_string , format_string )
+  //
+  // This function takes a date string and a format string. It matches
+  // If the date string matches the format string, it returns the 
+  // getTime() of the date. If it does not match, it returns 0.
+  // ------------------------------------------------------------------
+  getDateFromFormat: function(val,format) {
+  	val=val+"";
+  	format=format+"";
+  	var i_val=0;
+  	var i_format=0;
+  	var c="";
+  	var token="";
+  	var token2="";
+  	var x,y;
+  	var now=new Date();
+  	var year=now.getYear();
+  	var month=now.getMonth()+1;
+  	var date=1;
+  	var hh=now.getHours();
+  	var mm=now.getMinutes();
+  	var ss=now.getSeconds();
+  	var ampm="";
+
+  	while (i_format < format.length) {
+  		// Get next token from format string
+  		c=format.charAt(i_format);
+  		token="";
+  		while ((format.charAt(i_format)==c) && (i_format < format.length)) {
+  			token += format.charAt(i_format++);
+  			}
+  		// Extract contents of value based on format token
+  		if (token=="yyyy" || token=="yy" || token=="y") {
+  			if (token=="yyyy") { x=4;y=4; }
+  			if (token=="yy")   { x=2;y=2; }
+  			if (token=="y")    { x=2;y=4; }
+  			year=Date._getInt(val,i_val,x,y);
+  			if (year==null) { return 0; }
+  			i_val += year.length;
+  			if (year.length==2) {
+  				if (year > 70) { year=1900+(year-0); }
+  				else { year=2000+(year-0); }
+  				}
+  			}
+  		else if (token=="MMM"||token=="NNN"){
+  			month=0;
+  			for (var i=0; i<MONTH_NAMES.length; i++) {
+  				var month_name=MONTH_NAMES[i];
+  				if (val.substring(i_val,i_val+month_name.length).toLowerCase()==month_name.toLowerCase()) {
+  					if (token=="MMM"||(token=="NNN"&&i>11)) {
+  						month=i+1;
+  						if (month>12) { month -= 12; }
+  						i_val += month_name.length;
+  						break;
+  						}
+  					}
+  				}
+  			if ((month < 1)||(month>12)){return 0;}
+  			}
+  		else if (token=="EE"||token=="E"){
+  			for (var i=0; i<DAY_NAMES.length; i++) {
+  				var day_name=DAY_NAMES[i];
+  				if (val.substring(i_val,i_val+day_name.length).toLowerCase()==day_name.toLowerCase()) {
+  					i_val += day_name.length;
+  					break;
+  					}
+  				}
+  			}
+  		else if (token=="MM"||token=="M") {
+  			month=Date._getInt(val,i_val,token.length,2);
+  			if(month==null||(month<1)||(month>12)){return 0;}
+  			i_val+=month.length;}
+  		else if (token=="dd"||token=="d") {
+  			date=Date._getInt(val,i_val,token.length,2);
+  			if(date==null||(date<1)||(date>31)){return 0;}
+  			i_val+=date.length;}
+  		else if (token=="hh"||token=="h") {
+  			hh=Date._getInt(val,i_val,token.length,2);
+  			if(hh==null||(hh<1)||(hh>12)){return 0;}
+  			i_val+=hh.length;}
+  		else if (token=="HH"||token=="H") {
+  			hh=Date._getInt(val,i_val,token.length,2);
+  			if(hh==null||(hh<0)||(hh>23)){return 0;}
+  			i_val+=hh.length;}
+  		else if (token=="KK"||token=="K") {
+  			hh=Date._getInt(val,i_val,token.length,2);
+  			if(hh==null||(hh<0)||(hh>11)){return 0;}
+  			i_val+=hh.length;}
+  		else if (token=="kk"||token=="k") {
+  			hh=Date._getInt(val,i_val,token.length,2);
+  			if(hh==null||(hh<1)||(hh>24)){return 0;}
+  			i_val+=hh.length;hh--;}
+  		else if (token=="mm"||token=="m") {
+  			mm=Date._getInt(val,i_val,token.length,2);
+  			if(mm==null||(mm<0)||(mm>59)){return 0;}
+  			i_val+=mm.length;}
+  		else if (token=="ss"||token=="s") {
+  			ss=Date._getInt(val,i_val,token.length,2);
+  			if(ss==null||(ss<0)||(ss>59)){return 0;}
+  			i_val+=ss.length;}
+  		else if (token=="a") {
+  			if (val.substring(i_val,i_val+2).toLowerCase()=="am") {ampm="AM";}
+  			else if (val.substring(i_val,i_val+2).toLowerCase()=="pm") {ampm="PM";}
+  			else {return 0;}
+  			i_val+=2;}
+  		else {
+  			if (val.substring(i_val,i_val+token.length)!=token) {return 0;}
+  			else {i_val+=token.length;}
+  			}
+  		}
+  	// If there are any trailing characters left in the value, it doesn't match
+  	if (i_val != val.length) { return 0; }
+  	// Is date valid for month?
+  	if (month==2) {
+  		// Check for leap year
+  		if ( ( (year%4==0)&&(year%100 != 0) ) || (year%400==0) ) { // leap year
+  			if (date > 29){ return 0; }
+  			}
+  		else { if (date > 28) { return 0; } }
+  		}
+  	if ((month==4)||(month==6)||(month==9)||(month==11)) {
+  		if (date > 30) { return 0; }
+  		}
+  	// Correct hours value
+  	if (hh<12 && ampm=="PM") { hh=hh-0+12; }
+  	else if (hh>11 && ampm=="AM") { hh-=12; }
+  	var newdate=new Date(year,month-1,date,hh,mm,ss);
+  	return newdate.getTime();
+  },
+
+  // ------------------------------------------------------------------
+  // parseDate( date_string [, prefer_euro_format] )
+  //
+  // This function takes a date string and tries to match it to a
+  // number of possible date formats to get the value. It will try to
+  // match against the following international formats, in this order:
+  // y-M-d   MMM d, y   MMM d,y   y-MMM-d   d-MMM-y  MMM d
+  // M/d/y   M-d-y      M.d.y     MMM-d     M/d      M-d
+  // d/M/y   d-M-y      d.M.y     d-MMM     d/M      d-M
+  // 
+  // Also understands: 
+  // 
+  // yesterday, today, tomorrow, now
+  //
+  // A second argument may be passed to instruct the method to search
+  // for formats like d/M/y (european format) before M/d/y (American).
+  // Returns a Date object or null if no patterns match.
+  // ------------------------------------------------------------------
+  parseDate: function(val) {
+  	var preferEuro=(arguments.length==2)?arguments[1]:false;
+  	generalFormats=new Array('E NNN dd HH:mm:ss UTC yyyy','y-M-d','y-M-d','MMM d, y','MMM d,y','y-MMM-d','d-MMM-y','MMM d','d MMM y','d.MMM.y','y MMM d','y.MMM.d');
+  	monthFirst=new Array('M/d/y','M-d-y','M.d.y','MMM-d','M/d','M-d');
+  	dateFirst =new Array('d/M/y','d-M-y','d.M.y','d-MMM','d/M','d-M');
+  	var checkList=new Array('generalFormats',preferEuro?'dateFirst':'monthFirst',preferEuro?'monthFirst':'dateFirst');
+  	var d=null;
+  	
+  	// first look for natural language
+  	d = 0 ; var now = new Date().getTime() ;
+  	switch(val.toLowerCase()) {
+  	  case 'yesterday'.loc():
+  	    d = now - (24*60*60*1000) ;
+  	    break ;
+  	  case 'today'.loc():
+  	  case 'now'.loc():
+  	    d = now ;
+  	    break ;
+  	  case 'tomorrow'.loc():
+  	    d = now + (24*60*60*1000) ;
+  	    break;
+  	}
+  	if (d>0) return new Date(d) ;
+  	
+  	for (var i=0; i<checkList.length; i++) {
+  		var l=window[checkList[i]];
+  		for (var j=0; j<l.length; j++) {
+  			d=Date.getDateFromFormat(val,l[j]);
+  			if (d==0) d = Date.getDateFromFormat(val,l[j] + ' H:m:s') ;
+  			if (d==0) d = Date.getDateFromFormat(val,l[j] + ' h:m:s a') ;
+  			if (d!=0) return new Date(d); 
+  		}
+  	}
+  	return null;
+  },
+  
+  // ------------------------------------------------------------------
+  // Utility functions for parsing in getDateFromFormat()
+  // ------------------------------------------------------------------
+  _isInteger: function(val) {
+  	var digits="1234567890";
+  	for (var i=0; i < val.length; i++) {
+  		if (digits.indexOf(val.charAt(i))==-1) { return false; }
+  	}
+  	return true;
+  },
+  
+  _getInt: function(str,i,minlength,maxlength) {
+  	for (var x=maxlength; x>=minlength; x--) {
+  		var token=str.substring(i,i+x);
+  		if (token.length < minlength) { return null; }
+  		if (Date._isInteger(token)) { return token; }
+  	}
+  	return null;
+  }
+
+}) ;
+
+Object.extend(Date.prototype, {
+  
+  // ------------------------------------------------------------------
+  // formatDate (date_object, format, naturalLanguage)
+  // Returns a date in the output format specified.
+  // The format string uses the same abbreviations as in getDateFromFormat()
+  // 
+  // ------------------------------------------------------------------
+  format: function(format) {
+  	format=format+"";
+    var date = this ;
+  	var result="";
+  	var i_format=0;
+  	var c="";
+  	var token="";
+  	var y=date.getYear()+"";
+  	var M=date.getMonth()+1;
+  	var d=date.getDate();
+  	var E=date.getDay();
+  	var H=date.getHours();
+  	var m=date.getMinutes();
+  	var s=date.getSeconds();
+  	var yyyy,yy,MMM,MM,dd,hh,h,mm,ss,ampm,HH,H,KK,K,kk,k;
+  	// Convert real date parts into formatted versions
+  	var value=new Object();
+  	if (y.length < 4) {y=""+(y-0+1900);}
+  	value["y"]=""+y;
+  	value["yyyy"]=y;
+  	value["yy"]=y.substring(2,4);
+  	value["M"]=M;
+  	value["MM"]=LZ(M);
+  	value["MMM"]=MONTH_NAMES[M-1];
+  	value["NNN"]=MONTH_NAMES[M+11];
+  	value["d"]=d;
+  	value["dd"]=LZ(d);
+  	value["E"]=DAY_NAMES[E+7];
+  	value["EE"]=DAY_NAMES[E];
+  	value["H"]=H;
+  	value["HH"]=LZ(H);
+  	if (H==0){value["h"]=12;}
+  	else if (H>12){value["h"]=H-12;}
+  	else {value["h"]=H;}
+  	value["hh"]=LZ(value["h"]);
+  	if (H>11){value["K"]=H-12;} else {value["K"]=H;}
+  	value["k"]=H+1;
+  	value["KK"]=LZ(value["K"]);
+  	value["kk"]=LZ(value["k"]);
+  	if (H > 11) { value["a"]="PM"; }
+  	else { value["a"]="AM"; }
+  	value["m"]=m;
+  	value["mm"]=LZ(m);
+  	value["s"]=s;
+  	value["ss"]=LZ(s);
+  	while (i_format < format.length) {
+  		c=format.charAt(i_format);
+  		token="";
+  		while ((format.charAt(i_format)==c) && (i_format < format.length)) {
+  			token += format.charAt(i_format++);
+  			}
+  		if (value[token] != null) { result=result + value[token]; }
+  		else { result=result + token; }
+  		}
+  	return result;
+  },
+  
+  utcFormat: function() { return (new Date(this.getTime() + (this.getTimezoneOffset() * 60 * 1000))).format('E NNN dd HH:mm:ss UTC yyyy'); }
+
+}) ;

data/frameworks/sproutcore/foundation/error.js

@@ -0,0 +1,39 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2007 Sprout Systems, Inc.
+// ========================================================================
+
+require('foundation/object');
+
+// Error is used to communicate errors throughout the app.
+SC.Error = SC.Object.extend({
+  code: -1, // error code. Used to designate type.
+  description: '', // human readable dscriptions.
+  label: null // optionally set to human readable the name of the item with the error.
+}) ;
+
+// this will create a new instance of the receiver with the passed 
+// description, etc.
+SC.Error.desc = function(description, label, code) {
+  var opts = { description: description } ;
+  if (label !== undefined) opts.label = label ;
+  if (code !== undefined) opts.code = code ;
+  return this.create(opts) ;
+} ;
+
+// returns an error object.
+function $error(description, label, c) { 
+  return SC.Error.desc(description,label, c); 
+} ;
+
+
+// returns true if the return value is not false or an error.
+function $ok(ret) {
+  return (ret !== false) && ($type(ret) != T_ERROR) ;
+}
+
+
+// STANDARD ERROR OBJECTS
+
+// Used by objects that do not support multiple values.
+SC.Error.HAS_MULTIPLE_VALUES = -100 ;

data/frameworks/sproutcore/foundation/input_manager.js

@@ -0,0 +1,153 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2007 Sprout Systems, Inc.
+// ========================================================================
+
+require('Core') ;
+require('foundation/object') ;
+
+// An InputManager knows how to convert incoming keyboard events and convert
+// them into actions on a responder.  The default version should provide the
+// correct behavior for most people.  However, if you want some special
+// behavior, you can always write your own.
+//
+// An instance of this input manager is created as a property of
+// SC.Responder.  To overide the inputManager used for all responders, replace
+// this property with your own instance.  To override the inputManager used 
+// only for one responder, set the inputManager property on your specific 
+// instance.
+//
+// Note that generally you do not want to write your own inputManager.  They
+// are tricky to get right.  Instead, you should implement the various handler
+// methods on the responder.
+SC.InputManager = SC.Object.extend({
+  
+  // The is the primary entry point for the inputManager.  If you override
+  // the input manager, have this method process the key event and invoke
+  // methods on the responder. 
+  interpretKeyEvents: function(event, responder)
+  {
+    var codes = this.codesForEvent(event) ;
+    var cmd = codes[0]; var chr = codes[1];
+    if (!cmd && !chr) return false ;  //nothing to do.
+
+    // if this is a command key, try to do something about it.
+    if (cmd)
+    {
+      var methodName = SC.MODIFIED_COMMAND_MAP[cmd] || SC.BASE_COMMAND_MAP[cmd.split('_').last()];
+      if (methodName && responder.respondsTo(methodName))
+      {
+        // the responder has a method matching the keybinding... call it.
+        return responder[methodName]( event );
+      }
+    } 
+    if (chr && responder.respondsTo('insertText'))
+    {
+      // if we haven't returned yet and there is plain text, then do an insert of the text.
+      return responder.insertText(chr);
+    }
+
+    return false ; //nothing to do.
+  },
+  
+  // this will get a standardized command code for the event.  It returns
+  // null if the event is plain text, not a command code.
+  codesForEvent: function(e) {
+    var code = e.keyCode ;
+    var ret = null ; var key = null ;
+    var modifiers = '' ;
+    
+    // handle function keys.
+    if (code) {
+      ret = SC.FUNCTION_KEYS[code] ;
+      if (!ret && (e.altKey || e.ctrlKey)) ret = SC.PRINTABLE_KEYS[code] ;
+      if (ret) {
+        if (e.altKey) modifiers += 'alt_' ;
+        if (e.ctrlKey) modifiers += 'ctrl_' ;
+        if (e.shiftKey) modifiers += 'shift_' ;
+      }
+    }
+
+    // otherwise just go get the right key.
+    if (!ret) {
+      var code = e.charCode || e.keyCode ;
+      key = ret = String.fromCharCode(code) ;
+      var lowercase = ret.toLowerCase() ;
+      if (ret != lowercase) {
+        modifiers = 'shift_' ;
+        ret = lowercase ;
+      } else ret = null ;
+    }
+
+    if (ret) ret = modifiers + ret ;
+    return [ret, key] ;
+  }
+    
+});
+
+SC.MODIFIED_COMMAND_MAP = {
+  'ctrl_.': 'cancel',
+  'shift_tab': 'insertBacktab',
+  'shift_left': 'moveLeftAndModifySelection',
+  'shift_right': 'moveRightAndModifySelection',
+  'shift_up': 'moveUpAndModifySelection',
+  'shift_down': 'moveDownAndModifySelection',
+  'alt_left': 'moveLeftAndModifySelection',
+  'alt_right': 'moveRightAndModifySelection',
+  'alt_up': 'moveUpAndModifySelection',
+  'alt_down': 'moveDownAndModifySelection',
+  'ctrl_a': 'selectAll'
+} ;
+
+SC.BASE_COMMAND_MAP = {
+  'escape': 'cancel',
+  'backspace': 'deleteBackward',
+  'delete': 'deleteForward',
+  'return': 'insertNewline',
+  'tab': 'insertTab',
+  'left': 'moveLeft',
+  'right': 'moveRight',
+  'up': 'moveUp',
+  'down': 'moveDown',
+  'home': 'moveToBeginningOfDocument',
+  'end': 'moveToEndOfDocument',
+  'pagedown': 'pageDown',
+  'pageup': 'pageUp'
+} ;
+
+SC.MODIFIER_KEYS = {
+  16:'shift', 17:'ctrl', 18: 'alt'
+};
+
+SC.FUNCTION_KEYS = {
+  8: 'backspace',  9: 'tab',  13: 'return',  19: 'pause',  27: 'escape',  
+  32: 'space',  33: 'pageup', 34: 'pagedown', 35: 'end', 36: 'home', 
+  37: 'left', 38: 'up', 39: 'right', 40: 'down', 44: 'printscreen', 
+  45: 'insert', 46: 'delete', 112: 'f1', 113: 'f2', 114: 'f3', 115: 'f4', 
+  116: 'f5', 117: 'f7', 119: 'f8', 120: 'f9', 121: 'f10', 122: 'f11', 
+  123: 'f12', 144: 'numlock', 145: 'scrolllock'
+} ;
+
+SC.PRINTABLE_KEYS = {
+  48:"0", 49:"1", 50:"2", 51:"3", 52:"4", 53:"5", 54:"6", 55:"7", 56:"8",
+  57:"9", 59:";", 61:"=", 65:"a", 66:"b", 67:"c", 68:"d", 69:"e", 70:"f",
+  71:"g", 72:"h", 73:"i", 74:"j", 75:"k", 76:"l", 77:"m", 78:"n", 79:"o",
+  80:"p", 81:"q", 82:"r", 83:"s", 84:"t", 85:"u", 86:"v", 87:"w", 88:"x",
+  89:"y", 90:"z", 107:"+", 109:"-", 110:".", 188:",", 190:".", 191:"/",
+  192:"`", 219:"[", 220:"\\", 221:"]", 222:"\""
+} ;
+
+// make reverse keycode lookup for using in unit tests...
+SC.KEY_CODES = {};
+for (var i=0, n=256; i < n; i++)
+{
+  if (SC.MODIFIER_KEYS[i] !== undefined) {
+    SC.KEY_CODES[ SC.MODIFIER_KEYS[i] ] = i;
+  } else if (SC.FUNCTION_KEYS[i] !== undefined) {
+    SC.KEY_CODES[ SC.FUNCTION_KEYS[i] ] = i;
+  } else if (SC.PRINTABLE_KEYS[i] !== undefined) {
+    SC.KEY_CODES[ SC.PRINTABLE_KEYS[i] ] = i;
+  }
+}
+
+