sproutit-sproutcore 1.0.0.20090407205609 → 1.0.0.20090408130025

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/updateLayerLocation.js

@@ -0,0 +1,194 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+// .......................................................
+//  updateLayerLocation() 
+//
+var parent, child, parentLayer, childLayer;
+module("SC.View#updateLayerLocation", {
+	setup: function() {
+		parent = SC.View.create({ 
+			childViews: [SC.View]
+		});
+		child = parent.childViews[0];
+	
+		parent.createLayer();
+		parentLayer = parent.get('layer');
+		childLayer = child.get('layer');
+	},
+	
+	teardown: function() {
+		parent = child = parentLayer = childLayer = null;
+	}
+});  
+
+test("returns receiver", function() {
+	var view = SC.View.create();
+	equals(view.updateLayerLocation(), view, 'returns receiver');
+});
+
+
+// helper method for testing if a parent still contains a child node
+function parentHasChild(parent, child) {
+	var cur = parent.firstChild;
+	while(cur) {
+		if (cur === child) return YES;
+		cur = cur.nextSibling ;
+	}
+	return NO ;
+}
+
+test("CASE 1: remove child from parent - remove child layer from parent layer", function() {
+
+	equals(childLayer.parentNode, parentLayer, 'child layer currently belongs to parent');
+
+	child.removeFromParent();
+	child.updateLayerLocation();
+	ok(!parentHasChild(parentLayer, childLayer), 'child layer no longer belongs to parent node') ;
+});
+
+test("CASE 2: add child to new parent view with no layer if its own, destroy the layer...", function() {
+
+	var newParent = SC.View.create();
+	ok(!newParent.get('layer'), 'precond - new parent has no layer');
+	newParent.appendChild(child);
+	
+	child.updateLayerLocation() ;
+	ok(!parentHasChild(parentLayer, childLayer), 'child layer was removed from parent layer');
+	ok(!child.get('layer'), 'child no longer has layer either');
+});
+
+test("CASE 3: add child with no layer or parent with no layer.  nothing to do.  this test ensures no errors are thrown", function() {
+
+	// create a few new views w/ no layers...
+	var newParent = SC.View.create();
+	var newChild = SC.View.create();
+	ok(!newParent.get('layer'), 'precond - new parent has no layer');
+	ok(!newChild.get('layer'), 'precond - new child has no layer');
+	newParent.appendChild(newChild);
+	
+	ok(!newParent.get('layer'), 'new parent still has no layer');
+	ok(!newChild.get('layer'), 'new child still has no layer');
+});
+
+test("CASE 4: add child with no layer to parent with layer.  create layer for child", function() {
+
+	var newChild = SC.View.create();
+	ok(!newChild.get('layer'), 'precond - new child has no layer');
+
+	parent.appendChild(newChild);
+	newChild.updateLayerLocation();
+	
+	var layer = newChild.get('layer');
+	ok(layer, 'newChild now has layer');
+	equals(layer.parentNode, parentLayer, 'newChild layer belongs to parent layer');	
+});
+
+test("CASE 5: add child with layer to parent with layer.  move layer from previous location to new parent", function() {
+
+	var newParent = SC.View.create();
+	var layer = newParent.createLayer().get('layer');
+	ok(layer, 'precond - newParent has layer');
+	
+	newParent.appendChild(child);
+	child.updateLayerLocation();
+	
+	ok(!parentHasChild(parentLayer, childLayer), 'old parent layer no longer has child layer');
+	ok(parentHasChild(layer, childLayer), 'newParent layer now has child');
+});
+
+test("CASE 5a: insert child before a sibling w/ layer - should insert child layer before sibling layer", function() {
+
+	var newParent = SC.View.create({
+	  childViews: [SC.View]
+	}).createLayer();
+	var newParentLayer = newParent.get('layer');
+
+	var sibling = newParent.childViews[0];
+	var siblingLayer = sibling.get('layer');
+
+	ok(newParentLayer, 'precond - newParent has layer');
+	ok(siblingLayer, 'precond - sibling has layer');
+	ok(parentHasChild(newParentLayer, siblingLayer), 'precond - siblingLayer belongs to new parent layer')	;
+	
+	newParent.insertBefore(child, sibling);
+	child.updateLayerLocation();
+	
+	equals(childLayer.nextSibling, siblingLayer, 'child layer inserted before sibling layer');
+	ok(parentHasChild(newParentLayer, childLayer), 'newParentLayer does not have childLayer');
+});
+
+
+test("CASE 5b: insert child w/ layer before a sibling w/ NO layer - should create and insert sibling & child's layers", function() {
+
+	var newParent = SC.View.create().createLayer();
+	var newParentLayer = newParent.get('layer');
+
+	var sibling = SC.View.create();
+
+	ok(newParentLayer, 'precond - newParent has layer');
+	ok(!sibling.get('layer'), 'precond - sibling should have NO layer');
+	
+	// add layer-less sibling to parent before child..
+	newParent.appendChild(sibling);
+	newParent.insertBefore(child, sibling);
+	
+	ok(sibling.get('layerLocationNeedsUpdate'), 'sibling.layerLocationNeedsUpdate should be YES');
+	
+	child.updateLayerLocation();
+	
+	var siblingLayer = sibling.get('layer');
+	ok(siblingLayer, 'sibling should have layer now');
+	ok(parentHasChild(newParentLayer, siblingLayer), 'sibling layer should belong to newParent layer');
+	
+	equals(childLayer.nextSibling, siblingLayer, 'child layer should be inserted before sibling layer');
+	ok(parentHasChild(newParentLayer, childLayer), 'newParentLayer should have childLayer');
+});
+
+// .......................................................
+//  updateLayerLocationIfNeeded() 
+//
+var view, runCount ;
+module("SC.View#updateLayerLocationIfNeeded",{
+ setup: function() {
+   view = SC.View.create({
+     updateLayerLocation: function() { runCount++; }
+   })
+   runCount = 0;
+ },
+ 
+ teardown: function() { view = null; }
+});  
+
+test("returns receiver", function() {
+	equals(view.updateLayerLocationIfNeeded(), view, 'returns receiver');
+});
+
+test("invokes updateLayerLocation if layerLocationNeedsUpdate is YES", function() {
+  
+  view.set('layerLocationNeedsUpdate', YES);
+  view.updateLayerLocationIfNeeded();
+  equals(runCount, 1, 'did invoke');  
+});
+
+test("does NOT invoke updateLayerLocation if layerLocationNeedsUpdate is NO", function() {
+  
+  view.set('layerLocationNeedsUpdate', NO);
+  view.updateLayerLocationIfNeeded();
+  equals(runCount, 0, 'did NOT invoke');  
+});
+
+test("sets layerLocationNeedsUpdate to NO when run", function() {
+  
+  view.set('layerLocationNeedsUpdate', YES);
+  view.updateLayerLocationIfNeeded();
+  equals(view.get('layerLocationNeedsUpdate'), NO, 'did reset');
+});
+
+
+

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/viewDidResize.js

@@ -0,0 +1,185 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same Q$ htmlbody */
+
+// ..........................................................
+// viewDidResize()
+// 
+module("SC.View#viewDidResize");
+
+test("invokes parentViewDidResize on all child views - ignoring views that do not implement method", function() {
+  var callCount = 0 ;
+  var ChildView = SC.View.extend({ 
+    parentViewDidResize: function() { callCount++; } 
+  });
+  
+  var view = SC.View.create({
+    childViews: [ChildView, ChildView, ChildView]    
+  });
+  
+  // one of the childViews should NOT implement method
+  view.childViews[2].parentViewDidResize = null ;
+  
+  // now test...
+  view.viewDidResize();
+  equals(callCount, 2, 'should invoke parentViewDidResize() on two methods that support it');
+});
+
+test("triggers whenever layout property is changed", function() {
+  var callCount = 0 ;
+  var view = SC.View.create({
+    // use the callback below to detect when viewDidResize is icalled.
+    childViews: [SC.View.extend({
+      parentViewDidResize: function() { callCount++; }
+    })]
+  });
+  
+  view.set('layout', { top: 10, left: 20, height: 50, width: 40 });
+  equals(callCount, 1, 'viewDidResize should invoke once');
+});
+
+// ..........................................................
+// parentViewDidResize()
+// 
+module("SC.View#parentViewDidResize");
+
+// view.callCount must increments whenever something interesting happens
+function testParentViewDidResizeWithAlignments(view) {
+  // try with fixed layout
+  view.set('layout', { top: 10, left: 10, height: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 0, 'should not notify frame changed');
+
+  // try with flexible height
+  view.set('layout', { top: 10, left: 10, bottom: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+
+  // try with flexible width
+  view.set('layout', { top: 10, left: 10, height: 10, right: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+
+  // try with right align
+  view.set('layout', { top: 10, right: 10, height: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+
+  // try with bottom align
+  view.set('layout', { top: 10, bottom: 10, height: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+
+  // try with center horizontal align
+  view.set('layout', { centerX: 10, top: 10, height: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+
+  // try with center vertical align
+  view.set('layout', { left: 10, centerY: 10, height: 10, width: 10 });
+  view.callCount = 0 ;
+  view.parentViewDidResize();
+  equals(view.callCount, 1, 'should notify frame changed');
+}
+
+test("notifies 'frame' property change unless layout is fixed", function() {
+  var view = SC.View.create({
+    // instrument...
+    callCount: 0 ,
+    frameDidChange: function() { 
+      this.callCount++; 
+    }.observes('frame')
+  });
+  testParentViewDidResizeWithAlignments(view);
+});
+
+test("calls viewDidResize on self unless layout is fixed", function() {
+  var view = SC.View.create({
+    // instrument...
+    callCount: 0 ,
+    viewDidResize: function() { this.callCount++; }
+  });
+  testParentViewDidResizeWithAlignments(view);
+});
+
+test("invoked whenever view is added to a new parentView but not when it is removed", function() {
+  var callCount = 0;
+  var view = SC.View.create({
+    parentViewDidResize: function() { callCount++; }
+  });
+  var parent = SC.Pane.create().append(); // must be visible in window...
+  
+  callCount = 0 ;
+  parent.appendChild(view);
+  equals(callCount, 1, 'should call parentViewDidResize');
+  
+  callCount = 0;
+  parent.removeChild(view);
+  equals(callCount, 0, 'should not call parentViewDidResize()');
+  
+  parent.remove();
+});
+
+// ..........................................................
+// beginLiveResize()
+// 
+module("SC.View#beginLiveResize");
+
+test("invokes willBeginLiveResize on receiver and any child views that implement it", function() {
+  var callCount = 0;  
+  var ChildView = SC.View.extend({
+    willBeginLiveResize: function() { callCount++ ;}
+  });
+  
+  var view = ChildView.create({ // <-- has callback
+    childViews: [SC.View.extend({ // <-- this does not implement callback
+      childViews: [ChildView] // <-- has callback
+    })]
+  });
+  
+  callCount = 0 ;
+  view.beginLiveResize();
+  equals(callCount, 2, 'should invoke willBeginLiveResize when implemented');
+});
+
+test("returns receiver", function() {
+  var view = SC.View.create();
+  equals(view.beginLiveResize(), view, 'returns receiver');
+});
+
+// ..........................................................
+// endLiveResize()
+// 
+module("SC.View#endLiveResize");
+
+test("invokes didEndLiveResize on receiver and any child views that implement it", function() {
+  var callCount = 0;  
+  var ChildView = SC.View.extend({
+    didEndLiveResize: function() { callCount++; }
+  });
+  
+  var view = ChildView.create({ // <-- has callback
+    childViews: [SC.View.extend({ // <-- this does not implement callback
+      childViews: [ChildView] // <-- has callback
+    })]
+  });
+  
+  callCount = 0 ;
+  view.endLiveResize();
+  equals(callCount, 2, 'should invoke didEndLiveResize when implemented');
+});
+
+test("returns receiver", function() {
+  var view = SC.View.create();
+  equals(view.endLiveResize(), view, 'returns receiver');
+});

data/frameworks/sproutcore/frameworks/foundation/validators/credit_card.js

@@ -0,0 +1,125 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('validators/validator') ;
+
+/** @class
+  Validate a field value as a credit card number. 
+  
+  This validator will perform a basic check to ensure the credit card number
+  is mathematically valid.  It will also accept numbers with spaces, dashes
+  or other punctuation.  
+  
+  Converted credit card numbers are broken into units of 4.
+  
+  Basic credit card validation courtesy David Leppek 
+  (https://www.azcode.com/Mod10)
+
+  @extends SC.Validator
+  @since SproutCore 1.0
+*/
+SC.Validator.CreditCard = SC.Validator.extend(
+/** @scope SC.Validator.CreditCard.prototype */ {
+
+  /**
+    Expects a string of 16 digits.  Will split into groups of 4 for display.
+  */
+  fieldValueForObject: function(object, form, field) {
+    if (typeof(object) == "string" && object.length == 16) {
+      object = [object.slice(0,4),object.slice(4,8),object.slice(8,12),object.slice(12,16)].join(' ') ;
+    }
+    return object ;
+  },
+
+  /**
+    Removes all whitespace or dashes to make a single string.
+  */
+  objectForFieldValue: function(value, form, field) {
+    return value.replace(/[\s-\.\:]/g,'') ;
+  },
+  
+  validate: function(form, field) { 
+    return this.checkNumber(field.get('fieldValue')) ; 
+  },
+  
+  validateError: function(form, field) {
+    var label = field.get('errorLabel') || 'Field' ;
+    return SC.$error("Invalid.CreditCard(%@)".loc(label), label);
+  },
+  
+  /** 
+    Allow only numbers, dashes, and spaces 
+  */
+  validateKeyDown: function(form, field, charStr) {
+    return !!charStr.match(/[0-9\- ]/);
+  },
+  
+  checkNumber: function(ccNumb) {
+    
+    if (!ccNumb || ccNumb.length===0) return YES; // do not validate empty
+    
+    // remove any spaces or dashes
+    ccNumb = ccNumb.replace(/[^0-9]/g,'');
+    
+    var valid = "0123456789";  // Valid digits in a credit card number
+    var len = ccNumb.length;  // The length of the submitted cc number
+    var iCCN = parseInt(ccNumb,0);  // integer of ccNumb
+    var sCCN = ccNumb.toString();  // string of ccNumb
+    sCCN = sCCN.replace (/^\s+|\s+$/g,'');  // strip spaces
+    var iTotal = 0;  // integer total set at zero
+    var bNum = true;  // by default assume it is a number
+    var bResult = false;  // by default assume it is NOT a valid cc
+    var temp;  // temp variable for parsing string
+    var calc;  // used for calculation of each digit
+
+    // Determine if the ccNumb is in fact all numbers
+    for (var j=0; j<len; j++) {
+      temp = "" + sCCN.substring(j, j+1);
+      if (valid.indexOf(temp) == "-1"){bNum = false;}
+    }
+
+    // if it is NOT a number, you can either alert to the fact, 
+    // or just pass a failure
+    if(!bNum) bResult = false;
+
+    // Determine if it is the proper length 
+    if((len === 0)&&(bResult)){  // nothing, field is blank AND passed above # check
+      bResult = false;
+    } else{  // ccNumb is a number and the proper length - let's see if it is a valid card number
+      if(len >= 15){  // 15 or 16 for Amex or V/MC
+        for(var i=len;i>0;i--){  // LOOP throught the digits of the card
+          calc = parseInt(iCCN,0) % 10;  // right most digit
+          calc = parseInt(calc,0);  // assure it is an integer
+          iTotal += calc;  // running total of the card number as we loop - Do Nothing to first digit
+          i--;  // decrement the count - move to the next digit in the card
+          iCCN = iCCN / 10;                               // subtracts right most digit from ccNumb
+          calc = parseInt(iCCN,0) % 10 ;    // NEXT right most digit
+          calc = calc *2;                                 // multiply the digit by two
+          // Instead of some screwy method of converting 16 to a string and then parsing 1 and 6 and then adding them to make 7,
+          // I use a simple switch statement to change the value of calc2 to 7 if 16 is the multiple.
+          switch(calc){
+            case 10: calc = 1; break;       //5*2=10 & 1+0 = 1
+            case 12: calc = 3; break;       //6*2=12 & 1+2 = 3
+            case 14: calc = 5; break;       //7*2=14 & 1+4 = 5
+            case 16: calc = 7; break;       //8*2=16 & 1+6 = 7
+            case 18: calc = 9; break;       //9*2=18 & 1+8 = 9
+            default: calc = calc;           //4*2= 8 &   8 = 8  -same for all lower numbers
+          }                                               
+        iCCN = iCCN / 10;  // subtracts right most digit from ccNum
+        iTotal += calc;  // running total of the card number as we loop
+      }  // END OF LOOP
+      if ((iTotal%10)===0){  // check to see if the sum Mod 10 is zero
+        bResult = true;  // This IS (or could be) a valid credit card number.
+      } else {
+        bResult = false;  // This could NOT be a valid credit card number
+        }
+      }
+    }
+    return bResult; // Return the results
+  }
+    
+}) ;

data/frameworks/sproutcore/frameworks/foundation/validators/date.js

@@ -0,0 +1,52 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('validators/validator') ;
+
+/**
+  Handle parsing and display of dates.
+  
+  @class
+  @extends SC.Validator
+  @author Charles Jolley
+  @version 1.0
+*/
+SC.Validator.Date = SC.Validator.extend(
+/** @scope SC.Validator.Date.prototype */ {
+
+  /**
+    The standard format you want the validator to convert dates to.
+  */
+  format: 'NNN d, yyyy h:mm:ss a',
+  
+  /**
+    if we have a number, then convert to a date object.
+  */
+  fieldValueForObject: function(object, form, field) {
+    var date ;
+    if (typeof(object) == "number") {
+      date = new Date(object) ;
+    } else if (object instanceof Date) { date = object; }
+      
+    if (date) object = date.format(this.get('format')) ;
+    
+    return object ;
+  },
+
+  /**
+    Try to pase value as a date. convert into a number, or return null if
+    it could not be parsed.
+  */
+  objectForFieldValue: function(value, form, field) {
+    if (value) {
+      var date = Date.parseDate(value) ;
+      value = (date) ? date.getTime() : null ;
+    }
+    return value ;
+  }
+    
+}) ;

data/frameworks/sproutcore/frameworks/foundation/validators/email.js

@@ -0,0 +1,45 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('validators/validator') ;
+
+/**
+  Requires a valid email format.
+  
+  @class
+  @extends SC.Validator
+  @version 1.0
+*/
+SC.Validator.Email = SC.Validator.extend(
+/** @scope SC.Validator.Email.prototype */ {
+  
+  validate: function(form, field) { 
+    return (field.get('fieldValue') || '').match(/.+@.+\...+/) ; 
+  },
+  
+  validateError: function(form, field) {
+    var label = field.get('errorLabel') || 'Field' ;
+    return SC.$error("Invalid.Email(%@)".loc(label), label) ;
+  }  
+    
+}) ;
+
+/**
+  This variant allows an empty field as well as an email address.
+  
+  @class
+  @extends SC.Validator.Email
+  @author Charles Jolley
+  @version 1.0
+*/
+SC.Validator.EmailOrEmpty = SC.Validator.Email.extend(
+/** @scope SC.Validator.EmailOrEmpty.prototype */ {
+  validate: function(form, field) {
+    var value = field.get('fieldValue') ; 
+    return (value && value.length > 0) ? value.match(/.+@.+\...+/) : true ;
+  }
+}) ;

data/frameworks/sproutcore/frameworks/foundation/validators/not_empty.js

@@ -0,0 +1,33 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('validators/validator') ;
+
+/**
+  Requires some content in field, but does not check the specific content.
+  
+  @class
+  @extends SC.Validator
+  @author Charles Jolley
+  @version 1.0
+*/
+SC.Validator.NotEmpty = SC.Validator.extend(
+/** @scope SC.Validator.NotEmpty.prototype */ {
+  
+  validate: function(form, field) {
+    var value = field.get('fieldValue'); 
+    var ret = !!value ;
+    if (ret && value.length) ret = value.length > 0 ;
+    return ret ;
+  },
+  
+  validateError: function(form, field) {
+    var label = field.get('errorLabel') || 'Field' ;
+    return SC.$error("Invalid.NotEmpty(%@)".loc(label.capitalize()), field.get('errorLabel'));
+  }
+    
+}) ;