sproutcore 0.9.4 → 0.9.5

data/History.txt

@@ -1,5 +1,73 @@
 == SVN HEAD
 
+== SproutCore 0.9.5
+
+* Build Tools will now remove any loc strings from the strings.js file beginning with "@@" for the key name when building the JS file to send to the client.  This allows you to include strings in the strings.js file that you only want to use for server-side localization.
+
+* Build Tools now support the "loc()" ruby helper, which will include a server-side loc string pulled from the strings.js file for the current bundle.
+
+* Collection View now supports selectOnMouseDown which can be turned off to provide better drag and drop behavior on SourceList.  SC.SourceListView now turns this off by default.
+
+* Requesting a resource that should be available in production mode while 
+running your server in dev mode will now work.  Bundles now build one manifest per language/build_mode combination. 
+
+* Build tools now automatically set String.preferredLanguage to the current 
+build language.  This will ensure we start using the current strings when you
+load the loc'd interface.
+
+* Build tools no longer automatically merge .html files into the bundle.
+Instead they are treated like static resources.  If you want to have your html merged into the index, name it .rhtml or .html.erb
+
+* Initial changes to SampleControls to add a form-view demo.  None of the controls are wired up yet.
+
+* Added mongrel as a required dependency of SproutCore.  If you have something
+like thin installed this is technically not required, but several people were
+experiencing trouble installing the gem.
+
+* Lots of Safari-specific features for Photos just to demo some of its capabilities.  Client-side storage support is also provided but currently does not save changes you make.
+
+* SC.CollectionView now supports selectAll (Ctrl+A)
+
+* SC.CollectionView now supports the delete key to remove items.  Also added delegate methods to the collection view delegate to give you control over how deletions happen.
+
+* SC.window can now properly capture the backspace key in Firefox.  To 
+activate this feature you must declare SC.CAPTURE_BACKSPACE_KEY = YES in your
+core.js file.  Capturing the backspace key will prevent the browser from going to previous page when the user hits backspace, which can lead to data loss. To capture this key, SC.window will directly set the document.onkeypress handler.  
+
+* SC.GridView now supports dropping ON items.
+ 
+* SC.ListView now supports dropping ON items.
+
+* Removed the try/catch() that was placed around property notifiers.  This is not only faster but it will make it easier to debug these exceptions in Firebug and IE.
+
+* [FIX] SC.InlineTextFieldView was using the _frame property even though that
+is used by a parent class.  Changed to _optframe
+
+* Improved some documentation here and there.
+
+* [FIX] SC.View will recache its frames when isVisibleInWindow changes.  This will help to ensure we always have the correct dimensions when bringing views on and offscreen. -- All unit tests now pass again.
+
+* Improves Photos sample to include support for adding/deleting albums and drag and drop into albums.
+
+* Collection View now supports dropping items ON item views as well as between
+them. 
+
+* Collection Views now support a delegate object that can be used to control 
+drag and drop and selection behavior.  See mixins/collection_view_delegate.js 
+for a complete description of the new methods.
+
+* SC.ArrayController now supports the useControllersForContent property.  If
+set to YES, then getting an objectAt() will return a controller for the value
+instead of the value itself.  This is useful for those times you are using an
+array controller to manage a set of objects you want to control.  Previously 
+this feature was always used by array controllers and could not be disabled.  
+This is now off by default.
+
+* [FIX] SC.ArrayController and SC.ObjectController now will properly observe
+their own content, even when the content is set on init.
+
+== SproutCore 0.9.4
+
 * [FIX] Build system now generates index.html files for client bundles, even 
 if they do not include .rhtml resources.
 
@@ -19,6 +87,8 @@ notification system.
 * [FIX] The build system now ignored any rhtml files that does not appear in
 an lproj directory since this is where templates are stored.
 
+== SproutCore 0.9.3
+
 * Basic changes to get IE working.  All non-view tests now pass and the doc app and test runner both load and run in IE7.  Lots of visual fixes are still required for the sc-theme as well as IE-specific perf optimization and bug fixes.
 
 * [BUG] Default template for both client and template included a stray comma in their core.js file that breaks IE and Safari 2.  This is fixed in the templates and in the clients included with the framework, though you will need to make this change manually in your own apps.
@@ -46,8 +116,6 @@ will need to implement the InlineEditorDelegate (see documentation).
 
 * Inline editor now displays with a fixed width and grows downward as you type instead of stretching out to the end.
 
---
-
 * Added hello world sample app.
 
 * Updated contacts sample app.  It is much nicer now.

data/Manifest.txt

@@ -39,24 +39,10 @@ clients/sc_test_runner/main.js
 clients/sc_test_runner/models/test.js
 clients/sc_test_runner/views/runner_frame.js
 clients/sc_test_runner/views/test_label.js
-clients/view_builder/builders/builder.js
-clients/view_builder/builders/button.js
-clients/view_builder/controllers/document.js
-clients/view_builder/core.js
-clients/view_builder/english.lproj/body.css
-clients/view_builder/english.lproj/body.rhtml
-clients/view_builder/english.lproj/controls.css
-clients/view_builder/english.lproj/strings.js
-clients/view_builder/main.js
-clients/view_builder/mixins/design_mode.js
-clients/view_builder/tests/controllers/document.rhtml
-clients/view_builder/tests/views/builder.rhtml
-clients/view_builder/tests/views/palette.rhtml
-clients/view_builder/views/builder.js
-clients/view_builder/views/palette.js
 config/hoe.rb
 config/requirements.rb
 frameworks/prototype/prototype.js
+frameworks/sproutcore/animation/animation.js
 frameworks/sproutcore/controllers/array.js
 frameworks/sproutcore/controllers/collection.js
 frameworks/sproutcore/controllers/controller.js
@@ -112,6 +98,7 @@ frameworks/sproutcore/foundation/routes.js
 frameworks/sproutcore/foundation/run_loop.js
 frameworks/sproutcore/foundation/server.js
 frameworks/sproutcore/foundation/set.js
+frameworks/sproutcore/foundation/sorted_set.js
 frameworks/sproutcore/foundation/string.js
 frameworks/sproutcore/foundation/timer.js
 frameworks/sproutcore/foundation/undo_manager.js
@@ -127,6 +114,7 @@ frameworks/sproutcore/lib/form_views.rb
 frameworks/sproutcore/lib/index.rhtml
 frameworks/sproutcore/lib/menu_views.rb
 frameworks/sproutcore/mixins/array.js
+frameworks/sproutcore/mixins/collection_view_delegate.js
 frameworks/sproutcore/mixins/control.js
 frameworks/sproutcore/mixins/delegate_support.js
 frameworks/sproutcore/mixins/editable.js

data/config/hoe.rb

@@ -60,7 +60,7 @@ hoe = Hoe.new(GEM_NAME, VERS) do |p|
   
   # == Optional
   p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
-  p.extra_deps = [['activesupport', '>= 2.0.2'], ['merb-core', '>= 0.9.1'], ['erubis'], ['rubigen'], ]
+  p.extra_deps = [['activesupport', '>= 2.0.2'], ['merb-core', '>= 0.9.1'], ['erubis'], ['rubigen'], ['mongrel']]
   
   #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
   

data/frameworks/sproutcore/animation/animation.js

@@ -0,0 +1,411 @@
+// ========================================================================
+// SproutCore
+// copyright 2006-2008 Sprout Systems, Inc.
+// ========================================================================
+
+require('Core') ;
+require('foundation/timer') ;
+
+/**
+  @class
+  
+  An animator is a special timer that will transition its value property from
+  0 to 1 according to a transform function you define.  You can also specify
+  one or more "subjects" that will be invoked whenever the animation value
+  changes, which can apply the animation to any target you like.
+
+  This class and its related classes are based on Bernie's Better Animator
+  class.
+  
+  Use Cases:
+  
+  1. I just want to transition from x=0 -> x=20.
+    v.transitionTo('styleLeft', 20) ;
+     -> creates an animation for styleLeft.  If you add a new animation for
+        the same effect, it will cancel the old one automatically.
+        
+  2. I want to have an 'animation behavior' attached to some property.  
+     whenever I change it, it should automatically transition the property
+     instead of just updating it.  i.e. a "Tracker".
+     
+     -> I may want the tracker to update several things at once.  But that
+        could be done through changing one property which will in turn 
+        update everything else.  Better idea.
+        
+      Tracker simply stores some animation properties and calls transitionTo
+      whenever your target value changes.
+        
+  3. I want to have some property animating on its own.  For example a 
+     throbbing button
+     
+     a = v.addAnimation('opacity', { 
+       repeatCount: , 
+       autoreverses: YES, 
+       end: 1.0, 
+       start: 0.0,
+       property: 'opacity' 
+      }) ;
+      
+    a.set('isPaused', YES) ;
+    v.removeAnimation('opacity');
+    
+  --
+  We will need an animation builder.  It would be nice if I could have a 
+  complete timeline for an animation setup and you just tell it to run.  Set
+  the timecode to anytime that you want, tell it to start or stop.
+  
+  @extends SC.Timer
+  @author Charles Jolley
+  @since SproutCore 1.0
+*/
+SC.Animation = SC.Timer.extend(
+/** @scope SC.Animation.prototype */ {
+
+  /**
+    The target frame rate.  This is used to determine the interval of the
+    timer.
+    
+    @type {Number}
+    @field
+  */
+  frameRate: 60,
+  
+  /**
+    The interval between frames.  Calculated automatically from the frameRate.
+    This property is read only.
+    
+    @type {Number}
+    @field
+  */
+  interval: function() {
+    return 1000 / this.get('frameRate') ;
+  }.property('frameRate'),
+  
+  /**
+    The total amount of time in msec you want to take for the animation to
+    go from 0-1.
+  */
+  duration: 0,
+  
+  /**
+    The speed at which the timecode for the animation will progress.  1.0
+    means it will progress in real time, 2.0 means twice as fast, etc.
+  */
+  speed: 1.0,
+  
+  /**
+    The total number of times you want the animation to repeat.
+    
+    This can be any number, including partial numbers.  If you set this 
+    value you must not set repeatDuration as well.  This will be ignored 
+    if the value is 0, which is the default.
+    
+    If you set this property to -1, then the animation will repeat
+    indefinitely.
+    
+    Setting this property will update the targetTimecode.
+    
+    @type {Number}
+    @field
+  */
+  repeatCount: 0,
+  
+  /**
+    The total amount of time the animation should run, repeating itself, in
+    msec.
+    
+    If you set this value you must not set repeatCount as well.  This will
+    be ignored if the value is 0, which is the default.
+    
+    Setting this property will update the targetTimecode.
+    
+    @type {Number}
+    @field
+  */
+  repeatDuration: 0,
+  
+  /**
+    If YES, then the animation will automatically reverse itself on each
+    repeat.
+  
+    @type {Boolean}
+    @field
+  */
+  autoreverses: NO,
+  
+  /**
+    A transition function.  This is used to convert the progress into a 
+    state value.  You can supply your own transition function to provide
+    varied behaviors such as ease in, ease out, etc.
+  
+    The function must have a signature like:
+    
+    transition: function(value, animator)
+    
+    It must accept a value from 0-1 indicating the current animation progress
+    and return a value from 0-1 indication the current transition progress.
+    
+    @type {Function}
+    @field
+  */
+  transition: null,
+  
+  /**
+    This is the current timecode for the animation, in msec.  You can set
+    this to any value that you want and the animation to compute the current
+    transition value from it.  
+    
+    To move instantly to any part of your animation, you can simply set this
+    timecode or use jumpTo().
+    
+    @type {Number}
+    @field
+  */
+  currentTimecode: 0,
+
+  /**
+    This is the target timecode.  Whenever the target timecode and the
+    current timecode do not match, the animation will animate until it
+    reaches the target timecode.
+    
+    To transition the animation to a new state, set the timecode to any 
+    value that you want.  
+    
+    @type {Number}
+  */
+  targetTimecode: 0,
+
+  /**
+    The current animation progress.  
+    
+    This value will loop from 0-1 based on the current timecode and the 
+    setting of autoreverses.  You generally do not want to use this value. 
+    Instead use the value property to compute the current transition.
+    
+    @type {Number}
+    @field
+  */
+  progress: function() {
+
+    // current progress is calculated from the currentTimecode by dividing
+    // it by the animation duration and autoreverses.
+    var currentTimecode = this.get('currentTimecode') ;
+    var duration = this.get('duration') ;
+    var reverses = this.get('autoreverses') ;
+    
+    // find the progress through the current cycle.
+    var cycle = Math.floor(currentTimecode / duration) ;
+    var progress = (currentTimecode - (duration * cycle)) / duration;
+    
+    // if we autoreverse and the cycle is odd numbered, invert.
+    if (reverses && (cycle % 2) > 0) progress = 1 - progress ;
+    return progress ;
+  }.property('currentTimecode', 'duration', 'autoreverses'),
+  
+  /**
+    The current animation value.  Transform functions can observe this 
+    property and update the target object accordingly.
+  
+    @type {Number}
+    @field
+  */
+  value: function() {
+    var value = this.get('progress');
+    if (this.transition) value = this.transition(value, this) ;
+    return value ;
+  }.property('progress'),
+  
+  /**
+    The target object of the animation.  This is often used by transform
+    functions as the target of their change.  It is not strictly required.
+    
+    @type {Object}
+    @field
+  */
+  target: null,
+  
+
+  /**
+    This method must be called once when the animation is created to schedule
+    it with the run loop.  Once animation has been started, you should can
+    pause it to remove it from the runloop temporarily.
+    
+    @returns {void}
+  */
+  play: function() {
+    this.beginPropertyChanges() ;
+    if (!this.get('isScheduled')) {
+      this.schedule() ;
+      this._lastActionTime = SC.runLoop.get('startTime') ;
+    }
+    
+    if (this.get('isPaused')) this.set('isPaused', NO) ;
+    this.endPropertyChanges() ;
+  },
+  
+  /**
+    Once an animation has been started, you can pause it anytime with this
+    method.  Call start() to restart it or set isPaused to NO.
+    
+    @returns {void}
+  */
+  pause: function() {
+    this.set('isPaused', YES) ;
+  },
+  
+  /**
+    Immediately changes the currentTimecode to reflect the requested amount
+    of progress through a single cycle of the animation.
+    
+    @param progress {Number} a progress value from 0 to 1.
+    @returns {void}
+  */
+  jumpTo: function(progress) {
+    // get the current progress.
+    var cur = this.get('progress') ;
+    var diff = progress - cur ;
+    var duration = this.get('duration') ;
+    diff *= duration ;
+
+    var timecode = this.get('currentTimecode') ;
+    if (diff !== 0) this.set('currentTimecode', timecode + diff) ;
+  },
+  
+  /**
+    Changes the targetTimecode to reflect the request amount of progress
+    through the current cycle of the animation.  If the animation is in 
+    reverse, this could move the timecode in the opposite direction.
+    
+    @param progress {Number} a progress value from 0 to 1.
+    @returns {void}
+  */
+  seekTo: function(progress) {
+    // get the current progress.
+    var cur = this.get('progress') ;
+    var diff = progress - cur ;
+    var duration = this.get('duration') ;
+    diff *= duration ;
+
+    var timecode = this.get('currentTimecode') ;
+    if (diff !== 0) this.set('targetTimecode', timecode + diff) ;
+  },
+  
+  /**
+    Changes the currentTimecode and targetTimecode to reflect the requested
+    amount of progress through the current cycle of the animation.  If the
+    animation is in reverse, this could move the timecode in the opposite
+    direction.
+    
+    @param fromProgress {Number} a progress value from 0 to 1
+    @param toProgress {Number} a progress value from 0 to 1
+    @returns {void} 
+  */
+  seekFromTo: function(fromProgress, toProgress) {
+    // get the current progress.
+    var timecode = this.get('currentTimecode') ;
+    var cur = this.get('progress') ;
+    var duration = this.get('duration') ;
+
+    this.beginPropertyChanges() ;
+    
+    var diff = fromProgress - cur ;
+    diff *= duration ;
+    if (diff !== 0) this.set('currentTimecode', timecode + diff) ;
+    
+    diff = toProgress - cur ;
+    diff *= duration ;
+    if (diff !== 0) this.set('targetTimecode', timecode + diff) ;
+    
+    this.endPropertyChanges() ;
+  },
+  
+  /**
+    Changes the targetTimecode to invert the direction of the animation.
+    If the progress value is currently headed towards 1.0, it will be instead
+    headed to 0.
+    
+    @returns {Number} the new progress
+  */
+  toggle: function() {
+    throw "toggle not yet implemented" ;
+  },
+  
+  /**
+    The core action executed by the timer.
+  */
+  performAction: function() {
+    
+    // if timecodes match, then we suspend the animation and return, there
+    // is nothing more to do.
+    var cur = this.get('currentTimecode') ;
+    var target = this.get('targetTimecode') ;
+    if (cur == target) {
+      this.set('isPaused', YES) ;
+      return ;
+    }
+    
+    // determine the amount of time that has elapsed since the last time
+    // we were called.
+    var curTime = SC.runLoop.get('startTime') ;
+    var lapsed = (curTime - this._lastActionTime) * this.get('speed') ;
+    this._lastActionTime = curTime ;
+    
+    // update the current timecode.  Moving in the direction of the target
+    // timecode.  If timecodes match, there is nothing to do.
+    if (target > cur) {
+      cur += lapsed ;
+      if (cur > target) cur = target ;
+    } else {
+      cur -= lapsed ;
+      if (cur < target) cur = target ;
+    }
+    
+    // now set the new timecode, this should trigger other observers to
+    // update.
+    this.set('currentTimecode', cur) ;
+  },
+  
+  // ......................................
+  // INTERNAL METHODS
+  //
+  
+  /** @private
+    Observes changes to repeatCount; updates the targetTimecode.
+  */
+  _repeatCountObserver: function() {
+    var repeatCount = this.get('repeatCount') ;
+    var target ;
+    if (repeatCount < 0) {
+      target = Date.now() * 2 ;
+    } else if (repeatCount > 0) {
+      target = this.get('duration') * repeatCount ;
+    } else return ; // nothing to do.
+    this.set('targetTimecode', target) ;
+  }.observes('repeatCount'),
+  
+  /** @private
+    Observes changes to the repeatDuration; updates the targetTimecode.
+  */
+  _repeatDurationObserver: function() {
+    var dur = this.get('repeatDuration') ;
+    if (dur < 0) {
+      dur = Date.now() * 2 ;
+    } else if (dur == 0) return; // nothing to do
+    this.set('targetTimecode', dur) ;
+  }.observes('repeatDuration'),
+
+  init: function() {
+    arguments.callee.base.call(this) ;
+
+    this.targetTimecode = this.get('duration') ;
+    this._repeatDurationObserver() ;
+    this._repeatCountObserver() ;
+  },
+  
+  repeats: YES, // for timer
+  
+  _logValueObserver: function() {
+    console.log('value did change to: %@'.fmt(this.get('value')));
+  }.observes('value') 
+  
+});