sproutcore 1.6.0.beta.3-java → 1.6.0-java

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/platform.js

@@ -109,9 +109,9 @@ SC.platform = SC.Object.create({
   simulateTouchEvents: function() {
     // Touch events are supported natively, no need for this.
     if (this.touch) {
-      //@ if (debug)
+      // @if (debug)
       SC.Logger.info("Can't simulate touch events in an environment that supports them.");
-      //@ endif
+      // @endif
       return;
     }
     

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/render_context.js

@@ -50,7 +50,8 @@ SC.COMBO_STYLES = {
   context.begin() <-- begins a new tag context
   context.end() <-- ends the tag context...
 */
-SC.RenderContext = SC.Builder.create(/** SC.RenderContext.fn */ {
+SC.RenderContext = SC.Builder.create(
+  /** @lends SC.RenderContext */ {
 
   SELF_CLOSING: SC.CoreSet.create().addEach(['area', 'base', 'basefront', 'br', 'hr', 'input', 'img', 'link', 'meta']),
 
@@ -259,7 +260,7 @@ SC.RenderContext = SC.Builder.create(/** SC.RenderContext.fn */ {
     @returns {DOMElement} the element
   */
   element: function() {
-    return this._elem ? this._elem : SC.$(this.join())[0]
+    return this._elem ? this._elem : SC.$(this.join())[0];
   },
 
   /**
@@ -295,7 +296,7 @@ SC.RenderContext = SC.Builder.create(/** SC.RenderContext.fn */ {
   update: function() {
     var elem = this._elem,
         mode = this.updateMode,
-        cq, key, value, attr, styles, factory, cur, next, before;
+        cq, value, factory, cur, next;
 
     this._innerHTMLReplaced = NO;
 
@@ -318,14 +319,13 @@ SC.RenderContext = SC.Builder.create(/** SC.RenderContext.fn */ {
       } else {
         factory = elem.cloneNode(false);
         factory.innerHTML = this.join() ;
-        before = (mode === SC.MODE_APPEND) ? null : elem.firstChild;
         cur = factory.firstChild ;
         while(cur) {
           next = cur.nextSibling ;
           elem.insertBefore(cur, next);
           cur = next ;
         }
-        cur = next = factory = before = null ; // cleanup
+        cur = next = factory = null ; // cleanup
       }
     }
 
@@ -595,8 +595,9 @@ SC.RenderContext = SC.Builder.create(/** SC.RenderContext.fn */ {
         this._classNamesDidChange = YES ;
       }
     } else {
+      var cl;
       for(var i = 0, iLen= nameOrClasses.length; i<iLen; i++){
-        var cl = nameOrClasses[i];
+        cl = nameOrClasses[i];
         if (classNames.indexOf(cl)<0) {
           classNames.push(cl);
           this._classNamesDidChange = YES ;

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/responder.js

@@ -15,7 +15,7 @@
   @extends SC.Object
   @since SproutCore 1.0
 */
-SC.Responder = SC.Object.extend( /** SC.Responder.prototype */ {
+SC.Responder = SC.Object.extend( /** @scope SC.Responder.prototype */ {
 
   isResponder: YES,
   

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/root_responder.js

@@ -18,7 +18,8 @@ SC.CAPTURE_BACKSPACE_KEY = NO ;
   RootResponder directly.  Instead you will work with Pane objects, which
   register themselves with the RootResponder as needed to receive events.
 
-  ## RootResponder and Platforms
+  RootResponder and Platforms
+  ---
 
   RootResponder contains core functionality common among the different web
   platforms. You will likely be working with a subclass of RootResponder that
@@ -27,7 +28,8 @@ SC.CAPTURE_BACKSPACE_KEY = NO ;
   The correct instance of RootResponder is detected at runtime and loaded
   transparently.
 
-  ## Event Types
+  Event Types
+  ---
 
   RootResponders can route four types of events:
 
@@ -46,7 +48,8 @@ SC.CAPTURE_BACKSPACE_KEY = NO ;
      explicit target, or allow the action to traverse the hierarchy until a
      view is found that handles it.
 */
-SC.RootResponder = SC.Object.extend({
+SC.RootResponder = SC.Object.extend(
+  /** @scope SC.RootResponder.prototype */{
 
   /**
     Contains a list of all panes currently visible on screen.  Everytime a
@@ -68,7 +71,7 @@ SC.RootResponder = SC.Object.extend({
   // MAIN PANE
   //
 
-  /** @property
+  /**
     The main pane.  This pane receives shortcuts and actions if the
     focusedPane does not respond to them.  There can be only one main pane.
     You can swap main panes by calling makeMainPane() here.
@@ -76,6 +79,8 @@ SC.RootResponder = SC.Object.extend({
     Usually you will not need to edit the main pane directly.  Instead, you
     should use a MainPane subclass, which will automatically make itself main
     when you append it to the document.
+    
+    @type SC.MainPane
   */
   mainPane: null,
 
@@ -89,7 +94,7 @@ SC.RootResponder = SC.Object.extend({
     document body.  That will be handled by the Pane itself.
 
     @param {SC.Pane} pane
-    @returns {SC.RootResponder} receiver
+    @returns {SC.RootResponder}
   */
   makeMainPane: function(pane) {
     var currentMain = this.get('mainPane') ;
@@ -339,9 +344,18 @@ SC.RootResponder = SC.Object.extend({
     (removing sc-blur).  Also notify panes.
   */
   focus: function() {
+    
     if (!this.get('hasFocus')) {
       SC.$('body').addClass('sc-focus').removeClass('sc-blur');
 
+      // If the app is getting focus again set the first responder to the first
+      // valid firstResponder view in the view's tree
+      if(!SC.TABBING_ONLY_INSIDE_DOCUMENT){
+        var mainPane = this.get('mainPane'),
+            nextValidKeyView = mainPane ? mainPane.get('nextValidKeyView') : null;
+        if (nextValidKeyView) mainPane.makeFirstResponder(nextValidKeyView);
+      }
+      
       SC.run(function() {
         this.set('hasFocus', YES);
       }, this);
@@ -682,18 +696,18 @@ SC.RootResponder = SC.Object.extend({
     }
     SC.Event.add(document, mousewheel, this, this.mousewheel);
 
-    // If the browser is identifying itself as a touch-enabled browser, but
-    // touch events are not present, assume this is a desktop browser doing
-    // user agent spoofing and simulate touch events automatically.
-    if (SC.browser && SC.platform && SC.browser.mobileSafari && !SC.platform.touch) {
-      SC.platform.simulateTouchEvents();
-    }
-
     // do some initial set
     this.set('currentWindowSize', this.computeWindowSize()) ;
-    this.focus(); // assume the window is focused when you load.
 
     if (SC.browser.mobileSafari) {
+
+      // If the browser is identifying itself as a touch-enabled browser, but
+      // touch events are not present, assume this is a desktop browser doing
+      // user agent spoofing and simulate touch events automatically.
+      if (SC.platform && !SC.platform.touch) {
+        SC.platform.simulateTouchEvents();
+      }
+
       // Monkey patch RunLoop if we're in MobileSafari
       var f = SC.RunLoop.prototype.endRunLoop, patch;
 
@@ -1707,11 +1721,10 @@ SC.RootResponder = SC.Object.extend({
   mousedown: function(evt) {
     if (SC.platform.touch) {
       evt.allowDefault();
+      this._lastMouseDownCustomHandling = YES;
       return YES;
     }
 
-    if(!SC.browser.msie) window.focus();
-
     // First, save the click count. The click count resets if the mouse down
     // event occurs more than 250 ms later than the mouse up event or more
     // than 8 pixels away from the mouse down event.
@@ -1764,6 +1777,7 @@ SC.RootResponder = SC.Object.extend({
   mouseup: function(evt) {
     if (SC.platform.touch) {
       evt.allowDefault();
+      this._lastMouseUpCustomHandling = YES;
       return YES;
     }
 

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/sparse_array.js

@@ -102,7 +102,7 @@ SC.SparseArray = SC.Object.extend(SC.Observable, SC.Enumerable, SC.Array,
     added as range requests are completed.
   */
   requestedRangeIndex: null,
-  
+
   /**
     Make sure to create the index array during init so that it is not shared
     between all instances.
@@ -110,13 +110,13 @@ SC.SparseArray = SC.Object.extend(SC.Observable, SC.Enumerable, SC.Array,
   init: function() {
     sc_super();
     this.requestedRangeIndex = [];
-    
+
     this._TMP_PROVIDE_ARRAY = [];
     this._TMP_PROVIDE_RANGE = { length: 1 };
     this._TMP_RANGE = {};
   },
-  
-  /** 
+
+  /**
     Returns the object at the specified index.  If the value for the index
     is currently undefined, invokes the didRequestIndex() method to notify
     the delegate.
@@ -124,9 +124,9 @@ SC.SparseArray = SC.Object.extend(SC.Observable, SC.Enumerable, SC.Array,
     The omitMaterializing flag ensures that the object will not be materialized,
     but it simply checks for the presence of an object at the specified index
     and will return YES (or undefined if not found). This is useful in the case
-    of SparseArrays, where you might NOT want to request the index to be loaded, 
+    of SparseArrays, where you might NOT want to request the index to be loaded,
     but simply need a shallow check to see if the position has been filled.
-    
+
     @param {Number} idx the index to get
     @param {Boolean} omitMaterializing
     @return {Object} the object
@@ -251,7 +251,7 @@ SC.SparseArray = SC.Object.extend(SC.Observable, SC.Enumerable, SC.Array,
 
     @param {Range} range the range to apply to
     @param {Array} array the array of objects to insert
-    @returns {SC.SparseArray} reciever
+    @returns {SC.SparseArray} receiver
   */
   provideObjectsInRange: function(range, array) {
     var content = this._sa_content ;
@@ -300,7 +300,7 @@ SC.SparseArray = SC.Object.extend(SC.Observable, SC.Enumerable, SC.Array,
         var start = range.start, loc = Math.min(start + range.length, content.length);
         while (--loc>=start) content[loc] = undefined;
       }
-    }    
+    }
     this.arrayContentDidChange(range.start, range.length, range.length) ; // notify
     return this ;
   },

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/string.js

@@ -14,6 +14,8 @@ SC.STRING_TITLEIZE_REGEXP = (/([\s|\-|\_|\n])([^\s|\-|\_|\n]?)/g);
 SC.STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g);
 SC.STRING_DASHERIZE_REGEXP = (/[ _]/g);
 SC.STRING_DASHERIZE_CACHE = {};
+SC.STRING_TRIM_LEFT_REGEXP = (/^\s+/g);
+SC.STRING_TRIM_RIGHT_REGEXP = (/\s+$/g);
 
 /**
   @namespace
@@ -114,7 +116,7 @@ SC.mixin(SC.String, {
   },
 
   /**
-    Localizes the string.  This will look up the reciever string as a key
+    Localizes the string.  This will look up the receiver string as a key
     in the current Strings hash.  If the key matches, the loc'd value will be
     used.  The resulting string will also be passed through fmt() to insert
     any variables.
@@ -134,10 +136,104 @@ SC.mixin(SC.String, {
 
     var args = SC.$A(arguments);
     args.shift(); // remove str param
+    //to extend String.prototype
+    if(args.length>0 && args[0].isSCArray) args=args[0];
 
     return SC.String.fmt(localized, args);
   },
 
+  /**
+    Returns the localized metric value for the specified key.  A metric is a
+    single value intended to be used in your interface’s layout, such as
+    "Button.Confirm.Width" = 100.
+
+    If you would like to return a set of metrics for use in a layout hash, you
+    may prefer to use the locLayout() method instead.
+
+    @param str {String} key
+    @returns {Number} the localized metric
+  */
+  locMetric: function(key) {
+    var K             = SC.Locale,
+        currentLocale = K.currentLocale;
+
+    if (!currentLocale) {
+      K.createCurrentLocale();
+      currentLocale = K.currentLocale;
+    }
+    return currentLocale.locMetric(key);
+  },
+
+  /**
+    Creates and returns a new hash suitable for use as an SC.View’s 'layout'
+    hash.  This hash will be created by looking for localized metrics following
+    a pattern based on the “base key” you specify.
+
+    For example, if you specify "Button.Confirm", the following metrics will be
+    used if they are defined:
+
+      Button.Confirm.left
+      Button.Confirm.top
+      Button.Confirm.right
+      Button.Confirm.bottom
+      Button.Confirm.width
+      Button.Confirm.height
+      Button.Confirm.midWidth
+      Button.Confirm.minHeight
+      Button.Confirm.centerX
+      Button.Confirm.centerY
+
+    Additionally, you can optionally specify a hash which will be merged on top
+    of the returned hash.  For example, if you wish to allow a button’s width
+    to be configurable per-locale, but always wish for it to be centered
+    vertically and horizontally, you can call:
+
+      locLayout("Button.Confirm", {centerX:0, centerY:0})
+
+    …so that you can combine both localized and non-localized elements in the
+    returned hash.  (An exception will be thrown if there is a locale-specific
+    key that matches a key specific in this hash.)
+
+
+    For example, if your locale defines:
+
+      Button.Confirm.left
+      Button.Confirm.top
+      Button.Confirm.right
+      Button.Confirm.bottom
+
+
+    …then these two code snippets will produce the same result:
+
+      layout: {
+        left:   "Button.Confirm.left".locMetric(),
+        top:    "Button.Confirm.top".locMetric(),
+        right:  "Button.Confirm.right".locMetric(),
+        bottom: "Button.Confirm.bottom".locMetric()
+      }
+
+      layout: "Button.Confirm".locLayout()
+
+    The former is slightly more efficient because it doesn’t have to iterate
+    through the possible localized layout keys, but in virtually all situations
+    you will likely wish to use the latter.
+
+    @param str {String} key
+    @param {str} (optional) additionalHash
+    @param {String} (optional) additionalHash
+    @returns {Number} the localized metric
+  */
+  locLayout: function(key, additionalHash) {
+    var K             = SC.Locale,
+        currentLocale = K.currentLocale;
+
+    if (!currentLocale) {
+      K.createCurrentLocale();
+      currentLocale = K.currentLocale;
+    }
+    return currentLocale.locLayout(key, additionalHash);
+  },
+
   /**
     Works just like loc() except that it will return the passed default
     string if a matching key is not found.
@@ -158,5 +254,70 @@ SC.mixin(SC.String, {
     args.shift(); // remove def param
 
     return SC.String.fmt(localized, args);
+  },
+
+  /**
+   Removes any extra whitespace from the edges of the string. This method is
+   also aliased as strip().
+
+   @returns {String} the trimmed string
+  */
+  trim: jQuery.trim,
+
+  /**
+   Removes any extra whitespace from the left edge of the string.
+
+   @returns {String} the trimmed string
+  */
+  trimLeft: function (str) {
+    return str.replace(SC.STRING_TRIM_LEFT_REGEXP,"");
+  },
+
+  /**
+   Removes any extra whitespace from the right edge of the string.
+
+   @returns {String} the trimmed string
+  */
+  trimRight: function (str) {
+    return str.replace(SC.STRING_TRIM_RIGHT_REGEXP,"");
   }
 });
+
+
+// IE doesn't support string trimming
+if(String.prototype.trim) {
+  SC.supplement(String.prototype,
+  /** @scope String.prototype */ {
+
+    trim: function() {
+      return SC.String.trim(this, arguments);
+    },
+
+    trimLeft: function() {
+      return SC.String.trimLeft(this, arguments);
+    },
+
+    trimRight: function() {
+      return SC.String.trimRight(this, arguments);
+    }
+  });
+}
+
+// We want the version defined here, not in Runtime
+SC.mixin(String.prototype,
+/** @scope String.prototype */ {
+
+  loc: function() {
+    return SC.String.loc(this.toString(), SC.$A(arguments));
+  },
+
+  locMetric: function() {
+    return SC.String.locMetric(this.toString());
+  },
+
+  locLayout: function(additionalHash) {
+    return SC.String.locLayout(this.toString(), additionalHash);
+  }
+
+});
+

data/lib/frameworks/sproutcore/frameworks/core_foundation/system/theme.js

@@ -23,21 +23,6 @@
   by SC.View when you name a theme that doesn't actually exist: it creates
   a theme based on the parent theme.
 
-  Renderers
-  ---------------------------
-  Themes are used to keep track of theme class names and, more important,
-  to keep track of renderers.
-
-  Renderers are added to a theme using theme.addRenderer(theRenderer). After
-  this has been done, they may be instantiated using theme.renderer(rendererName).
-
-  Instantiating with renderer() instantiates a version of that renderer
-  specialized for this specific theme-- not any parent themes. The renderer
-  will include all class names for _this_ theme. This means that you can
-  theme controls differently without overriding any renderers: just subclass
-  the original theme that _has_ the renderers, give it its own name, and
-  all renderers will render with that name as a class name.
-
   Locating Child Themes
   ----------------------------
   Locating child themes is relatively simple for the most part: it looks in
@@ -51,7 +36,7 @@
   base classes; if the theme is a global theme, those class names should not
   be included.
 
-  This makes sense logically as well, because when searching for a renderer,
+  This makes sense logically as well, because when searching for a render delegate,
   it will locate it in any base theme that has it, but that doesn't mean
   class names from the derived theme shouldn't be included.
 
@@ -143,10 +128,6 @@ SC.Theme = {
     // method.
     result._privateThemes = {};
 
-    // the theme also specializes all renderers it creates so that they
-    // have the theme's classNames and have their 'theme' property set.
-    result._specializedRenderers = {};
-
     // also, the theme specializes all child themes as they are created
     // to ensure that all of the class names on this theme are included.
     result._specializedThemes = {};
@@ -263,40 +244,6 @@ SC.Theme = {
   */
   addTheme: function(theme) {
     this.themes[theme.name] = theme;
-  },
-
-  /**
-    Adds a renderer to the theme. The renderer's name will be used to
-    keep track of it and identify it later.
-
-    The biggest responsibility of addRenderer is to ensure that renderer()
-    can be used to instantiate that renderer. If a renderer is not instantiated
-    through renderer(), it will not know its theme's classNames.
-  */
-  addRenderer: function(renderer) {
-    this[renderer.name] = renderer;
-  },
-
-   /**
-     Finds the named renderer and instantiates it, returning the result.
-     It also ensures it is using a version of the renderer specialized for
-     this theme. It keeps a cache of specialized versions of the renderer.
-
-     Any arguments after the name are passed on to the instantiated
-     renderer.
-   */
-  renderer: function(name) {
-    var renderer = this._specializedRenderers[name], base = this[name];
-    if (!renderer || renderer._specializedFrom !== base) {
-      if (!base) return null;
-
-      renderer = base.extend({ classNames: this.classNames, theme: this });
-    }
-
-    var args = SC.$A(arguments);
-    args.shift();
-    renderer = renderer.create.apply(renderer, args);
-    return renderer;
   }
 };
 
@@ -304,8 +251,8 @@ SC.Theme = {
 // optimal, but the reasoning is because of test running: the
 // test runner, when running foundation unit tests, cannot load
 // the theme. As such, foundation must include default versions of
-// all of its renderers, and it does so in BaseTheme. All SproutCore
-// controls have renderers in BaseTheme.
+// all of its render delegates, and it does so in BaseTheme. All SproutCore
+// controls have render delegates in BaseTheme.
 SC.BaseTheme = SC.Theme.create({
   name: '' // it is a base class, and doesn't need a class name or such
 });