sproutit-sproutcore 1.0.203 → 1.0.20090721145236

data/frameworks/sproutcore/frameworks/foundation/protocols/inline_editor_delegate.js

@@ -1,84 +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)
-// ==========================================================================
-
-/**
-  @namespace
-  
-  The inline editor delegate receives notifications from the inline text
-  editor before, during, and after the user completes inline editing.
-  
-  The inline editor delegate is used by views that work with the inline
-  editor.  You may need to implement this protocol if you want to
-  use the inline editor in your own custom views.
-  
-  @since SproutCore 1.0
-*/
-SC.InlineEditorDelegate = {
-  
-    /**
-     This is a  classname you can apply to the inline editor field
-     to configure it's styling, in addition to the the editor's 
-     default style-cloning behavior.
-      
-      @property inlineEditorClassName {String} A class name to use with the inline editor.
-    */
-    inlineEditorClassName: "",
-  
-  
-    /**
-      Called just before the inline edit displays itself but after it has been 
-      configured for display.  
-      
-      You can use this method to make last minute changes to the display of 
-      the inline editor or to collect its value.
-      
-      @param inlineEditor {SC.InlineTextFieldView} The inline editor.
-      @returns {void}
-    */
-    inlineEditorWillBeginEditing: function(inlineEditor) {},
-
-    /**
-      Called just after an inline editor displays itself.
-      
-      You can use this method to perform any hiding or other view changes
-      you need to perform on your own view to make room for the new editor.
-      
-      Note tht editors are placed over the top of views in the page, not 
-      inside of them from a DOM perspective.
-      
-      @param inlineEditor {SC.InlineTextFieldView} The inline editor.
-      @returns {void}
-    */
-    inlineEditorDidBeginEditing: function(inlineEditor) {},
-    
-    /**
-      Called just before an inline editor tries to end editing and hide 
-      itself.
-      
-      You can use this method to control whether the inline editor will
-      actually be allowed to end editing.  For example, you might disallow
-      the editor to end editing if the new value fails validation.
-      
-      @param inlineEditor {SC.InlineTextFieldView} the inline editor
-      @param finalValue {Object} the final value
-      @returns {Boolean} YES to allow the editor to end editing.
-    */
-    inlineEditorShouldEndEditing: function(inlineEditor, finalValue) {
-      return YES ;
-    },
-    
-    /**
-      Called just after the inline editor has ended editing. You can use this 
-      method to save the final value of the inline editor and to perform any 
-      other cleanup you need to do.
-      
-      @param inlineEditor {SC.InlineTextFieldView} the inline editor
-      @param finalValue {Object} the final value
-      @returns {void}
-    */
-    inlineEditorDidEndEditing: function(inlineEditor, finalValue) {}
-};

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

@@ -1,36 +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)
-// ==========================================================================
-
-sc_require('system/responder_context');
-
-/** @class
-
-  The root object for a SproutCore application.  Usually you will create a 
-  single SC.Application instance as your root namespace.  SC.Application is
-  required if you intend to use SC.Responder to route events.
-  
-  h2. Example
-  
-  {{{
-    Contacts = SC.Application.create({
-      store: SC.Store.create(SC.Record.fixtures),
-      
-      // add other useful properties here
-    });
-  }}}
-
-  h2. Sending Events
-  
-  You can send actions and events down an application-level responder chain
-  by 
-  
-  @extends SC.ResponderContext
-  @since SproutCore 1.0
-*/
-SC.Application = SC.ResponderContext.extend(/** SC.Application.prototype */ {
-
-});

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

@@ -1,492 +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)
-// ==========================================================================
-
-sc_require('core') ;
- 
-/** @namespace SC.Benchmark
-
-  This bit of meta-programming magic can install a benchmark handler on any
-  object method.  When a benchmark is installed, the time required to execute
-  the method will be printed to the console log everytime the method is 
-  called.
-
-  This class can be used to implement benchmarking.  To use this object, just
-  call start() with a key name and end() with a keyname.  The benchmark will 
-  be logged.  If you set verbose = true, then benchmark will log everytime it 
-  saves a bench.  Otherwise, it just keeps stats.  You can get the stats by
-  calling report().
-
-  Benchmark does not require anything other than the date.js class.  It also
-  does not rely on SC.Object so that you can benchmark code in that area as
-  well.
-  
-  The benchmark has three types of reports.
-  
-  report(): Returns an abbreviated list with just the durations of the bench. 
-            Also, it averages multiple runs. Everything is reported on the top
-            level only.
-            
-  timelineReport(): Returns an list of benchmarks and sub-benchmarks. If the
-                    the globalStartTime is set, then it will show relative
-                    time from that time.
-  
-  timelineChart(): Displays a chart of all the benchmarks (not sub-benchmarks)
-                   relative to the first time capture or to the globalStartTime.
-                   Hide this by calling hideChart()
-*/
-SC.Benchmark = {
-
-  /**
-    If true, then benchmarks will be logged to the console as they are 
-    recorded.
-  
-    @type bool
-  */
-  verbose: NO,
-  
-  /**
-    If false, benchmarking will be disabled.  You might want to disable this
-    during production to maximize performance.
-  
-    @type bool
-  */
-  enabled: YES,
-  
-  /**
-     This hash stores collected stats.  It contains key value pairs.  The value
-     will be a hash with the following properties:
-   
-    * * *runs*: the number of times this stat has run
-    * * *amt*: the total time consumed by this (divide by runs to get avg)
-    * * *name*: an optional longer name you assigned to the stat key.  Set this  using name().
-    * * *_starts*: this array is used internally.
-    * * *_times*: this array is used internally.
-  */
-  stats: {},
-
-  /**
-    If set, one can tell when the benchmark is started relatively to the global start time.
-  
-    @type Integer
-  */
-  globalStartTime: null,
-
-   /**
-    Call this method at the start of whatever you want to collect.
-    If a parentKey is passed, then you will attach the stat to the parent, otherwise 
-    it will be on the top level. If topLevelOnly is passed, then recursive calls 
-    to the start will be ignored and only the top level call will be benchmarked.
-    
-    @param key {String} A unique key that identifies this benchmark.  All calls to start/end with the same key will be groups together.
-    @param parentKey {String} A unique key that identifies the parent benchmark.  All calls to start/end with the same key will be groups together.
-    @param topLevelOnly {Boolean} If true then recursive calls to this method with the same key will be ignored.  
-    @param time {Integer} Only pass if you want to explicitly set the start time.  Otherwise the start time is now.
-  */
-  start: function(key, parentKey, time, topLevelOnly) {
-    if (!this.enabled) return ;
-
-    var start = (time || Date.now());
-
-    if(parentKey)
-    {
-      var stat = this._subStatFor(key, parentKey) ;
-    }
-    else
-    {
-      var stat = this._statFor(key) ;
-    }
-    
-    if (topLevelOnly && stat._starts.length > 0) 
-    {
-      stat._starts.push('ignore') ;
-    }
-    else
-    {
-      stat._starts.push(start) ;
-    }
-    stat._times.push({start: start, _subStats: {}});
-    
-    return key;
-  },
-
-  /**
-    Call this method at the end of whatever you want to collect.  This will
-    save the collected benchmark.
-    
-    @param key {String} The benchmark key you used when you called start()
-    @param parentKey {String} The benchmark parent key you used when you called start()
-    @param time {Integer} Only pass if you want to explicitly set the end time.  Otherwise start time is now.
-  */
-  end: function(key, parentKey, time) {
-    if (!this.enabled) return ;
-    if(parentKey)
-    {
-      var stat = this._subStatFor(key, parentKey) ;
-    }
-    else
-    {
-      var stat = this._statFor(key) ;
-    }
-    var start = stat._starts.pop() ;
-    if (!start) {
-      console.log('SC.Benchmark "%@" ended without a matching start.  No information was saved.'.fmt(key));
-      return ;
-    }
-
-    // top level only.
-    if (start == 'ignore') return ; 
-    
-    var end = (time || Date.now()) ;
-    var dur = end - start;
-
-    stat._times[stat._times.length-1].end = end;
-    stat._times[stat._times.length-1].dur = dur;
-
-    stat.amt += dur ;
-    stat.runs++ ;
-    
-    if (this.verbose) this.log(key) ;
-  },
-  
-  /* 
-    Set the inital global start time.
-  */
-  setGlobalStartTime: function(time)
-  {
-    this.globalStartTime = time;
-  },
-
-  /**
-    This is a simple way to benchmark a function.  The function will be 
-    run with the name you provide the number of times you indicate.  Only the
-    function is a required param.
-  */  
-  bench: function(func, key, reps) {
-    if (!key) key = "bench%@".fmt(this._benchCount++) ;
-    if (!reps) reps = 1 ;
-    var ret ;
-    
-    while(--reps >= 0) {
-      var timeKey = SC.Benchmark.start(key) ;
-      ret = func();
-      SC.Benchmark.end(timeKey) ; 
-    }
-    
-    return ret ;
-  },
-  
-  /**  
-    This bit of metaprogramming magic install a wrapper around a method and
-    benchmark it whenever it is run.
-  */  
-  install: function(object,method, topLevelOnly) {
-    
-    // vae the original method.
-    var __func = object['b__' + method] = object[method] ;
-    
-    // replace with this helper.
-    object[method] = function() {
-      var key = '%@(%@)'.fmt(method, $A(arguments).join(', ')) ;
-      SC.Benchmark.start(key, topLevelOnly) ;
-      var ret = __func.apply(this, arguments) ;
-      SC.Benchmark.end(key) ;
-      return ret ;
-    } ;
-  },
-  
-  /**
-    Restore the original method, deactivating the benchmark.
-  
-    @param {object} object the object to change
-    @param {string} method the method name as a string.
-  
-  */  
-  restore: function(object,method) {
-    object[method] = object['b__' + method] ;
-  },
-  
-  /**
-    This method will return a string containing a report of the stats
-    collected so far.  If you pass a key, only the stats for that key will
-    be returned.  Otherwise, all keys will be used.
-  */
-  report: function(key) {
-    if (key) return this._genReport(key) ;
-    var ret = [] ;
-    for(var key in this.stats) {
-      if (!this.stats.hasOwnProperty(key)) continue ;
-      ret.push(this._genReport(key)) ;
-    }
-    return ret.join("\n") ;
-  },
-
-  /**
-    Generate a human readable benchmark report. Pass in appName if you desire.
-
-    @param {string} application name.
-  */
-  timelineReport: function(appName) 
-  {
-    appName = (appName) ? 'SproutCore Application' : appName;
-    var ret = [appName, 'User-Agent: %@'.fmt(navigator.userAgent), 'Report Generated: %@ (%@)'.fmt(new Date().toString(), Date.now()), ''] ;
-
-    var chart = this._compileChartData(true);
-    for(var i=0; i<chart.length; i++)
-    {
-      if(chart[i][4])
-      {
-        ret.push(this._timelineGenSubReport(chart[i]));
-      }
-      else
-      {
-        ret.push(this._timelineGenReport(chart[i]));
-      }
-    }
-    return ret.join("\n") ;
-  },
-
-  /**
-    Generate a human readable benchmark chart. Pass in appName if you desire.
-
-  */
-  timelineChart: function(appName) {
-    
-    // Hide the chart if there is an existing one.
-    this.hideChart();
-    
-    // Compile the data.
-    var chart = this._compileChartData(false);
-    var chartLen = chart.length;
-    
-    // Return if there is nothing to draw.
-    if(chartLen == 0) return;
-    
-    // Get the global start of the graph.
-    var gStart = (this.globalStartTime) ? this.globalStartTime : chart[0][1];
-    var maxDur = chart[chartLen-1][2]-gStart;
-    var maxHeight = 50+chartLen*30;
-    var incr = Math.ceil(maxDur/200)+1;
-    var maxWidth = incr*50;
-    
-    // Create the basic graph element.
-    var graph = document.createElement('div');
-    graph.className = 'sc-benchmark-graph';
-    document.body.appendChild(graph);
-
-    // Set the title.
-    var title = document.createElement('div');
-    title.innerHTML = ((appName) ? appName : 'SproutCore Application') + (' - Total Captured Time: ' + maxDur +' ms - Points Captured: ' + chartLen) + ' [<a href="javascript:SC.Benchmark.hideChart();">Hide Chart</a>]';
-    title.className = 'sc-benchmark-title'; 
-    graph.appendChild(title);
-
-
-    var topBox = document.createElement('div');
-    topBox.className = 'sc-benchmark-top'; 
-    topBox.style.width = maxWidth + 'px';
-    graph.appendChild(topBox);
-
-    // Draw the tick marks.
-    for(var i=0;i<incr; i++)
-    {
-      var tick = document.createElement('div');
-      tick.className = 'sc-benchmark-tick';
-      tick.style.left = (i*50)+'px';
-      tick.style.height = maxHeight+'px';
-      var tickLabel = document.createElement('div');
-      tickLabel.className = 'sc-benchmark-tick-label';
-      tickLabel.style.left = (i*50)+'px';
-      tickLabel.innerHTML = i*200+" ms";
-      graph.appendChild(tick);
-      graph.appendChild(tickLabel);
-    }
-    
-    // For each item in the chart, print it out on the screen.
-    for(var i=0;i<chartLen; i++)
-    {
-    	var row = document.createElement('div');
-    	row.style.top = (75+(i*30))+'px';
-    	row.style.width = maxWidth+'px';
-    	row.className = (i%2==0) ? 'sc-benchmark-row even' : 'sc-benchmark-row';
-    	graph.appendChild(row);
-
-      var div = document.createElement('div');
-      var start = chart[i][1];
-      var end = chart[i][2];
-      var duration = chart[i][3];
-      
-      div.innerHTML = '&nbsp;' + (chart[i][0] + " <span class='sc-benchmark-emphasis'>" + duration + 'ms</span>');
-      
-      div.className = 'sc-benchmark-bar';
-      div.style.cssText = 'left:'+ (((start-gStart)/4))+'px; width: '+((duration/4))+
-                          'px; top: '+(53+(i*30))+'px;';
-      div.title = "start: " + (start-gStart) + " ms, end: " + (end-gStart) + ' ms, duration: ' + duration + ' ms';
-      graph.appendChild(div);
-    }
-
-    // Save the graph.
-    this._graph = graph;
-  },
-  
-  /*
-    Hide chart.
-    
-  */
-  hideChart: function()
-  {
-    if(this._graph) {
-      try{ 
-        document.body.removeChild(this._graph);
-      }catch(e){};
-    }
-  },
-  
-
-  /**
-    This method is just like report() except that it will log the results to
-    the console.
-  */  
-  log: function(key) {
-    console.log(this.report(key)) ;
-  },
-  
-  /**
-    This will activate profiling if you have Firebug installed.  Otherwise
-    does nothing.
-  */
-  startProfile: function(key) {
-    if (!this.enabled) return ;
-    if (console && console.profile) console.profile(key) ;
-  },
-  
-  endProfile: function(key) {
-    if (!this.enabled) return ;
-    if (console && console.profileEnd) console.profileEnd(key) ;
-  },
-  
-  // PRIVATE METHODS
-
-  // @private
-  
-  // Generates, sorts, and returns the array of all the data that has been captured.
-  _compileChartData: function(showSub)
-  {
-    var chart = [];
-    for(var key in this.stats) 
-    {
-      var stat = this.stats[key];
-      for(var i=0; i<stat._times.length; i++)
-      {
-        var st = stat._times[i];
-        var dispKey = (stat._times.length > 1) ? (i+1)+' - '+key : key;
-        chart.push([dispKey, st.start, st.end, st.dur, false]);
-        if(showSub)
-        {
-          var subStats = st._subStats;
-          for(var k in subStats) 
-          {
-           
-            var subStat = subStats[k];
-            for(var j=0; j<subStat._times.length; j++)
-            {
-              var s = subStat._times[j];
-              var dispKey = (subStat._times.length > 1) ? (j+1)+' - '+k : k;
-              chart.push([dispKey, s.start, s.end, s.dur, true]);
-         
-            }
-          }
-        }
-      }
-    }
-    
-    chart.sort(function(a,b)
-    {
-      if(a[1] < b[1]) 
-      {
-        return -1;
-      }
-      else if(a[1] == b[1])
-      {
-        if(a[3] && !b[3]) return -1;
-        if(!a[3] && b[3]) return 1;
-        return 0;
-      }
-      return 1;
-    });
-
-    return chart;
-  },
-  
-  // Generate the traditional report show multiple runs averaged.
-  _genReport: function(key) {
-    var stat = this._statFor(key) ;
-    var avg = (stat.runs > 0) ? (Math.floor(stat.amt * 1000 / stat.runs) / 1000) : 0 ;
-     
-    return 'BENCH %@ msec: %@ (%@x)'.fmt(avg, (stat.name || key), stat.runs) ;  
-  },
-
-  // Generate the report in the form of at time line. This returns the parent.
-  _timelineGenReport: function(val) 
-  {
-    if(this.globalStartTime)
-    {
-      return 'BENCH start: %@ msec, duration: %@ msec,  %@'.fmt((val[1]-this.globalStartTime), val[3], val[0]) ;  
-    } 
-    else
-    {
-      return 'BENCH duration: %@ msec, %@'.fmt( val[3],  val[0]) ;  
-    }
-  },
-  
-  // Generate the report in the form of at time line. This returns the children.
-  _timelineGenSubReport: function(val) 
-  {
-    if(this.globalStartTime)
-    {
-      return '   CHECKPOINT BENCH start: %@ msec, duration: %@ msec,  %@'.fmt((val[1]-this.globalStartTime), val[3], val[0]) ;  
-    } 
-    else
-    {
-      return '   CHECKPOINT BENCH duration: %@ msec, %@'.fmt( val[3], val[0]) ;  
-    }
-  },
-  
-  // returns a stats hash for the named key and parent key.  If the hash does not exist yet,
-  // creates it.
-  _subStatFor: function(key, parentKey) {
-    var parentTimeLen = this.stats[parentKey]._times.length;
-    if(parentTimeLen == 0) return;
-    var parentSubStats = this.stats[parentKey]._times[this.stats[parentKey]._times.length-1]._subStats;
-    var ret = parentSubStats[key] ;
-    if (!ret) ret = parentSubStats[key] = {
-      runs: 0, amt: 0, name: key, _starts: [], _times: []      
-    };
-    return ret ;
-  },
-
-  // returns a stats hash for the named key.  If the hash does not exist yet,
-  // creates it.
-  _statFor: function(key) {
-    var ret = this.stats[key] ;
-    if (!ret) ret = this.stats[key] = {
-      runs: 0, amt: 0, name: key, _starts: [], _times: []      
-    };
-    return ret ;
-  },
-  
-  reset: function() { this.stats = {} ; },
-  
-  // This is private, but it is used in some places, so we are keeping this for
-  // compatibility.
-  _bench: function(func, name) {
-    SC.Benchmark.bench(func, name, 1) ;
-  },
-  
-  _benchCount: 1
-  
-} ;
-
-SC.Benchmark = SC.Benchmark;

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

@@ -1,64 +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)
-// ==========================================================================
-
-/** Detects the current browser type. Borrowed from jQuery + prototype */
-SC.browser = (function() {
-  
-  var userAgent = navigator.userAgent.toLowerCase();
-  var version = (userAgent.match( /.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/ ) || [])[1] ;
-
-  var browser = /** @scope SC.browser */ {
-    
-    /** The current browser version */
-    version: version,
-    
-    /** non-zero if webkit-based browser */
-    safari: (/webkit/).test( userAgent ) ? version : 0,
-    
-    /** non-zero if this is an opera-based browser */
-    opera: (/opera/).test( userAgent ) ? version : 0,
-    
-    /** non-zero if this is IE */
-    msie: (/msie/).test( userAgent ) && !(/opera/).test( userAgent ) ? version : 0,
-    
-    /** non-zero if this is a miozilla based browser */
-    mozilla: (/mozilla/).test( userAgent ) && !(/(compatible|webkit)/).test( userAgent ) ? version : 0,
-    
-    /** non-zero if this is mobile safari */
-    mobileSafari: (/apple.*mobile.*safari/).test(userAgent) ? version : 0,
-    
-    /** non-zero if we are on windows */
-    windows: !!(/(windows)/).test(userAgent),
-    
-    /** non-zero if we are on a mac */
-    mac: !!((/(macintosh)/).test(userAgent) || (/(mac os x)/).test(userAgent)),
-    
-    language: ((navigator.language || navigator.browserLanguage).split('-', 1)[0])
-  };
-  
-  // Add more SC-like descriptions...
-  SC.extend(browser, /** @scope SC.browser */ {
-    
-    isOpera: !!browser.opera,
-    isIe: !!browser.msie,
-    isIE: !!browser.msie,
-    isSafari: !!browser.safari,
-    isMobileSafari: !!browser.mobileSafari,
-    isMozilla: !!browser.mozilla,
-    isWindows: !!browser.windows,
-    isMac: !!browser.mac,
-
-    /**
-      The current browser name.  This is useful for switch statements. */
-    current: (browser.msie) ? 'msie' : (browser.mozilla) ? 'mozilla' : (browser.safari) ? 'safari' : (browser.opera) ? 'opera' : 'unknown'
-    
-  }) ;
-  
-  return browser ;
-
-})();
-