sproutit-sproutcore 1.0.203 → 1.0.20090721145236

data/frameworks/sproutcore/frameworks/foundation/system/utils.js

@@ -1,425 +0,0 @@
-// ==========================================================================
-// 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)
-// ==========================================================================
-
-// These are helpful utility functions for calculating range and rect values
-sc_require('system/browser');
-
-SC.mixin( /** @scope SC */ {
-
-  _downloadFrames: 0, // count of download frames inserted into document
-  
-  /**
-    Starts a download of the file at the named path.
-    
-    Use this method when you want to cause a file to be downloaded to a users
-    desktop instead of having it display in the web browser.  Note that your
-    server must return a header indicating that the file is intended for 
-    download also.
-  */
-  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.browser.isSafari)) {
-      tempDLIFrame.setAttribute('src',path);
-    }
-    document.getElementsByTagName('body')[0].appendChild(tempDLIFrame);
-    if (SC.browser.isSafari) {
-      tempDLIFrame.setAttribute('src',path);    
-    }
-    this._downloadFrames = this._downloadFrames + 1;
-    if (!(SC.browser.isSafari)) {
-      var r = function() { 
-        document.body.removeChild(document.getElementById(frameId)); 
-        frameId = null;
-      } ;
-      var t = r.invokeLater(null, 2000);
-    }
-    //remove possible IE7 leak
-    tempDLIFrame = null;
-  },
-
-  /**
-    Takes a URL of any type and normalizes it into a fully qualified URL with
-    hostname.  For example:
-    
-    {{{
-      "some/path" => "http://localhost:4020/some/path" 
-      "/some/path" => "http://localhost:4020/some/path"
-      "http://localhost:4020/some/path" => "http://localhost:4020/some/path"
-    }}}
-    
-    @param url {String} the URL
-    @returns {String} the normalized 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.href + '/' + url ;
-    }
-    return url ;
-  },
-  
-  
-  /** Return the left edge of the frame */
-  minX: function(frame) { 
-    return frame.x || 0; 
-  },
-  
-  /** Return the right edge of the frame. */
-  maxX: function(frame) { 
-    return (frame.x || 0) + (frame.width || 0); 
-  },
-  
-  /** Return the midpoint of the frame. */
-  midX: function(frame) {
-    return (frame.x || 0) + ((frame.width || 0) / 2) ;
-  },
-  
-  /** Return the top edge of the frame */
-  minY: function(frame) {
-    return frame.y || 0 ;
-  },
-  
-  /** Return the bottom edge of the frame */
-  maxY: function(frame) {
-    return (frame.y || 0) + (frame.height || 0) ;
-  },
-  
-  /** Return the midpoint of the frame */
-  midY: function(frame) {
-    return (frame.y || 0) + ((frame.height || 0) / 2) ;
-  },
-  
-  /** Returns the point that will center the frame X within the passed frame. */
-  centerX: function(innerFrame, outerFrame) {
-    return (outerFrame.width - innerFrame.width) / 2 ;
-  },
-  
-  /** Return the point that will center the frame Y within the passed frame. */
-  centerY: function(innerFrame, outerFrame) {
-    return (outerFrame.height - innerFrame.height) /2  ;
-  },
-  
-  /** Check if the given point is inside the rect. */
-  pointInRect: function(point, f) {
-    return  (point.x >= SC.minX(f)) &&
-            (point.y >= SC.minY(f)) &&
-            (point.x <= SC.maxX(f)) && 
-            (point.y <= SC.maxY(f)) ;
-  },
-  
-  /** Return true if the two frames match.  You can also pass only points or sizes.
-  
-    @param r1 {Rect} the first rect
-    @param r2 {Rect} the second rect
-    @param delta {Float} an optional delta that allows for rects that do not match exactly. Defaults to 0.1
-    @returns {Boolean} true if rects match
-   */
-  rectsEqual: function(r1, r2, delta) {
-    if (!r1 || !r2) return (r1 == r2) ;
-    
-    if (delta == null) delta = 0.1;
-    if ((r1.y != r2.y) && (Math.abs(r1.y - r2.y) > delta)) return NO ; 
-    if ((r1.x != r2.x) && (Math.abs(r1.x - r2.x) > delta)) return NO ; 
-    if ((r1.width != r2.width) && (Math.abs(r1.width - r2.width) > delta)) return NO ; 
-    if ((r1.height != r2.height) && (Math.abs(r1.height - r2.height) > delta)) return NO ; 
-    return true ;
-  },
-  
-  /** Returns the insersection between two rectangles. 
-  
-    @param r1 {Rect} The first rect
-    @param r2 {Rect} the second rect
-    @returns {Rect} the intersection rect.  width || height will be 0 if they do not interset.
-  */
-  intersectRects: function(r1, r2) {
-    // find all four edges
-    var ret = {
-      x: Math.max(SC.minX(r1), SC.minX(r2)),
-      y: Math.max(SC.minY(r1), SC.minY(r2)),
-      width: Math.min(SC.maxX(r1), SC.maxX(r2)),
-      height: Math.min(SC.maxY(r1), SC.maxY(r2))
-    } ;
-    
-    // convert edges to w/h
-    ret.width = Math.max(0, ret.width - ret.x) ;
-    ret.height = Math.max(0, ret.height - ret.y) ;
-    return ret ;
-  },
-  
-  /** Returns the union between two rectangles
-  
-    @param r1 {Rect} The first rect
-    @param r2 {Rect} The second rect
-    @returns {Rect} The union rect.
-  */
-  unionRects: function(r1, r2) {
-    // find all four edges
-    var ret = {
-      x: Math.min(SC.minX(r1), SC.minX(r2)),
-      y: Math.min(SC.minY(r1), SC.minY(r2)),
-      width: Math.max(SC.maxX(r1), SC.maxX(r2)),
-      height: Math.max(SC.maxY(r1), SC.maxX(r2))
-    } ;
-    
-    // convert edges to w/h
-    ret.width = Math.max(0, ret.width - ret.x) ;
-    ret.height = Math.max(0, ret.height - ret.y) ;
-    return ret ;
-  },
-  
-  /** Duplicates the passed rect.  
-  
-    This is faster than Object.clone(). 
-    
-    @param r {Rect} The rect to clone.
-    @returns {Rect} The cloned rect
-  */
-  cloneRect: function(r) {
-    return { x: r.x, y: r.y, width: r.width, height: r.height } ;
-  },
-  
-  
-  /** Finds the absolute viewportOffset for a given element.
-    This method is more accurate than the version provided by prototype.
-    
-    If you pass NULL to this method, it will return a { x:0, y:0 }
-    @param el The DOM element
-    @returns {Point} A hash with x,y offsets.
-  */
-  viewportOffset: function(el) {
-    var valueL = 0 ; var valueT = 0;
-
-    // add up all the offsets for the element.
-    var element = el ;
-    var isFirefox3 = SC.browser.mozilla >= 3 ;
-    while (element) {
-      valueT += (element.offsetTop  || 0);
-      if (!isFirefox3 || (element !== el)) {
-        valueT += (element.clientTop  || 0);
-      }
-
-      valueL += (element.offsetLeft || 0);
-      if (!isFirefox3 || (element !== el)) {
-        valueL += (element.clientLeft || 0);
-      }
-
-      // bizarely for FireFox if your offsetParent has a border, then it can 
-      // impact the offset. 
-      if (SC.browser.mozilla) {
-        var overflow = SC.$(element).attr('overflow') ;
-        if (overflow !== 'visible') {
-          var left = parseInt(SC.$(element).attr('borderLeftWidth'),0) || 0 ;
-          var top = parseInt(SC.$(element).attr('borderTopWidth'),0) || 0 ;
-          if (el !== element) {
-            left *= 2; top *= 2 ;
-          }
-          valueL += left; valueT += top ;
-        }
-        
-        // In FireFox 3 -- the offsetTop/offsetLeft subtracts the clientTop/
-        // clientLeft of the offset parent.
-        var offsetParent = element.offsetParent ;
-        if ((SC.browser.mozilla >= 3) && offsetParent) {
-          valueT -= offsetParent.clientTop ;
-          valueL -= offsetParent.clientLeft;
-        }
-      }
-
-      // Safari fix
-      if (element.offsetParent == document.body &&
-        SC.$(element).attr('position') == 'absolute') break;
-
-      element = element.offsetParent ;
-
-    }
-
-    element = el;
-    while (element) {
-      if (!SC.browser.isOpera || element.tagName == 'BODY') {
-        valueT -= element.scrollTop  || 0;
-        valueL -= element.scrollLeft || 0;
-      }
-      
-      element = element.parentNode ;
-    }
-
-    return { x: valueL, y: valueT } ;
-  },
-  
-  /** A Point at {0,0} */
-  ZERO_POINT: { x: 0, y: 0 },
-  
-  /** A zero length range at zero. */
-  ZERO_RANGE: { start: 0, length: 0 },
-
-  RANGE_NOT_FOUND: { start: 0, length: -1 },
-  
-  /** Returns true if the passed index is in the specified range */
-  valueInRange: function(value, range) {
-    return (value >= 0) && (value >= range.start) && (value < (range.start + range.length));  
-  },
-  
-  /** Returns first value of the range. */
-  minRange: function(range) { return range.start; },
-  
-  /** Returns the first value outside of the range. */
-  maxRange: function(range) { return (range.length < 0) ? -1 : (range.start + range.length); },
-  
-  /** Returns the union of two ranges.  If one range is null, the other
-   range will be returned.  */
-  unionRanges: function(r1, r2) { 
-    if ((r1 == null) || (r1.length < 0)) return r2 ;
-    if ((r2 == null) || (r2.length < 0)) return r1 ;
-    
-    var min = Math.min(r1.start, r2.start) ;
-    var max = Math.max(SC.maxRange(r1), SC.maxRange(r2)) ;
-    return { start: min, length: max - min } ;
-  },
-  
-  /** Returns the intersection of the two ranges or SC.RANGE_NOT_FOUND */
-  intersectRanges: function(r1, r2) {
-    if ((r1 == null) || (r2 == null)) return SC.RANGE_NOT_FOUND ;
-    if ((r1.length < 0) || (r2.length < 0)) return SC.RANGE_NOT_FOUND;
-    var min = Math.max(SC.minRange(r1), SC.minRange(r2)) ;
-    var max = Math.min(SC.maxRange(r1), SC.maxRange(r2)) ;
-    if (max < min) return SC.RANGE_NOT_FOUND ;
-    return { start: min, length: max-min };
-  },
-  
-  /** Returns the difference of the two ranges or SC.RANGE_NOT_FOUND */
-  subtractRanges: function(r1, r2) {
-    if ((r1 == null) || (r2 == null)) return SC.RANGE_NOT_FOUND ;
-    if ((r1.length < 0) || (r2.length < 0)) return SC.RANGE_NOT_FOUND;
-    var max = Math.max(SC.minRange(r1), SC.minRange(r2)) ;
-    var min = Math.min(SC.maxRange(r1), SC.maxRange(r2)) ;
-    if (max < min) return SC.RANGE_NOT_FOUND ;
-    return { start: min, length: max-min };
-  },
-  
-  /** Returns a clone of the range. */
-  cloneRange: function(r) { 
-    return { start: r.start, length: r.length }; 
-  },
-  
-  /** Returns true if the two passed ranges are equal.  A null value is
-    treated like RANGE_NOT_FOUND.
-  */
-  rangesEqual: function(r1, r2) {
-    if (r1===r2) return true ;
-    if (r1 == null) return r2.length < 0 ;
-    if (r2 == null) return r1.length < 0 ;
-    return (r1.start == r2.start) && (r1.length == r2.length) ;
-  },
-
-  /** Returns hex color from hsv value */
-  convertHsvToHex: function (h, s, v) {
-    var r = 0;
-    var g = 0;
-    var b = 0;
-
-    if (v > 0) {
-      var i = (h == 1) ? 0 : Math.floor(h * 6);
-      var f = (h == 1) ? 0 : (h * 6) - i;
-      var p = v * (1 - s);
-      var q = v * (1 - (s * f));
-      var t = v * (1 - (s * (1 - f)));
-      var rgb = [[v,t,p],[q,v,p],[p,v,t],[p,q,v],[t,p,v],[v,p,q]];
-      r = Math.round(255 * rgb[i][0]);
-      g = Math.round(255 * rgb[i][1]);
-      b = Math.round(255 * rgb[i][2]);
-    }
-    return this.parseColor('rgb(' + r + ',' + g + ',' + b + ')');
-  },  
-
-  /** Returns hsv color from hex value */
-  convertHexToHsv: function (hex) {
-    var rgb = this.expandColor(hex);
-    var max = Math.max(Math.max(rgb[0], rgb[1]), rgb[2]);
-    var min = Math.min(Math.min(rgb[0], rgb[1]), rgb[2]);
-
-    var h = (max == min) ? 0 : ((max == rgb[0]) ? ((rgb[1]-rgb[2])/(max-min)/6) : ((max == rgb[1]) ? ((rgb[2]-rgb[0])/(max-min)/6+1/3) : ((rgb[0]-rgb[1])/(max-min)/6+2/3)));
-    var s = (max == 0) ? 0 : (1 - min/max);
-    var v = max/255;
-    return [h, s, v];
-  },
-
-  /** regular expression for parsing color: rgb, hex */
-  PARSE_COLOR_RGBRE: /^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i,
-  PARSE_COLOR_HEXRE: /^\#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/,
-
-  // return an array of r,g,b colour
-  expandColor: function(color) {
-    var hexColor, red, green, blue;
-    hexColor = this.parseColor(color);
-    if (hexColor) {
-      red = parseInt(hexColor.slice(1, 3), 16);
-      green = parseInt(hexColor.slice(3, 5), 16);
-      blue = parseInt(hexColor.slice(5, 7), 16);
-      return [red,green,blue];
-    }
-  },
-
-  // parse rgb color or 3-digit hex color to return a properly formatted 6-digit hex colour spec, or false
-  parseColor: function(string) {
-    var color = '#', match;
-    if(match = this.PARSE_COLOR_RGBRE.exec(string)) {
-      var part;
-      for (var i=1; i<=3; i++) {
-        part = Math.max(0, Math.min(255, parseInt(match[i],0)));
-        color += this.toColorPart(part);
-      }
-      return color;
-    }
-    if (match = this.PARSE_COLOR_HEXRE.exec(string)) {
-      if(match[1].length == 3) {
-        for (var i=0; i<3; i++) {
-          color += match[1].charAt(i) + match[1].charAt(i);
-        }
-        return color;
-      }
-      return '#' + match[1];
-    }
-    return false;
-  },
-
-  // convert one r,g,b number to a 2 digit hex string
-  toColorPart: function(number) {
-    if (number > 255) number = 255;
-    var digits = number.toString(16);
-    if (number < 16) return '0' + digits;
-    return digits;
-  },
-  
-  
-  // Get the computed style from specific element. Useful for cloning styles
-  getStyle: function(oElm, strCssRule){
-  	var strValue = "";
-  	if(document.defaultView && document.defaultView.getComputedStyle){
-  		strValue = document.defaultView.getComputedStyle(oElm, "").getPropertyValue(strCssRule);
-  	}
-  	else if(oElm.currentStyle){
-  		strCssRule = strCssRule.replace(/\-(\w)/g, function (strMatch, p1){
-  			return p1.toUpperCase();
-  		});
-  		strValue = oElm.currentStyle[strCssRule];
-  	}
-  	return strValue;
-  }
-
-}) ;

data/frameworks/sproutcore/frameworks/foundation/tests/controllers/array/array_case.js

@@ -1,182 +0,0 @@
-// ==========================================================================
-// 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)
-// ==========================================================================
-
-/*globals throws */
-
-var content, controller, extra;
-
-var TestObject = SC.Object.extend({
-  title: "test",  
-  toString: function() { return "TestObject(%@)".fmt(this.get("title")); }
-});
-
-
-// ..........................................................
-// EMPTY
-// 
-
-module("SC.ArrayController - array_case - EMPTY", {
-  setup: function() {
-    content = [];
-    controller = SC.ArrayController.create({ content: content });
-    extra = TestObject.create({ title: "FOO" });
-  },
-  
-  teardown: function() {
-    controller.destroy();
-  }
-});
-
-test("state properties", function() {
-  equals(controller.get("hasContent"), YES, 'c.hasContent');
-  equals(controller.get("canRemoveContent"), YES, "c.canRemoveContent");
-  equals(controller.get("canReorderContent"), YES, "c.canReorderContent");
-  equals(controller.get("canAddContent"), YES, "c.canAddContent");
-});
-
-// addObject should append to end of array + notify observers on Array itself
-test("addObject", function() {
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  SC.run(function() { controller.addObject(extra); });
-  
-  same(content, [extra], 'addObject(extra) should work');
-  equals(callCount, 1, 'should notify observer that content has changed');
-  equals(content.get('length'), 1, 'should update length of controller');
-});
-
-test("removeObject", function() {
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  SC.run(function() { controller.removeObject(extra); });
-  
-  same(content, [], 'removeObject(extra) should have no effect');
-  equals(callCount, 0, 'should not notify observer since content did not change');
-});
-
-test("basic array READ operations", function() {
-  equals(controller.get("length"), 0, 'length should be empty');
-  equals(controller.objectAt(0), undefined, "objectAt() should return undefined");
-});
-
-test("basic array WRITE operations", function() {
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  controller.replace(0,1,[extra]);
-  
-  same(content, [extra], 'should modify content');
-  equals(callCount, 1, 'should notify observer that content has changed');
-  equals(content.get('length'), 1, 'should update length of controller');
-});
-
-test("arrangedObjects", function() {
-  equals(controller.get("arrangedObjects"), controller, 'c.arrangedObjects should return receiver');
-});
-
-
-// ..........................................................
-// NON-EMPTY ARRAY
-// 
-
-module("SC.ArrayController - array_case - NON-EMPTY", {
-  setup: function() {
-    content = "1 2 3 4 5".w().map(function(x) {
-      return TestObject.create({ title: x });
-    });
-    
-    controller = SC.ArrayController.create({ content: content });
-    extra = TestObject.create({ title: "FOO" });
-  },
-  
-  teardown: function() {
-    controller.destroy();
-  }
-});
-
-test("state properties", function() {
-  equals(controller.get("hasContent"), YES, 'c.hasContent');
-  equals(controller.get("canRemoveContent"), YES, "c.canRemoveContent");
-  equals(controller.get("canReorderContent"), YES, "c.canReorderContent");
-  equals(controller.get("canAddContent"), YES, "c.canAddContent");
-});
-
-// addObject should append to end of array + notify observers on Array itself
-test("addObject", function() {
-  var expected = content.slice();
-  expected.push(extra);
-  
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  SC.run(function() { controller.addObject(extra); });
-  
-  same(content, expected, 'addObject(extra) should work');
-  equals(callCount, 1, 'should notify observer that content has changed');
-  equals(content.get('length'), expected.length, 'should update length of controller');
-});
-
-test("removeObject", function() {
-  var expected = content.slice(), obj = expected[3];
-  expected.removeObject(obj);
-  
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  SC.run(function() { controller.removeObject(obj); });
-  
-  same(content, expected, 'removeObject(extra) should remove object');
-  equals(callCount, 1, 'should notify observer that content has changed');
-  equals(content.get('length'), expected.length, 'should update length of controller');
-});
-
-test("basic array READ operations", function() {
-  equals(controller.get("length"), content.length, 'length should be empty');
-  
-  var loc = content.length+1; // verify 1 past end as well
-  while(--loc>=0) {
-    equals(controller.objectAt(loc), content[loc], "objectAt(%@) should return same value at content[%@]".fmt(loc, loc));
-  }
-});
-
-test("basic array WRITE operations", function() {
-  var expected = content.slice();
-  expected.replace(3,1,[extra]);
-  
-  var callCount = 0;
-  controller.addObserver('[]', function() { callCount++; });
-  
-  controller.replace(3,1,[extra]);
-  
-  same(content, expected, 'should modify content');
-  equals(callCount, 1, 'should notify observer that content has changed');
-  equals(content.get('length'), expected.length, 'should update length of controller');
-});
-
-test("arrangedObjects", function() {
-  equals(controller.get("arrangedObjects"), controller, 'c.arrangedObjects should return receiver');
-});
-
-// ..........................................................
-// ADD SPECIAL CASES HERE
-// 
-
-
-// ..........................................................
-// VERIFY SC.ARRAY COMPLIANCE
-// 
-
-SC.ArraySuite.generate("SC.ArrayController", {
-  newObject: function(amt) {
-    if (amt === undefined || typeof amt === SC.T_NUMBER) {
-      amt = this.expected(amt);
-    }
-    return SC.ArrayController.create({ content: amt });
-  }
-});