sproutit-sproutcore 1.0.0.20090416161445 → 1.0.0.20090720093355

data/frameworks/sproutcore/apps/docs/english.lproj/loading.rhtml

@@ -0,0 +1,9 @@
+<% content_for :loading do %>
+<% # Any HTML in this file will be visible on screen while your page loads
+   # its application JavaScript.  SproutCore applications are optimized for 
+   # caching and startup very fast, so your users will often only see this 
+   # content for a brief moment on their first app load, if at all.
+%>
+<p class="loading">Loading...<p>
+
+<% end %>

data/frameworks/sproutcore/apps/docs/english.lproj/main_page.js

@@ -0,0 +1,22 @@
+// ==========================================================================
+// Project:   Docs - mainPage
+// Copyright: ©2009 My Company, Inc.
+// ==========================================================================
+/*globals Docs */
+
+// This page describes the main user interface for your application.  
+Docs.mainPage = SC.Page.design({
+
+  // The main pane is made visible on screen as soon as your app is loaded.
+  // Add childViews to this pane for views to display immediately on page 
+  // load.
+  mainPane: SC.MainPane.design({
+    childViews: 'labelView'.w(),
+    
+    labelView: SC.LabelView.design({
+      layout: { centerX: 0, centerY: 0, width: 100, height: 18 },
+      tagName: "h1", value: "Hello World"
+    })
+  })
+
+});

data/frameworks/sproutcore/apps/{sc_jsdoc → docs}/english.lproj/strings.js

@@ -1,15 +1,15 @@
 // ==========================================================================
-// JsDoc English Strings
+// Project:   Docs Strings
+// Copyright: ©2009 My Company, Inc.
 // ==========================================================================
+/*globals Docs */
 
-// Place strings you want to localize here.  In your app, use the key and 
+// Place strings you want to localize here.  In your app, use the key and
 // localize it using "key string".loc().  HINT: For your key names, use the
 // english string with an underscore in front.  This way you can still see
 // how your UI will look and you'll notice right away when something needs a
 // localized string added to this file!
-
-Object.extend( String.English, {
-  
+//
+SC.stringsFor('English', {
   // "_String Key": "Localized String"
-  
-});
+}) ;

data/frameworks/sproutcore/apps/docs/main.js

@@ -0,0 +1,30 @@
+// ==========================================================================
+// Project:   Docs
+// Copyright: ©2009 My Company, Inc.
+// ==========================================================================
+/*globals Docs */
+
+// This is the function that will start your app running.  The default
+// implementation will load any fixtures you have created then instantiate
+// your controllers and awake the elements on your page.
+//
+// As you develop your application you will probably want to override this.
+// See comments for some pointers on what to do next.
+//
+Docs.main = function main() {
+
+  // Step 1: Instantiate Your Views
+  // The default code here will make the mainPane for your application visible
+  // on screen.  If you app gets any level of complexity, you will probably 
+  // create multiple pages and panes.  
+  Docs.getPath('mainPage.mainPane').append() ;
+
+  // Step 2. Set the content property on your primary controller.
+  // This will make your app come alive!
+
+  // TODO: Set the content property on your primary controller
+  // ex: .contactsController.set('content',.contacts);
+
+} ;
+
+function main() { Docs.main(); }

data/frameworks/sproutcore/apps/tests/controllers/detail.js

@@ -0,0 +1,16 @@
+// ==========================================================================
+// Project:   TestRunner.detailController
+// Copyright: ©2009 My Company, Inc.
+// ==========================================================================
+/*globals TestRunner */
+
+/** @class
+
+  The currently selected test in detail view.
+
+  @extends SC.ObjectController
+*/
+TestRunner.detailController = SC.ObjectController.create(
+/** @scope TestRunner.detailController.prototype */ {
+  
+}) ;

data/frameworks/sproutcore/apps/tests/controllers/source.js

@@ -0,0 +1,29 @@
+// ==========================================================================
+// Project:   TestRunner.sourceController
+// Copyright: ©2009 My Company, Inc.
+// ==========================================================================
+/*globals TestRunner */
+
+/** @class
+
+  Exposed the flattened list of targets for the source list.  Computed from 
+  the root node generated on the targetsController.  Configure for display of
+  the source list.
+
+  @extends SC.TreeController
+*/
+TestRunner.sourceController = SC.TreeController.create(
+/** @scope TestRunner.sourceController.prototype */ {
+
+  contentBinding: 'TestRunner.targetsController.sourceRoot',
+  treeItemChildrenKey: "children",
+  treeItemIsExpandedKey: "isExpanded",
+  treeItemIsGrouped: YES,
+  
+  allowsMultipleSelection: NO,
+  allowsEmptySelection: NO,
+  
+  // used to set the thickness of the sidebar.  bound here.
+  sidebarThickness: 200  // set default thickness in pixels
+ 
+}) ;

data/frameworks/sproutcore/apps/tests/controllers/target.js

@@ -0,0 +1,26 @@
+// ==========================================================================
+// Project:   TestRunner.targetController
+// Copyright: ©2009 My Company, Inc.
+// ==========================================================================
+/*globals TestRunner */
+
+/** @class
+
+  The currently selected target.  Used by the testsController to get the 
+  tests of the target.  May be used by other parts of the app to control the
+  selected target.
+
+  @extends SC.ObjectController
+*/
+TestRunner.targetController = SC.ObjectController.create(
+/** @scope TestRunner.targetController.prototype */ {
+
+  contentBinding: 'TestRunner.sourceController.selection',
+  
+  nameDidChange: function() {
+    var name = this.get('name');
+    if (name) name = name.slice(1);
+    document.title = "_Window Title".loc(name || '_No Target'.loc());  
+  }.observes('name')
+  
+}) ;

data/frameworks/sproutcore/apps/tests/controllers/targets.js

@@ -1,47 +1,86 @@
 // ==========================================================================
-// Project:   TestRunner.targetController
+// Project:   TestRunner.targetsController
 // Copyright: ©2009 My Company, Inc.
 // ==========================================================================
 /*globals TestRunner */
 
 /** @class
 
-  Manages the targets.  The targets will be displayed and selected in the 
-  source list.
+  The full set of targets available in the application.  This is populated 
+  automatically when you call loadTargets().
 
   @extends SC.ArrayController
 */
 TestRunner.targetsController = SC.ArrayController.create(
-/** @scope TestRunner.targetController.prototype */ {
+/** @scope TestRunner.targetsController.prototype */ {
 
-  allowsEmptySelection: NO,
-  allowsMultipleSelection: NO,
-  
   /**
-    Loads the targets from the server.  When the targets have loaded, adds 
-    them to the store and then sets the local content.
+    Call this method whenever you want to relaod the targets from the server.
   */
-  refresh: function() {
-    SC.Request.getUrl('/sc/targets.json')
-      .notify(this, 'targetsDidRefresh').set('isJSON', YES).send();
+  reload: function() {
+    var targets = TestRunner.store.findAll(TestRunner.Target);
+    this.set('content', targets);
   },
   
-  targetsDidRefresh: function(request) {
-    var json = request.get('response'), len = json.length, idx;
-    for(idx=0;idx<len;idx++) json[idx].guid = json[idx].name ; // patch
-    var targets = SC.Store.updateRecords(json, SC.Store, TestRunner.Target);
-    targets = targets.sort(function(a,b) { 
-      var kindA = a.get('kind'), kindB = b.get('kind');
-      if (kindA < kindB) return -1 ;
-      if (kindA > kindB) return 1 ;
-      if (kindA === kindB) {
-        a = a.get('name'); 
-        b = b.get('name');
-        return (a<b) ? -1 : (a>b) ? 1 : 0;
+  /** 
+    Generates the root array of children objects whenever the target content
+    changes.  Used in a tree node.
+  */
+  sourceRoot: function() {
+    
+    // break targets into their respective types.  Items that should not be 
+    // visible at the top level will not have a sort kind
+    var kinds = {}, keys = [], kind, targets, ret;
+    
+    this.forEach(function(target) { 
+      if (kind = target.get('sortKind')) {
+        targets = kinds[kind];
+        if (!targets) kinds[kind] = targets = [];
+        targets.push(target);
+        if (keys.indexOf(kind) < 0) keys.push(kind);
       }
+    }, this);
+
+    // sort kinds alphabetically - with sproutcore at end and apps at top
+    keys.sort();
+    if (keys.indexOf('sproutcore') >= 0) {
+      keys.removeObject('sproutcore').pushObject('sproutcore');      
+    }
+    if (keys.indexOf('apps') >= 0) {
+      keys.removeObject('apps').unshiftObject('apps');
+    }
+    
+    // once divided into kinds, create group nodes for each kind
+    ret = [];
+    keys.forEach(function(kind) {
+      targets = kinds[kind];
+      
+      var defKey = "SourceList.%@.isExpanded".fmt(kind),
+          expanded = TestRunner.userDefaults.get(defKey);
+      
+      ret.push(SC.Object.create({
+        displayName: "Kind.%@".fmt(kind).loc(),
+        isExpanded: SC.none(expanded) ? (kind !== 'sproutcore') : expanded,
+        children: targets.sortProperty('kind', 'displayName'),
+        
+        isExpandedDefaultKey: defKey,
+        isExpandedDidChange: function() {
+          TestRunner.userDefaults.set(this.get('isExpandedDefaultKey'), this.get('isExpanded'));
+        }.observes('isExpanded')
+      }));
     });
     
-    this.set('content', targets);
-  }
+    return SC.Object.create({ children: ret, isExpanded: YES });
+    
+  }.property('[]').cacheable(),
+  
+  /**
+    Send event when targets load.
+  */
+  stateDidChange: function() {
+    TestRunner.sendAction('targetsDidChange');
+  }.observes('state')
 
 }) ;
+
+TestRunner.targetsController.addProbe('state');

data/frameworks/sproutcore/apps/tests/controllers/tests.js

@@ -1,38 +1,33 @@
 // ==========================================================================
-// Project:   SproutCore Test Runner - mainPage
-// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
-//            Portions ©2008-2009 Apple, Inc. All rights reserved.
-// License:   Licened under MIT license (see license.js)
+// Project:   TestRunner.testsController
+// Copyright: ©2009 My Company, Inc.
 // ==========================================================================
 /*globals TestRunner */
 
 /** @class
 
-  Manages the current selection of tests.
+  Manages the list of tests for the currently focused target.
 
   @extends SC.ArrayController
 */
 TestRunner.testsController = SC.ArrayController.create(
 /** @scope TestRunner.testsController.prototype */ {
 
+  contentBinding: "TestRunner.targetController.tests",
+  
   /**
-    The selected target.  Will be used to load tests.
+    Enables/disables continuous integration mode.
   */
-  targetBinding: SC.Binding.single("TestRunner.targetsController.selection"),
-  
-  contentBinding: "*target.tests",
+  useContinuousIntegration: NO,
   
   /**
-    Bound to the continuous integration checkbox.  If you start running 
-    all tests and this is set to YES, then the runner will loop until it is
-    stopped.
-    
-    @property {Boolean}
+    Whenever we are actually showing the tests, then controls are enabled.
+    Set to YES when in READY_LIST mode.
   */
-  useContinuousIntegration: NO
+  isShowingTests: YES,
+  
+  stateDidChange: function() {
+    TestRunner.sendAction('testsDidChange');
+  }.observes('state')
   
 }) ;
-
-TestRunner.testsController.addProbe('useContinuousIntegration');
-TestRunner.testsController.addProbe('target');
-TestRunner.testsController.addProbe('content');

data/frameworks/sproutcore/apps/tests/core.js

@@ -1,5 +1,5 @@
 // ==========================================================================
-// Project:   SproutCore Test Runner
+// 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)
@@ -8,28 +8,126 @@
 
 /** @namespace
 
-  Test Runner application for SproutCore.  This is a simple application that
-  loads the list of unit tests from the built-in sc-server and then provides
-  an interface for running them.
+  My cool new app.  Describe your application.
   
-  You can access this test runner by visiting:
+  @extends SC.Application
+*/
+TestRunner = SC.Application.create(
+  /** @scope TestRunner.prototype */ {
+
+  NAMESPACE: 'TestRunner',
+  VERSION: '0.1.0',
+
+  // This is your application store.  You will use this store to access all
+  // of your model data.  You can also set a data source on this store to
+  // connect to a backend server.  The default setup below connects the store
+  // to any fixtures you define.
+  store: SC.Store.create().from('TestRunner.DevDataSource'),
   
-  http://localhost:4020/TARGET_NAME/-tests
+  /** Returns all known targets */
+  targets: function() {
+    return this.get('store').findAll(TestRunner.Target);
+  }.property().cacheable(),
   
-  or
+  trace: NO,
   
-  http://localhost:4020/sproutcore/tests#TARGET_NAME
+  userDefaults: SC.UserDefaults.create({
+    userDomain: 'anonymous',
+    appDomain:  'SC.TestRunner'
+  }),
   
-  The source for for the test runner is also heavily documented so you can 
-  use it as an example for building your own applications.  Take a look.
+  // ..........................................................
+  // ROUTE SUPPORT
+  // 
   
-  @extends SC.Object
-*/
-TestRunner = SC.Object.create(/** @scope TestRunner.prototype */ {
+  /**
+    The current route.  This is set whenever the route changes.
+  */
+  route: {},
+  
+  /**
+    Whenever the route changes and it does not match the current state,
+    this will be set to YES.  Whenever states transition, if the route is
+    pending, they will try to move it on to the next step if possible.
+  */
+  routePending: NO,
+  
+  /**
+    Computes the current target as named by the route.  If the target is not
+    found it will return null.  
+  */
+  computeRouteTarget: function() {
+    var name = this.get('route').target;
+    if (!name) return null;
+    else return TestRunner.targetsController.findProperty('name', name);    
+  },
+  
+  /**
+    Computes the current test as named by the route.  If the test is not found
+    it will return null.
+  */
+  computeRouteTest: function() {
+    var name = this.get('route').test;
+    if (!name) return null;
+    else return TestRunner.testsController.findProperty('filename', name);
+  },
+  
+  /**
+    Called whenever the route changes.  Sends an appropriate event down the
+    responder chain.  Also sets the current target.
+  */
+  routeDidChange: function(params) {
+    if (!params.target) return NO; // nothing to do
+    
+    // normalize target + test
+    params = SC.clone(params);
+    if (params.target) params.target = '/' + params.target;
+    if (params.test) params.test   = 'tests/' + params.test ;
+    
+    // save the desired state properties
+    this.set('route', params);
+    this.set('routePending', YES);
+    
+    this.trace = YES;
+    this.sendAction('route', this, params);
+    this.trace=NO;
 
-  NAMESPACE: 'TestRunner',
-  VERSION: '1.0.0',
+    return YES;
+  },
   
-  FIXTURES: []
+  /**
+    Called by the state machine whenever it lands in a stable target state.
+    Pass in the target and test.  We'll update the location and set a new 
+    target route state if needed.
+    
+    Whenever you update the route to the current route state, then 
+    routePending will be cleared.
+    
+    Passing isFinal will force the routePending to go to NO.  pass this when
+    the state is at a dead-end and can't move forward any further.
+  */
+  updateRoute: function(target, test, isFinal) {
+    var route = this.get('route'),
+        loc;
+    
+    if (isFinal || ((target === route.target) && (test === route.test))) {
+      this.set('routePending', NO);
+    }
+
+    // if a route is not pending, then update the current location with the
+    // new route
+    if (!this.get('routePending')) {
+      if (target) target = target.get('name');
+      if (test)   test = test.get('filename');
 
+      loc = target ? target.slice(1) : '';
+      if (test) loc = '%@&test=%@'.fmt(loc, test.slice(6));
+
+      SC.routes.setIfChanged('location', loc);
+    }    
+  }
+  
 }) ;
+
+// Add a route handler to select a target and, optionally, a test.
+SC.routes.add('*target', TestRunner, TestRunner.routeDidChange);