sproutcore 1.10.3.1 → 1.11.0.rc1

data/lib/frameworks/sproutcore/README.md

@@ -1,155 +1,42 @@
-[![Build Status](https://travis-ci.org/sproutcore/sproutcore.png)](https://travis-ci.org/sproutcore/sproutcore)
+[![Build Status](https://travis-ci.org/sproutcore/sproutcore.png?branch=master)](https://travis-ci.org/sproutcore/sproutcore)
 
-SproutCore HTML5 Application Framework
-======================================
+SproutCore: For Native-Caliber Web Apps
+=======
 
-SproutCore is a framework for building blazing-fast, desktop-like applications
-in the web browser using only native HTML5 features. With SproutCore, you can
-build rich, interactive applications in the web in less code than most simple
-web pages require today.
+SproutCore is a JS-MVC framework for building blazing-fast, native-caliber web
+applications. SproutCore's full-stack approach to single-page application
+development gives you the tools you need to build rich, powerful applications...
+which happen to run in the browser.
 
-The easiest way to get started with SproutCore is using the build tools
-included with the SproutCore package when you install it from the Ruby gem.
-Please see the Getting Started documentation on the
-[SproutCore website](http://www.sproutcore.com/) for more information.
+## Getting Started
 
-For additional SproutCore user support, join the sproutcore@googlegroups.com
-mailing list and for those interested in working on the framework itself, please
-join sproutcore-dev@googlegroups.com.
+The easiest way to get started with SproutCore is to install the Ruby gem.
+You can find instructions [here](http://sproutcore.com/install/). Once you've
+got SproutCore installed, checkout the
+[Getting Started](http://guides.sproutcore.com/getting_started.html) tutorial.
 
+## Next Steps
 
-## Contributors
+Once you're through the Getting Started tutorial:
 
-SproutCore has been built thanks to the tireless efforts of many talented
-developers. Special thanks to the following developers who contributed lots of
-code and ideas:
+- Check out the [Showcase](http://showcase.sproutcore.com/) for demos of a number
+  of views and concepts.
+- Check out lead developer Tyler Keating's book,
+  [SproutCore Web Application Development](http://blog.sproutcore.com/sproutcore-book-available/).
+- Check out Juniper, the [web app](http://juniper.dcporter.net/) +
+  [annotated source code](https://github.com/dcporter/juniper) combo, for a deep
+  dive into SproutCore features and best practices in action.
 
-- Alex Iskander
-- Alex Johnson
-- Andreas Cederström
-- Andrew Dupont
-- Asko Soukka
-- Benedikt Böhm
-- Brandon Blatnick
-- Brandon Dimcheff
-- Brian Cully
-- Brian Mitchell
-- Brian Moore
-- Bruz Marzolf
-- Charles Jolley
-- Charlie Lai
-- Cherif Yaya
-- Chris Hyle
-- Christopher M Pieper
-- Christopher Swasey
-- Chuck Edwall
-- Colin Campbell
-- Corey Burrows
-- Cortland Klein
-- Devin Torres
-- Devon Govett
-- Emrys Ingersoll
-- Eric Kidd
-- Erich Ocean
-- Evin Grano
-- Ganesh J
-- Gareth Townsend
-- Geoffrey Donaldson
-- Gopal Sharma
-- Gregory Moeck
-- Hemanth Kumar
-- James A. Rosen
-- James Austin
-- James Craig
-- James F. Herdman
-- James Ribar
-- Jason Dooley
-- Jason Ketterman
-- Jeff Pittman
-- Jim Benton
-- Jiří Zajpt
-- Joe Gaudet
-- John Rogelstad
-- Jonathan Lewis
-- Joshua Dickens
-- Joshua Holt
-- Joubert Nel
-- Juan Pinzon
-- Julian Viereck
-- Konstantin Bender
-- Lauri Fjallstrom
-- Lawrence Pit
-- Levi McCallum
-- Luke Burton
-- Luke Melia
-- Mahesh Mukundan
-- Majd Taby
-- Martin Häcker
-- Martin Ottenwaelter
-- Matt Smith
-- Matthew Grantham
-- Matthias Loitsch
-- Maurits Lamers
-- Michael Cohen
-- Michael Gillogly
-- Michael Harris
-- Michael Krotscheck
-- Michael Rykov
-- Michal Kurgan
-- Mike Ball
-- Mike Subelsky
-- Mitch Oliver
-- Mitchell Rivera
-- Mohammed Ashik
-- Mohammed Taher
-- Nathan Baxter
-- Nicolas Badia
-- Nirumal Thomas
-- Nitin Gupta
-- Onar Vikingstad
-- Patrick Walton
-- Paul Chavard
-- Paul Lambert
-- Peter Bergström
-- Peter Wagenet
-- Piotr Sarnacki
-- Piotr Steininger
-- Rajesh Segu
-- Ray Bodenhorn
-- Rich Harrison
-- Richard Klancer
-- Rick Russell
-- Rob Linton
-- Robert Buchholz
-- Rodrigo Basa
-- Ryan Mudryk
-- Ryan Nielsen
-- Santhakumar Murugaiyan
-- Sean Eidemiller
-- Sergey Ukustov
-- Steven Tate
-- Sudarshan Bhat
-- Sunny Ripert
-- Suvajit Gupta
-- Tanner Donovan
-- Teresa Tsui
-- Thomas Balthazar
-- Thomas Bartelmess
-- Thomas Bradford
-- Thomas Lang
-- Tim Evans
-- Tom Dale
-- Tomasz Mazur
-- Topher Fangio
-- Trek Glowacki
-- Tyler Keating
-- Umberto Nicoletti
-- Vibul Imtarnasa
-- Vincent Fiano
-- Wesley Workman
-- William Kakes
-- Yehuda Katz
-- Yogesh Kumar
+## Support
+
+Resources for SproutCore developers include [the docs](http://docs.sproutcore.com/)
+for API documentation, and [the Guides](http://guides.sproutcore.com/) for a
+series of topical walk-throughs.
+
+For additional SproutCore user support, join the
+[mailing list](https://groups.google.com/group/sproutcore), or stop by the #sproutcore
+[IRC channel](http://sproutcore.com/community/#tab=irc). For those interested in
+contributing to the framework itself, please join sproutcore-dev@googlegroups.com.
 
 ## Acknowledgements
 

data/lib/frameworks/sproutcore/apps/showcase/controllers/source_tree_controller.js

@@ -38,6 +38,11 @@ Showcase.sources = SC.Object.create(SC.CollectionContent, SC.TreeItemContent, {
           name: "Displaying Big Data",
           view: 'Showcase.mainPage.demoView'
         }),
+        SC.Object.create({
+          appPath: 'http://demos.sproutcore.com/flot_demo',
+          name: "Flot (or other) Integration",
+          view: 'Showcase.mainPage.demoView'
+        }),
         SC.Object.create({
           appPath: 'http://demos.sproutcore.com/lively_view_demo',
           name: "Transition Plugins",
@@ -129,10 +134,10 @@ Showcase.sources = SC.Object.create(SC.CollectionContent, SC.TreeItemContent, {
           name: "SC.SourceListView",
           view: 'Showcase.viewsPage.sourceListViews'
         }),
-        // SC.Object.create({
-        //   name: "SC.SplitView",
-        //   view: 'Showcase.viewsPage.splitViews'
-        // }),
+        SC.Object.create({
+          name: "SC.SplitView",
+          view: 'Showcase.viewsPage.splitViews'
+        }),
         SC.Object.create({
           name: "SC.StackedView",
           view: 'Showcase.viewsPage.stackedViews'

data/lib/frameworks/sproutcore/apps/showcase/resources/stylesheet.css

@@ -382,3 +382,8 @@ $theme.sc-label-view.tab-view {
     background-color: #ff2e2a;
   }
 }
+
+$theme.demo-split-view-label {
+  text-align: center;
+  line-height: 40px;
+}

data/lib/frameworks/sproutcore/apps/showcase/system/views_item_content.js

@@ -23,7 +23,7 @@ Showcase.ViewsItemContent = SC.Object.extend({
 
     parts = example.split('  ');
     parts.forEach(function(part, index) {
-      if (part.indexOf('.extend(') >= 0 || part.indexOf('function(') >= 0 || part.indexOf('({') >= 0) {
+      if (part.indexOf('.extend(') >= 0 || part.indexOf('.design(') >= 0 || part.indexOf('function(') >= 0 || part.indexOf('({') >= 0) {
         parts[index] = padding + part;
         padding += '  ';
       } else if (part.indexOf('}.property') >= 0 || part.indexOf('})') >= 0) {

data/lib/frameworks/sproutcore/apps/showcase/views/split_views.js

@@ -13,10 +13,23 @@ sc_require('views/views_list_view.js');
 */
 Showcase.splitViews = SC.ScrollView.design({
   contentView: Showcase.ViewsListView.design({
+  	exampleHeight: 200,
     content: [
       Showcase.ViewsItemContent.create({
-        title: 'Regular',
-        example: "SC.SplitView.extend({  layout: { top: 20, bottom: 20, left: 20, right: 20 },  topLeftView: SC.LabelView.design({  value: 'Left View'  }),  bottomRightView: SC.LabelView.design({  value: 'Right View'  })  })"
+        title: 'Horizontal (default)',
+        example: "SC.SplitView.extend({  layout: { top: 20, bottom: 20, left: 20, right: 20 },  childViews: ['leftView', 'rightView'],  leftView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Left View',  minimumSize: 80  }),  rightView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Right View',  minimumSize: 80  })  })"
+      }),
+      Showcase.ViewsItemContent.create({
+        title: 'Vertical',
+        example: "SC.SplitView.extend({  layoutDirection: SC.LAYOUT_VERTICAL,  layout: { top: 20, bottom: 20, left: 20, right: 20 },  childViews: ['topView', 'bottomView'],  topView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Top View',  minimumSize: 40  }),  bottomView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Bottom View',  minimumSize: 40  })  })"
+      }),
+      Showcase.ViewsItemContent.create({
+        title: 'Custom Initial Size',
+        example: "SC.SplitView.extend({  layout: { top: 20, bottom: 20, left: 20, right: 20 },  childViews: ['leftView', 'rightView'],  leftView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  size: 120,  value: 'Left View',  minimumSize: 80  }),  rightView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Right View',  minimumSize: 80  })  })"
+      }),
+      Showcase.ViewsItemContent.create({
+        title: 'Three Children',
+        example: "SC.SplitView.extend({  layout: { top: 20, bottom: 20, left: 20, right: 20 },  childViews: ['leftView', 'middleView', 'rightView'],  leftView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Left View',  minimumSize: 80  }),  middleView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Middle View',  minimumSize: 80  }),  rightView: SC.LabelView.design(SC.SplitChild, {  classNames: ['demo-split-view-label'],  value: 'Right View',  minimumSize: 80  })  })"
       })
     ]
   })

data/lib/frameworks/sproutcore/apps/showcase/views/stacked_views.js

@@ -16,7 +16,7 @@ Showcase.stackedViews = SC.ScrollView.design({
     content: [
       Showcase.ViewsItemContent.create({
         title: 'Regular',
-        example: "SC.ScrollView.extend({  classNames: ['my-scroll-view'],  layout: { left: 20, right: 20, top: 20, bottom: 20 },  contentView:  SC.StackedView.extend({  classNames: ['my-stacked-view'],  content: ['These rows have statically laid out content with random heights.  Selecting a row causes the row to re-render and change its height.',1,2,3,4,5,6],  exampleView: SC.View.extend({  displayProperties: ['isSelected'],  useStaticLayout: true,  render: function(context) {  context.setClass('sel', this.get('isSelected'));  context.push('<div style=\"height: ' + (20 + Math.round((Math.random() * 100))) + 'px;\">' + this.get('content') + '</div>');  }  }),  selectionDidChange: function() {  this.updateHeight(false);  }.observes('selection')  })  })"
+        example: "SC.ScrollView.extend({  classNames: ['my-scroll-view'],  layout: { left: 20, right: 20, top: 20, bottom: 20 },  contentView:  SC.StackedView.extend({  classNames: ['my-stacked-view'],  content: ['These rows have statically laid out content with random heights.  Selecting a row causes the row to re-render with a new height.',1,2,3,4,5,6],  exampleView: SC.View.extend({  displayProperties: ['isSelected'],  useStaticLayout: true,  render: function(context) {  context.setClass('sel', this.get('isSelected'));  context.push('<div style=\"height: ' + (20 + Math.round((Math.random() * 100))) + 'px;\">' + this.get('content') + '</div>');  }  }),  selectionDidChange: function() {  this.updateHeight(false);  }.observes('selection')  })  })"
       })
     ],
     exampleHeight: 420

data/lib/frameworks/sproutcore/apps/tests/english.lproj/main_page.js

@@ -205,8 +205,18 @@ TestRunner.mainPage = SC.Page.design({
 
       locationLabel: SC.LabelView.design({
         classNames: ['location-label'],
+        escapeHTML: false,
         layout: { right: 10, centerY: 0, height: 16, left: 100 },
-        valueBinding: SC.Binding.oneWay("TestRunner.testController.displayName")
+        contentBinding: SC.Binding.oneWay("TestRunner.testController.content"),
+        value: function () {
+          var content = this.get('content');
+
+          if (content) {
+            return '<a href="%@" target="_blank">%@</a>'.fmt(content.get('url'), content.get('displayName'));
+          } else {
+            return '';
+          }
+        }.property('content')
       })
 
     }),

data/lib/frameworks/sproutcore/frameworks/ajax/mixins/websocket_delegate.js

@@ -0,0 +1,90 @@
+// ==========================================================================
+// Project:   SC.WebSocket
+// Copyright: ©2013 Nicolas BADIA and contributors
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/** 
+  @namespace
+  
+  A WebSocket Delegate is consulted by `SC.WebSocket` when events are received.
+  You may want to handle this events before propagate them to eventual listeners.
+
+  Example:
+
+    var ws = SC.WebSocket.create({
+      server: 'ws://server',
+      delegate: MyApp.WebSocketDelegate
+    });
+  
+  @since SproutCore 1.11
+  @author Nicolas BADIA
+*/
+SC.WebSocketDelegate = {
+  
+  /**
+    Walk like a duck
+
+    @type Boolean
+  */
+  isWebSocketDelegate: true,
+
+  // ..........................................................
+  // CALLBACKS
+  //
+
+  /**
+    The passed webSocket connection is open.
+
+    @param webSocket {SC.WebSocket} The webSocket object
+    @param event {Event}
+  */
+  webSocketDidOpen: function (webSocket, event) {},
+
+  /**
+    A message has been received. Before processing it, you have
+    a chance to check it. 
+
+    For example, if `isJSON` is true, you will want to check if the message
+    is a correct JSON.
+
+    @param webSocket {SC.WebSocket} The webSocket object
+    @param data {String}  
+    @returns {String|Boolean} Return true to prevent further handling
+  */
+  webSocketDidReceiveMessage: function (webSocket, data) {
+    switch(data) {
+      case 'ping': return true; break;
+    }
+
+    if (this.get('isJSON')) {
+      try {
+        JSON.parse(data);
+      }
+      catch(e) {
+        return true;
+      }
+    }
+  },
+
+  /**
+    The websocket connection is close. Return true to prevent a
+    reconnection or further handling.
+
+    @param webSocket {SC.WebSocket} The webSocket object
+    @param closeEvent {CloseEvent} The closeEvent
+    @returns {Boolean} Return true to prevent further handling
+  */
+  webSocketDidClose: function (webSocket, closeEvent) {},
+
+  /**
+    Call when an error occur.
+
+    @param webSocket {SC.WebSocket} The webSocket object
+    @param event {Event} 
+    @returns {Boolean} Return true to prevent further handling
+  */
+  webSocketDidError: function (webSocket, event) {},
+
+};
+

data/lib/frameworks/sproutcore/frameworks/ajax/system/request.js

@@ -30,6 +30,18 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
   // PROPERTIES
   //
 
+  /**
+    Whether to allow credentials, such as Cookies, in the request. While this has no effect on
+    requests to the same domain, cross-domain requests require that the transport be configured to
+    allow the inclusion of credentials such as Cookies.
+
+    You can change this property using the chainable `credentials()` helper method (or set it directly).
+
+    @type Boolean
+    @default YES
+  */
+  allowCredentials: YES,
+
   /**
     Sends the request asynchronously instead of blocking the browser. You
     should almost always make requests asynchronous. You can change this
@@ -88,6 +100,29 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
     return ret;
   }.property().cacheable(),
 
+  /**
+    Whether the request is within the same domain or not. The response class may use this property
+    to determine specific cross domain configurations.
+
+    @field
+    @type Boolean
+  */
+  isSameDomain: function () {
+    var address = this.get('address'),
+      urlRegex = /^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,
+      location = window.location,
+      parts, originParts;
+
+      // This pattern matching strategy was taken from jQuery.
+      parts = urlRegex.exec( address.toLowerCase()  );
+      originParts = urlRegex.exec( window.location.href.toLowerCase() );
+
+      return SC.none(parts) ||
+        (parts[1] === originParts[1] &&  // protocol
+         parts[2] === originParts[2] &&  // domain
+         (parts[3] || (parts[1] === "http:" ? 80 : 443 ) ) === (originParts[3] || (originParts[1] === "http:" ? 80 : 443))); // port
+  }.property('address').cacheable(),
+
   /**
     Underlying response class to actually handle this request. Currently the
     only supported option is SC.XHRResponse which uses a traditional
@@ -222,7 +257,7 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
   concatenatedProperties: 'COPY_KEYS',
 
   /** @private */
-  COPY_KEYS: ['attachIdentifyingHeaders', 'isAsynchronous', 'isJSON', 'isXML', 'address', 'type', 'timeout', 'body', 'responseClass', 'willSend', 'didSend', 'willReceive', 'didReceive'],
+  COPY_KEYS: ['attachIdentifyingHeaders', 'allowCredentials', 'isAsynchronous', 'isJSON', 'isXML', 'address', 'type', 'timeout', 'body', 'responseClass', 'willSend', 'didSend', 'willReceive', 'didReceive'],
 
   /**
     Returns a copy of the current request. This will only copy certain
@@ -318,6 +353,17 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
     return this.set('isAsynchronous', flag);
   },
 
+  /**
+    Converts the current request to request allowing credentials or not.
+
+    @param {Boolean} flag YES to request allowing credentials, NO to disallow credentials. Default YES.
+    @returns {SC.Request} receiver
+  */
+  credentials: function(flag) {
+    if (flag === undefined) { flag = YES; }
+    return this.set('allowCredentials', flag);
+  },
+
   /**
     Sets the maximum amount of time the request will wait for a response.
 
@@ -480,6 +526,12 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
   notify: function(statusOrEvent, target, action) {
     var args;
 
+    //@if (debug)
+    if (statusOrEvent === 'loadend' && SC.Request.WARN_ON_LOADEND) {
+      SC.warn("Developer Warning: You have called SC.Request#notify for the 'loadend' event. Note that on certain platforms, like older iPads, loadend is not supported and this notification will fail silently. You can protect against this by checking SC.platform.get('supportsXHR2LoadEndEvent'), and attaching listeners for load, error and abort instead. (This is not done automatically because your code may need to handle event type and fire order considerations.) To suppress this warning, set SC.Request.WARN_ON_LOADEND to NO.");
+    }
+    //@endif
+
     // Normalize arguments
     if (SC.typeOf(statusOrEvent) !== SC.T_NUMBER && SC.typeOf(statusOrEvent) !== SC.T_STRING) {
       // Accept multiple additional arguments (Do so before shifting the arguments!)
@@ -571,6 +623,9 @@ SC.Request.mixin(
 
 });
 
+/* @private Gates loadend warning. */
+SC.Request.WARN_ON_LOADEND = YES;
+
 /**
   @class
 
@@ -639,7 +694,7 @@ SC.Request.manager = SC.Object.create(
     Cancels a specific request. If the request is pending it will simply
     be removed. Otherwise it will actually be cancelled.
 
-    @param {Object} response a response object
+    @param {SC.Response} response a response object
     @returns {Boolean} YES if cancelled
   */
   cancel: function(response) {
@@ -682,13 +737,13 @@ SC.Request.manager = SC.Object.create(
         var r = inflight.objectAt(i);
         r.cancel();
       }
-      
+
       // Manually scrub the arrays without screwing up memory pointers.
       pending.replace(0, pendingLen);
       inflight.replace(0, inflightLen);
-      
+
       return YES;
-      
+
     }
     return NO;
   },
@@ -717,8 +772,29 @@ SC.Request.manager = SC.Object.create(
     the transport from the queue and kicks off the next one.
   */
   transportDidClose: function(response) {
+    this.get('pending').removeObject(response);
     this.get('inflight').removeObject(response);
     this.fireRequestIfNeeded();
+  },
+
+  /**
+    Checks if the response is in the pending queue.
+
+    @param {SC.Response} response a response object
+    @return {Boolean} is response in pending queue
+  */
+  isPending: function(response) {
+    return this.get('pending').contains(response);
+  },
+
+  /**
+    Checks if the response is in the inflight queue.
+
+    @param {SC.Response} response a response object
+    @return {Boolean} is response in inflight queue
+  */
+  isInFlight: function(response) {
+    return this.get('inflight').contains(response);
   }
 
 });