sproutcore 1.5.0-java → 1.6.0.beta.2-java

data/lib/frameworks/sproutcore/frameworks/foundation/views/inline_text_field.js

@@ -21,62 +21,58 @@ sc_require('mixins/inline_editor');
   editing. If you would like to use the inline editor for your own views, 
   you can do that also by using the editing API described here.
   
-  h2. Using the Inline Editor in Your Own Views
+  ## Using the Inline Editor in Your Own Views
 
   To use the inlineEditor on a custom view you should mixin SC.InlineEditable on
   it. SC.InlineTextFieldView is the default editor so you do not need to do any
   other setup. The class methods beginEditing, commitEditing, and discardEditing
   still exist for backwards compatibility but should not be used on new views.
 
-  {{{
-    MyProject.MyView = SC.View.extend(SC.InlineEditable, {
-    });
-  }}}
+      MyProject.MyView = SC.View.extend(SC.InlineEditable, {
+      });
   
-  h3. Starting the Editor
+  ### Starting the Editor
   
   The inline editor works by positioning itself over the top of your view 
   with the same offset, width, and font information.
 
   To start it simply call beginEditing on your view.
 
-  {{{
-    myView.beginEditing();
-  }}}
+      myView.beginEditing();
   
   By default, if the inline editor is currently in use elsewhere, it will automatically
   close itself over there and begin editing for your view instead. This behavior
   is defined by the inlineEditorDelegate of your view, and can be changed by using
   one other than the default.
 
-  h2. Customizing the editor
+  ## Customizing the editor
 
   The editor has several parameters that can be used to customize it to your
   needs. These options should be set on the editor passed to your delegate's (or
   view's) inlineEditorWillBeginEditing method:
 
-  - *exampleFrame* The editors initial frame in viewport coordinates.
-  - *value* Initial value of the edit field.
-  - *exampleElement* A DOM element to use when copying styles.
-  - *multiline* If YES then the hitting return will add to the value instead of exiting the inline editor.
-  - *commitOnBlur* If YES then blurring will commit the value, otherwise it will discard the current value.  Defaults to YES.
-  - *validator* Validator to be attached to the field.
+   - `exampleFrame` -- The editors initial frame in viewport coordinates.
+   - `value` -- Initial value of the edit field.
+   - `exampleElement` -- A DOM element to use when copying styles.
+   - `multiline` -- If YES then the hitting return will add to the value instead
+     of exiting the inline editor.
+   - `commitOnBlur` -- If YES then blurring will commit the value, otherwise it
+     will discard the current value.  Defaults to YES.
+   - `validator` -- Validator to be attached to the field.
 
   For backwards compatibility, calling the class method beginEditing with an
   options hash will translate the values in the hash to the correct settings on
   the editor.
 
-  h2. Committing or Discarding Changes
+  ## Committing or Discarding Changes
   
   Normally the editor will automatically commit or discard its changes 
   whenever the user exits the edit mode by pressing enter, escape, or clicking
   elsewhere on the page. If you need to force the editor to end editing, you can
   do so by calling commitEditing() or discardEditing():
   
-  {{{
-    myView.commitEditing();
-    myView.discardEditing();
-  }}}
+      myView.commitEditing();
+      myView.discardEditing();
   
   Both methods will try to end the editing context and will call the 
   relevant delegate methods on the inlineEditorDelegate set on your view.
@@ -515,23 +511,21 @@ SC.mixin(SC.InlineTextFieldView, {
   * To trigger compatibility mode, call this method with a hash of options. The
   * required options are:
   *
-    {{{
-      SC.InlineTextFieldView.beginEditing({
-        delegate: myView,
-        frame: myView.get('frame'),
-        exampleElement: myView.$()
-      }) ;
-    }}}
+        SC.InlineTextFieldView.beginEditing({
+          delegate: myView,
+          frame: myView.get('frame'),
+          exampleElement: myView.$()
+        }) ;
   *
-    - *delegate* The view that should be notified of events on the editor.
-    - *frame* The frame of the view that you want the editor to position itself over.
-    - *exampleElement* A DOM element to use when copying styles.
+     - `delegate` -- The view that should be notified of events on the editor.
+     - `frame` -- The frame of the view that you want the editor to position itself over.
+     - `exampleElement` -- A DOM element to use when copying styles.
 
   * Other options may be passed to further customize the editor:
   *
-    - *multiline* If YES then the hitting return will add to the value instead of exiting the inline editor.
-    - *commitOnBlur* If YES then blurring will commit the value, otherwise it will discard the current value.  Defaults to YES.
-    - *validator* Validator to be attached to the field.
+     - `multiline` -- If YES then the hitting return will add to the value instead of exiting the inline editor.
+     - `commitOnBlur` -- If YES then blurring will commit the value, otherwise it will discard the current value.  Defaults to YES.
+     - `validator` -- Validator to be attached to the field.
 
     The editor expects your source view to implement the InlineTextFieldViewDelegate protocol.
 

data/lib/frameworks/sproutcore/frameworks/{foundation → routing}/system/routes.js

@@ -9,24 +9,18 @@
   SC.routes manages the browser location. You can change the hash part of the
   current location. The following code
   
-  {{{
-    SC.routes.set('location', 'notes/edit/4');
-  }}}
+      SC.routes.set('location', 'notes/edit/4');
   
   will change the location to http://domain.tld/my_app#notes/edit/4. Adding
   routes will register a handler that will be called whenever the location
   changes and matches the route:
   
-  {{{
-    SC.routes.add(':controller/:action/:id', MyApp, MyApp.route);
-  }}}
+      SC.routes.add(':controller/:action/:id', MyApp, MyApp.route);
   
   You can pass additional parameters in the location hash that will be relayed
   to the route handler:
   
-  {{{
-    SC.routes.set('location', 'notes/show/4?format=xml&language=fr');
-  }}}
+      SC.routes.set('location', 'notes/show/4?format=xml&language=fr');
   
   The syntax for the location hash is described in the location property
   documentation, and the syntax for adding handlers is described in the
@@ -51,15 +45,13 @@ SC.routes = SC.Object.create({
     event.
     
     By default it is NO, so your URLs will look like:
-    {{{
-      http://domain.tld/my_app#notes/edit/4
-    }}}
+
+        http://domain.tld/my_app#notes/edit/4
     
     If set to YES and the browser supports pushState(), your URLs will look
     like:
-    {{{
-      http://domain.tld/my_app/notes/edit/4
-    }}}
+
+        http://domain.tld/my_app/notes/edit/4
     
     You will also need to make sure that baseURI is properly configured, as
     well as your server so that your routes are properly pointing to your
@@ -87,15 +79,13 @@ SC.routes = SC.Object.create({
     
     The build tools automatically configure this value if you have the
     html5_history option activated in the Buildfile:
-    {{{
-      config :my_app, :html5_history => true
-    }}}
+
+        config :my_app, :html5_history => true
     
     Alternatively, it uses by default the value of the href attribute of the
     <base> tag of the HTML document. For example:
-    {{{
-      <base href="http://domain.tld/my_app">
-    }}}
+
+        <base href="http://domain.tld/my_app">
     
     The value can also be customized before or during the exectution of the
     main() method.
@@ -183,9 +173,7 @@ SC.routes = SC.Object.create({
     
     The following code
     
-    {{{
-      SC.routes.set('location', 'notes/edit/4');
-    }}}
+        SC.routes.set('location', 'notes/edit/4');
     
     will change the location to http://domain.tld/my_app#notes/edit/4 and call
     the correct route handler if it has been registered with the add method.
@@ -193,31 +181,25 @@ SC.routes = SC.Object.create({
     You can also pass additional parameters. They will be relayed to the route
     handler. For example, the following code
     
-    {{{
-      SC.routes.add(':controller/:action/:id', MyApp, MyApp.route);
-      SC.routes.set('location', 'notes/show/4?format=xml&language=fr');
-    }}}
+        SC.routes.add(':controller/:action/:id', MyApp, MyApp.route);
+        SC.routes.set('location', 'notes/show/4?format=xml&language=fr');
     
     will change the location to 
     http://domain.tld/my_app#notes/show/4?format=xml&language=fr and call the
     MyApp.route method with the following argument:
     
-    {{{
-      { route: 'notes/show/4',
-        params: '?format=xml&language=fr',
-        controller: 'notes',
-        action: 'show',
-        id: '4',
-        format: 'xml',
-        language: 'fr' }
-    }}}
+        { route: 'notes/show/4',
+          params: '?format=xml&language=fr',
+          controller: 'notes',
+          action: 'show',
+          id: '4',
+          format: 'xml',
+          language: 'fr' }
     
     The location can also be set with a hash, the following code
     
-    {{{
-      SC.routes.set('location',
-        { route: 'notes/edit/4', format: 'xml', language: 'fr' });
-    }}}
+        SC.routes.set('location',
+          { route: 'notes/edit/4', format: 'xml', language: 'fr' });
     
     will change the location to
     http://domain.tld/my_app#notes/show/4?format=xml&language=fr.
@@ -341,17 +323,19 @@ SC.routes = SC.Object.create({
   
   /**
     Adds a route handler. Routes have the following format:
-      - 'users/show/5' is a static route and only matches this exact string,
-      - ':action/:controller/:id' is a dynamic route and the handler will be
+
+     - 'users/show/5' is a static route and only matches this exact string,
+     - ':action/:controller/:id' is a dynamic route and the handler will be
         called with the 'action', 'controller' and 'id' parameters passed in a
         hash,
-      - '*url' is a wildcard route, it matches the whole route and the handler
+     - '*url' is a wildcard route, it matches the whole route and the handler
         will be called with the 'url' parameter passed in a hash.
     
     Route types can be combined, the following are valid routes:
-      - 'users/:action/:id'
-      - ':controller/show/:id'
-      - ':controller/ *url' (ignore the space, because of jslint)
+
+     - 'users/:action/:id'
+     - ':controller/show/:id'
+     - ':controller/ *url' (ignore the space, because of jslint)
     
     @param {String} route the route to be registered
     @param {Object} target the object on which the method will be called, or

data/lib/frameworks/sproutcore/frameworks/runtime/core.js

@@ -36,7 +36,7 @@ if (typeof console === 'undefined') {
 // rest of the methods go into the mixin defined below.
 
 /**
-  @version 1.5.0
+  @version 1.6.0.beta.2
   @namespace
 
   All SproutCore methods and functions are defined
@@ -57,7 +57,7 @@ if (typeof console === 'undefined') {
 window.SC = window.SC || {} ;
 window.SproutCore = window.SproutCore || SC ;
 
-SC.VERSION = '1.5.0';
+SC.VERSION = '1.6.0.beta.2';
 
 /**
   @private

data/lib/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/base.js

@@ -17,11 +17,9 @@
   instance of the object you want to have tested.  You can also implement the
   destroyObject() method, which should destroy a passed object.
   
-  {{{
-    SC.ArrayTests.generate("Array", {
-      newObject:  function() { return []; }
-    });
-  }}}
+      SC.ArrayTests.generate("Array", {
+        newObject:  function() { return []; }
+      });
   
   newObject must accept an optional array indicating the number of items
   that should be in the array.  You should initialize the the item with 
@@ -31,16 +29,14 @@
   function you pass will be invoked whenever the ArrayTests are generated. The
   parameter passed will be the instance of ArrayTests you should work with.
   
-  {{{
-    SC.ArrayTests.define(function(T) {
-      T.module("length");
+      SC.ArrayTests.define(function(T) {
+        T.module("length");
       
-      test("verify length", function() {
-        var ary = T.newObject();
-        equals(ary.get('length'), 0, 'should have 0 initial length');
-      });
-    }
-  }}}
+        test("verify length", function() {
+          var ary = T.newObject();
+          equals(ary.get('length'), 0, 'should have 0 initial length');
+        });
+      }
 */
 
 SC.TestSuite = /** @scope SC.TestSuite.prototype */ {
@@ -182,13 +178,11 @@ SC.TestSuite = /** @scope SC.TestSuite.prototype */ {
     a convenience function for use inside of a definition function.  You could
     do the same thing by calling:
     
-    {{{
-      var T = this ;
-      module(T.desc(description), {
-        setup: function() { T.setup(); },
-        teardown: function() { T.teardown(); }
-      }
-    }}}
+        var T = this ;
+        module(T.desc(description), {
+          setup: function() { T.setup(); },
+          teardown: function() { T.teardown(); }
+        }
     
     @param {String} desc detailed descrition
     @returns {SC.TestSuite} receiver

data/lib/frameworks/sproutcore/frameworks/runtime/mixins/array.js

@@ -567,6 +567,14 @@ SC.CoreArray = /** @lends SC.Array.prototype */ {
     var target, action;
     var didChangeObservers = this._kvo_array_did_change;
     if (didChangeObservers) {
+      // If arrayContentDidChange is called with no parameters, assume the
+      // entire array has changed.
+      if (start === undefined) {
+        start = 0;
+        removedCount = this.get('length');
+        addedCount = 0;
+      }
+
       members = didChangeObservers.members;
       membersLen = members.length;
 

data/lib/frameworks/sproutcore/frameworks/runtime/mixins/enumerable.js

@@ -62,7 +62,7 @@ SC.Enumerable = /** @scope SC.Enumerable.prototype */{
   /**
     Implement this method to make your class enumerable.
 
-    This method will be call repeatedly during enumeration.  The index value
+    This method will be called repeatedly during enumeration.  The index value
     will always begin with 0 and increment monotonically.  You don't have to
     rely on the index value to determine what object to return, but you should
     always check the value and start from the beginning when you see the
@@ -72,7 +72,7 @@ SC.Enumerable = /** @scope SC.Enumerable.prototype */{
     to nextObject for the current iteration.  This is a useful way to
     manage iteration if you are tracing a linked list, for example.
 
-    Finally the context paramter will always contain a hash you can use as
+    Finally the context parameter will always contain a hash you can use as
     a "scratchpad" to maintain any other state you need in order to iterate
     properly.  The context object is reused and is not reset between
     iterations so make sure you setup the context with a fresh state whenever
@@ -82,7 +82,7 @@ SC.Enumerable = /** @scope SC.Enumerable.prototype */{
     reaches the your current length-1.  If you run out of data before this
     time for some reason, you should simply return undefined.
 
-    The default impementation of this method simply looks up the index.
+    The default implementation of this method simply looks up the index.
     This works great on any Array-like objects.
 
     @param {Number} index the current index of the iteration

data/lib/frameworks/sproutcore/frameworks/runtime/tests/mixins/array_observers.js

@@ -0,0 +1,23 @@
+module("SC.Array mixin - Array observers");
+
+(function(root) {
+  test("notifies entire array has changed when arrayContentDidChange() is called with no arguments", function() {
+    var content = [1, 2, 3, 4, 5];
+    var start, added, removed;
+
+    content.addArrayObservers({
+      didChange: function(s, r, a) {
+        start = s;
+        added = a;
+        removed = r;
+      }
+    });
+
+    content.arrayContentDidChange();
+
+    equals(start, 0, "change starts at index 0");
+    equals(removed, 5, "five items were removed");
+    equals(added, 0, "zero items were added");
+  });
+
+})(this);

data/lib/frameworks/sproutcore/frameworks/runtime/tests/system/binding.js

@@ -297,7 +297,7 @@ test("two bindings to the same value should sync in the order they are initializ
   
   var b = window.b;
 
-  SC.LOG_BINDINGS = YES;
+  SC.LOG_BINDINGS = NO;
     
   SC.RunLoop.end();
   

data/lib/frameworks/sproutcore/frameworks/runtime/tests/system/index_set/contains.js

@@ -53,17 +53,17 @@ test("handle range partially inside set", function() {
 // INDEX SET
 // 
 
-test("handle set inside set", function() {
+test("handle set inside IndexSet", function() {
   var test = SC.IndexSet.create().add(1001,4).add(1005,2);
   equals(set.contains(test), YES, '%@ should be in %@'.fmt(test, set));
 });
 
-test("handle range outside of set", function() {
+test("handle range outside of IndexSet", function() {
   var test = SC.IndexSet.create().add(100,4).add(105,2);
   equals(set.contains(test), NO, '%@ should be in %@'.fmt(test, set));
 });
 
-test("handle range partially inside set", function() {
+test("handle range partially inside IndexSet", function() {
   var test = SC.IndexSet.create().add(1001,4).add(100,2);
   equals(set.contains(test), NO, '%@ should be in %@'.fmt(test, set));
 });

data/lib/frameworks/sproutcore/frameworks/runtime/tests/system/index_set/intersects.js

@@ -53,17 +53,17 @@ test("handle range partially inside set", function() {
 // INDEX SET
 // 
 
-test("handle set inside set", function() {
+test("handle set inside IndexSet", function() {
   var test = SC.IndexSet.create().add(1001,4).add(1005,2);
   equals(set.intersects(test), YES, '%@ should be in %@'.fmt(test, set));
 });
 
-test("handle range outside of set", function() {
+test("handle range outside of IndexSet", function() {
   var test = SC.IndexSet.create().add(100,4).add(105,2);
   equals(set.intersects(test), NO, '%@ should be in %@'.fmt(test, set));
 });
 
-test("handle range partially inside set", function() {
+test("handle range partially inside IndexSet", function() {
   var test = SC.IndexSet.create().add(1001,4).add(100,2);
   equals(set.intersects(test), YES, '%@ should be in %@'.fmt(test, set));
 });