sproutcore 1.9.2 → 1.10.0.rc.1

data/lib/frameworks/sproutcore/frameworks/{experimental/frameworks/designer → designer}/controllers/designs.js

@@ -10,20 +10,20 @@
 /*globals SC */
 /*jslint evil: true*/
 
-/** @class
+/**
 
   (Document Your Controller Here)
-  
+
   this controller is used by Greenhouse to list all of the views in a page files
 
   @extends SC.Object
 */
 SC.designsController = SC.ArrayController.create(SC.CollectionViewDelegate,
 /** @scope SC.designsController.prototype */ {
-  
+
   setDesigns: function(page, iframe){
     var designs = [];
-    
+
     for(var v in page){
       if(page.hasOwnProperty(v)){
         if(v !== '__sc_super__' && page[v] && page[v].kindOf){
@@ -49,39 +49,39 @@ SC.designsController = SC.ArrayController.create(SC.CollectionViewDelegate,
     this.set('content', designs);
     this.set('page', page);
   },
-  
+
   // ..........................................................
   // Drop Target
-  // 
-  
+  //
+
   collectionViewComputeDragOperations: function(view, drag, op){
     return SC.DRAG_ANY;
   },
   /**
     Called by the collection view during a drag to let you determine the
     kind and location of a drop you might want to accept.
-    
+
     You can override this method to implement fine-grained control over how
     and when a dragged item is allowed to be dropped into a collection view.
 
-    This method will be called by the collection view both to determine in 
+    This method will be called by the collection view both to determine in
     general which operations you might support and specifically the operations
     you would support if the user dropped an item over a specific location.
-    
+
     If the `proposedDropOperation` parameter is `SC.DROP_ON` or
     `SC.DROP_BEFORE`, then the `proposedInsertionPoint` will be a
     non-negative value and you should determine the specific operations you
     will support if the user dropped the drag item at that point.
-    
-    If you do not like the proposed drop operation or insertion point, you 
+
+    If you do not like the proposed drop operation or insertion point, you
     can override these properties as well by setting the proposedDropOperation
     and proposedInsertionIndex properties on the collection view during this
     method.  These properties are ignored all other times.
-    
+
     @param view {SC.CollectionView} the collection view
     @param drag {SC.Drag} the current drag object
     @param op {Number} proposed logical OR of allowed drag operations.
-    @param proposedInsertionIndex {Number} an index into the content array 
+    @param proposedInsertionIndex {Number} an index into the content array
       representing the proposed insertion point.
     @param proposedDropOperation {String} the proposed drop operation.  Will be one of SC.DROP_ON, SC.DROP_BEFORE, or SC.DROP_ANY.
     @returns the allowed drag operation.  Defaults to op
@@ -96,17 +96,17 @@ SC.designsController = SC.ArrayController.create(SC.CollectionViewDelegate,
       return (proposedDropOperation & SC.DROP_ON) ? SC.DRAG_NONE : op ;
     }
   },
-  
+
   /**
     Called by the collection view to actually accept a drop.  This method will
     only be invoked *AFTER* your `validateDrop` method has been called to
     determine if you want to even allow the drag operation to go through.
-    
+
     You should actually make changes to the data model if needed here and
     then return the actual drag operation that was performed.  If you return
     SC.DRAG_NONE and the dragOperation was `SC.DRAG_REORDER`, then the default
     reorder behavior will be provided by the collection view.
-    
+
     @param view {SC.CollectionView}
     @param drag {SC.Drag} the current drag object
     @param op {Number} proposed logical OR of allowed drag operations.
@@ -125,12 +125,12 @@ SC.designsController = SC.ArrayController.create(SC.CollectionViewDelegate,
         addItemToPage: function(name){
           scClass = eval(this.getPath('data.scClass'));
           var type = SC.kindOf(scClass, SC.View) ? 'view' : 'controller';
-          
+
           page[name] = scClass.design().create({page: page});
           that.pushObject(SC.Object.create({type: type, view: page.get(name), name: name}));
         }
       });
-      
+
       SC._Greenhouse.sendAction('newPageElement', actionObj);
       return SC.DRAG_ANY;
     }

data/lib/frameworks/sproutcore/frameworks/{experimental/frameworks/designer → designer}/controllers/page_design.js

@@ -6,34 +6,34 @@
 // ==========================================================================
 
 
-/** @class
-  An instance of this controller is created for every page where designers 
-  are involved.  The Designer's themselves will register with the 
+/**
+  An instance of this controller is created for every page where designers
+  are involved.  The Designer's themselves will register with the
   controller so that you can hook to the controller to manage the views and
   their editors.
-  
+
   Among other things, this controller implements global selection support for
   the designers.
-  
+
   @extends SC.Object
   @since SproutCore 1.0
 */
 SC.PageDesignController = SC.Object.extend({
-  
+
   isPageDesignController: YES,
-  
+
   // ..........................................................
   // SELECTION
-  // 
-  
+  //
+
   /** The current view builder selection. */
   selection: null,
-  
-  /** 
-    Updates the selection either by adding the item or by resetting the 
-    selection.  Calling this method with no parameters will reset the 
+
+  /**
+    Updates the selection either by adding the item or by resetting the
+    selection.  Calling this method with no parameters will reset the
     selection.
-    
+
     The passed selection must be a Designer object.
   */
   select: function(sel, extend) {
@@ -47,14 +47,14 @@ SC.PageDesignController = SC.Object.extend({
     }
     return this ;
   },
-  
+
   /**
     Removes the passed items from the current selection.
-    
+
     The passed selection must be a Designer object.
   */
   deselect: function(sel) {
-    
+
     var base = this.get('selection');
     if (base && base.contains(sel)) {
       base = base.copy();
@@ -64,7 +64,7 @@ SC.PageDesignController = SC.Object.extend({
     return this;
   },
   /**
-    Invoked whenever the selection changes.  Updates the selection states 
+    Invoked whenever the selection changes.  Updates the selection states
     on the old and new views.
   */
   selectionDidChange: function() {
@@ -73,29 +73,29 @@ SC.PageDesignController = SC.Object.extend({
 
     // save old selection for next time
     this._selection = sel ;
-    
+
     // set the isSelected state on new selection.
     if (sel) sel.setEach('designIsSelected', YES);
-    
+
     // remove the isSelected state for old selection not in new selection.
     if (oldSel) {
-      oldSel.forEach(function(s){ 
+      oldSel.forEach(function(s){
         if (!sel || !sel.contains(s)) s.set('designIsSelected', NO);
       }, this);
     }
-    
+
   }.observes('selection'),
-  
-  
+
+
   /**
-    Called by a view to reposition the current selection during a mouse 
+    Called by a view to reposition the current selection during a mouse
     drag.
   */
   repositionSelection: function(evt, info) {
     var sel = this.get('selection');
-    if (sel) sel.invoke('mouseReposition', evt, info);  
+    if (sel) sel.invoke('mouseReposition', evt, info);
   },
-  
+
   /**
     Called by a view to prepare all views in selection for repositioning
   */
@@ -108,7 +108,7 @@ SC.PageDesignController = SC.Object.extend({
   */
   deleteSelection: function(){
     var sel = this.get('selection'), first, parentView;
-    
+
     if(sel && sel.get('length') > 0){
       //TODO: delete multi selection
       //this.beginPropertyChanges();
@@ -124,49 +124,49 @@ SC.PageDesignController = SC.Object.extend({
       //this.endPropertyChanges();
     }
   },
-  
-  
+
+
   // ..........................................................
   // DESIGNERS
-  // 
-  
+  //
+
   /** All of the designers on the current page. */
   designers: null,
 
-  /**  
+  /**
     Called by each designer when it is created to register itself with the
-    controller.  You can use this to know which designers are currently in 
+    controller.  You can use this to know which designers are currently in
     the document to delete them as needed.
   */
   registerDesigner: function(designer) {
     this.get('designers').add(designer);
   },
-  
+
   // ..........................................................
   // ROOT DESIGNER
-  // 
+  //
   rootDesigner: null,
-  
+
   makeRootDesigner: function(designer){
     var currRoot = this.get('rootDesigner');
-    
+
     if(currRoot) currRoot.set('isRootDesigner', NO);
-    
+
     this.deselect(designer);
     designer.set('isRootDesigner', YES);
     designer.set('prevRootDesigner', currRoot);
     //TODO: allow greenhouse to highlight the root view!
     this.set('rootDesigner', designer);
   },
-  
-  
+
+
   // ..........................................................
   // INTERNAL SUPPORT
-  // 
+  //
   init: function() {
     this.designers = SC.Set.create();
     this.sel = [];
     sc_super();
   }
-  
-}) ;
+
+}) ;

data/lib/frameworks/sproutcore/frameworks/{experimental/frameworks/designer → designer}/controllers/page_files.js

@@ -9,7 +9,7 @@
 // ==========================================================================
 /*globals SC */
 
-/** @class
+/**
 
   in `suppressMain` mode all page files register with this array controller
 
@@ -17,12 +17,12 @@
 */
 SC.pageFilesController = SC.ArrayController.create(
 /** @scope SC.pageFilesController.prototype */ {
-  
+
 }) ;
 SC.pageFilesController.mixin({
   pages: [],
-  
+
   register: function(page){
     SC.pageFilesController.pages.pushObject(page);
   }
-});
+});

data/lib/frameworks/sproutcore/frameworks/{experimental/frameworks/designer → designer}/css/css_style.js

@@ -8,22 +8,22 @@
 /**
   @class SC.CSSStyle
 
-  A css style object represents a css style that is part of a single css rule 
+  A css style object represents a css style that is part of a single css rule
   in a single css style sheet.
-  
+
   @extends SC.Object
 */
 SC.CSSStyle = SC.Object.extend(
 /** @scope SC.CSSStyle.prototype */ {
-  
+
   /**
-    @property {String} a css string representing the style property
+    @type String a css string representing the style property
   */
   style: '',
-  
+
   /**
     @property {SC.CSSRule} the rule this style is part of
   */
   rule: null
-  
+
 });

data/lib/frameworks/sproutcore/frameworks/{experimental/frameworks/designer → designer}/css/css_style_sheet.js

@@ -12,15 +12,15 @@ sc_require('css/css_rule') ;
 
   A style sheet object wraps a document style sheet object. `C.CSSStyleSheet`
   will re-use stylesheet objects as needed.
-  
+
   @extends SC.Object
 */
 SC.CSSStyleSheet = SC.Object.extend(
 /** @scope SC.CSSStyleSheet.prototype */ {
-  
+
   init: function() {
     sc_super() ;
-    
+
     var ss = this.styleSheet ;
     if (!ss) {
       // create the stylesheet object the hard way (works everywhere)
@@ -30,23 +30,23 @@ SC.CSSStyleSheet = SC.Object.extend(
       if (!head) head = document.documentElement ; // fix for Opera
       head.appendChild(ss) ;
     }
-    
+
     // cache this object for later
     var ssObjects = this.constructor.styleSheets ;
     if (!ssObjects) ssObjects = this.constructor.styleSheets = {} ;
     ssObjects[SC.guidFor(ss)] ;
-    
+
     // create rules array
     var rules = ss.rules || SC.EMPTY_ARRAY ;
     var array = SC.SparseArray.create(rules.length) ;
     array.delegate = this ;
     this.rules = array ;
-    
+
     return this ;
   },
-  
+
   /**
-    @property {Boolean} YES if the stylesheet is enabled.
+    @type Boolean YES if the stylesheet is enabled.
   */
   isEnabled: function(key, val) {
     if (val !== undefined) {
@@ -55,18 +55,18 @@ SC.CSSStyleSheet = SC.Object.extend(
     return !this.styleSheet.disabled ;
   }.property(),
   isEnabledBindingDefault: SC.Binding.bool(),
-  
+
   /**
     **DO NOT MODIFY THIS OBJECT DIRECTLY!!!!** Use the methods defined on this
-    object to update properties of the style sheet; otherwise, your changes 
+    object to update properties of the style sheet; otherwise, your changes
     will not be reflected.
-    
-    @property {CSSStyleSheet} RO
+
+    @type CSSStyleSheet RO
   */
   styleSheet: null,
-  
+
   /**
-    @property {String}
+    @type String
   */
   href: function(key, val) {
     if (val !== undefined) {
@@ -74,9 +74,9 @@ SC.CSSStyleSheet = SC.Object.extend(
     }
     else return this.styleSheet.href ;
   }.property(),
-  
+
   /**
-    @property {String}
+    @type String
   */
   title: function(key, val) {
     if (val !== undefined) {
@@ -84,19 +84,19 @@ SC.CSSStyleSheet = SC.Object.extend(
     }
     else return this.styleSheet.title ;
   }.property(),
-  
+
   /**
-    @property {SC.Array} contains SC.CSSRule objects
+    @type SC.Array contains SC.CSSRule objects
   */
   rules: null,
-  
+
   /**
     You can also insert and remove rules on the rules property array.
   */
   insertRule: function(rule) {
     var rules = this.get('rules') ;
   },
-  
+
   /**
     You can also insert and remove rules on the rules property array.
   */
@@ -104,13 +104,13 @@ SC.CSSStyleSheet = SC.Object.extend(
     var rules = this.get('rules') ;
     rules.removeObject(rule) ;
   },
-  
+
   // TODO: implement a destroy method
-  
+
   /**
     @private
-    
-    Invoked by the sparse array whenever it needs a particular index 
+
+    Invoked by the sparse array whenever it needs a particular index
     provided.  Provide the content for the index.
   */
   sparseArrayDidRequestIndex: function(array, idx) {
@@ -118,48 +118,48 @@ SC.CSSStyleSheet = SC.Object.extend(
     var rules = this.styleSheet.rules || SC.EMPTY_ARRAY ;
     var rule = rules[idx] ;
     if (rule) {
-      array.provideContentAtIndex(idx, SC.CSSRule.create({ 
+      array.provideContentAtIndex(idx, SC.CSSRule.create({
         rule: rule,
         styleSheet: this
-      })); 
+      }));
     }
   },
-  
+
   /** @private synchronize the browser's rules array with our own */
   sparseArrayDidReplace: function(array, idx, amt, objects) {
     var cssRules = objects.collect(function(obj) { return obj.rule; }) ;
     this.styleSheet.rules.replace(idx, amt, cssRules) ;
   }
-  
+
 });
 
 SC.mixin(SC.CSSStyleSheet,
 /** SC.CSSStyleSheet */{
-  
+
   /**
     Find a stylesheet object by name or href. If by name, `.css` will be
     appended automatically.
-    
+
         var ss = SC.CSSStyleSheet.find('style.css') ;
         var ss2 = SC.CSSStyleSheet.find('style') ; // same thing
         sc_assert(ss === ss2) ; // SC.CSSStyleSheet objects are stable
-    
+
     @param {String} nameOrUrl a stylesheet name or href to find
     @returns {SC.CSSStyleSheet} null if not found
   */
   find: function(nameOrUrl) {
     var isUrl = nameOrUrl ? nameOrUrl.indexOf('/') >= 0 : NO ;
-    
+
     if (!nameOrUrl) return null ; // no name or url? fail!
-    
+
     if (!isUrl && nameOrUrl.indexOf('.css') == -1) {
       nameOrUrl = nameOrUrl + '.css' ;
     }
-    
+
     // initialize styleSheet cache
     var ssObjects = this.styleSheets ;
     if (!ssObjects) ssObjects = this.styleSheets = {} ;
-    
+
     var styleSheets = document.styleSheets ;
     var ss, ssName, ssObject, guid ;
     for (var idx=0, len=styleSheets.length; idx < len; ++idx) {
@@ -193,7 +193,7 @@ SC.mixin(SC.CSSStyleSheet,
     }
     return null ; // stylesheet not found
   },
-  
+
   styleSheets: null
-  
+
 });