From d599169f86b55f27be4cd68bbcad394131ea3ba7 Mon Sep 17 00:00:00 2001 From: Marcelo Giorgi Date: Fri, 23 Mar 2012 09:10:50 -0300 Subject: [PATCH] Update to Ember.js 0.9.5 --- vendor/assets/javascripts/ember.js | 15552 +++++++++++++++------------ 1 file changed, 8448 insertions(+), 7104 deletions(-) diff --git a/vendor/assets/javascripts/ember.js b/vendor/assets/javascripts/ember.js index 0c8b76f..d5a775e 100644 --- a/vendor/assets/javascripts/ember.js +++ b/vendor/assets/javascripts/ember.js @@ -1,3 +1,132 @@ +(function(exports) { +/*global __fail__*/ +/** + Define an assertion that will throw an exception if the condition is not + met. Ember build tools will remove any calls to ember_assert() when + doing a production build. + + ## Examples + + #js: + + // pass a simple Boolean value + ember_assert('must pass a valid object', !!obj); + + // pass a function. If the function returns false the assertion fails + // any other return value (including void) will pass. + ember_assert('a passed record must have a firstName', function() { + if (obj instanceof Ember.Record) { + return !Ember.empty(obj.firstName); + } + }); + + @static + @function + @param {String} desc + A description of the assertion. This will become the text of the Error + thrown if the assertion fails. + + @param {Boolean} test + Must return true for the assertion to pass. If you pass a function it + will be executed. If the function returns false an exception will be + thrown. +*/ +window.ember_assert = window.sc_assert = function ember_assert(desc, test) { + if ('function' === typeof test) test = test()!==false; + if (!test) throw new Error("assertion failed: "+desc); +}; + + +/** + Display a warning with the provided message. Ember build tools will + remove any calls to ember_warn() when doing a production build. + + @static + @function + @param {String} message + A warning to display. + + @param {Boolean} test + An optional boolean or function. If the test returns false, the warning + will be displayed. +*/ +window.ember_warn = function(message, test) { + if (arguments.length === 1) { test = false; } + if ('function' === typeof test) test = test()!==false; + if (!test) console.warn("WARNING: "+message); +}; + +/** + Display a deprecation warning with the provided message and a stack trace + (Chrome and Firefox only). Ember build tools will remove any calls to + ember_deprecate() when doing a production build. + + @static + @function + @param {String} message + A description of the deprecation. + + @param {Boolean} test + An optional boolean or function. If the test returns false, the deprecation + will be displayed. +*/ +window.ember_deprecate = function(message, test) { + if (Ember.TESTING_DEPRECATION) { return; } + + if (arguments.length === 1) { test = false; } + if ('function' === typeof test) { test = test()!==false; } + if (test) { return; } + + if (Ember.ENV.RAISE_ON_DEPRECATION) { throw new Error(message); } + + var error, stackStr = ''; + + // When using new Error, we can't do the arguments check for Chrome. Alternatives are welcome + try { __fail__.fail(); } catch (e) { error = e; } + + if (error.stack) { + var stack; + + if (error['arguments']) { + // Chrome + stack = error.stack.replace(/^\s+at\s+/gm, ''). + replace(/^([^\(]+?)([\n$])/gm, '{anonymous}($1)$2'). + replace(/^Object.\s*\(([^\)]+)\)/gm, '{anonymous}($1)').split('\n'); + stack.shift(); + } else { + // Firefox + stack = error.stack.replace(/(?:\n@:0)?\s+$/m, ''). + replace(/^\(/gm, '{anonymous}(').split('\n'); + } + + stackStr = "\n " + stack.slice(2).join("\n "); + } + + console.warn("DEPRECATION: "+message+stackStr); +}; + + + +/** + Display a deprecation warning with the provided message and a stack trace + (Chrome and Firefox only) when the wrapped method is called. + + @static + @function + @param {String} message + A description of the deprecation. + + @param {Function} func + The function to be deprecated. +*/ +window.ember_deprecateFunc = function(message, func) { + return function() { + window.ember_deprecate(message); + return func.apply(this, arguments); + }; +}; + +})({}); (function(exports) { // lib/handlebars/base.js @@ -107,85 +236,85 @@ performAction: function anonymous(yytext,yyleng,yylineno,yy,yystate,$$,_$) { var $0 = $$.length - 1; switch (yystate) { -case 1: return $$[$0-1] +case 1: return $$[$0-1] break; -case 2: this.$ = new yy.ProgramNode($$[$0-2], $$[$0]) +case 2: this.$ = new yy.ProgramNode($$[$0-2], $$[$0]) break; -case 3: this.$ = new yy.ProgramNode($$[$0]) +case 3: this.$ = new yy.ProgramNode($$[$0]) break; -case 4: this.$ = new yy.ProgramNode([]) +case 4: this.$ = new yy.ProgramNode([]) break; -case 5: this.$ = [$$[$0]] +case 5: this.$ = [$$[$0]] break; -case 6: $$[$0-1].push($$[$0]); this.$ = $$[$0-1] +case 6: $$[$0-1].push($$[$0]); this.$ = $$[$0-1] break; -case 7: this.$ = new yy.InverseNode($$[$0-2], $$[$0-1], $$[$0]) +case 7: this.$ = new yy.InverseNode($$[$0-2], $$[$0-1], $$[$0]) break; -case 8: this.$ = new yy.BlockNode($$[$0-2], $$[$0-1], $$[$0]) +case 8: this.$ = new yy.BlockNode($$[$0-2], $$[$0-1], $$[$0]) break; -case 9: this.$ = $$[$0] +case 9: this.$ = $$[$0] break; -case 10: this.$ = $$[$0] +case 10: this.$ = $$[$0] break; -case 11: this.$ = new yy.ContentNode($$[$0]) +case 11: this.$ = new yy.ContentNode($$[$0]) break; -case 12: this.$ = new yy.CommentNode($$[$0]) +case 12: this.$ = new yy.CommentNode($$[$0]) break; -case 13: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) +case 13: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) break; -case 14: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) +case 14: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) break; -case 15: this.$ = $$[$0-1] +case 15: this.$ = $$[$0-1] break; -case 16: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) +case 16: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1]) break; -case 17: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], true) +case 17: this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], true) break; -case 18: this.$ = new yy.PartialNode($$[$0-1]) +case 18: this.$ = new yy.PartialNode($$[$0-1]) break; -case 19: this.$ = new yy.PartialNode($$[$0-2], $$[$0-1]) +case 19: this.$ = new yy.PartialNode($$[$0-2], $$[$0-1]) break; -case 20: +case 20: break; -case 21: this.$ = [[$$[$0-2]].concat($$[$0-1]), $$[$0]] +case 21: this.$ = [[$$[$0-2]].concat($$[$0-1]), $$[$0]] break; -case 22: this.$ = [[$$[$0-1]].concat($$[$0]), null] +case 22: this.$ = [[$$[$0-1]].concat($$[$0]), null] break; -case 23: this.$ = [[$$[$0-1]], $$[$0]] +case 23: this.$ = [[$$[$0-1]], $$[$0]] break; -case 24: this.$ = [[$$[$0]], null] +case 24: this.$ = [[$$[$0]], null] break; -case 25: $$[$0-1].push($$[$0]); this.$ = $$[$0-1]; +case 25: $$[$0-1].push($$[$0]); this.$ = $$[$0-1]; break; -case 26: this.$ = [$$[$0]] +case 26: this.$ = [$$[$0]] break; -case 27: this.$ = $$[$0] +case 27: this.$ = $$[$0] break; -case 28: this.$ = new yy.StringNode($$[$0]) +case 28: this.$ = new yy.StringNode($$[$0]) break; -case 29: this.$ = new yy.IntegerNode($$[$0]) +case 29: this.$ = new yy.IntegerNode($$[$0]) break; -case 30: this.$ = new yy.BooleanNode($$[$0]) +case 30: this.$ = new yy.BooleanNode($$[$0]) break; -case 31: this.$ = new yy.HashNode($$[$0]) +case 31: this.$ = new yy.HashNode($$[$0]) break; -case 32: $$[$0-1].push($$[$0]); this.$ = $$[$0-1] +case 32: $$[$0-1].push($$[$0]); this.$ = $$[$0-1] break; -case 33: this.$ = [$$[$0]] +case 33: this.$ = [$$[$0]] break; -case 34: this.$ = [$$[$0-2], $$[$0]] +case 34: this.$ = [$$[$0-2], $$[$0]] break; -case 35: this.$ = [$$[$0-2], new yy.StringNode($$[$0])] +case 35: this.$ = [$$[$0-2], new yy.StringNode($$[$0])] break; -case 36: this.$ = [$$[$0-2], new yy.IntegerNode($$[$0])] +case 36: this.$ = [$$[$0-2], new yy.IntegerNode($$[$0])] break; -case 37: this.$ = [$$[$0-2], new yy.BooleanNode($$[$0])] +case 37: this.$ = [$$[$0-2], new yy.BooleanNode($$[$0])] break; -case 38: this.$ = new yy.IdNode($$[$0]) +case 38: this.$ = new yy.IdNode($$[$0]) break; -case 39: $$[$0-2].push($$[$0]); this.$ = $$[$0-2]; +case 39: $$[$0-2].push($$[$0]); this.$ = $$[$0-2]; break; -case 40: this.$ = [$$[$0]] +case 40: this.$ = [$$[$0]] break; } }, @@ -470,7 +599,7 @@ next:function () { if (this._input === "") { return this.EOF; } else { - this.parseError('Lexical error on line '+(this.yylineno+1)+'. Unrecognized text.\n'+this.showPosition(), + this.parseError('Lexical error on line '+(this.yylineno+1)+'. Unrecognized text.\n'+this.showPosition(), {text: "", token: null, line: this.yylineno}); } }, @@ -495,57 +624,57 @@ lexer.performAction = function anonymous(yy,yy_,$avoiding_name_collisions,YY_STA var YYSTATE=YY_START switch($avoiding_name_collisions) { -case 0: this.begin("mu"); if (yy_.yytext) return 14; +case 0: this.begin("mu"); if (yy_.yytext) return 14; break; -case 1: return 14; +case 1: return 14; break; -case 2: return 24; +case 2: return 24; break; -case 3: return 16; +case 3: return 16; break; -case 4: return 20; +case 4: return 20; break; -case 5: return 19; +case 5: return 19; break; -case 6: return 19; +case 6: return 19; break; -case 7: return 23; +case 7: return 23; break; -case 8: return 23; +case 8: return 23; break; -case 9: yy_.yytext = yy_.yytext.substr(3,yy_.yyleng-5); this.begin("INITIAL"); return 15; +case 9: yy_.yytext = yy_.yytext.substr(3,yy_.yyleng-5); this.begin("INITIAL"); return 15; break; -case 10: return 22; +case 10: return 22; break; -case 11: return 34; +case 11: return 34; break; -case 12: return 33; +case 12: return 33; break; -case 13: return 33; +case 13: return 33; break; -case 14: return 36; +case 14: return 36; break; -case 15: /*ignore whitespace*/ +case 15: /*ignore whitespace*/ break; -case 16: this.begin("INITIAL"); return 18; +case 16: this.begin("INITIAL"); return 18; break; -case 17: this.begin("INITIAL"); return 18; +case 17: this.begin("INITIAL"); return 18; break; -case 18: yy_.yytext = yy_.yytext.substr(1,yy_.yyleng-2).replace(/\\"/g,'"'); return 28; +case 18: yy_.yytext = yy_.yytext.substr(1,yy_.yyleng-2).replace(/\\"/g,'"'); return 28; break; -case 19: return 30; +case 19: return 30; break; -case 20: return 30; +case 20: return 30; break; -case 21: return 29; +case 21: return 29; break; -case 22: return 33; +case 22: return 33; break; -case 23: yy_.yytext = yy_.yytext.substr(1, yy_.yyleng-2); return 33; +case 23: yy_.yytext = yy_.yytext.substr(1, yy_.yyleng-2); return 33; break; -case 24: return 'INVALID'; +case 24: return 'INVALID'; break; -case 25: return 5; +case 25: return 5; break; } }; @@ -1602,13 +1731,13 @@ Handlebars.template = Handlebars.VM.template; // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals ENV ember_assert */ +/*globals Em:true ENV */ if ('undefined' === typeof Ember) { /** @namespace @name Ember - @version 0.9.4 + @version 0.9.5 All Ember methods and functions are defined inside of this namespace. You generally should not add new properties to this namespace as it may be @@ -1616,10 +1745,10 @@ if ('undefined' === typeof Ember) { You can also use the shorthand "Em" instead of "Ember". - Ember-Runtime is a framework that provides core functions for - Ember including cross-platform functions, support for property - observing and objects. Its focus is on small size and performance. You can - use this in place of or along-side other cross-platform libraries such as + Ember-Runtime is a framework that provides core functions for + Ember including cross-platform functions, support for property + observing and objects. Its focus is on small size and performance. You can + use this in place of or along-side other cross-platform libraries such as jQuery. The core Runtime framework is based on the jQuery API with a number of @@ -1632,7 +1761,7 @@ Ember = { isNamespace: true, toString: function() { return "Ember"; } }; // aliases needed to keep minifiers from removing the global context if ('undefined' !== typeof window) { - window.SC = window.SproutCore = window.Em = window.Ember = SC = SproutCore = Em = Ember; + window.Em = window.Ember = Em = Ember; } } @@ -1640,22 +1769,57 @@ if ('undefined' !== typeof window) { /** @static @type String - @default '0.9.4' + @default '0.9.5' @constant */ -Ember.VERSION = '0.9.4'; +Ember.VERSION = '0.9.5'; /** @static @type Hash @constant - + Standard environmental variables. You can define these in a global `ENV` - variable before loading Ember to control various configuration + variable before loading Ember to control various configuration settings. */ Ember.ENV = 'undefined' === typeof ENV ? {} : ENV; + +// .......................................................... +// BOOTSTRAP +// + +/** + @static + @type Boolean + @default true + @constant + + Determines whether Ember should enhances some built-in object + prototypes to provide a more friendly API. If enabled, a few methods + will be added to Function, String, and Array. Object.prototype will not be + enhanced, which is the one that causes most troubles for people. + + In general we recommend leaving this option set to true since it rarely + conflicts with other code. If you need to turn it off however, you can + define an ENV.EXTEND_PROTOTYPES config to disable it. +*/ +Ember.EXTEND_PROTOTYPES = (Ember.ENV.EXTEND_PROTOTYPES !== false); + + +/** + @static + @type Boolean + @default Ember.EXTEND_PROTOTYPES + @constant + + Determines whether Ember should add ECMAScript 5 shims to older browsers. +*/ +Ember.SHIM_ES5 = (Ember.ENV.SHIM_ES5 === false) ? false : Ember.EXTEND_PROTOTYPES; + + + /** Empty function. Useful for some operations. @@ -1670,48 +1834,24 @@ Ember.K = function() { return this; }; @description The global window object */ -/** - Define an assertion that will throw an exception if the condition is not - met. Ember build tools will remove any calls to ember_assert() when - doing a production build. - - ## Examples - - #js: - - // pass a simple Boolean value - ember_assert('must pass a valid object', !!obj); - // pass a function. If the function returns false the assertion fails - // any other return value (including void) will pass. - ember_assert('a passed record must have a firstName', function() { - if (obj instanceof Ember.Record) { - return !Ember.empty(obj.firstName); - } - }); - - @static - @function - @param {String} desc - A description of the assertion. This will become the text of the Error - thrown if the assertion fails. - - @param {Boolean} test - Must return true for the assertion to pass. If you pass a function it - will be executed. If the function returns false an exception will be - thrown. -*/ -window.ember_assert = window.sc_assert = function ember_assert(desc, test) { - if ('function' === typeof test) test = test()!==false; - if (!test) throw new Error("assertion failed: "+desc); -}; +// Stub out the methods defined by the ember-debug package in case it's not loaded -//if ('undefined' === typeof ember_require) ember_require = Ember.K; -if ('undefined' === typeof require) require = Ember.K; +if ('undefined' === typeof ember_assert) { + window.ember_assert = Ember.K; +} + +if ('undefined' === typeof ember_warn) { window.ember_warn = Ember.K; } + +if ('undefined' === typeof ember_deprecate) { window.ember_deprecate = Ember.K; } + +if ('undefined' === typeof ember_deprecateFunc) { + window.ember_deprecateFunc = function(_, func) { return func; }; +} // .......................................................... // LOGGER -// +// /** @class @@ -1723,14 +1863,13 @@ Ember.Logger = window.console || { log: Ember.K, warn: Ember.K, error: Ember.K } })({}); - (function(exports) { // ========================================================================== // Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals ember_assert */ +/*globals Node */ /** @class @@ -1748,6 +1887,7 @@ var platform = Ember.platform = {} ; platform.create = Object.create; if (!platform.create) { + /** @private */ var O_ctor = function() {}, O_proto = O_ctor.prototype; @@ -1769,13 +1909,16 @@ if (!platform.create) { platform.create.isSimulated = true; } -var defineProperty = Object.defineProperty, canRedefineProperties, canDefinePropertyOnDOM; +/** @private */ +var defineProperty = Object.defineProperty; +var canRedefineProperties, canDefinePropertyOnDOM; // Catch IE8 where Object.defineProperty exists but only works on DOM elements if (defineProperty) { try { defineProperty({}, 'a',{get:function(){}}); } catch (e) { + /** @private */ defineProperty = null; } } @@ -1783,6 +1926,7 @@ if (defineProperty) { if (defineProperty) { // Detects a bug in Android <3.2 where you cannot redefine a property using // Object.defineProperty once accessors have already been set. + /** @private */ canRedefineProperties = (function() { var obj = {}; @@ -1805,10 +1949,10 @@ if (defineProperty) { // This is for Safari 5.0, which supports Object.defineProperty, but not // on DOM nodes. - + /** @private */ canDefinePropertyOnDOM = (function(){ try { - defineProperty(document.body, 'definePropertyOnDOM', {}); + defineProperty(document.createElement('div'), 'definePropertyOnDOM', {}); return true; } catch(e) { } @@ -1816,8 +1960,10 @@ if (defineProperty) { })(); if (!canRedefineProperties) { + /** @private */ defineProperty = null; } else if (!canDefinePropertyOnDOM) { + /** @private */ defineProperty = function(obj, keyName, desc){ var isNode; @@ -1871,7 +2017,6 @@ if (!platform.defineProperty) { })({}); - (function(exports) { // ========================================================================== // Project: Ember Metal @@ -1880,7 +2025,7 @@ if (!platform.defineProperty) { // ========================================================================== // .......................................................... // GUIDS -// +// // Used for guid generation... var GUID_KEY = '__ember'+ (+ new Date()); @@ -1890,7 +2035,7 @@ uuid = 0; numberCache = []; stringCache = {}; -var GUID_DESC = { +var GUID_DESC = Ember.GUID_DESC = { configurable: true, writable: true, enumerable: false @@ -1909,7 +2054,7 @@ var o_create = Ember.platform.create; If you inspect an object in your browser debugger you will often see these. They can be safely ignored. - On browsers that support it, these properties are added with enumeration + On browsers that support it, these properties are added with enumeration disabled so they won't show up when you iterate over your properties. */ Ember.GUID_KEY = GUID_KEY; @@ -1923,7 +2068,7 @@ Ember.GUID_KEY = GUID_KEY; @param {Object} obj Optional object the guid will be used for. If passed in, the guid will - be saved on the object and reused whenever you pass the same object + be saved on the object and reused whenever you pass the same object again. If no object is passed, just generate a new guid. @@ -1994,7 +2139,7 @@ Ember.guidFor = function(obj) { // .......................................................... // META -// +// var META_DESC = { writable: true, @@ -2017,29 +2162,31 @@ Ember.META_KEY = META_KEY; var EMPTY_META = { descs: {}, watching: {} -}; +}; if (Object.freeze) Object.freeze(EMPTY_META); +var createMeta = Ember.platform.defineProperty.isSimulated ? o_create : (function(meta) { return meta; }); + /** @private @function - + Retrieves the meta hash for an object. If 'writable' is true ensures the hash is writable for this object as well. - + The meta object contains information about computed property descriptors as well as any watched properties and other information. You generally will - not access this information directly but instead work with higher level - methods that manipulate this has indirectly. + not access this information directly but instead work with higher level + methods that manipulate this hash indirectly. @param {Object} obj The object to retrieve meta for - + @param {Boolean} writable - Pass false if you do not intend to modify the meta hash, allowing the + Pass false if you do not intend to modify the meta hash, allowing the method to avoid making an unnecessary copy. - + @returns {Hash} */ Ember.meta = function meta(obj, writable) { @@ -2049,26 +2196,29 @@ Ember.meta = function meta(obj, writable) { if (!ret) { o_defineProperty(obj, META_KEY, META_DESC); - ret = obj[META_KEY] = { + ret = obj[META_KEY] = createMeta({ descs: {}, watching: {}, values: {}, lastSetValues: {}, cache: {}, source: obj - }; - + }); + // make sure we don't accidentally try to create constructor like desc ret.descs.constructor = null; - + } else if (ret.source !== obj) { - ret = obj[META_KEY] = o_create(ret); + ret = o_create(ret); ret.descs = o_create(ret.descs); ret.values = o_create(ret.values); ret.watching = o_create(ret.watching); ret.lastSetValues = {}; ret.cache = {}; ret.source = obj; + + o_defineProperty(obj, META_KEY, META_DESC); + ret = obj[META_KEY] = createMeta(ret); } return ret; }; @@ -2142,19 +2292,19 @@ Ember.metaPath = function(obj, path, writable) { Wraps the passed function so that `this._super` will point to the superFunc when the function is invoked. This is the primitive we use to implement calls to super. - + @param {Function} func The function to call - + @param {Function} superFunc The super function. - + @returns {Function} wrapped function. */ Ember.wrap = function(func, superFunc) { - + function K() {} - + var newFunc = function() { var ret, sup = this._super; this._super = superFunc || K; @@ -2162,15 +2312,15 @@ Ember.wrap = function(func, superFunc) { this._super = sup; return ret; }; - + newFunc.base = func; return newFunc; }; /** @function - - Returns YES if the passed object is an array or Array-like. + + Returns true if the passed object is an array or Array-like. Ember Array Protocol: @@ -2196,12 +2346,12 @@ Ember.isArray = function(obj) { Forces the passed object to be part of an array. If the object is already an array or array-like, returns the object. Otherwise adds the object to an array. If obj is null or undefined, returns an empty array. - + @param {Object} obj the object @returns {Array} */ Ember.makeArray = function(obj) { - if (obj==null) return []; + if (obj === null || obj === undefined) return []; return Ember.isArray(obj) ? obj : [obj]; }; @@ -2209,7 +2359,6 @@ Ember.makeArray = function(obj) { })({}); - (function(exports) { // ========================================================================== // Project: Ember Metal @@ -2224,7 +2373,7 @@ var meta = Ember.meta; // .......................................................... // GET AND SET -// +// // If we are on a platform that supports accessors we can get use those. // Otherwise simulate accessors by looking up the property directly on the // object. @@ -2237,7 +2386,7 @@ get = function get(obj, keyName) { keyName = obj; obj = Ember; } - + if (!obj) return undefined; var ret = obj[keyName]; if (ret===undefined && 'function'===typeof obj.unknownProperty) { @@ -2263,7 +2412,8 @@ set = function set(obj, keyName, value) { if (!USE_ACCESSORS) { var o_get = get, o_set = set; - + + /** @private */ get = function(obj, keyName) { if (keyName === undefined && 'string' === typeof obj) { keyName = obj; @@ -2278,6 +2428,7 @@ if (!USE_ACCESSORS) { else return o_get(obj, keyName); }; + /** @private */ set = function(obj, keyName, value) { ember_assert("You need to provide an object and key to `set`.", !!obj && keyName !== undefined); var desc = meta(obj, false).descs[keyName]; @@ -2290,72 +2441,73 @@ if (!USE_ACCESSORS) { /** @function - + Gets the value of a property on an object. If the property is computed, - the function will be invoked. If the property is not defined but the + the function will be invoked. If the property is not defined but the object implements the unknownProperty() method then that will be invoked. - - If you plan to run on IE8 and older browsers then you should use this + + If you plan to run on IE8 and older browsers then you should use this method anytime you want to retrieve a property on an object that you don't - know for sure is private. (My convention only properties beginning with + know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) - - On all newer browsers, you only need to use this method to retrieve + + On all newer browsers, you only need to use this method to retrieve properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. - - Note that if the obj itself is null, this method will simply return + + Note that if the obj itself is null, this method will simply return undefined. - + @param {Object} obj The object to retrieve from. - + @param {String} keyName The property key to retrieve - + @returns {Object} the property value or null. */ Ember.get = get; /** - @function - + @function + Sets the value of a property on an object, respecting computed properties - and notifying observers and other listeners of the change. If the + and notifying observers and other listeners of the change. If the property is not defined but the object implements the unknownProperty() method then that will be invoked as well. - - If you plan to run on IE8 and older browsers then you should use this + + If you plan to run on IE8 and older browsers then you should use this method anytime you want to set a property on an object that you don't - know for sure is private. (My convention only properties beginning with + know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) - - On all newer browsers, you only need to use this method to set + + On all newer browsers, you only need to use this method to set properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. - + @param {Object} obj The object to modify. - + @param {String} keyName The property key to set - + @param {Object} value The value to set - + @returns {Object} the passed value. */ Ember.set = set; // .......................................................... // PATHS -// +// +/** @private */ function normalizePath(path) { ember_assert('must pass non-empty string to normalizePath()', path && path!==''); - + if (path==='*') return path; //special case... var first = path.charAt(0); if(first==='.') return 'this'+path; @@ -2364,9 +2516,10 @@ function normalizePath(path) { } // assumes normalized input; no *, normalized path, always a target... +/** @private */ function getPath(target, path) { var len = path.length, idx, next, key; - + idx = path.indexOf('*'); if (idx>0 && path.charAt(idx-1)!=='.') { return getPath(getPath(target, path.slice(0, idx)), path.slice(idx+1)); @@ -2392,11 +2545,13 @@ var IS_GLOBAL_PATH = /^([A-Z$]|([0-9][A-Z$])).*[\.\*]/; var HAS_THIS = /^this[\.\*]/; var FIRST_KEY = /^([^\.\*]+)/; +/** @private */ function firstKey(path) { return path.match(FIRST_KEY)[0]; } // assumes path is already normalized +/** @private */ function normalizeTuple(target, path) { var hasThis = HAS_THIS.test(path), isGlobal = !hasThis && IS_GLOBAL_PATH.test(path), @@ -2404,10 +2559,10 @@ function normalizeTuple(target, path) { if (!target || isGlobal) target = window; if (hasThis) path = path.slice(5); - + var idx = path.indexOf('*'); if (idx>0 && path.charAt(idx-1)!=='.') { - + // should not do lookup on a prototype object because the object isn't // really live yet. if (target && meta(target,false).proto!==target) { @@ -2425,7 +2580,7 @@ function normalizeTuple(target, path) { // must return some kind of path to be valid else other things will break. if (!path || path.length===0) throw new Error('Invalid Path'); - + TUPLE_RET[0] = target; TUPLE_RET[1] = path; return TUPLE_RET; @@ -2438,7 +2593,7 @@ function normalizeTuple(target, path) { @function @param {String} path path to normalize - @returns {String} normalized path + @returns {String} normalized path */ Ember.normalizePath = normalizePath; @@ -2446,16 +2601,16 @@ Ember.normalizePath = normalizePath; @private Normalizes a target/path pair to reflect that actual target/path that should - be observed, etc. This takes into account passing in global property - paths (i.e. a path beginning with a captial letter not defined on the + be observed, etc. This takes into account passing in global property + paths (i.e. a path beginning with a captial letter not defined on the target) and * separators. - + @param {Object} target The current target. May be null. - + @param {String} path A path on the target or a global property path. - + @returns {Array} a temporary array with the normalized target/path pair. */ Ember.normalizeTuple = function(target, path) { @@ -2464,9 +2619,16 @@ Ember.normalizeTuple = function(target, path) { Ember.normalizeTuple.primitive = normalizeTuple; +Ember.getWithDefault = function(root, key, defaultValue) { + var value = Ember.get(root, key); + + if (value === undefined) { return defaultValue; } + return value; +}; + Ember.getPath = function(root, path, _checkGlobal) { - var hasThis, hasStar, isGlobal, ret; - + var pathOnly, hasThis, hasStar, isGlobal, ret; + // Helpers that operate with 'this' within an #each if (path === '') { return root; @@ -2475,6 +2637,7 @@ Ember.getPath = function(root, path, _checkGlobal) { if (!path && 'string'===typeof root) { path = root; root = null; + pathOnly = true; } hasStar = path.indexOf('*') > -1; @@ -2489,9 +2652,7 @@ Ember.getPath = function(root, path, _checkGlobal) { hasThis = HAS_THIS.test(path); if (!root || hasThis || hasStar) { - if (root && root !== window && IS_GLOBAL.test(path)) { - console.warn("Fetching globals with Ember.getPath is deprecated", root, path); - } + ember_deprecate("Fetching globals with Ember.getPath is deprecated (root: "+root+", path: "+path+")", !root || root === window || !IS_GLOBAL.test(path)); var tuple = normalizeTuple(root, path); root = tuple[0]; @@ -2501,8 +2662,8 @@ Ember.getPath = function(root, path, _checkGlobal) { ret = getPath(root, path); - if (ret === undefined && root !== window && !hasThis && IS_GLOBAL.test(path) && _checkGlobal !== false) { - console.warn("Fetching globals with Ember.getPath is deprecated", root, path); + if (ret === undefined && !pathOnly && !hasThis && root !== window && IS_GLOBAL.test(path) && _checkGlobal !== false) { + ember_deprecate("Fetching globals with Ember.getPath is deprecated (root: "+root+", path: "+path+")"); return Ember.getPath(window, path); } else { return ret; @@ -2511,18 +2672,16 @@ Ember.getPath = function(root, path, _checkGlobal) { Ember.setPath = function(root, path, value, tolerant) { var keyName; - + if (arguments.length===2 && 'string' === typeof root) { value = path; path = root; root = null; } - + path = normalizePath(path); if (path.indexOf('*')>0) { - if (root && root !== window && IS_GLOBAL.test(path)) { - console.warn("Setting globals with Ember.setPath is deprecated", path); - }; + ember_deprecate("Setting globals with Ember.setPath is deprecated (path: "+path+")", !root || root === window || !IS_GLOBAL.test(path)); var tuple = normalizeTuple(root, path); root = tuple[0]; @@ -2537,7 +2696,7 @@ Ember.setPath = function(root, path, value, tolerant) { // Remove the `false` when we're done with this deprecation root = Ember.getPath(root, path, false); if (!root && IS_GLOBAL.test(path)) { - console.warn("Setting globals with Ember.setPath is deprecated", path); + ember_deprecate("Setting globals with Ember.setPath is deprecated (path: "+path+")"); root = Ember.getPath(window, path); } } @@ -2546,7 +2705,7 @@ Ember.setPath = function(root, path, value, tolerant) { if (IS_GLOBAL.test(path)) throw new Error('Invalid Path'); keyName = path; } - + if (!keyName || keyName.length===0 || keyName==='*') { throw new Error('Invalid Path'); } @@ -2589,279 +2748,6 @@ Ember.isGlobalPath = function(path) { })({}); - -(function(exports) { -// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map -if (!Array.prototype.map) -{ - Array.prototype.map = function(fun /*, thisp */) - { - "use strict"; - - if (this === void 0 || this === null) - throw new TypeError(); - - var t = Object(this); - var len = t.length >>> 0; - if (typeof fun !== "function") - throw new TypeError(); - - var res = new Array(len); - var thisp = arguments[1]; - for (var i = 0; i < len; i++) - { - if (i in t) - res[i] = fun.call(thisp, t[i], i, t); - } - - return res; - }; -} - -// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach -if (!Array.prototype.forEach) -{ - Array.prototype.forEach = function(fun /*, thisp */) - { - "use strict"; - - if (this === void 0 || this === null) - throw new TypeError(); - - var t = Object(this); - var len = t.length >>> 0; - if (typeof fun !== "function") - throw new TypeError(); - - var thisp = arguments[1]; - for (var i = 0; i < len; i++) - { - if (i in t) - fun.call(thisp, t[i], i, t); - } - }; -} - -if (!Array.prototype.indexOf) { - Array.prototype.indexOf = function (obj, fromIndex) { - if (fromIndex == null) { fromIndex = 0; } - else if (fromIndex < 0) { fromIndex = Math.max(0, this.length + fromIndex); } - for (var i = fromIndex, j = this.length; i < j; i++) { - if (this[i] === obj) { return i; } - } - return -1; - }; -} - -})({}); - - -(function(exports) { -// ========================================================================== -// Project: Ember Metal -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -/*globals ember_assert */ -var AFTER_OBSERVERS = ':change'; -var BEFORE_OBSERVERS = ':before'; -var guidFor = Ember.guidFor; -var normalizePath = Ember.normalizePath; - -var suspended = 0; -var array_Slice = Array.prototype.slice; - -var ObserverSet = function(iterateable) { - this.set = {}; - if (iterateable) { this.array = []; } -}; - -ObserverSet.prototype.add = function(target, name) { - var set = this.set, guid = Ember.guidFor(target), array; - - if (!set[guid]) { set[guid] = {}; } - set[guid][name] = true; - if (array = this.array) { - array.push([target, name]); - } -}; - -ObserverSet.prototype.contains = function(target, name) { - var set = this.set, guid = Ember.guidFor(target), nameSet = set[guid]; - return nameSet && nameSet[name]; -}; - -ObserverSet.prototype.empty = function() { - this.set = {}; - this.array = []; -}; - -ObserverSet.prototype.forEach = function(fn) { - var q = this.array; - this.empty(); - q.forEach(function(item) { - fn(item[0], item[1]); - }); -}; - -var queue = new ObserverSet(true), beforeObserverSet = new ObserverSet(); - -function notifyObservers(obj, eventName, forceNotification) { - if (suspended && !forceNotification) { - - // if suspended add to the queue to send event later - but only send - // event once. - if (!queue.contains(obj, eventName)) { - queue.add(obj, eventName); - } - - } else { - Ember.sendEvent(obj, eventName); - } -} - -function flushObserverQueue() { - beforeObserverSet.empty(); - - if (!queue || queue.array.length===0) return ; - queue.forEach(function(target, event){ Ember.sendEvent(target, event); }); -} - -Ember.beginPropertyChanges = function() { - suspended++; - return this; -}; - -Ember.endPropertyChanges = function() { - suspended--; - if (suspended<=0) flushObserverQueue(); -}; - -/** - Make a series of property changes together in an - exception-safe way. - - Ember.changeProperties(function() { - obj1.set('foo', mayBlowUpWhenSet); - obj2.set('bar', baz); - }); -*/ -Ember.changeProperties = function(cb){ - Ember.beginPropertyChanges(); - try { - cb(); - } finally { - Ember.endPropertyChanges(); - } -}; - -function changeEvent(keyName) { - return keyName+AFTER_OBSERVERS; -} - -function beforeEvent(keyName) { - return keyName+BEFORE_OBSERVERS; -} - -function changeKey(eventName) { - return eventName.slice(0, -7); -} - -function beforeKey(eventName) { - return eventName.slice(0, -7); -} - -function xformForArgs(args) { - return function (target, method, params) { - var obj = params[0], keyName = changeKey(params[1]), val; - var copy_args = args.slice(); - if (method.length>2) { - val = Ember.getPath(Ember.isGlobalPath(keyName) ? window : obj, keyName); - } - copy_args.unshift(obj, keyName, val); - method.apply(target, copy_args); - }; -} - -var xformChange = xformForArgs([]); - -function xformBefore(target, method, params) { - var obj = params[0], keyName = beforeKey(params[1]), val; - if (method.length>2) val = Ember.getPath(obj, keyName); - method.call(target, obj, keyName, val); -} - -Ember.addObserver = function(obj, path, target, method) { - path = normalizePath(path); - - var xform; - if (arguments.length > 4) { - var args = array_Slice.call(arguments, 4); - xform = xformForArgs(args); - } else { - xform = xformChange; - } - Ember.addListener(obj, changeEvent(path), target, method, xform); - Ember.watch(obj, path); - return this; -}; - -/** @private */ -Ember.observersFor = function(obj, path) { - return Ember.listenersFor(obj, changeEvent(path)); -}; - -Ember.removeObserver = function(obj, path, target, method) { - path = normalizePath(path); - Ember.unwatch(obj, path); - Ember.removeListener(obj, changeEvent(path), target, method); - return this; -}; - -Ember.addBeforeObserver = function(obj, path, target, method) { - path = normalizePath(path); - Ember.addListener(obj, beforeEvent(path), target, method, xformBefore); - Ember.watch(obj, path); - return this; -}; - -/** @private */ -Ember.beforeObserversFor = function(obj, path) { - return Ember.listenersFor(obj, beforeEvent(path)); -}; - -Ember.removeBeforeObserver = function(obj, path, target, method) { - path = normalizePath(path); - Ember.unwatch(obj, path); - Ember.removeListener(obj, beforeEvent(path), target, method); - return this; -}; - -/** @private */ -Ember.notifyObservers = function(obj, keyName) { - notifyObservers(obj, changeEvent(keyName)); -}; - -/** @private */ -Ember.notifyBeforeObservers = function(obj, keyName) { - var guid, set, forceNotification = false; - - if (suspended) { - if (!beforeObserverSet.contains(obj, keyName)) { - beforeObserverSet.add(obj, keyName); - forceNotification = true; - } else { - return; - } - } - - notifyObservers(obj, beforeEvent(keyName), forceNotification); -}; - - -})({}); - - (function(exports) { // ========================================================================== // Project: Ember Metal @@ -2879,7 +2765,7 @@ var SIMPLE_PROPERTY, WATCHED_PROPERTY; // .......................................................... // DESCRIPTOR -// +// var SIMPLE_DESC = { writable: true, @@ -2891,10 +2777,10 @@ var SIMPLE_DESC = { /** @private @constructor - + Objects of this type can implement an interface to responds requests to get and set. The default implementation handles simple properties. - + You generally won't need to create or subclass this directly. */ var Dc = Ember.Descriptor = function() {}; @@ -2908,19 +2794,19 @@ var setup = Dc.setup = function(obj, keyName, value) { var Dp = Ember.Descriptor.prototype; /** - Called whenever we want to set the property value. Should set the value - and return the actual set value (which is usually the same but may be + Called whenever we want to set the property value. Should set the value + and return the actual set value (which is usually the same but may be different in the case of computed properties.) - + @param {Object} obj The object to set the value on. - + @param {String} keyName The key to set. - + @param {Object} value The new value - + @returns {Object} value actual set value */ Dp.set = function(obj, keyName, value) { @@ -2929,15 +2815,15 @@ Dp.set = function(obj, keyName, value) { }; /** - Called whenever we want to get the property value. Should retrieve the + Called whenever we want to get the property value. Should retrieve the current value. - + @param {Object} obj The object to get the value on. - + @param {String} keyName The key to retrieve - + @returns {Object} the current value */ Dp.get = function(obj, keyName) { @@ -2945,41 +2831,41 @@ Dp.get = function(obj, keyName) { }; /** - This is called on the descriptor to set it up on the object. The + This is called on the descriptor to set it up on the object. The descriptor is responsible for actually defining the property on the object here. - - The passed `value` is the transferValue returned from any previous + + The passed `value` is the transferValue returned from any previous descriptor. - + @param {Object} obj The object to set the value on. - + @param {String} keyName The key to set. - + @param {Object} value The transfer value from any previous descriptor. - + @returns {void} */ Dp.setup = setup; /** This is called on the descriptor just before another descriptor takes its - place. This method should at least return the 'transfer value' of the + place. This method should at least return the 'transfer value' of the property - which is the value you want to passed as the input to the new - descriptor's setup() method. - + descriptor's setup() method. + It is not generally necessary to actually 'undefine' the property as a new property descriptor will redefine it immediately after this method returns. - + @param {Object} obj The object to set the value on. - + @param {String} keyName The key to set. - + @returns {Object} transfer value */ Dp.teardown = function(obj, keyName) { @@ -2992,7 +2878,7 @@ Dp.val = function(obj, keyName) { // .......................................................... // SIMPLE AND WATCHED PROPERTIES -// +// // if accessors are disabled for the app then this will act as a guard when // testing on browsers that do support accessors. It will throw an exception @@ -3028,6 +2914,7 @@ var WATCHED_DESC = { set: Ember.Descriptor.MUST_USE_SETTER }; +/** @private */ function w_get(obj, keyName, values) { values = values || meta(obj, false).values; @@ -3039,10 +2926,11 @@ function w_get(obj, keyName, values) { } +/** @private */ function w_set(obj, keyName, value) { var m = meta(obj), watching; - - watching = m.watching[keyName]>0 && value!==m.values[keyName]; + + watching = m.watching[keyName]>0 && value!==m.values[keyName]; if (watching) Ember.propertyWillChange(obj, keyName); m.values[keyName] = value; if (watching) Ember.propertyDidChange(obj, keyName); @@ -3050,17 +2938,19 @@ function w_set(obj, keyName, value) { } var WATCHED_GETTERS = {}; +/** @private */ function mkWatchedGetter(keyName) { var ret = WATCHED_GETTERS[keyName]; if (!ret) { - ret = WATCHED_GETTERS[keyName] = function() { - return w_get(this, keyName); + ret = WATCHED_GETTERS[keyName] = function() { + return w_get(this, keyName); }; } return ret; } var WATCHED_SETTERS = {}; +/** @private */ function mkWatchedSetter(keyName) { var ret = WATCHED_SETTERS[keyName]; if (!ret) { @@ -3072,8 +2962,8 @@ function mkWatchedSetter(keyName) { } /** - @private - + @private + Private version of simple property that invokes property change callbacks. */ WATCHED_PROPERTY = new Ember.Descriptor(); @@ -3106,26 +2996,26 @@ if (Ember.platform.hasPropertyAccessors) { return ret; }; -// NOTE: if platform does not have property accessors then we just have to +// NOTE: if platform does not have property accessors then we just have to // set values and hope for the best. You just won't get any warnings... } else { - + WATCHED_PROPERTY.set = function(obj, keyName, value) { var m = meta(obj), watching; - watching = m.watching[keyName]>0 && value!==obj[keyName]; + watching = m.watching[keyName]>0 && value!==obj[keyName]; if (watching) Ember.propertyWillChange(obj, keyName); obj[keyName] = value; if (watching) Ember.propertyDidChange(obj, keyName); return value; }; - + } /** The default descriptor for simple properties. Pass as the third argument to Ember.defineProperty() along with a value to set a simple value. - + @static @default Ember.Descriptor */ @@ -3138,8 +3028,9 @@ SIMPLE_PROPERTY.watched = WATCHED_PROPERTY.watched = WATCHED_PROPERTY; // .......................................................... // DEFINING PROPERTIES API -// +// +/** @private */ function hasDesc(descs, keyName) { if (keyName === 'toString') return 'function' !== typeof descs.toString; else return !!descs[keyName]; @@ -3151,16 +3042,16 @@ function hasDesc(descs, keyName) { NOTE: This is a low-level method used by other parts of the API. You almost never want to call this method directly. Instead you should use Ember.mixin() to define new properties. - - Defines a property on an object. This method works much like the ES5 - Object.defineProperty() method except that it can also accept computed - properties and other special descriptors. + + Defines a property on an object. This method works much like the ES5 + Object.defineProperty() method except that it can also accept computed + properties and other special descriptors. Normally this method takes only three parameters. However if you pass an instance of Ember.Descriptor as the third param then you can pass an optional value as the fourth parameter. This is often more efficient than creating new descriptor hashes for each property. - + ## Examples // ES5 compatible mode @@ -3170,10 +3061,10 @@ function hasDesc(descs, keyName) { enumerable: true, value: 'Charles' }); - + // define a simple property Ember.defineProperty(contact, 'lastName', Ember.SIMPLE_PROPERTY, 'Jolley'); - + // define a computed property Ember.defineProperty(contact, 'fullName', Ember.computed(function() { return this.firstName+' '+this.lastName; @@ -3190,12 +3081,12 @@ Ember.defineProperty = function(obj, keyName, desc, val) { } if (!desc) desc = SIMPLE_PROPERTY; - + if (desc instanceof Ember.Descriptor) { m = meta(obj, true); descs = m.descs; - - desc = (watching ? desc.watched : desc.unwatched) || desc; + + desc = (watching ? desc.watched : desc.unwatched) || desc; descs[keyName] = desc; desc.setup(obj, keyName, val, watching); @@ -3216,14 +3107,14 @@ Ember.defineProperty = function(obj, keyName, desc, val) { Creates a new object using the passed object as its prototype. On browsers that support it, this uses the built in Object.create method. Else one is simulated for you. - - This method is a better choice thant Object.create() because it will make - sure that any observers, event listeners, and computed properties are + + This method is a better choice thant Object.create() because it will make + sure that any observers, event listeners, and computed properties are inherited from the parent as well. - + @param {Object} obj The object you want to have as the prototype. - + @returns {Object} the newly created object */ Ember.create = function(obj, props) { @@ -3238,15 +3129,15 @@ Ember.create = function(obj, props) { Creates a new object using the passed object as its prototype. This method acts like `Ember.create()` in every way except that bindings, observers, and - computed properties will be activated on the object. - + computed properties will be activated on the object. + The purpose of this method is to build an object for use in a prototype - chain. (i.e. to be set as the `prototype` property on a constructor + chain. (i.e. to be set as the `prototype` property on a constructor function). Prototype objects need to inherit bindings, observers and other configuration so they pass it on to their children. However since they are never 'live' objects themselves, they should not fire or make other changes when various properties around them change. - + You should use this method anytime you want to create a new object for use in a prototype chain. @@ -3268,7 +3159,6 @@ Ember.createPrototype = function(obj, props) { })({}); - (function(exports) { // ========================================================================== // Project: Ember Metal @@ -3276,4819 +3166,5647 @@ Ember.createPrototype = function(obj, props) { // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals ember_assert */ +var meta = Ember.meta; var guidFor = Ember.guidFor; -var meta = Ember.meta; -var get = Ember.get, set = Ember.set; -var normalizeTuple = Ember.normalizeTuple.primitive; -var normalizePath = Ember.normalizePath; -var SIMPLE_PROPERTY = Ember.SIMPLE_PROPERTY; -var GUID_KEY = Ember.GUID_KEY; -var META_KEY = Ember.META_KEY; -var notifyObservers = Ember.notifyObservers; - -var FIRST_KEY = /^([^\.\*]+)/; -var IS_PATH = /[\.\*]/; - -function firstKey(path) { - return path.match(FIRST_KEY)[0]; -} - -// returns true if the passed path is just a keyName -function isKeyName(path) { - return path==='*' || !IS_PATH.test(path); -} +var USE_ACCESSORS = Ember.USE_ACCESSORS; +var a_slice = Array.prototype.slice; +var o_create = Ember.platform.create; +var o_defineProperty = Ember.platform.defineProperty; // .......................................................... // DEPENDENT KEYS // -var DEP_SKIP = { __emberproto__: true }; // skip some keys and toString -function iterDeps(method, obj, depKey, seen, meta) { +// data structure: +// meta.deps = { +// 'depKey': { +// 'keyName': count, +// __emberproto__: SRC_OBJ [to detect clones] +// }, +// __emberproto__: SRC_OBJ +// } - var guid = guidFor(obj); - if (!seen[guid]) seen[guid] = {}; - if (seen[guid][depKey]) return ; - seen[guid][depKey] = true; +/** @private */ +function uniqDeps(obj, depKey) { + var m = meta(obj), deps, ret; + deps = m.deps; + if (!deps) { + deps = m.deps = { __emberproto__: obj }; + } else if (deps.__emberproto__ !== obj) { + deps = m.deps = o_create(deps); + deps.__emberproto__ = obj; + } - var deps = meta.deps; - deps = deps && deps[depKey]; - if (deps) { - for(var key in deps) { - if (DEP_SKIP[key]) continue; - method(obj, key); - } + ret = deps[depKey]; + if (!ret) { + ret = deps[depKey] = { __emberproto__: obj }; + } else if (ret.__emberproto__ !== obj) { + ret = deps[depKey] = o_create(ret); + ret.__emberproto__ = obj; } -} + return ret; +} -var WILL_SEEN, DID_SEEN; +/** @private */ +function addDependentKey(obj, keyName, depKey) { + var deps = uniqDeps(obj, depKey); + deps[keyName] = (deps[keyName] || 0) + 1; + Ember.watch(obj, depKey); +} -// called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...) -function dependentKeysWillChange(obj, depKey, meta) { - var seen = WILL_SEEN, top = !seen; - if (top) seen = WILL_SEEN = {}; - iterDeps(propertyWillChange, obj, depKey, seen, meta); - if (top) WILL_SEEN = null; +/** @private */ +function removeDependentKey(obj, keyName, depKey) { + var deps = uniqDeps(obj, depKey); + deps[keyName] = (deps[keyName] || 0) - 1; + Ember.unwatch(obj, depKey); } -// called whenever a property has just changed to update dependent keys -function dependentKeysDidChange(obj, depKey, meta) { - var seen = DID_SEEN, top = !seen; - if (top) seen = DID_SEEN = {}; - iterDeps(propertyDidChange, obj, depKey, seen, meta); - if (top) DID_SEEN = null; +/** @private */ +function addDependentKeys(desc, obj, keyName) { + var keys = desc._dependentKeys, + len = keys ? keys.length : 0; + for(var idx=0;idx0) { - setTimeout(flushPendingChains, 1); +/** @private */ +function mkCpGetter(keyName, desc) { + var cacheable = desc._cacheable, + func = desc.func; + + if (cacheable) { + return function() { + var ret, cache = meta(this).cache; + if (keyName in cache) return cache[keyName]; + ret = cache[keyName] = func.call(this, keyName); + return ret ; + }; + } else { + return function() { + return func.call(this, keyName); + }; } } -function isProto(pvalue) { - return meta(pvalue, false).proto === pvalue; -} +/** @private */ +function mkCpSetter(keyName, desc) { + var cacheable = desc._cacheable, + func = desc.func; -// A ChainNode watches a single key on an object. If you provide a starting -// value for the key then the node won't actually watch it. For a root node -// pass null for parent and key and object for value. -var ChainNode = function(parent, key, value, separator) { - var obj; - this._parent = parent; - this._key = key; + return function(value) { + var m = meta(this, cacheable), + watched = (m.source===this) && m.watching[keyName]>0, + ret, oldSuspended, lastSetValues; - // _watching is true when calling get(this._parent, this._key) will - // return the value of this node. - // - // It is false for the root of a chain (because we have no parent) - // and for global paths (because the parent node is the object with - // the observer on it) - this._watching = value===undefined; + oldSuspended = desc._suspended; + desc._suspended = this; - this._value = value; - this._separator = separator || '.'; - this._paths = {}; - if (this._watching) { - this._object = parent.value(); - if (this._object) addChainWatcher(this._object, this._key, this); - } + watched = watched && m.lastSetValues[keyName]!==guidFor(value); + if (watched) { + m.lastSetValues[keyName] = guidFor(value); + Ember.propertyWillChange(this, keyName); + } - // Special-case: the EachProxy relies on immediate evaluation to - // establish its observers. - // - // TODO: Replace this with an efficient callback that the EachProxy - // can implement. - if (this._parent && this._parent._key === '@each') { - this.value(); - } -}; + if (cacheable) delete m.cache[keyName]; + ret = func.call(this, keyName, value); + if (cacheable) m.cache[keyName] = ret; + if (watched) Ember.propertyDidChange(this, keyName); + desc._suspended = oldSuspended; + return ret; + }; +} +/** + @extends Ember.ComputedProperty + @private +*/ +var Cp = ComputedProperty.prototype; -var Wp = ChainNode.prototype; +/** + Call on a computed property to set it into cacheable mode. When in this + mode the computed property will automatically cache the return value of + your function until one of the dependent keys changes. -Wp.value = function() { - if (this._value === undefined && this._watching){ - var obj = this._parent.value(); - this._value = (obj && !isProto(obj)) ? get(obj, this._key) : undefined; + MyApp.president = Ember.Object.create({ + fullName: function() { + return this.get('firstName') + ' ' + this.get('lastName'); + + // After calculating the value of this function, Ember.js will + // return that value without re-executing this function until + // one of the dependent properties change. + }.property('firstName', 'lastName').cacheable() + }); + + It is common to use `cacheable()` on nearly every computed property + you define. + + @name Ember.ComputedProperty.cacheable + @param {Boolean} aFlag optional set to false to disable cacheing + @returns {Ember.ComputedProperty} receiver +*/ +Cp.cacheable = function(aFlag) { + this._cacheable = aFlag!==false; + return this; +}; + +/** + Sets the dependent keys on this computed property. Pass any number of + arguments containing key paths that this computed property depends on. + + MyApp.president = Ember.Object.create({ + fullName: Ember.computed(function() { + return this.get('firstName') + ' ' + this.get('lastName'); + + // Tell Ember.js that this computed property depends on firstName + // and lastName + }).property('firstName', 'lastName') + }); + + @name Ember.ComputedProperty.property + @param {String} path... zero or more property paths + @returns {Ember.ComputedProperty} receiver +*/ +Cp.property = function() { + this._dependentKeys = a_slice.call(arguments); + return this; +}; + +/** + In some cases, you may want to annotate computed properties with additional + metadata about how they function or what values they operate on. For example, + computed property functions may close over variables that are then no longer + available for introspection. + + You can pass a hash of these values to a computed property like this: + + person: function() { + var personId = this.get('personId'); + return App.Person.create({ id: personId }); + }.property().meta({ type: App.Person }) + + The hash that you pass to the `meta()` function will be saved on the + computed property descriptor under the `_meta` key. Ember runtime + exposes a public API for retrieving these values from classes, + via the `metaForProperty()` function. + + @name Ember.ComputedProperty.meta + @param {Hash} metadata + @returns {Ember.ComputedProperty} property descriptor instance +*/ + +Cp.meta = function(meta) { + this._meta = meta; + return this; +}; + +/** @private - impl descriptor API */ +Cp.setup = function(obj, keyName, value) { + CP_DESC.get = mkCpGetter(keyName, this); + CP_DESC.set = mkCpSetter(keyName, this); + o_defineProperty(obj, keyName, CP_DESC); + CP_DESC.get = CP_DESC.set = null; + addDependentKeys(this, obj, keyName); +}; + +/** @private - impl descriptor API */ +Cp.teardown = function(obj, keyName) { + var keys = this._dependentKeys, + len = keys ? keys.length : 0; + for(var idx=0;idx 0)) continue; // this check will also catch non-number vals. - ret.add(path); +/** @private - impl descriptor API */ +Cp.set = function(obj, keyName, value) { + var cacheable = this._cacheable; + + var m = meta(obj, cacheable), + watched = (m.source===obj) && m.watching[keyName]>0, + ret, oldSuspended, lastSetValues; + + oldSuspended = this._suspended; + this._suspended = obj; + + watched = watched && m.lastSetValues[keyName]!==guidFor(value); + if (watched) { + m.lastSetValues[keyName] = guidFor(value); + Ember.propertyWillChange(obj, keyName); } + + if (cacheable) delete m.cache[keyName]; + ret = this.func.call(obj, keyName, value); + if (cacheable) m.cache[keyName] = ret; + if (watched) Ember.propertyDidChange(obj, keyName); + this._suspended = oldSuspended; return ret; }; -// called on the root node of a chain to setup watchers on the specified -// path. -Wp.add = function(path) { - var obj, tuple, key, src, separator, paths; +Cp.val = function(obj, keyName) { + return meta(obj, false).values[keyName]; +}; - paths = this._paths; - paths[path] = (paths[path] || 0) + 1 ; +if (!Ember.platform.hasPropertyAccessors) { + Cp.setup = function(obj, keyName, value) { + obj[keyName] = undefined; // so it shows up in key iteration + addDependentKeys(this, obj, keyName); + }; - obj = this.value(); - tuple = normalizeTuple(obj, path); +} else if (!USE_ACCESSORS) { + Cp.setup = function(obj, keyName) { + // throw exception if not using Ember.get() and Ember.set() when supported + o_defineProperty(obj, keyName, CP_DESC); + addDependentKeys(this, obj, keyName); + }; +} - // the path was a local path - if (tuple[0] && (tuple[0] === obj)) { - path = tuple[1]; - key = firstKey(path); - path = path.slice(key.length+1); +/** + This helper returns a new property descriptor that wraps the passed + computed property function. You can use this helper to define properties + with mixins or via Ember.defineProperty(). - // global path, but object does not exist yet. - // put into a queue and try to connect later. - } else if (!tuple[0]) { - pendingQueue.push([this, path]); - tuple.length = 0; - return; + The function you pass will be used to both get and set property values. + The function should accept two parameters, key and value. If value is not + undefined you should set the value first. In either case return the + current value of the property. - // global path, and object already exists - } else { - src = tuple[0]; - key = path.slice(0, 0-(tuple[1].length+1)); - separator = path.slice(key.length, key.length+1); - path = tuple[1]; + @param {Function} func + The computed property function. + + @returns {Ember.ComputedProperty} property descriptor instance +*/ +Ember.computed = function(func) { + var args; + + if (arguments.length > 1) { + args = a_slice.call(arguments, 0, -1); + func = a_slice.call(arguments, -1)[0]; } - tuple.length = 0; - this.chain(key, path, src, separator); -}; + var cp = new ComputedProperty(func); -// called on the root node of a chain to teardown watcher on the specified -// path -Wp.remove = function(path) { - var obj, tuple, key, src, paths; + if (args) { + cp.property.apply(cp, args); + } - paths = this._paths; - if (paths[path] > 0) paths[path]--; + return cp; +}; - obj = this.value(); - tuple = normalizeTuple(obj, path); - if (tuple[0] === obj) { - path = tuple[1]; - key = firstKey(path); - path = path.slice(key.length+1); +})({}); - } else { - src = tuple[0]; - key = path.slice(0, 0-(tuple[1].length+1)); - path = tuple[1]; - } +(function(exports) { +/*jshint newcap:false*/ - tuple.length = 0; - this.unchain(key, path); +// NOTE: There is a bug in jshint that doesn't recognize `Object()` without `new` +// as being ok unless both `newcap:false` and not `use strict`. +// https://github.com/jshint/jshint/issues/392 + +// Testing this is not ideal, but we want ArrayUtils to use native functions +// if available, but not to use versions created by libraries like Prototype +/** @private */ +var isNativeFunc = function(func) { + // This should probably work in all browsers likely to have ES5 array methods + return func && Function.prototype.toString.call(func).indexOf('[native code]') > -1; }; -Wp.count = 0; +// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map +/** @private */ +var arrayMap = isNativeFunc(Array.prototype.map) ? Array.prototype.map : function(fun /*, thisp */) { + //"use strict"; -Wp.chain = function(key, path, src, separator) { - var chains = this._chains, node; - if (!chains) chains = this._chains = {}; + if (this === void 0 || this === null) { + throw new TypeError(); + } - node = chains[key]; - if (!node) node = chains[key] = new ChainNode(this, key, src, separator); - node.count++; // count chains... + var t = Object(this); + var len = t.length >>> 0; + if (typeof fun !== "function") { + throw new TypeError(); + } - // chain rest of path if there is one - if (path && path.length>0) { - key = firstKey(path); - path = path.slice(key.length+1); - node.chain(key, path); // NOTE: no src means it will observe changes... + var res = new Array(len); + var thisp = arguments[1]; + for (var i = 0; i < len; i++) { + if (i in t) { + res[i] = fun.call(thisp, t[i], i, t); + } } + + return res; }; -Wp.unchain = function(key, path) { - var chains = this._chains, node = chains[key]; +// From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach +/** @private */ +var arrayForEach = isNativeFunc(Array.prototype.forEach) ? Array.prototype.forEach : function(fun /*, thisp */) { + //"use strict"; - // unchain rest of path first... - if (path && path.length>1) { - key = firstKey(path); - path = path.slice(key.length+1); - node.unchain(key, path); + if (this === void 0 || this === null) { + throw new TypeError(); } - // delete node if needed. - node.count--; - if (node.count<=0) { - delete chains[node._key]; - node.destroy(); + var t = Object(this); + var len = t.length >>> 0; + if (typeof fun !== "function") { + throw new TypeError(); } - -}; -Wp.willChange = function() { - var chains = this._chains; - if (chains) { - for(var key in chains) { - if (!chains.hasOwnProperty(key)) continue; - chains[key].willChange(); + var thisp = arguments[1]; + for (var i = 0; i < len; i++) { + if (i in t) { + fun.call(thisp, t[i], i, t); } } - - if (this._parent) this._parent.chainWillChange(this, this._key, 1); }; -Wp.chainWillChange = function(chain, path, depth) { - if (this._key) path = this._key+this._separator+path; - - if (this._parent) { - this._parent.chainWillChange(this, path, depth+1); - } else { - if (depth>1) Ember.propertyWillChange(this.value(), path); - path = 'this.'+path; - if (this._paths[path]>0) Ember.propertyWillChange(this.value(), path); +/** @private */ +var arrayIndexOf = isNativeFunc(Array.prototype.indexOf) ? Array.prototype.indexOf : function (obj, fromIndex) { + if (fromIndex === null || fromIndex === undefined) { fromIndex = 0; } + else if (fromIndex < 0) { fromIndex = Math.max(0, this.length + fromIndex); } + for (var i = fromIndex, j = this.length; i < j; i++) { + if (this[i] === obj) { return i; } } + return -1; }; -Wp.chainDidChange = function(chain, path, depth) { - if (this._key) path = this._key+this._separator+path; - if (this._parent) { - this._parent.chainDidChange(this, path, depth+1); - } else { - if (depth>1) Ember.propertyDidChange(this.value(), path); - path = 'this.'+path; - if (this._paths[path]>0) Ember.propertyDidChange(this.value(), path); + +Ember.ArrayUtils = { + map: function(obj) { + var args = Array.prototype.slice.call(arguments, 1); + return obj.map ? obj.map.apply(obj, args) : arrayMap.apply(obj, args); + }, + + forEach: function(obj) { + var args = Array.prototype.slice.call(arguments, 1); + return obj.forEach ? obj.forEach.apply(obj, args) : arrayForEach.apply(obj, args); + }, + + indexOf: function(obj) { + var args = Array.prototype.slice.call(arguments, 1); + return obj.indexOf ? obj.indexOf.apply(obj, args) : arrayIndexOf.apply(obj, args); + }, + + removeObject: function(array, item) { + var index = this.indexOf(array, item); + if (index !== -1) { array.splice(index, 1); } } }; -Wp.didChange = function(suppressEvent) { - // invalidate my own value first. - if (this._watching) { - var obj = this._parent.value(); - if (obj !== this._object) { - removeChainWatcher(this._object, this._key, this); - this._object = obj; - addChainWatcher(obj, this._key, this); - } - this._value = undefined; - // Special-case: the EachProxy relies on immediate evaluation to - // establish its observers. - if (this._parent && this._parent._key === '@each') - this.value(); - } - - // then notify chains... - var chains = this._chains; - if (chains) { - for(var key in chains) { - if (!chains.hasOwnProperty(key)) continue; - chains[key].didChange(suppressEvent); - } +if (Ember.SHIM_ES5) { + if (!Array.prototype.map) { + /** @private */ + Array.prototype.map = arrayMap; } - if (suppressEvent) return; - - // and finally tell parent about my path changing... - if (this._parent) this._parent.chainDidChange(this, this._key, 1); -}; + if (!Array.prototype.forEach) { + /** @private */ + Array.prototype.forEach = arrayForEach; + } -// get the chains for the current object. If the current object has -// chains inherited from the proto they will be cloned and reconfigured for -// the current object. -function chainsFor(obj) { - var m = meta(obj), ret = m.chains; - if (!ret) { - ret = m.chains = new ChainNode(null, null, obj); - } else if (ret.value() !== obj) { - ret = m.chains = ret.copy(obj); + if (!Array.prototype.indexOf) { + /** @private */ + Array.prototype.indexOf = arrayIndexOf; } - return ret ; } +})({}); +(function(exports) { +// ========================================================================== +// Project: Ember Metal +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var AFTER_OBSERVERS = ':change'; +var BEFORE_OBSERVERS = ':before'; +var guidFor = Ember.guidFor; +var normalizePath = Ember.normalizePath; -function notifyChains(obj, m, keyName, methodName, arg) { - var nodes = m.chainWatchers; +var deferred = 0; +var array_Slice = Array.prototype.slice; +var array_ForEach = Ember.ArrayUtils.forEach; - if (!nodes || nodes.__emberproto__ !== obj) return; // nothing to do +/** @private */ +var ObserverSet = function () { + this.targetSet = {}; +}; +ObserverSet.prototype.add = function (target, path) { + var targetSet = this.targetSet, + targetGuid = Ember.guidFor(target), + pathSet = targetSet[targetGuid]; + if (!pathSet) { + targetSet[targetGuid] = pathSet = {}; + } + if (pathSet[path]) { + return false; + } else { + return pathSet[path] = true; + } +}; +ObserverSet.prototype.clear = function () { + this.targetSet = {}; +}; - nodes = nodes[keyName]; - if (!nodes) return; +/** @private */ +var DeferredEventQueue = function() { + this.targetSet = {}; + this.queue = []; +}; - for(var key in nodes) { - if (!nodes.hasOwnProperty(key)) continue; - nodes[key][methodName](arg); +DeferredEventQueue.prototype.push = function(target, eventName) { + var targetSet = this.targetSet, + queue = this.queue, + targetGuid = Ember.guidFor(target), + eventNameSet = targetSet[targetGuid], + index; + + if (!eventNameSet) { + targetSet[targetGuid] = eventNameSet = {}; } -} + index = eventNameSet[eventName]; + if (index === undefined) { + eventNameSet[eventName] = queue.push(Ember.deferEvent(target, eventName)) - 1; + } else { + queue[index] = Ember.deferEvent(target, eventName); + } +}; -Ember.overrideChains = function(obj, keyName, m) { - notifyChains(obj, m, keyName, 'didChange', true); -} +DeferredEventQueue.prototype.flush = function() { + var queue = this.queue; + this.queue = []; + this.targetSet = {}; + for (var i=0, len=queue.length; i < len; ++i) { + queue[i](); + } +}; -function chainsWillChange(obj, keyName, m) { - notifyChains(obj, m, keyName, 'willChange'); +var queue = new DeferredEventQueue(), beforeObserverSet = new ObserverSet(); + +/** @private */ +function notifyObservers(obj, eventName, forceNotification) { + if (deferred && !forceNotification) { + queue.push(obj, eventName); + } else { + Ember.sendEvent(obj, eventName); + } } -function chainsDidChange(obj, keyName, m) { - notifyChains(obj, m, keyName, 'didChange'); +/** @private */ +function flushObserverQueue() { + beforeObserverSet.clear(); + + queue.flush(); } -// .......................................................... -// WATCH -// +Ember.beginPropertyChanges = function() { + deferred++; + return this; +}; -var WATCHED_PROPERTY = Ember.SIMPLE_PROPERTY.watched; +Ember.endPropertyChanges = function() { + deferred--; + if (deferred<=0) flushObserverQueue(); +}; /** - @private + Make a series of property changes together in an + exception-safe way. - Starts watching a property on an object. Whenever the property changes, - invokes Ember.propertyWillChange and Ember.propertyDidChange. This is the - primitive used by observers and dependent keys; usually you will never call - this method directly but instead use higher level methods like - Ember.addObserver(). + Ember.changeProperties(function() { + obj1.set('foo', mayBlowUpWhenSet); + obj2.set('bar', baz); + }); */ -Ember.watch = function(obj, keyName) { - - // can't watch length on Array - it is special... - if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; - - var m = meta(obj), watching = m.watching, desc; - keyName = normalizePath(keyName); - - // activate watching first time - if (!watching[keyName]) { - watching[keyName] = 1; - if (isKeyName(keyName)) { - desc = m.descs[keyName]; - desc = desc ? desc.watched : WATCHED_PROPERTY; - if (desc) Ember.defineProperty(obj, keyName, desc); - } else { - chainsFor(obj).add(keyName); - } - - } else { - watching[keyName] = (watching[keyName]||0)+1; +Ember.changeProperties = function(cb, binding){ + Ember.beginPropertyChanges(); + try { + cb.call(binding); + } finally { + Ember.endPropertyChanges(); } - return this; }; -Ember.isWatching = function(obj, keyName) { - return !!meta(obj).watching[keyName]; +/** + Set a list of properties on an object. These properties are set inside + a single `beginPropertyChanges` and `endPropertyChanges` batch, so + observers will be buffered. +*/ +Ember.setProperties = function(self, hash) { + Ember.changeProperties(function(){ + for(var prop in hash) { + if (hash.hasOwnProperty(prop)) Ember.set(self, prop, hash[prop]); + } + }); + return self; }; -Ember.watch.flushPending = flushPendingChains; /** @private */ -Ember.unwatch = function(obj, keyName) { - // can't watch length on Array - it is special... - if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; +function changeEvent(keyName) { + return keyName+AFTER_OBSERVERS; +} - var watching = meta(obj).watching, desc, descs; - keyName = normalizePath(keyName); - if (watching[keyName] === 1) { - watching[keyName] = 0; - if (isKeyName(keyName)) { - desc = meta(obj).descs[keyName]; - desc = desc ? desc.unwatched : SIMPLE_PROPERTY; - if (desc) Ember.defineProperty(obj, keyName, desc); - } else { - chainsFor(obj).remove(keyName); - } +/** @private */ +function beforeEvent(keyName) { + return keyName+BEFORE_OBSERVERS; +} - } else if (watching[keyName]>1) { - watching[keyName]--; - } - - return this; -}; +/** @private */ +function changeKey(eventName) { + return eventName.slice(0, -7); +} -/** - @private +/** @private */ +function beforeKey(eventName) { + return eventName.slice(0, -7); +} - Call on an object when you first beget it from another object. This will - setup any chained watchers on the object instance as needed. This method is - safe to call multiple times. -*/ -Ember.rewatch = function(obj) { - var m = meta(obj, false), chains = m.chains, bindings = m.bindings, key, b; +/** @private */ +function xformForArgs(args) { + return function (target, method, params) { + var obj = params[0], keyName = changeKey(params[1]), val; + var copy_args = args.slice(); + if (method.length>2) { + val = Ember.getPath(Ember.isGlobalPath(keyName) ? window : obj, keyName); + } + copy_args.unshift(obj, keyName, val); + method.apply(target, copy_args); + }; +} - // make sure the object has its own guid. - if (GUID_KEY in obj && !obj.hasOwnProperty(GUID_KEY)) { - Ember.generateGuid(obj, 'ember'); - } +var xformChange = xformForArgs([]); - // make sure any chained watchers update. - if (chains && chains.value() !== obj) chainsFor(obj); +/** @private */ +function xformBefore(target, method, params) { + var obj = params[0], keyName = beforeKey(params[1]), val; + if (method.length>2) val = Ember.getPath(obj, keyName); + method.call(target, obj, keyName, val); +} - // if the object has bindings then sync them.. - if (bindings && m.proto!==obj) { - for (key in bindings) { - b = !DEP_SKIP[key] && obj[key]; - if (b && b instanceof Ember.Binding) b.fromDidChange(obj); - } +Ember.addObserver = function(obj, path, target, method) { + path = normalizePath(path); + + var xform; + if (arguments.length > 4) { + var args = array_Slice.call(arguments, 4); + xform = xformForArgs(args); + } else { + xform = xformChange; } + Ember.addListener(obj, changeEvent(path), target, method, xform); + Ember.watch(obj, path); + return this; +}; + +/** @private */ +Ember.observersFor = function(obj, path) { + return Ember.listenersFor(obj, changeEvent(path)); +}; +Ember.removeObserver = function(obj, path, target, method) { + path = normalizePath(path); + Ember.unwatch(obj, path); + Ember.removeListener(obj, changeEvent(path), target, method); return this; }; -// .......................................................... -// PROPERTY CHANGES -// +Ember.addBeforeObserver = function(obj, path, target, method) { + path = normalizePath(path); + Ember.addListener(obj, beforeEvent(path), target, method, xformBefore); + Ember.watch(obj, path); + return this; +}; -/** - This function is called just before an object property is about to change. - It will notify any before observers and prepare caches among other things. - - Normally you will not need to call this method directly but if for some - reason you can't directly watch a property you can invoke this method - manually along with `Ember.propertyDidChange()` which you should call just - after the property value changes. - - @param {Object} obj - The object with the property that will change - - @param {String} keyName - The property key (or path) that will change. - - @returns {void} -*/ -var propertyWillChange = Ember.propertyWillChange = function(obj, keyName) { - var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; - if (proto === obj) return ; - if (desc && desc.willChange) desc.willChange(obj, keyName); - dependentKeysWillChange(obj, keyName, m); - chainsWillChange(obj, keyName, m); - Ember.notifyBeforeObservers(obj, keyName); +// Suspend observer during callback. +// +// This should only be used by the target of the observer +// while it is setting the observed path. +/** @private */ +Ember._suspendObserver = function(obj, path, target, method, callback) { + return Ember._suspendListener(obj, changeEvent(path), target, method, callback); }; -/** - This function is called just after an object property has changed. - It will notify any observers and clear caches among other things. - - Normally you will not need to call this method directly but if for some - reason you can't directly watch a property you can invoke this method - manually along with `Ember.propertyWilLChange()` which you should call just - before the property value changes. - - @param {Object} obj - The object with the property that will change - - @param {String} keyName - The property key (or path) that will change. - - @returns {void} -*/ -var propertyDidChange = Ember.propertyDidChange = function(obj, keyName) { - var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; - if (proto === obj) return ; - if (desc && desc.didChange) desc.didChange(obj, keyName); - dependentKeysDidChange(obj, keyName, m); - chainsDidChange(obj, keyName, m); - Ember.notifyObservers(obj, keyName); +/** @private */ +Ember.beforeObserversFor = function(obj, path) { + return Ember.listenersFor(obj, beforeEvent(path)); }; -var NODE_STACK = [] +Ember.removeBeforeObserver = function(obj, path, target, method) { + path = normalizePath(path); + Ember.unwatch(obj, path); + Ember.removeListener(obj, beforeEvent(path), target, method); + return this; +}; -/** - Tears down the meta on an object so that it can be garbage collected. - Multiple calls will have no effect. - - @param {Object} obj the object to destroy - @returns {void} -*/ -Ember.destroy = function (obj) { - var meta = obj[META_KEY], node, nodes, key, nodeObject; - if (meta) { - obj[META_KEY] = null; - // remove chainWatchers to remove circular references that would prevent GC - node = meta.chains; - if (node) { - NODE_STACK.push(node); - // process tree - while (NODE_STACK.length > 0) { - node = NODE_STACK.pop(); - // push children - nodes = node._chains; - if (nodes) { - for (key in nodes) { - if (nodes.hasOwnProperty(key)) { - NODE_STACK.push(nodes[key]); - } - } - } - // remove chainWatcher in node object - if (node._watching) { - nodeObject = node._object; - if (nodeObject) { - removeChainWatcher(nodeObject, node._key, node); - } - } - } +/** @private */ +Ember.notifyObservers = function(obj, keyName) { + if (obj.isDestroying) { return; } + + notifyObservers(obj, changeEvent(keyName)); +}; + +/** @private */ +Ember.notifyBeforeObservers = function(obj, keyName) { + if (obj.isDestroying) { return; } + + var guid, set, forceNotification = false; + + if (deferred) { + if (beforeObserverSet.add(obj, keyName)) { + forceNotification = true; + } else { + return; } } + + notifyObservers(obj, beforeEvent(keyName), forceNotification); }; -})({}); +})({}); (function(exports) { // ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2010 Apple Inc. All rights reserved. +// Project: Ember Metal +// Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals ember_assert */ -// Ember.Logger -// Ember.watch.flushPending -// Ember.beginPropertyChanges, Ember.endPropertyChanges -// Ember.guidFor +var guidFor = Ember.guidFor; +var meta = Ember.meta; +var get = Ember.get, set = Ember.set; +var normalizeTuple = Ember.normalizeTuple.primitive; +var normalizePath = Ember.normalizePath; +var SIMPLE_PROPERTY = Ember.SIMPLE_PROPERTY; +var GUID_KEY = Ember.GUID_KEY; +var META_KEY = Ember.META_KEY; +var notifyObservers = Ember.notifyObservers; +var forEach = Ember.ArrayUtils.forEach; + +var FIRST_KEY = /^([^\.\*]+)/; +var IS_PATH = /[\.\*]/; + +/** @private */ +function firstKey(path) { + return path.match(FIRST_KEY)[0]; +} + +// returns true if the passed path is just a keyName +/** @private */ +function isKeyName(path) { + return path==='*' || !IS_PATH.test(path); +} // .......................................................... -// HELPERS +// DEPENDENT KEYS // -var slice = Array.prototype.slice; - -// invokes passed params - normalizing so you can pass target/func, -// target/string or just func -function invoke(target, method, args, ignore) { +var DEP_SKIP = { __emberproto__: true }; // skip some keys and toString - if (method===undefined) { - method = target; - target = undefined; - } +/** @private */ +function iterDeps(method, obj, depKey, seen, meta) { - if ('string'===typeof method) method = target[method]; - if (args && ignore>0) { - args = args.length>ignore ? slice.call(args, ignore) : null; - } + var guid = guidFor(obj); + if (!seen[guid]) seen[guid] = {}; + if (seen[guid][depKey]) return ; + seen[guid][depKey] = true; - // Unfortunately in some browsers we lose the backtrace if we rethrow the existing error, - // so in the event that we don't have an `onerror` handler we don't wrap in a try/catch - if ('function' === typeof Ember.onerror) { - try { - // IE8's Function.prototype.apply doesn't accept undefined/null arguments. - return method.apply(target || this, args || []); - } catch (error) { - Ember.onerror(error); + var deps = meta.deps; + deps = deps && deps[depKey]; + if (deps) { + for(var key in deps) { + if (DEP_SKIP[key]) continue; + method(obj, key); } - } else { - // IE8's Function.prototype.apply doesn't accept undefined/null arguments. - return method.apply(target || this, args || []); } } -// .......................................................... -// RUNLOOP -// - -var timerMark; // used by timers... +var WILL_SEEN, DID_SEEN; -var K = function() {}; -var RunLoop = function(prev) { - var self; +// called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...) +/** @private */ +function dependentKeysWillChange(obj, depKey, meta) { + if (obj.isDestroying) { return; } - if (this instanceof RunLoop) { - self = this; - } else { - self = new K(); - } + var seen = WILL_SEEN, top = !seen; + if (top) seen = WILL_SEEN = {}; + iterDeps(propertyWillChange, obj, depKey, seen, meta); + if (top) WILL_SEEN = null; +} - self._prev = prev || null; - self.onceTimers = {}; +// called whenever a property has just changed to update dependent keys +/** @private */ +function dependentKeysDidChange(obj, depKey, meta) { + if (obj.isDestroying) { return; } - return self; -}; + var seen = DID_SEEN, top = !seen; + if (top) seen = DID_SEEN = {}; + iterDeps(propertyDidChange, obj, depKey, seen, meta); + if (top) DID_SEEN = null; +} -K.prototype = RunLoop.prototype; +// .......................................................... +// CHAIN +// -RunLoop.prototype = { - end: function() { - this.flush(); - }, +/** @private */ +function addChainWatcher(obj, keyName, node) { + if (!obj || ('object' !== typeof obj)) return; // nothing to do + var m = meta(obj); + var nodes = m.chainWatchers; + if (!nodes || nodes.__emberproto__ !== obj) { + nodes = m.chainWatchers = { __emberproto__: obj }; + } - prev: function() { - return this._prev; - }, + if (!nodes[keyName]) nodes[keyName] = {}; + nodes[keyName][guidFor(node)] = node; + Ember.watch(obj, keyName); +} - // .......................................................... - // Delayed Actions - // +/** @private */ +function removeChainWatcher(obj, keyName, node) { + if (!obj || ('object' !== typeof obj)) return; // nothing to do + var m = meta(obj, false); + var nodes = m.chainWatchers; + if (!nodes || nodes.__emberproto__ !== obj) return; //nothing to do + if (nodes[keyName]) delete nodes[keyName][guidFor(node)]; + Ember.unwatch(obj, keyName); +} - schedule: function(queueName, target, method) { - var queues = this._queues, queue; - if (!queues) queues = this._queues = {}; - queue = queues[queueName]; - if (!queue) queue = queues[queueName] = []; +var pendingQueue = []; - var args = arguments.length>3 ? slice.call(arguments, 3) : null; - queue.push({ target: target, method: method, args: args }); - return this; - }, +// attempts to add the pendingQueue chains again. If some of them end up +// back in the queue and reschedule is true, schedules a timeout to try +// again. +/** @private */ +function flushPendingChains(reschedule) { + if (pendingQueue.length===0) return ; // nothing to do - flush: function(queueName) { - var queues = this._queues, queueNames, idx, len, queue, log; + var queue = pendingQueue; + pendingQueue = []; - if (!queues) return this; // nothing to do + forEach(queue, function(q) { q[0].add(q[1]); }); + if (reschedule!==false && pendingQueue.length>0) { + setTimeout(flushPendingChains, 1); + } +} - function iter(item) { - invoke(item.target, item.method, item.args); - } +/** @private */ +function isProto(pvalue) { + return meta(pvalue, false).proto === pvalue; +} - Ember.watch.flushPending(); // make sure all chained watchers are setup +// A ChainNode watches a single key on an object. If you provide a starting +// value for the key then the node won't actually watch it. For a root node +// pass null for parent and key and object for value. +/** @private */ +var ChainNode = function(parent, key, value, separator) { + var obj; + this._parent = parent; + this._key = key; - if (queueName) { - while (this._queues && (queue = this._queues[queueName])) { - this._queues[queueName] = null; + // _watching is true when calling get(this._parent, this._key) will + // return the value of this node. + // + // It is false for the root of a chain (because we have no parent) + // and for global paths (because the parent node is the object with + // the observer on it) + this._watching = value===undefined; - log = Ember.LOG_BINDINGS && queueName==='sync'; - if (log) Ember.Logger.log('Begin: Flush Sync Queue'); + this._value = value; + this._separator = separator || '.'; + this._paths = {}; + if (this._watching) { + this._object = parent.value(); + if (this._object) addChainWatcher(this._object, this._key, this); + } - // the sync phase is to allow property changes to propogate. don't - // invoke observers until that is finished. - if (queueName === 'sync') Ember.beginPropertyChanges(); - queue.forEach(iter); - if (queueName === 'sync') Ember.endPropertyChanges(); + // Special-case: the EachProxy relies on immediate evaluation to + // establish its observers. + // + // TODO: Replace this with an efficient callback that the EachProxy + // can implement. + if (this._parent && this._parent._key === '@each') { + this.value(); + } +}; - if (log) Ember.Logger.log('End: Flush Sync Queue'); - } +var Wp = ChainNode.prototype; - } else { - queueNames = Ember.run.queues; - len = queueNames.length; - do { - this._queues = null; - for(idx=0;idx 0) paths[path]--; -/** - Runs the passed target and method inside of a runloop, ensuring any - deferred actions including bindings and views updates are flushed at the - end. + obj = this.value(); + tuple = normalizeTuple(obj, path); + if (tuple[0] === obj) { + path = tuple[1]; + key = firstKey(path); + path = path.slice(key.length+1); - Normally you should not need to invoke this method yourself. However if - you are implementing raw event handlers when interfacing with other - libraries or plugins, you should probably wrap all of your code inside this - call. + } else { + src = tuple[0]; + key = path.slice(0, 0-(tuple[1].length+1)); + path = tuple[1]; + } - @function - @param {Object} target - (Optional) target of method to call + tuple.length = 0; + this.unchain(key, path); +}; - @param {Function|String} method - Method to invoke. May be a function or a string. If you pass a string - then it will be looked up on the passed target. +Wp.count = 0; - @param {Object...} args - Any additional arguments you wish to pass to the method. +Wp.chain = function(key, path, src, separator) { + var chains = this._chains, node; + if (!chains) chains = this._chains = {}; - @returns {Object} return value from invoking the passed function. -*/ -Ember.run = run = function(target, method) { + node = chains[key]; + if (!node) node = chains[key] = new ChainNode(this, key, src, separator); + node.count++; // count chains... - var ret, loop; - run.begin(); - try { - if (target || method) ret = invoke(target, method, arguments, 2); - } finally { - run.end(); + // chain rest of path if there is one + if (path && path.length>0) { + key = firstKey(path); + path = path.slice(key.length+1); + node.chain(key, path); // NOTE: no src means it will observe changes... } - return ret; -}; - -/** - Begins a new RunLoop. Any deferred actions invoked after the begin will - be buffered until you invoke a matching call to Ember.run.end(). This is - an lower-level way to use a RunLoop instead of using Ember.run(). - - @returns {void} -*/ -Ember.run.begin = function() { - run.currentRunLoop = new RunLoop(run.currentRunLoop); }; -/** - Ends a RunLoop. This must be called sometime after you call Ember.run.begin() - to flush any deferred actions. This is a lower-level way to use a RunLoop - instead of using Ember.run(). +Wp.unchain = function(key, path) { + var chains = this._chains, node = chains[key]; - @returns {void} -*/ -Ember.run.end = function() { - ember_assert('must have a current run loop', run.currentRunLoop); - try { - run.currentRunLoop.end(); + // unchain rest of path first... + if (path && path.length>1) { + key = firstKey(path); + path = path.slice(key.length+1); + node.unchain(key, path); } - finally { - run.currentRunLoop = run.currentRunLoop.prev(); + + // delete node if needed. + node.count--; + if (node.count<=0) { + delete chains[node._key]; + node.destroy(); } + }; -/** - Array of named queues. This array determines the order in which queues - are flushed at the end of the RunLoop. You can define your own queues by - simply adding the queue name to this array. Normally you should not need - to inspect or modify this property. +Wp.willChange = function() { + var chains = this._chains; + if (chains) { + for(var key in chains) { + if (!chains.hasOwnProperty(key)) continue; + chains[key].willChange(); + } + } - @property {String} -*/ -Ember.run.queues = ['sync', 'actions', 'destroy', 'timers']; + if (this._parent) this._parent.chainWillChange(this, this._key, 1); +}; -/** - Adds the passed target/method and any optional arguments to the named - queue to be executed at the end of the RunLoop. If you have not already - started a RunLoop when calling this method one will be started for you - automatically. +Wp.chainWillChange = function(chain, path, depth) { + if (this._key) path = this._key+this._separator+path; - At the end of a RunLoop, any methods scheduled in this way will be invoked. - Methods will be invoked in an order matching the named queues defined in - the run.queues property. + if (this._parent) { + this._parent.chainWillChange(this, path, depth+1); + } else { + if (depth>1) Ember.propertyWillChange(this.value(), path); + path = 'this.'+path; + if (this._paths[path]>0) Ember.propertyWillChange(this.value(), path); + } +}; - @param {String} queue - The name of the queue to schedule against. Default queues are 'sync' and - 'actions' +Wp.chainDidChange = function(chain, path, depth) { + if (this._key) path = this._key+this._separator+path; + if (this._parent) { + this._parent.chainDidChange(this, path, depth+1); + } else { + if (depth>1) Ember.propertyDidChange(this.value(), path); + path = 'this.'+path; + if (this._paths[path]>0) Ember.propertyDidChange(this.value(), path); + } +}; - @param {Object} target - (Optional) target object to use as the context when invoking a method. +Wp.didChange = function(suppressEvent) { + // invalidate my own value first. + if (this._watching) { + var obj = this._parent.value(); + if (obj !== this._object) { + removeChainWatcher(this._object, this._key, this); + this._object = obj; + addChainWatcher(obj, this._key, this); + } + this._value = undefined; - @param {String|Function} method - The method to invoke. If you pass a string it will be resolved on the - target object at the time the scheduled item is invoked allowing you to - change the target function. + // Special-case: the EachProxy relies on immediate evaluation to + // establish its observers. + if (this._parent && this._parent._key === '@each') + this.value(); + } - @param {Object} arguments... - Optional arguments to be passed to the queued method. + // then notify chains... + var chains = this._chains; + if (chains) { + for(var key in chains) { + if (!chains.hasOwnProperty(key)) continue; + chains[key].didChange(suppressEvent); + } + } - @returns {void} -*/ -Ember.run.schedule = function(queue, target, method) { - var loop = run.autorun(); - loop.schedule.apply(loop, arguments); -}; + if (suppressEvent) return; -var autorunTimer; + // and finally tell parent about my path changing... + if (this._parent) this._parent.chainDidChange(this, this._key, 1); +}; -function autorun() { - autorunTimer = null; - if (run.currentRunLoop) run.end(); +// get the chains for the current object. If the current object has +// chains inherited from the proto they will be cloned and reconfigured for +// the current object. +/** @private */ +function chainsFor(obj) { + var m = meta(obj), ret = m.chains; + if (!ret) { + ret = m.chains = new ChainNode(null, null, obj); + } else if (ret.value() !== obj) { + ret = m.chains = ret.copy(obj); + } + return ret ; } -/** - Begins a new RunLoop if necessary and schedules a timer to flush the - RunLoop at a later time. This method is used by parts of Ember to - ensure the RunLoop always finishes. You normally do not need to call this - method directly. Instead use Ember.run(). - @returns {Ember.RunLoop} the new current RunLoop -*/ -Ember.run.autorun = function() { +/** @private */ +function notifyChains(obj, m, keyName, methodName, arg) { + var nodes = m.chainWatchers; - if (!run.currentRunLoop) { - run.begin(); + if (!nodes || nodes.__emberproto__ !== obj) return; // nothing to do - // TODO: throw during tests - if (Ember.testing) { - run.end(); - } else if (!autorunTimer) { - autorunTimer = setTimeout(autorun, 1); - } + nodes = nodes[keyName]; + if (!nodes) return; + + for(var key in nodes) { + if (!nodes.hasOwnProperty(key)) continue; + nodes[key][methodName](arg); } +} - return run.currentRunLoop; +Ember.overrideChains = function(obj, keyName, m) { + notifyChains(obj, m, keyName, 'didChange', true); }; -/** - Immediately flushes any events scheduled in the 'sync' queue. Bindings - use this queue so this method is a useful way to immediately force all - bindings in the application to sync. - - You should call this method anytime you need any changed state to propogate - throughout the app immediately without repainting the UI. +/** @private */ +function chainsWillChange(obj, keyName, m) { + notifyChains(obj, m, keyName, 'willChange'); +} - @returns {void} -*/ -Ember.run.sync = function() { - run.autorun(); - run.currentRunLoop.flush('sync'); -}; +/** @private */ +function chainsDidChange(obj, keyName, m) { + notifyChains(obj, m, keyName, 'didChange'); +} // .......................................................... -// TIMERS +// WATCH // -var timers = {}; // active timers... +var WATCHED_PROPERTY = Ember.SIMPLE_PROPERTY.watched; -var laterScheduled = false; -function invokeLaterTimers() { - var now = (+ new Date()), earliest = -1; - for(var key in timers) { - if (!timers.hasOwnProperty(key)) continue; - var timer = timers[key]; - if (timer && timer.expires) { - if (now >= timer.expires) { - delete timers[key]; - invoke(timer.target, timer.method, timer.args, 2); - } else { - if (earliest<0 || (timer.expires < earliest)) earliest=timer.expires; - } - } - } +/** + @private - // schedule next timeout to fire... - if (earliest>0) setTimeout(invokeLaterTimers, earliest-(+ new Date())); -} + Starts watching a property on an object. Whenever the property changes, + invokes Ember.propertyWillChange and Ember.propertyDidChange. This is the + primitive used by observers and dependent keys; usually you will never call + this method directly but instead use higher level methods like + Ember.addObserver(). +*/ +Ember.watch = function(obj, keyName) { -/** - Invokes the passed target/method and optional arguments after a specified - period if time. The last parameter of this method must always be a number - of milliseconds. + // can't watch length on Array - it is special... + if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; - You should use this method whenever you need to run some action after a - period of time inside of using setTimeout(). This method will ensure that - items that expire during the same script execution cycle all execute - together, which is often more efficient than using a real setTimeout. + var m = meta(obj), watching = m.watching, desc; + keyName = normalizePath(keyName); - @param {Object} target - (optional) target of method to invoke + // activate watching first time + if (!watching[keyName]) { + watching[keyName] = 1; + if (isKeyName(keyName)) { + desc = m.descs[keyName]; + desc = desc ? desc.watched : WATCHED_PROPERTY; + if (desc) Ember.defineProperty(obj, keyName, desc); + } else { + chainsFor(obj).add(keyName); + } - @param {Function|String} method - The method to invoke. If you pass a string it will be resolved on the - target at the time the method is invoked. + } else { + watching[keyName] = (watching[keyName]||0)+1; + } + return this; +}; - @param {Object...} args - Optional arguments to pass to the timeout. +Ember.isWatching = function(obj, keyName) { + return !!meta(obj).watching[keyName]; +}; - @param {Number} wait - Number of milliseconds to wait. +Ember.watch.flushPending = flushPendingChains; - @returns {Timer} an object you can use to cancel a timer at a later time. -*/ -Ember.run.later = function(target, method) { - var args, expires, timer, guid, wait; +/** @private */ +Ember.unwatch = function(obj, keyName) { + // can't watch length on Array - it is special... + if (keyName === 'length' && Ember.typeOf(obj)==='array') return this; - // setTimeout compatibility... - if (arguments.length===2 && 'function' === typeof target) { - wait = method; - method = target; - target = undefined; - args = [target, method]; + var watching = meta(obj).watching, desc, descs; + keyName = normalizePath(keyName); + if (watching[keyName] === 1) { + watching[keyName] = 0; + if (isKeyName(keyName)) { + desc = meta(obj).descs[keyName]; + desc = desc ? desc.unwatched : SIMPLE_PROPERTY; + if (desc) Ember.defineProperty(obj, keyName, desc); + } else { + chainsFor(obj).remove(keyName); + } - } else { - args = slice.call(arguments); - wait = args.pop(); + } else if (watching[keyName]>1) { + watching[keyName]--; } - expires = (+ new Date())+wait; - timer = { target: target, method: method, expires: expires, args: args }; - guid = Ember.guidFor(timer); - timers[guid] = timer; - run.once(timers, invokeLaterTimers); - return guid; + return this; }; -function invokeOnceTimer(guid, onceTimers) { - if (onceTimers[this.tguid]) delete onceTimers[this.tguid][this.mguid]; - if (timers[guid]) invoke(this.target, this.method, this.args, 2); - delete timers[guid]; -} - /** - Schedules an item to run one time during the current RunLoop. Calling - this method with the same target/method combination will have no effect. + @private - Note that although you can pass optional arguments these will not be - considered when looking for duplicates. New arguments will replace previous - calls. + Call on an object when you first beget it from another object. This will + setup any chained watchers on the object instance as needed. This method is + safe to call multiple times. +*/ +Ember.rewatch = function(obj) { + var m = meta(obj, false), chains = m.chains, bindings = m.bindings, key, b; - @param {Object} target - (optional) target of method to invoke + // make sure the object has its own guid. + if (GUID_KEY in obj && !obj.hasOwnProperty(GUID_KEY)) { + Ember.generateGuid(obj, 'ember'); + } - @param {Function|String} method - The method to invoke. If you pass a string it will be resolved on the - target at the time the method is invoked. + // make sure any chained watchers update. + if (chains && chains.value() !== obj) chainsFor(obj); - @param {Object...} args - Optional arguments to pass to the timeout. - - - @returns {Object} timer -*/ -Ember.run.once = function(target, method) { - var tguid = Ember.guidFor(target), mguid = Ember.guidFor(method), guid, timer; - - var onceTimers = run.autorun().onceTimers; - guid = onceTimers[tguid] && onceTimers[tguid][mguid]; - if (guid && timers[guid]) { - timers[guid].args = slice.call(arguments); // replace args - - } else { - timer = { - target: target, - method: method, - args: slice.call(arguments), - tguid: tguid, - mguid: mguid - }; - - guid = Ember.guidFor(timer); - timers[guid] = timer; - if (!onceTimers[tguid]) onceTimers[tguid] = {}; - onceTimers[tguid][mguid] = guid; // so it isn't scheduled more than once - - run.schedule('actions', timer, invokeOnceTimer, guid, onceTimers); + // if the object has bindings then sync them.. + if (bindings && m.proto!==obj) { + for (key in bindings) { + b = !DEP_SKIP[key] && obj[key]; + if (b && b instanceof Ember.Binding) b.fromDidChange(obj); + } } - return guid; + return this; }; -var scheduledNext = false; -function invokeNextTimers() { - scheduledNext = null; - for(var key in timers) { - if (!timers.hasOwnProperty(key)) continue; - var timer = timers[key]; - if (timer.next) { - delete timers[key]; - invoke(timer.target, timer.method, timer.args, 2); - } - } -} +// .......................................................... +// PROPERTY CHANGES +// /** - Schedules an item to run after control has been returned to the system. - This is often equivalent to calling setTimeout(function...,1). - - @param {Object} target - (optional) target of method to invoke + This function is called just before an object property is about to change. + It will notify any before observers and prepare caches among other things. - @param {Function|String} method - The method to invoke. If you pass a string it will be resolved on the - target at the time the method is invoked. + Normally you will not need to call this method directly but if for some + reason you can't directly watch a property you can invoke this method + manually along with `Ember.propertyDidChange()` which you should call just + after the property value changes. - @param {Object...} args - Optional arguments to pass to the timeout. + @memberOf Ember - @returns {Object} timer -*/ -Ember.run.next = function(target, method) { - var timer, guid; + @param {Object} obj + The object with the property that will change - timer = { - target: target, - method: method, - args: slice.call(arguments), - next: true - }; + @param {String} keyName + The property key (or path) that will change. - guid = Ember.guidFor(timer); - timers[guid] = timer; + @returns {void} +*/ +function propertyWillChange(obj, keyName) { + var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; + if (proto === obj) return ; + if (desc && desc.willChange) desc.willChange(obj, keyName); + dependentKeysWillChange(obj, keyName, m); + chainsWillChange(obj, keyName, m); + Ember.notifyBeforeObservers(obj, keyName); +} - if (!scheduledNext) scheduledNext = setTimeout(invokeNextTimers, 1); - return guid; -}; +Ember.propertyWillChange = propertyWillChange; /** - Cancels a scheduled item. Must be a value returned by `Ember.run.later()`, - `Ember.run.once()`, or `Ember.run.next()`. + This function is called just after an object property has changed. + It will notify any observers and clear caches among other things. - @param {Object} timer - Timer object to cancel + Normally you will not need to call this method directly but if for some + reason you can't directly watch a property you can invoke this method + manually along with `Ember.propertyWilLChange()` which you should call just + before the property value changes. - @returns {void} -*/ -Ember.run.cancel = function(timer) { - delete timers[timer]; -}; + @memberOf Ember -// .......................................................... -// DEPRECATED API -// + @param {Object} obj + The object with the property that will change -/** - @namespace - @name Ember.RunLoop - @deprecated - @description Compatibility for Ember.run + @param {String} keyName + The property key (or path) that will change. + + @returns {void} */ +function propertyDidChange(obj, keyName) { + var m = meta(obj, false), proto = m.proto, desc = m.descs[keyName]; + if (proto === obj) return ; + if (desc && desc.didChange) desc.didChange(obj, keyName); + dependentKeysDidChange(obj, keyName, m); + chainsDidChange(obj, keyName, m); + Ember.notifyObservers(obj, keyName); +} -/** - @deprecated - @method +Ember.propertyDidChange = propertyDidChange; - Use `#js:Ember.run.begin()` instead -*/ -Ember.RunLoop.begin = Ember.run.begin; +var NODE_STACK = []; /** - @deprecated - @method + Tears down the meta on an object so that it can be garbage collected. + Multiple calls will have no effect. - Use `#js:Ember.run.end()` instead + @param {Object} obj the object to destroy + @returns {void} */ -Ember.RunLoop.end = Ember.run.end; - - +Ember.destroy = function (obj) { + var meta = obj[META_KEY], node, nodes, key, nodeObject; + if (meta) { + obj[META_KEY] = null; + // remove chainWatchers to remove circular references that would prevent GC + node = meta.chains; + if (node) { + NODE_STACK.push(node); + // process tree + while (NODE_STACK.length > 0) { + node = NODE_STACK.pop(); + // push children + nodes = node._chains; + if (nodes) { + for (key in nodes) { + if (nodes.hasOwnProperty(key)) { + NODE_STACK.push(nodes[key]); + } + } + } + // remove chainWatcher in node object + if (node._watching) { + nodeObject = node._object; + if (nodeObject) { + removeChainWatcher(nodeObject, node._key, node); + } + } + } + } + } +}; })({}); - (function(exports) { // ========================================================================== -// Project: Ember Runtime +// Project: Ember Metal // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals ember_assert */ -// Ember.Logger -// get, getPath, setPath, trySetPath -// guidFor, isArray, meta -// addObserver, removeObserver -// Ember.run.schedule - -// .......................................................... -// CONSTANTS -// - +var o_create = Ember.platform.create; +var meta = Ember.meta; +var guidFor = Ember.guidFor; +var a_slice = Array.prototype.slice; /** - @static - - Debug parameter you can turn on. This will log all bindings that fire to - the console. This should be disabled in production code. Note that you - can also enable this from the console or temporarily. - - @type Boolean - @default NO -*/ -Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; + The event system uses a series of nested hashes to store listeners on an + object. When a listener is registered, or when an event arrives, these + hashes are consulted to determine which target and action pair to invoke. -/** - @static + The hashes are stored in the object's meta hash, and look like this: - Performance paramter. This will benchmark the time spent firing each - binding. + // Object's meta hash + { + listeners: { // variable name: `listenerSet` + "foo:changed": { // variable name: `targetSet` + [targetGuid]: { // variable name: `actionSet` + [methodGuid]: { // variable name: `action` + target: [Object object], + method: [Function function], + xform: [Function function] + } + } + } + } + } - @type Boolean */ -Ember.BENCHMARK_BINDING_NOTIFICATIONS = !!Ember.ENV.BENCHMARK_BINDING_NOTIFICATIONS; -/** - @static +/** @private */ +var metaPath = Ember.metaPath; - Performance parameter. This will benchmark the time spend configuring each - binding. +// Gets the set of all actions, keyed on the guid of each action's +// method property. +/** @private */ +function actionSetFor(obj, eventName, target, writable) { + var targetGuid = guidFor(target); + return metaPath(obj, ['listeners', eventName, targetGuid], writable); +} - @type Boolean -*/ -Ember.BENCHMARK_BINDING_SETUP = !!Ember.ENV.BENCHMARK_BINDING_SETUP; +// Gets the set of all targets, keyed on the guid of each action's +// target property. +/** @private */ +function targetSetFor(obj, eventName) { + var listenerSet = meta(obj, false).listeners; + if (!listenerSet) { return false; } + return listenerSet[eventName] || false; +} -/** - @static +// TODO: This knowledge should really be a part of the +// meta system. +var SKIP_PROPERTIES = { __ember_source__: true }; - Default placeholder for multiple values in bindings. +/** @private */ +function iterateSet(targetSet, callback, params) { + if (!targetSet) { return false; } + // Iterate through all elements of the target set + for(var targetGuid in targetSet) { + if (SKIP_PROPERTIES[targetGuid]) { continue; } - @type String - @default '@@MULT@@' -*/ -Ember.MULTIPLE_PLACEHOLDER = '@@MULT@@'; + var actionSet = targetSet[targetGuid]; + if (actionSet) { + // Iterate through the elements of the action set + for(var methodGuid in actionSet) { + if (SKIP_PROPERTIES[methodGuid]) { continue; } + + var action = actionSet[methodGuid]; + if (action) { + if (callback(action, params) === true) { + return true; + } + } + } + } + } + return false; +} -/** - @static +/** @private */ +function invokeAction(action, params) { + var method = action.method, target = action.target, xform = action.xform; + // If there is no target, the target is the object + // on which the event was fired. + if (!target) { target = params[0]; } + if ('string' === typeof method) { method = target[method]; } + + // Listeners can provide an `xform` function, which can perform + // arbitrary transformations, such as changing the order of + // parameters. + // + // This is primarily used by ember-runtime's observer system, which + // provides a higher level abstraction on top of events, including + // dynamically looking up current values and passing them into the + // registered listener. + if (xform) { + xform(target, method, params); + } else { + method.apply(target, params); + } +} - Default placeholder for empty values in bindings. Used by notEmpty() - helper unless you specify an alternative. +/** + The parameters passed to an event listener are not exactly the + parameters passed to an observer. if you pass an xform function, it will + be invoked and is able to translate event listener parameters into the form + that observers are expecting. - @type String - @default '@@EMPTY@@' + @memberOf Ember */ -Ember.EMPTY_PLACEHOLDER = '@@EMPTY@@'; +function addListener(obj, eventName, target, method, xform) { + ember_assert("You must pass at least an object and event name to Ember.addListener", !!obj && !!eventName); -// .......................................................... -// TYPE COERCION HELPERS -// + if (!method && 'function' === typeof target) { + method = target; + target = null; + } -// Coerces a non-array value into an array. -function MULTIPLE(val) { - if (val instanceof Array) return val; - if (val === undefined || val === null) return []; - return [val]; -} + var actionSet = actionSetFor(obj, eventName, target, true), + methodGuid = guidFor(method), ret; -// Treats a single-element array as the element. Otherwise -// returns a placeholder. -function SINGLE(val, placeholder) { - if (val instanceof Array) { - if (val.length>1) return placeholder; - else return val[0]; + if (!actionSet[methodGuid]) { + actionSet[methodGuid] = { target: target, method: method, xform: xform }; + } else { + actionSet[methodGuid].xform = xform; // used by observers etc to map params } - return val; -} - -// Coerces the binding value into a Boolean. -var BOOL = { - to: function (val) { - return !!val; + if ('function' === typeof obj.didAddListener) { + obj.didAddListener(eventName, target, method); } -}; -// Returns the Boolean inverse of the value. -var NOT = { - to: function NOT(val) { - return !val; + return ret; // return true if this is the first listener. +} + +/** @memberOf Ember */ +function removeListener(obj, eventName, target, method) { + if (!method && 'function'===typeof target) { + method = target; + target = null; } -}; -var get = Ember.get, - getPath = Ember.getPath, - setPath = Ember.setPath, - guidFor = Ember.guidFor, - isGlobalPath = Ember.isGlobalPath; + var actionSet = actionSetFor(obj, eventName, target, true), + methodGuid = guidFor(method); -// Applies a binding's transformations against a value. -function getTransformedValue(binding, val, obj, dir) { + // we can't simply delete this parameter, because if we do, we might + // re-expose the property from the prototype chain. + if (actionSet && actionSet[methodGuid]) { actionSet[methodGuid] = null; } - // First run a type transform, if it exists, that changes the fundamental - // type of the value. For example, some transforms convert an array to a - // single object. + if (obj && 'function'===typeof obj.didRemoveListener) { + obj.didRemoveListener(eventName, target, method); + } +} - var typeTransform = binding._typeTransform; - if (typeTransform) { val = typeTransform(val, binding._placeholder); } +// Suspend listener during callback. +// +// This should only be used by the target of the event listener +// when it is taking an action that would cause the event, e.g. +// an object might suspend its property change listener while it is +// setting that property. +/** @private */ +function suspendListener(obj, eventName, target, method, callback) { + if (!method && 'function' === typeof target) { + method = target; + target = null; + } - // handle transforms - var transforms = binding._transforms, - len = transforms ? transforms.length : 0, - idx; + var actionSet = actionSetFor(obj, eventName, target, true), + methodGuid = guidFor(method), + action = actionSet && actionSet[methodGuid]; - for(idx=0;idx 0) { + mixin.mixins = a_map(args, function(x) { + if (x instanceof Mixin) return x; - /** - Adds the specified transform to the array of transform functions. + // Note: Manually setup a primitive mixin here. This is the only + // way to actually get a primitive mixin. This way normal creation + // of mixins will give you combined mixins... + var mixin = new Mixin(); + mixin.properties = x; + return mixin; + }); + } + return mixin; +} - A transform is a hash with `to` and `from` properties. Each property - should be a function that performs a transformation in either the - forward or back direction. +var NATIVES = [Boolean, Object, Number, Array, Date, String]; +/** @private */ +function isMethod(obj) { + if ('function' !== typeof obj || obj.isMethod===false) return false; + return a_indexOf(NATIVES, obj)<0; +} - The functions you pass must have the following signature: +/** @private */ +function mergeMixins(mixins, m, descs, values, base) { + var len = mixins.length, idx, mixin, guid, props, value, key, ovalue, concats; - function(value) {}; + /** @private */ + function removeKeys(keyName) { + delete descs[keyName]; + delete values[keyName]; + } - They must also return the transformed value. + for(idx=0;idx null - - [a] => a - - [a,b,c] => Multiple Placeholder + for (key in props) { + if (!props.hasOwnProperty(key)) continue; + value = props[key]; + if (value instanceof Ember.Descriptor) { + if (value === REQUIRED && descs[key]) { continue; } - You can pass in an optional multiple placeholder or it will use the - default. + descs[key] = value; + values[key] = undefined; + } else { - Note that this transform will only happen on forwarded valued. Reverse - values are send unchanged. + // impl super if needed... + if (isMethod(value)) { + ovalue = (descs[key] === Ember.SIMPLE_PROPERTY) && values[key]; + if (!ovalue) ovalue = base[key]; + if ('function' !== typeof ovalue) ovalue = null; + if (ovalue) { + var o = value.__ember_observes__, ob = value.__ember_observesBefore__; + value = Ember.wrap(value, ovalue); + value.__ember_observes__ = o; + value.__ember_observesBefore__ = ob; + } + } else if ((concats && a_indexOf(concats, key)>=0) || key === 'concatenatedProperties') { + var baseValue = values[key] || base[key]; + value = baseValue ? baseValue.concat(value) : Ember.makeArray(value); + } - @param {String} fromPath from path or null - @param {Object} [placeholder] Placeholder value. - @returns {Ember.Binding} this - */ - single: function(placeholder) { - if (placeholder===undefined) placeholder = Ember.MULTIPLE_PLACEHOLDER; - this._typeTransform = SINGLE; - this._placeholder = placeholder; - return this; - }, + descs[key] = Ember.SIMPLE_PROPERTY; + values[key] = value; + } + } - /** - Adds a transform that will convert the passed value to an array. If - the value is null or undefined, it will be converted to an empty array. + // manually copy toString() because some JS engines do not enumerate it + if (props.hasOwnProperty('toString')) { + base.toString = props.toString; + } - @param {String} [fromPath] - @returns {Ember.Binding} this - */ - multiple: function() { - this._typeTransform = MULTIPLE; - this._placeholder = null; - return this; - }, + } else if (mixin.mixins) { + mergeMixins(mixin.mixins, m, descs, values, base); + if (mixin._without) a_forEach(mixin._without, removeKeys); + } + } +} - /** - Adds a transform to convert the value to a bool value. If the value is - an array it will return YES if array is not empty. If the value is a - string it will return YES if the string is not empty. +/** @private */ +var defineProperty = Ember.defineProperty; - @returns {Ember.Binding} this - */ - bool: function() { - this.transform(BOOL); - return this; - }, +/** @private */ +function writableReq(obj) { + var m = Ember.meta(obj), req = m.required; + if (!req || (req.__emberproto__ !== obj)) { + req = m.required = req ? o_create(req) : { __ember_count__: 0 }; + req.__emberproto__ = obj; + } + return req; +} - /** - Adds a transform that will return the placeholder value if the value is - null, undefined, an empty array or an empty string. See also notNull(). +/** @private */ +function getObserverPaths(value) { + return ('function' === typeof value) && value.__ember_observes__; +} - @param {Object} [placeholder] Placeholder value. - @returns {Ember.Binding} this - */ - notEmpty: function(placeholder) { - // Display warning for users using the SproutCore 1.x-style API. - ember_assert("notEmpty should only take a placeholder as a parameter. You no longer need to pass null as the first parameter.", arguments.length < 2); +/** @private */ +function getBeforeObserverPaths(value) { + return ('function' === typeof value) && value.__ember_observesBefore__; +} - if (placeholder == undefined) { placeholder = Ember.EMPTY_PLACEHOLDER; } +Ember._mixinBindings = function(obj, key, value, m) { + return value; +}; - this.transform({ - to: function(val) { return empty(val) ? placeholder : val; } - }); +/** @private */ +function applyMixin(obj, mixins, partial) { + var descs = {}, values = {}, m = Ember.meta(obj), req = m.required; + var key, willApply, didApply, value, desc; - return this; - }, + var mixinBindings = Ember._mixinBindings; - /** - Adds a transform that will return the placeholder value if the value is - null or undefined. Otherwise it will passthrough untouched. See also notEmpty(). + // Go through all mixins and hashes passed in, and: + // + // * Handle concatenated properties + // * Set up _super wrapping if necessary + // * Set up descriptors (simple, watched or computed properties) + // * Copying `toString` in broken browsers + mergeMixins(mixins, meta(obj), descs, values, obj); - @param {String} fromPath from path or null - @param {Object} [placeholder] Placeholder value. - @returns {Ember.Binding} this - */ - notNull: function(placeholder) { - if (placeholder == undefined) { placeholder = Ember.EMPTY_PLACEHOLDER; } + if (MixinDelegate.detect(obj)) { + willApply = values.willApplyProperty || obj.willApplyProperty; + didApply = values.didApplyProperty || obj.didApplyProperty; + } - this.transform({ - to: function(val) { return val == null ? placeholder : val; } - }); + for(key in descs) { + if (!descs.hasOwnProperty(key)) continue; - return this; - }, + desc = descs[key]; + value = values[key]; - /** - Adds a transform to convert the value to the inverse of a bool value. This - uses the same transform as bool() but inverts it. + if (desc === REQUIRED) { + if (!(key in obj)) { + if (!partial) throw new Error('Required property not defined: '+key); - @returns {Ember.Binding} this - */ - not: function() { - this.transform(NOT); - return this; - }, + // for partial applies add to hash of required keys + req = writableReq(obj); + req.__ember_count__++; + req[key] = true; + } - /** - Adds a transform that will return YES if the value is null or undefined, NO otherwise. + } else { - @returns {Ember.Binding} this - */ - isNull: function() { - this.transform(function(val) { return val == null; }); - return this; - }, + while (desc instanceof Alias) { - /** @private */ - toString: function() { - var oneWay = this._oneWay ? '[oneWay]' : ''; - return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; - }, + var altKey = desc.methodName; + if (descs[altKey]) { + value = values[altKey]; + desc = descs[altKey]; + } else if (m.descs[altKey]) { + desc = m.descs[altKey]; + value = desc.val(obj, altKey); + } else { + value = obj[altKey]; + desc = Ember.SIMPLE_PROPERTY; + } + } - // .......................................................... - // CONNECT AND SYNC - // + if (willApply) willApply.call(obj, key); - /** - Attempts to connect this binding instance so that it can receive and relay - changes. This method will raise an exception if you have not set the - from/to properties yet. + var observerPaths = getObserverPaths(value), + curObserverPaths = observerPaths && getObserverPaths(obj[key]), + beforeObserverPaths = getBeforeObserverPaths(value), + curBeforeObserverPaths = beforeObserverPaths && getBeforeObserverPaths(obj[key]), + len, idx; - @param {Object} obj - The root object for this binding. + if (curObserverPaths) { + len = curObserverPaths.length; + for(idx=0;idx0) { + var keys = []; + for(key in req) { + if (META_SKIP[key]) continue; + keys.push(key); + } + throw new Error('Required properties not defined: '+keys.join(',')); + } + return obj; +} - @param {Object} obj - The root object you passed when connecting the binding. +Ember.mixin = function(obj) { + var args = a_slice.call(arguments, 1); + return applyMixin(obj, args, false); +}; - @returns {Ember.Binding} this - */ - disconnect: function(obj) { - ember_assert('Must pass a valid object to Ember.Binding.disconnect()', !!obj); - var oneWay = this._oneWay, operand = this._operand; +/** + @constructor +*/ +Ember.Mixin = function() { return initMixin(this, arguments); }; - // remove an observer on the object so we're no longer notified of - // changes that should update bindings. - Ember.removeObserver(obj, this._from, this, this.fromDidChange); +/** @private */ +Mixin = Ember.Mixin; - // if there is an operand, remove the observer from it as well - if (operand) Ember.removeObserver(obj, operand, this, this.fromDidChange); +/** @private */ +Mixin._apply = applyMixin; - // if the binding is two-way, remove the observer from the target as well - if (!oneWay) Ember.removeObserver(obj, this._to, this, this.toDidChange); +Mixin.applyPartial = function(obj) { + var args = a_slice.call(arguments, 1); + return applyMixin(obj, args, true); +}; - this._readyToSync = false; // disable scheduled syncs... - return this; - }, +Mixin.create = function() { + classToString.processed = false; + var M = this; + return initMixin(new M(), arguments); +}; - // .......................................................... - // PRIVATE - // +Mixin.prototype.reopen = function() { - /** @private - called when the from side changes */ - fromDidChange: function(target) { - this._scheduleSync(target, 'fwd'); - }, + var mixin, tmp; - /** @private - called when the to side changes */ - toDidChange: function(target) { - this._scheduleSync(target, 'back'); - }, + if (this.properties) { + mixin = Mixin.create(); + mixin.properties = this.properties; + delete this.properties; + this.mixins = [mixin]; + } - /** @private */ - _scheduleSync: function(obj, dir) { - var guid = guidFor(obj), existingDir = this[guid]; + var len = arguments.length, mixins = this.mixins, idx; - // if we haven't scheduled the binding yet, schedule it - if (!existingDir) { - Ember.run.schedule('sync', this, this._sync, obj); - this[guid] = dir; + for(idx=0;idx= 0) { + if (_detect(mixins[loc], targetMixin, seen)) return true; + } + return false; +} - // apply any operations to the object, then apply transforms - var fromValue = getTransformedFromValue(obj, this); - var toValue = getTransformedToValue(obj, this); +Mixin.prototype.detect = function(obj) { + if (!obj) return false; + if (obj instanceof Mixin) return _detect(obj, this, {}); + return !!meta(obj, false)[Ember.guidFor(this)]; +}; - if (toValue === fromValue) { return; } +Mixin.prototype.without = function() { + var ret = new Mixin(this); + ret._without = a_slice.call(arguments); + return ret; +}; - // if we're synchronizing from the remote object... - if (direction === 'fwd') { - if (log) { Ember.Logger.log(' ', this.toString(), toValue, '->', fromValue, obj); } - Ember.trySetPath(Ember.isGlobalPath(toPath) ? window : obj, toPath, fromValue); +/** @private */ +function _keys(ret, mixin, seen) { + if (seen[Ember.guidFor(mixin)]) return; + seen[Ember.guidFor(mixin)] = true; - // if we're synchronizing *to* the remote object - } else if (direction === 'back') {// && !this._oneWay) { - if (log) { Ember.Logger.log(' ', this.toString(), toValue, '<-', fromValue, obj); } - Ember.trySetPath(Ember.isGlobalPath(fromPath) ? window : obj, fromPath, toValue); + if (mixin.properties) { + var props = mixin.properties; + for(var key in props) { + if (props.hasOwnProperty(key)) ret[key] = true; } + } else if (mixin.mixins) { + a_forEach(mixin.mixins, function(x) { _keys(ret, x, seen); }); } +} +Mixin.prototype.keys = function() { + var keys = {}, seen = {}, ret = []; + _keys(keys, this, seen); + for(var key in keys) { + if (keys.hasOwnProperty(key)) ret.push(key); + } + return ret; }; -function mixinProperties(to, from) { - for (var key in from) { - if (from.hasOwnProperty(key)) { - to[key] = from[key]; - } - } -} +/** @private - make Mixin's have nice displayNames */ -mixinProperties(Binding, -/** @scope Ember.Binding */ { +var NAME_KEY = Ember.GUID_KEY+'_name'; +var get = Ember.get; - /** - @see Ember.Binding.prototype.from - */ - from: function() { - var C = this, binding = new C(); - return binding.from.apply(binding, arguments); - }, +/** @private */ +function processNames(paths, root, seen) { + var idx = paths.length; + for(var key in root) { + if (!root.hasOwnProperty || !root.hasOwnProperty(key)) continue; + var obj = root[key]; + paths[idx] = key; - /** - @see Ember.Binding.prototype.to - */ - to: function() { - var C = this, binding = new C(); - return binding.to.apply(binding, arguments); - }, + if (obj && obj.toString === classToString) { + obj[NAME_KEY] = paths.join('.'); + } else if (obj && get(obj, 'isNamespace')) { + if (seen[Ember.guidFor(obj)]) continue; + seen[Ember.guidFor(obj)] = true; + processNames(paths, obj, seen); + } - /** - @see Ember.Binding.prototype.oneWay - */ - oneWay: function(from, flag) { - var C = this, binding = new C(null, from); - return binding.oneWay(flag); - }, + } + paths.length = idx; // cut out last item +} - /** - @see Ember.Binding.prototype.single - */ - single: function(from) { - var C = this, binding = new C(null, from); - return binding.single(); - }, +/** @private */ +function findNamespaces() { + var Namespace = Ember.Namespace, obj; - /** - @see Ember.Binding.prototype.multiple - */ - multiple: function(from) { - var C = this, binding = new C(null, from); - return binding.multiple(); - }, + if (Namespace.PROCESSED) { return; } - /** - @see Ember.Binding.prototype.transform - */ - transform: function(func) { - var C = this, binding = new C(); - return binding.transform(func); - }, + for (var prop in window) { + // get(window.globalStorage, 'isNamespace') would try to read the storage for domain isNamespace and cause exception in Firefox. + // globalStorage is a storage obsoleted by the WhatWG storage specification. See https://developer.mozilla.org/en/DOM/Storage#globalStorage + if (prop === "globalStorage" && window.StorageList && window.globalStorage instanceof window.StorageList) { continue; } + // Don't access properties on parent window, which will throw "Access/Permission Denied" in IE/Firefox for windows on different domains + if (prop === "parent" || prop === "top" || prop === "frameElement" || prop === "content") { continue; } + // Unfortunately, some versions of IE don't support window.hasOwnProperty + if (window.hasOwnProperty && !window.hasOwnProperty(prop)) { continue; } - /** - @see Ember.Binding.prototype.notEmpty - */ - notEmpty: function(from, placeholder) { - var C = this, binding = new C(null, from); - return binding.notEmpty(placeholder); - }, + obj = window[prop]; - /** - @see Ember.Binding.prototype.bool - */ - bool: function(from) { - var C = this, binding = new C(null, from); - return binding.bool(); - }, + if (obj && get(obj, 'isNamespace')) { + obj[NAME_KEY] = prop; + } + } +} - /** - @see Ember.Binding.prototype.not - */ - not: function(from) { - var C = this, binding = new C(null, from); - return binding.not(); - }, +Ember.identifyNamespaces = findNamespaces; - /** - Adds a transform that forwards the logical 'AND' of values at 'pathA' and - 'pathB' whenever either source changes. Note that the transform acts - strictly as a one-way binding, working only in the direction +/** @private */ +superClassString = function(mixin) { + var superclass = mixin.superclass; + if (superclass) { + if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; } + else { return superClassString(superclass); } + } else { + return; + } +}; - 'pathA' AND 'pathB' --> value (value returned is the result of ('pathA' && 'pathB')) +/** @private */ +classToString = function() { + var Namespace = Ember.Namespace, namespace; - Usage example where a delete button's `isEnabled` value is determined by - whether something is selected in a list and whether the current user is - allowed to delete: + // TODO: Namespace should really be in Metal + if (Namespace) { + if (!this[NAME_KEY] && !classToString.processed) { + if (!Namespace.PROCESSED) { + findNamespaces(); + Namespace.PROCESSED = true; + } - deleteButton: Ember.ButtonView.design({ - isEnabledBinding: Ember.Binding.and('MyApp.itemsController.hasSelection', 'MyApp.userController.canDelete') - }) + classToString.processed = true; - @param {String} pathA The first part of the conditional - @param {String} pathB The second part of the conditional - */ - and: function(pathA, pathB) { - var C = this, binding = new C(null, pathA).oneWay(); - binding._operand = pathB; - binding._operation = AND_OPERATION; - return binding; - }, + var namespaces = Namespace.NAMESPACES; + for (var i=0, l=namespaces.length; i value (value returned is the result of ('pathA' || 'pathB')) +Mixin.prototype.toString = classToString; - @param {String} pathA The first part of the conditional - @param {String} pathB The second part of the conditional - */ - or: function(pathA, pathB) { - var C = this, binding = new C(null, pathA).oneWay(); - binding._operand = pathB; - binding._operation = OR_OPERATION; - return binding; +// returns the mixins currently applied to the specified object +// TODO: Make Ember.mixin +Mixin.mixins = function(obj) { + var ret = [], mixins = meta(obj, false), key, mixin; + for(key in mixins) { + if (META_SKIP[key]) continue; + mixin = mixins[key]; + + // skip primitive mixins since these are always anonymous + if (!mixin.properties) ret.push(mixins[key]); } + return ret; +}; -}); +REQUIRED = new Ember.Descriptor(); +REQUIRED.toString = function() { return '(Required Property)'; }; -/** - @class +Ember.required = function() { + return REQUIRED; +}; - A binding simply connects the properties of two objects so that whenever the - value of one property changes, the other property will be changed also. You - do not usually work with Binding objects directly but instead describe - bindings in your class definition using something like: +/** @private */ +Alias = function(methodName) { + this.methodName = methodName; +}; +Alias.prototype = new Ember.Descriptor(); - valueBinding: "MyApp.someController.title" +Ember.alias = function(methodName) { + return new Alias(methodName); +}; - This will create a binding from `MyApp.someController.title` to the `value` - property of your object instance automatically. Now the two values will be - kept in sync. +Ember.MixinDelegate = Mixin.create({ - ## Customizing Your Bindings + willApplyProperty: Ember.required(), + didApplyProperty: Ember.required() - In addition to synchronizing values, bindings can also perform some basic - transforms on values. These transforms can help to make sure the data fed - into one object always meets the expectations of that object regardless of - what the other object outputs. +}); - To customize a binding, you can use one of the many helper methods defined - on Ember.Binding like so: +/** @private */ +MixinDelegate = Ember.MixinDelegate; - valueBinding: Ember.Binding.single("MyApp.someController.title") - This will create a binding just like the example above, except that now the - binding will convert the value of `MyApp.someController.title` to a single - object (removing any arrays) before applying it to the `value` property of - your object. +// .......................................................... +// OBSERVER HELPER +// - You can also chain helper methods to build custom bindings like so: +Ember.observer = function(func) { + var paths = a_slice.call(arguments, 1); + func.__ember_observes__ = paths; + return func; +}; - valueBinding: Ember.Binding.single("MyApp.someController.title").notEmpty("(EMPTY)") +Ember.beforeObserver = function(func) { + var paths = a_slice.call(arguments, 1); + func.__ember_observesBefore__ = paths; + return func; +}; - This will force the value of MyApp.someController.title to be a single value - and then check to see if the value is "empty" (null, undefined, empty array, - or an empty string). If it is empty, the value will be set to the string - "(EMPTY)". - ## One Way Bindings - One especially useful binding customization you can use is the `oneWay()` - helper. This helper tells Ember that you are only interested in - receiving changes on the object you are binding from. For example, if you - are binding to a preference and you want to be notified if the preference - has changed, but your object will not be changing the preference itself, you - could do: - bigTitlesBinding: Ember.Binding.oneWay("MyApp.preferencesController.bigTitles") - This way if the value of MyApp.preferencesController.bigTitles changes the - "bigTitles" property of your object will change also. However, if you - change the value of your "bigTitles" property, it will not update the - preferencesController. - One way bindings are almost twice as fast to setup and twice as fast to - execute because the binding only has to worry about changes to one side. - You should consider using one way bindings anytime you have an object that - may be created frequently and you do not intend to change a property; only - to monitor it for changes. (such as in the example above). +})({}); - ## Adding Custom Transforms +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2010 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +/*globals ember_assert */ +// Ember.Logger +// Ember.watch.flushPending +// Ember.beginPropertyChanges, Ember.endPropertyChanges +// Ember.guidFor +// Ember.ArrayUtils - In addition to using the standard helpers provided by Ember, you can - also defined your own custom transform functions which will be used to - convert the value. To do this, just define your transform function and add - it to the binding with the transform() helper. The following example will - not allow Integers less than ten. Note that it checks the value of the - bindings and allows all other values to pass: +// .......................................................... +// HELPERS +// - valueBinding: Ember.Binding.transform(function(value, binding) { - return ((Ember.typeOf(value) === 'number') && (value < 10)) ? 10 : value; - }).from("MyApp.someController.value") +var slice = Array.prototype.slice; +var forEach = Ember.ArrayUtils.forEach; - If you would like to instead use this transform on a number of bindings, - you can also optionally add your own helper method to Ember.Binding. This - method should simply return the value of `this.transform()`. The example - below adds a new helper called `notLessThan()` which will limit the value to - be not less than the passed minimum: +// invokes passed params - normalizing so you can pass target/func, +// target/string or just func +/** @private */ +function invoke(target, method, args, ignore) { - Ember.Binding.reopen({ - notLessThan: function(minValue) { - return this.transform(function(value, binding) { - return ((Ember.typeOf(value) === 'number') && (value < minValue)) ? minValue : value; - }); - } - }); + if (method===undefined) { + method = target; + target = undefined; + } - You could specify this in your core.js file, for example. Then anywhere in - your application you can use it to define bindings like so: + if ('string'===typeof method) method = target[method]; + if (args && ignore>0) { + args = args.length>ignore ? slice.call(args, ignore) : null; + } - valueBinding: Ember.Binding.from("MyApp.someController.value").notLessThan(10) + // Unfortunately in some browsers we lose the backtrace if we rethrow the existing error, + // so in the event that we don't have an `onerror` handler we don't wrap in a try/catch + if ('function' === typeof Ember.onerror) { + try { + // IE8's Function.prototype.apply doesn't accept undefined/null arguments. + return method.apply(target || this, args || []); + } catch (error) { + Ember.onerror(error); + } + } else { + // IE8's Function.prototype.apply doesn't accept undefined/null arguments. + return method.apply(target || this, args || []); + } +} - Also, remember that helpers are chained so you can use your helper along - with any other helpers. The example below will create a one way binding that - does not allow empty values or values less than 10: - valueBinding: Ember.Binding.oneWay("MyApp.someController.value").notEmpty().notLessThan(10) +// .......................................................... +// RUNLOOP +// - Finally, it's also possible to specify bi-directional transforms. To do this, - you can pass a hash to `transform` with `to` and `from`. In the following - example, we are expecting a lowercase string that we want to transform to - uppercase. +var timerMark; // used by timers... - valueBinding: Ember.Binding.transform({ - to: function(value, binding) { return value.toUpperCase(); }, - from: function(value, binding) { return value.toLowerCase(); } +/** @private */ +var K = function() {}; - ## How to Manually Adding Binding +/** @private */ +var RunLoop = function(prev) { + var self; - All of the examples above show you how to configure a custom binding, but - the result of these customizations will be a binding template, not a fully - active binding. The binding will actually become active only when you - instantiate the object the binding belongs to. It is useful however, to - understand what actually happens when the binding is activated. + if (this instanceof RunLoop) { + self = this; + } else { + self = new K(); + } - For a binding to function it must have at least a "from" property and a "to" - property. The from property path points to the object/key that you want to - bind from while the to path points to the object/key you want to bind to. + self._prev = prev || null; + self.onceTimers = {}; - When you define a custom binding, you are usually describing the property - you want to bind from (such as "MyApp.someController.value" in the examples - above). When your object is created, it will automatically assign the value - you want to bind "to" based on the name of your binding key. In the - examples above, during init, Ember objects will effectively call - something like this on your binding: + return self; +}; - binding = Ember.Binding.from(this.valueBinding).to("value"); +K.prototype = RunLoop.prototype; - This creates a new binding instance based on the template you provide, and - sets the to path to the "value" property of the new object. Now that the - binding is fully configured with a "from" and a "to", it simply needs to be - connected to become active. This is done through the connect() method: +RunLoop.prototype = { + end: function() { + this.flush(); + }, - binding.connect(this); + prev: function() { + return this._prev; + }, - Note that when you connect a binding you pass the object you want it to be - connected to. This object will be used as the root for both the from and - to side of the binding when inspecting relative paths. This allows the - binding to be automatically inherited by subclassed objects as well. + // .......................................................... + // Delayed Actions + // - Now that the binding is connected, it will observe both the from and to side - and relay changes. + schedule: function(queueName, target, method) { + var queues = this._queues, queue; + if (!queues) queues = this._queues = {}; + queue = queues[queueName]; + if (!queue) queue = queues[queueName] = []; - If you ever needed to do so (you almost never will, but it is useful to - understand this anyway), you could manually create an active binding by - using the Ember.bind() helper method. (This is the same method used by - to setup your bindings on objects): + var args = arguments.length>3 ? slice.call(arguments, 3) : null; + queue.push({ target: target, method: method, args: args }); + return this; + }, - Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value"); + flush: function(queueName) { + var queues = this._queues, queueNames, idx, len, queue, log; - Both of these code fragments have the same effect as doing the most friendly - form of binding creation like so: + if (!queues) return this; // nothing to do - MyApp.anotherObject = Ember.Object.create({ - valueBinding: "MyApp.someController.value", + function iter(item) { + invoke(item.target, item.method, item.args); + } - // OTHER CODE FOR THIS OBJECT... + Ember.watch.flushPending(); // make sure all chained watchers are setup - }); + if (queueName) { + while (this._queues && (queue = this._queues[queueName])) { + this._queues[queueName] = null; - Ember's built in binding creation method makes it easy to automatically - create bindings for you. You should always use the highest-level APIs - available, even if you understand how to it works underneath. + // the sync phase is to allow property changes to propogate. don't + // invoke observers until that is finished. + if (queueName === 'sync') { + log = Ember.LOG_BINDINGS; + if (log) Ember.Logger.log('Begin: Flush Sync Queue'); - @since Ember 0.9 -*/ -Ember.Binding = Binding; + Ember.beginPropertyChanges(); + try { + forEach(queue, iter); + } finally { + Ember.endPropertyChanges(); + } -/** - Global helper method to create a new binding. Just pass the root object - along with a to and from path to create and connect the binding. The new - binding object will be returned which you can further configure with - transforms and other conditions. + if (log) Ember.Logger.log('End: Flush Sync Queue'); - @param {Object} obj - The root object of the transform. + } else { + forEach(queue, iter); + } + } - @param {String} to - The path to the 'to' side of the binding. Must be relative to obj. + } else { + queueNames = Ember.run.queues; + len = queueNames.length; + do { + this._queues = null; + for(idx=0;idx0, - ret, oldSuspended, lastSetValues; - oldSuspended = desc._suspended; - desc._suspended = this; +/** + Begins a new RunLoop. Any deferred actions invoked after the begin will + be buffered until you invoke a matching call to Ember.run.end(). This is + an lower-level way to use a RunLoop instead of using Ember.run(). - watched = watched && m.lastSetValues[keyName]!==guidFor(value); - if (watched) { - m.lastSetValues[keyName] = guidFor(value); - Ember.propertyWillChange(this, keyName); - } - - if (cacheable) delete m.cache[keyName]; - ret = func.call(this, keyName, value); - if (cacheable) m.cache[keyName] = ret; - if (watched) Ember.propertyDidChange(this, keyName); - desc._suspended = oldSuspended; - return ret; - }; -} + @returns {void} +*/ +Ember.run.begin = function() { + run.currentRunLoop = new RunLoop(run.currentRunLoop); +}; /** - @extends Ember.ComputedProperty - @private + Ends a RunLoop. This must be called sometime after you call Ember.run.begin() + to flush any deferred actions. This is a lower-level way to use a RunLoop + instead of using Ember.run(). + + @returns {void} */ -var Cp = ComputedProperty.prototype; +Ember.run.end = function() { + ember_assert('must have a current run loop', run.currentRunLoop); + try { + run.currentRunLoop.end(); + } + finally { + run.currentRunLoop = run.currentRunLoop.prev(); + } +}; /** - Call on a computed property to set it into cacheable mode. When in this - mode the computed property will automatically cache the return value of - your function until one of the dependent keys changes. + Array of named queues. This array determines the order in which queues + are flushed at the end of the RunLoop. You can define your own queues by + simply adding the queue name to this array. Normally you should not need + to inspect or modify this property. - @param {Boolean} aFlag optional set to false to disable cacheing - @returns {Ember.ComputedProperty} receiver + @property {String} */ -Cp.cacheable = function(aFlag) { - this._cacheable = aFlag!==false; - return this; -}; +Ember.run.queues = ['sync', 'actions', 'destroy', 'timers']; /** - Sets the dependent keys on this computed property. Pass any number of - arguments containing key paths that this computed property depends on. - - @param {String} path... zero or more property paths - @returns {Ember.ComputedProperty} receiver + Adds the passed target/method and any optional arguments to the named + queue to be executed at the end of the RunLoop. If you have not already + started a RunLoop when calling this method one will be started for you + automatically. + + At the end of a RunLoop, any methods scheduled in this way will be invoked. + Methods will be invoked in an order matching the named queues defined in + the run.queues property. + + @param {String} queue + The name of the queue to schedule against. Default queues are 'sync' and + 'actions' + + @param {Object} target + (Optional) target object to use as the context when invoking a method. + + @param {String|Function} method + The method to invoke. If you pass a string it will be resolved on the + target object at the time the scheduled item is invoked allowing you to + change the target function. + + @param {Object} arguments... + Optional arguments to be passed to the queued method. + + @returns {void} */ -Cp.property = function() { - this._dependentKeys = a_slice.call(arguments); - return this; +Ember.run.schedule = function(queue, target, method) { + var loop = run.autorun(); + loop.schedule.apply(loop, arguments); }; -/** @private - impl descriptor API */ -Cp.setup = function(obj, keyName, value) { - CP_DESC.get = mkCpGetter(keyName, this); - CP_DESC.set = mkCpSetter(keyName, this); - o_defineProperty(obj, keyName, CP_DESC); - CP_DESC.get = CP_DESC.set = null; - addDependentKeys(this, obj, keyName); -}; +var autorunTimer; -/** @private - impl descriptor API */ -Cp.teardown = function(obj, keyName) { - var keys = this._dependentKeys, - len = keys ? keys.length : 0; - for(var idx=0;idx0, - ret, oldSuspended, lastSetValues; +/** + Immediately flushes any events scheduled in the 'sync' queue. Bindings + use this queue so this method is a useful way to immediately force all + bindings in the application to sync. - oldSuspended = this._suspended; - this._suspended = obj; + You should call this method anytime you need any changed state to propogate + throughout the app immediately without repainting the UI. - watched = watched && m.lastSetValues[keyName]!==guidFor(value); - if (watched) { - m.lastSetValues[keyName] = guidFor(value); - Ember.propertyWillChange(obj, keyName); - } - - if (cacheable) delete m.cache[keyName]; - ret = this.func.call(obj, keyName, value); - if (cacheable) m.cache[keyName] = ret; - if (watched) Ember.propertyDidChange(obj, keyName); - this._suspended = oldSuspended; - return ret; + @returns {void} +*/ +Ember.run.sync = function() { + run.autorun(); + run.currentRunLoop.flush('sync'); }; -Cp.val = function(obj, keyName) { - return meta(obj, false).values[keyName]; -}; +// .......................................................... +// TIMERS +// -if (!Ember.platform.hasPropertyAccessors) { - Cp.setup = function(obj, keyName, value) { - obj[keyName] = undefined; // so it shows up in key iteration - addDependentKeys(this, obj, keyName); - }; - -} else if (!USE_ACCESSORS) { - Cp.setup = function(obj, keyName) { - // throw exception if not using Ember.get() and Ember.set() when supported - o_defineProperty(obj, keyName, CP_DESC); - addDependentKeys(this, obj, keyName); - }; -} +var timers = {}; // active timers... -/** - This helper returns a new property descriptor that wraps the passed - computed property function. You can use this helper to define properties - with mixins or via Ember.defineProperty(). - - The function you pass will be used to both get and set property values. - The function should accept two parameters, key and value. If value is not - undefined you should set the value first. In either case return the - current value of the property. - - @param {Function} func - The computed property function. - - @returns {Ember.ComputedProperty} property descriptor instance -*/ -Ember.computed = function(func) { - return new ComputedProperty(func); -}; +var laterScheduled = false; +/** @private */ +function invokeLaterTimers() { + var now = (+ new Date()), earliest = -1; + for(var key in timers) { + if (!timers.hasOwnProperty(key)) continue; + var timer = timers[key]; + if (timer && timer.expires) { + if (now >= timer.expires) { + delete timers[key]; + invoke(timer.target, timer.method, timer.args, 2); + } else { + if (earliest<0 || (timer.expires < earliest)) earliest=timer.expires; + } + } + } -})({}); + // schedule next timeout to fire... + if (earliest>0) setTimeout(invokeLaterTimers, earliest-(+ new Date())); +} +/** + Invokes the passed target/method and optional arguments after a specified + period if time. The last parameter of this method must always be a number + of milliseconds. -(function(exports) { -// ========================================================================== -// Project: Ember Metal -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -/*globals ember_assert */ -var o_create = Ember.platform.create; -var meta = Ember.meta; -var guidFor = Ember.guidFor; -var array_Slice = Array.prototype.slice; + You should use this method whenever you need to run some action after a + period of time inside of using setTimeout(). This method will ensure that + items that expire during the same script execution cycle all execute + together, which is often more efficient than using a real setTimeout. -/** - The event system uses a series of nested hashes to store listeners on an - object. When a listener is registered, or when an event arrives, these - hashes are consulted to determine which target and action pair to invoke. + @param {Object} target + (optional) target of method to invoke - The hashes are stored in the object's meta hash, and look like this: + @param {Function|String} method + The method to invoke. If you pass a string it will be resolved on the + target at the time the method is invoked. - // Object's meta hash - { - listeners: { // variable name: `listenerSet` - "foo:changed": { // variable name: `targetSet` - [targetGuid]: { // variable name: `actionSet` - [methodGuid]: { // variable name: `action` - target: [Object object], - method: [Function function], - xform: [Function function] - } - } - } - } - } + @param {Object...} args + Optional arguments to pass to the timeout. + + @param {Number} wait + Number of milliseconds to wait. + @returns {Timer} an object you can use to cancel a timer at a later time. */ +Ember.run.later = function(target, method) { + var args, expires, timer, guid, wait; -/** @private */ -var metaPath = Ember.metaPath; + // setTimeout compatibility... + if (arguments.length===2 && 'function' === typeof target) { + wait = method; + method = target; + target = undefined; + args = [target, method]; -// Gets the set of all actions, keyed on the guid of each action's -// method property. -function actionSetFor(obj, eventName, target, writable) { - var targetGuid = guidFor(target); - return metaPath(obj, ['listeners', eventName, targetGuid], writable); -} + } else { + args = slice.call(arguments); + wait = args.pop(); + } -// Gets the set of all targets, keyed on the guid of each action's -// target property. -function targetSetFor(obj, eventName) { - var listenerSet = meta(obj, false).listeners; - if (!listenerSet) { return false; } + expires = (+ new Date())+wait; + timer = { target: target, method: method, expires: expires, args: args }; + guid = Ember.guidFor(timer); + timers[guid] = timer; + run.once(timers, invokeLaterTimers); + return guid; +}; - return listenerSet[eventName] || false; +/** @private */ +function invokeOnceTimer(guid, onceTimers) { + if (onceTimers[this.tguid]) delete onceTimers[this.tguid][this.mguid]; + if (timers[guid]) invoke(this.target, this.method, this.args, 2); + delete timers[guid]; } -// TODO: This knowledge should really be a part of the -// meta system. -var SKIP_PROPERTIES = { __ember_source__: true }; +/** + Schedules an item to run one time during the current RunLoop. Calling + this method with the same target/method combination will have no effect. -// For a given target, invokes all of the methods that have -// been registered as a listener. -function invokeEvents(targetSet, params) { - // Iterate through all elements of the target set - for(var targetGuid in targetSet) { - if (SKIP_PROPERTIES[targetGuid]) { continue; } + Note that although you can pass optional arguments these will not be + considered when looking for duplicates. New arguments will replace previous + calls. - var actionSet = targetSet[targetGuid]; + @param {Object} target + (optional) target of method to invoke - // Iterate through the elements of the action set - for(var methodGuid in actionSet) { - if (SKIP_PROPERTIES[methodGuid]) { continue; } + @param {Function|String} method + The method to invoke. If you pass a string it will be resolved on the + target at the time the method is invoked. - var action = actionSet[methodGuid]; - if (!action) { continue; } + @param {Object...} args + Optional arguments to pass to the timeout. - // Extract target and method for each action - var method = action.method; - var target = action.target; - // If there is no target, the target is the object - // on which the event was fired. - if (!target) { target = params[0]; } - if ('string' === typeof method) { method = target[method]; } + @returns {Object} timer +*/ +Ember.run.once = function(target, method) { + var tguid = Ember.guidFor(target), mguid = Ember.guidFor(method), guid, timer; - // Listeners can provide an `xform` function, which can perform - // arbitrary transformations, such as changing the order of - // parameters. - // - // This is primarily used by ember-runtime's observer system, which - // provides a higher level abstraction on top of events, including - // dynamically looking up current values and passing them into the - // registered listener. - var xform = action.xform; - - if (xform) { - xform(target, method, params); - } else { - method.apply(target, params); - } - } - } -} + var onceTimers = run.autorun().onceTimers; + guid = onceTimers[tguid] && onceTimers[tguid][mguid]; + if (guid && timers[guid]) { + timers[guid].args = slice.call(arguments); // replace args -/** - The parameters passed to an event listener are not exactly the - parameters passed to an observer. if you pass an xform function, it will - be invoked and is able to translate event listener parameters into the form - that observers are expecting. + } else { + timer = { + target: target, + method: method, + args: slice.call(arguments), + tguid: tguid, + mguid: mguid + }; - @name Ember.addListener -*/ -function addListener(obj, eventName, target, method, xform) { - ember_assert("You must pass at least an object and event name to Ember.addListener", !!obj && !!eventName); + guid = Ember.guidFor(timer); + timers[guid] = timer; + if (!onceTimers[tguid]) onceTimers[tguid] = {}; + onceTimers[tguid][mguid] = guid; // so it isn't scheduled more than once - if (!method && 'function' === typeof target) { - method = target; - target = null; + run.schedule('actions', timer, invokeOnceTimer, guid, onceTimers); } - var actionSet = actionSetFor(obj, eventName, target, true), - methodGuid = guidFor(method), ret; - - if (!actionSet[methodGuid]) { - actionSet[methodGuid] = { target: target, method: method, xform: xform }; - } else { - actionSet[methodGuid].xform = xform; // used by observers etc to map params - } + return guid; +}; - if ('function' === typeof obj.didAddListener) { - obj.didAddListener(eventName, target, method); +var scheduledNext = false; +/** @private */ +function invokeNextTimers() { + scheduledNext = null; + for(var key in timers) { + if (!timers.hasOwnProperty(key)) continue; + var timer = timers[key]; + if (timer.next) { + delete timers[key]; + invoke(timer.target, timer.method, timer.args, 2); + } } - - return ret; // return true if this is the first listener. } -function removeListener(obj, eventName, target, method) { - if (!method && 'function'===typeof target) { - method = target; - target = null; - } +/** + Schedules an item to run after control has been returned to the system. + This is often equivalent to calling setTimeout(function...,1). - var actionSet = actionSetFor(obj, eventName, target, true), - methodGuid = guidFor(method); + @param {Object} target + (optional) target of method to invoke - // we can't simply delete this parameter, because if we do, we might - // re-expose the property from the prototype chain. - if (actionSet && actionSet[methodGuid]) { actionSet[methodGuid] = null; } - - if (obj && 'function'===typeof obj.didRemoveListener) { - obj.didRemoveListener(eventName, target, method); - } -} - -// returns a list of currently watched events -function watchedEvents(obj) { - var listeners = meta(obj, false).listeners, ret = []; - - if (listeners) { - for(var eventName in listeners) { - if (!SKIP_PROPERTIES[eventName] && listeners[eventName]) { - ret.push(eventName); - } - } - } - return ret; -} + @param {Function|String} method + The method to invoke. If you pass a string it will be resolved on the + target at the time the method is invoked. -function sendEvent(obj, eventName) { + @param {Object...} args + Optional arguments to pass to the timeout. - // first give object a chance to handle it - if (obj !== Ember && 'function' === typeof obj.sendEvent) { - obj.sendEvent.apply(obj, array_Slice.call(arguments, 1)); - } + @returns {Object} timer +*/ +Ember.run.next = function(target, method) { + var timer, guid; - var targetSet = targetSetFor(obj, eventName); - if (!targetSet) { return false; } + timer = { + target: target, + method: method, + args: slice.call(arguments), + next: true + }; - invokeEvents(targetSet, arguments); - return true; -} + guid = Ember.guidFor(timer); + timers[guid] = timer; -function hasListeners(obj, eventName) { - var targetSet = targetSetFor(obj, eventName); - if (!targetSet) { return false; } + if (!scheduledNext) scheduledNext = setTimeout(invokeNextTimers, 1); + return guid; +}; - for(var targetGuid in targetSet) { - if (SKIP_PROPERTIES[targetGuid] || !targetSet[targetGuid]) { continue; } +/** + Cancels a scheduled item. Must be a value returned by `Ember.run.later()`, + `Ember.run.once()`, or `Ember.run.next()`. - var actionSet = targetSet[targetGuid]; + @param {Object} timer + Timer object to cancel - for(var methodGuid in actionSet) { - if (SKIP_PROPERTIES[methodGuid] || !actionSet[methodGuid]) { continue; } - return true; // stop as soon as we find a valid listener - } - } + @returns {void} +*/ +Ember.run.cancel = function(timer) { + delete timers[timer]; +}; - // no listeners! might as well clean this up so it is faster later. - var set = metaPath(obj, ['listeners'], true); - set[eventName] = null; +// .......................................................... +// DEPRECATED API +// - return false; -} +/** + @namespace + @name Ember.RunLoop + @deprecated + @description Compatibility for Ember.run +*/ -function listenersFor(obj, eventName) { - var targetSet = targetSetFor(obj, eventName), ret = []; - if (!targetSet) { return ret; } +/** + @deprecated + @method - var info; - for(var targetGuid in targetSet) { - if (SKIP_PROPERTIES[targetGuid] || !targetSet[targetGuid]) { continue; } + Use `#js:Ember.run.begin()` instead +*/ +Ember.RunLoop.begin = ember_deprecateFunc("Use Ember.run.begin instead of Ember.RunLoop.begin.", Ember.run.begin); - var actionSet = targetSet[targetGuid]; +/** + @deprecated + @method - for(var methodGuid in actionSet) { - if (SKIP_PROPERTIES[methodGuid] || !actionSet[methodGuid]) { continue; } - info = actionSet[methodGuid]; - ret.push([info.target, info.method]); - } - } + Use `#js:Ember.run.end()` instead +*/ +Ember.RunLoop.end = ember_deprecateFunc("Use Ember.run.end instead of Ember.RunLoop.end.", Ember.run.end); - return ret; -} -Ember.addListener = addListener; -Ember.removeListener = removeListener; -Ember.sendEvent = sendEvent; -Ember.hasListeners = hasListeners; -Ember.watchedEvents = watchedEvents; -Ember.listenersFor = listenersFor; })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -var Mixin, MixinDelegate, REQUIRED, Alias; -var classToString, superClassString; +/*globals ember_assert */ +// Ember.Logger +// get, getPath, setPath, trySetPath +// guidFor, isArray, meta +// addObserver, removeObserver +// Ember.run.schedule -var a_map = Array.prototype.map; -var a_slice = Array.prototype.slice; -var EMPTY_META = {}; // dummy for non-writable meta -var META_SKIP = { __emberproto__: true, __ember_count__: true }; +// .......................................................... +// CONSTANTS +// -var o_create = Ember.platform.create; -function meta(obj, writable) { - var m = Ember.meta(obj, writable!==false), ret = m.mixins; - if (writable===false) return ret || EMPTY_META; +/** + @static - if (!ret) { - ret = m.mixins = { __emberproto__: obj }; - } else if (ret.__emberproto__ !== obj) { - ret = m.mixins = o_create(ret); - ret.__emberproto__ = obj; - } - return ret; -} + Debug parameter you can turn on. This will log all bindings that fire to + the console. This should be disabled in production code. Note that you + can also enable this from the console or temporarily. -function initMixin(mixin, args) { - if (args && args.length > 0) { - mixin.mixins = a_map.call(args, function(x) { - if (x instanceof Mixin) return x; + @type Boolean + @default false +*/ +Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; - // Note: Manually setup a primitive mixin here. This is the only - // way to actually get a primitive mixin. This way normal creation - // of mixins will give you combined mixins... - var mixin = new Mixin(); - mixin.properties = x; - return mixin; - }); - } - return mixin; -} +/** + @static -var NATIVES = [Boolean, Object, Number, Array, Date, String]; -function isMethod(obj) { - if ('function' !== typeof obj || obj.isMethod===false) return false; - return NATIVES.indexOf(obj)<0; -} + Performance paramter. This will benchmark the time spent firing each + binding. -function mergeMixins(mixins, m, descs, values, base) { - var len = mixins.length, idx, mixin, guid, props, value, key, ovalue, concats; + @type Boolean +*/ +Ember.BENCHMARK_BINDING_NOTIFICATIONS = !!Ember.ENV.BENCHMARK_BINDING_NOTIFICATIONS; - function removeKeys(keyName) { - delete descs[keyName]; - delete values[keyName]; - } +/** + @static - for(idx=0;idx=0) || key === 'concatenatedProperties') { - var baseValue = values[key] || base[key]; - value = baseValue ? baseValue.concat(value) : Ember.makeArray(value); - } + Default placeholder for empty values in bindings. Used by notEmpty() + helper unless you specify an alternative. - descs[key] = Ember.SIMPLE_PROPERTY; - values[key] = value; - } - } + @type String + @default '@@EMPTY@@' +*/ +Ember.EMPTY_PLACEHOLDER = '@@EMPTY@@'; - // manually copy toString() because some JS engines do not enumerate it - if (props.hasOwnProperty('toString')) { - base.toString = props.toString; - } +// .......................................................... +// TYPE COERCION HELPERS +// - } else if (mixin.mixins) { - mergeMixins(mixin.mixins, m, descs, values, base); - if (mixin._without) mixin._without.forEach(removeKeys); - } - } +// Coerces a non-array value into an array. +/** @private */ +function MULTIPLE(val) { + if (val instanceof Array) return val; + if (val === undefined || val === null) return []; + return [val]; } -var defineProperty = Ember.defineProperty; - -function writableReq(obj) { - var m = Ember.meta(obj), req = m.required; - if (!req || (req.__emberproto__ !== obj)) { - req = m.required = req ? o_create(req) : { __ember_count__: 0 }; - req.__emberproto__ = obj; +// Treats a single-element array as the element. Otherwise +// returns a placeholder. +/** @private */ +function SINGLE(val, placeholder) { + if (val instanceof Array) { + if (val.length>1) return placeholder; + else return val[0]; } - return req; + return val; } -function getObserverPaths(value) { - return ('function' === typeof value) && value.__ember_observes__; -} +// Coerces the binding value into a Boolean. -function getBeforeObserverPaths(value) { - return ('function' === typeof value) && value.__ember_observesBefore__; -} +var BOOL = { + to: function (val) { + return !!val; + } +}; -Ember._mixinBindings = function(obj, key, value, m) { - return value; +// Returns the Boolean inverse of the value. +var NOT = { + to: function NOT(val) { + return !val; + } }; -function applyMixin(obj, mixins, partial) { - var descs = {}, values = {}, m = Ember.meta(obj), req = m.required; - var key, willApply, didApply, value, desc; +var get = Ember.get, + getPath = Ember.getPath, + setPath = Ember.setPath, + guidFor = Ember.guidFor, + isGlobalPath = Ember.isGlobalPath; - var mixinBindings = Ember._mixinBindings; +// Applies a binding's transformations against a value. +/** @private */ +function getTransformedValue(binding, val, obj, dir) { - mergeMixins(mixins, meta(obj), descs, values, obj); + // First run a type transform, if it exists, that changes the fundamental + // type of the value. For example, some transforms convert an array to a + // single object. - if (MixinDelegate.detect(obj)) { - willApply = values.willApplyProperty || obj.willApplyProperty; - didApply = values.didApplyProperty || obj.didApplyProperty; + var typeTransform = binding._typeTransform; + if (typeTransform) { val = typeTransform(val, binding._placeholder); } + + // handle transforms + var transforms = binding._transforms, + len = transforms ? transforms.length : 0, + idx; + + for(idx=0;idx0) { - var keys = []; - for(key in req) { - if (META_SKIP[key]) continue; - keys.push(key); - } - throw new Error('Required properties not defined: '+keys.join(',')); - } - return obj; -} + The binding will search for the property path starting at the root object + you pass when you connect() the binding. It follows the same rules as + `getPath()` - see that method for more information. -Ember.mixin = function(obj) { - var args = a_slice.call(arguments, 1); - return applyMixin(obj, args, false); -}; + @param {String|Tuple} propertyPath A property path or tuple + @param {Object} [root] Root object to use when resolving the path. + @returns {Ember.Binding} this + */ + to: function(path) { + this._to = path; + return this; + }, + /** + Configures the binding as one way. A one-way binding will relay changes + on the "from" side to the "to" side, but not the other way around. This + means that if you change the "to" side directly, the "from" side may have + a different value. -/** - @constructor - @name Ember.Mixin -*/ -Mixin = function() { return initMixin(this, arguments); }; + @param {Boolean} flag + (Optional) passing nothing here will make the binding oneWay. You can + instead pass false to disable oneWay, making the binding two way again. -Mixin._apply = applyMixin; + @returns {Ember.Binding} receiver + */ + oneWay: function(flag) { + this._oneWay = flag===undefined ? true : !!flag; + return this; + }, -Mixin.applyPartial = function(obj) { - var args = a_slice.call(arguments, 1); - return applyMixin(obj, args, true); -}; + /** + Adds the specified transform to the array of transform functions. -Mixin.create = function() { - classToString.processed = false; - var M = this; - return initMixin(new M(), arguments); -}; + A transform is a hash with `to` and `from` properties. Each property + should be a function that performs a transformation in either the + forward or back direction. -Mixin.prototype.reopen = function() { + The functions you pass must have the following signature: - var mixin, tmp; + function(value) {}; - if (this.properties) { - mixin = Mixin.create(); - mixin.properties = this.properties; - delete this.properties; - this.mixins = [mixin]; - } + They must also return the transformed value. - var len = arguments.length, mixins = this.mixins, idx; + Transforms are invoked in the order they were added. If you are + extending a binding and want to reset the transforms, you can call + `resetTransform()` first. - for(idx=0;idx= 0) { - if (_detect(mixins[loc], targetMixin, seen)) return true; - } - return false; -} + - [] => null + - [a] => a + - [a,b,c] => Multiple Placeholder -Mixin.prototype.detect = function(obj) { - if (!obj) return false; - if (obj instanceof Mixin) return _detect(obj, this, {}); - return !!meta(obj, false)[Ember.guidFor(this)]; -}; + You can pass in an optional multiple placeholder or it will use the + default. -Mixin.prototype.without = function() { - var ret = new Mixin(this); - ret._without = a_slice.call(arguments); - return ret; -}; + Note that this transform will only happen on forwarded valued. Reverse + values are send unchanged. -function _keys(ret, mixin, seen) { - if (seen[Ember.guidFor(mixin)]) return; - seen[Ember.guidFor(mixin)] = true; + @param {String} fromPath from path or null + @param {Object} [placeholder] Placeholder value. + @returns {Ember.Binding} this + */ + single: function(placeholder) { + if (placeholder===undefined) placeholder = Ember.MULTIPLE_PLACEHOLDER; + this._typeTransform = SINGLE; + this._placeholder = placeholder; + return this; + }, - if (mixin.properties) { - var props = mixin.properties; - for(var key in props) { - if (props.hasOwnProperty(key)) ret[key] = true; - } - } else if (mixin.mixins) { - mixin.mixins.forEach(function(x) { _keys(ret, x, seen); }); - } -} + /** + Adds a transform that will convert the passed value to an array. If + the value is null or undefined, it will be converted to an empty array. -Mixin.prototype.keys = function() { - var keys = {}, seen = {}, ret = []; - _keys(keys, this, seen); - for(var key in keys) { - if (keys.hasOwnProperty(key)) ret.push(key); - } - return ret; -}; + @param {String} [fromPath] + @returns {Ember.Binding} this + */ + multiple: function() { + this._typeTransform = MULTIPLE; + this._placeholder = null; + return this; + }, -/** @private - make Mixin's have nice displayNames */ + /** + Adds a transform to convert the value to a bool value. If the value is + an array it will return true if array is not empty. If the value is a + string it will return true if the string is not empty. -var NAME_KEY = Ember.GUID_KEY+'_name'; -var get = Ember.get; + @returns {Ember.Binding} this + */ + bool: function() { + this.transform(BOOL); + return this; + }, -function processNames(paths, root, seen) { - var idx = paths.length; - for(var key in root) { - if (!root.hasOwnProperty || !root.hasOwnProperty(key)) continue; - var obj = root[key]; - paths[idx] = key; + /** + Adds a transform that will return the placeholder value if the value is + null, undefined, an empty array or an empty string. See also notNull(). - if (obj && obj.toString === classToString) { - obj[NAME_KEY] = paths.join('.'); - } else if (obj && get(obj, 'isNamespace')) { - if (seen[Ember.guidFor(obj)]) continue; - seen[Ember.guidFor(obj)] = true; - processNames(paths, obj, seen); + @param {Object} [placeholder] Placeholder value. + @returns {Ember.Binding} this + */ + notEmpty: function(placeholder) { + if (placeholder === null || placeholder === undefined) { + placeholder = Ember.EMPTY_PLACEHOLDER; } - } - paths.length = idx; // cut out last item -} + this.transform({ + to: function(val) { return empty(val) ? placeholder : val; } + }); -function findNamespaces() { - var Namespace = Ember.Namespace, obj; + return this; + }, - if (Namespace.PROCESSED) { return; } + /** + Adds a transform that will return the placeholder value if the value is + null or undefined. Otherwise it will passthrough untouched. See also notEmpty(). - for (var prop in window) { - // get(window.globalStorage, 'isNamespace') would try to read the storage for domain isNamespace and cause exception in Firefox. - // globalStorage is a storage obsoleted by the WhatWG storage specification. See https://developer.mozilla.org/en/DOM/Storage#globalStorage - if (prop === "globalStorage" && window.StorageList && window.globalStorage instanceof window.StorageList) { continue; } - // Unfortunately, some versions of IE don't support window.hasOwnProperty - if (window.hasOwnProperty && !window.hasOwnProperty(prop)) { continue; } + @param {String} fromPath from path or null + @param {Object} [placeholder] Placeholder value. + @returns {Ember.Binding} this + */ + notNull: function(placeholder) { + if (placeholder === null || placeholder === undefined) { + placeholder = Ember.EMPTY_PLACEHOLDER; + } - obj = window[prop]; + this.transform({ + to: function(val) { return (val === null || val === undefined) ? placeholder : val; } + }); - if (obj && get(obj, 'isNamespace')) { - obj[NAME_KEY] = prop; - } - } -} + return this; + }, -Ember.identifyNamespaces = findNamespaces; + /** + Adds a transform to convert the value to the inverse of a bool value. This + uses the same transform as bool() but inverts it. -superClassString = function(mixin) { - var superclass = mixin.superclass; - if (superclass) { - if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; } - else { return superClassString(superclass); } - } else { - return; - } -}; + @returns {Ember.Binding} this + */ + not: function() { + this.transform(NOT); + return this; + }, -classToString = function() { - var Namespace = Ember.Namespace, namespace; + /** + Adds a transform that will return true if the value is null or undefined, false otherwise. - // TODO: Namespace should really be in Metal - if (Namespace) { - if (!this[NAME_KEY] && !classToString.processed) { - if (!Namespace.PROCESSED) { - findNamespaces(); - Namespace.PROCESSED = true; - } + @returns {Ember.Binding} this + */ + isNull: function() { + this.transform(function(val) { return val === null || val === undefined; }); + return this; + }, - classToString.processed = true; + /** @private */ + toString: function() { + var oneWay = this._oneWay ? '[oneWay]' : ''; + return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; + }, - var namespaces = Namespace.NAMESPACES; - for (var i=0, l=namespaces.length; i', fromValue, obj); + } + if (this._oneWay) { + Ember.trySetPath(Ember.isGlobalPath(toPath) ? window : obj, toPath, fromValue); + } else { + Ember._suspendObserver(obj, toPath, this, this.toDidChange, function () { + Ember.trySetPath(Ember.isGlobalPath(toPath) ? window : obj, toPath, fromValue); + }); + } + // if we're synchronizing *to* the remote object + } else if (direction === 'back') {// && !this._oneWay) { + var toValue = getTransformedToValue(obj, this); + if (log) { + Ember.Logger.log(' ', this.toString(), '<-', toValue, obj); + } + Ember._suspendObserver(obj, fromPath, this, this.fromDidChange, function () { + Ember.trySetPath(Ember.isGlobalPath(fromPath) ? window : obj, fromPath, toValue); + }); + } + } -var contexts = []; -function popCtx() { - return contexts.length===0 ? {} : contexts.pop(); -} +}; -function pushCtx(ctx) { - contexts.push(ctx); - return null; +/** @private */ +function mixinProperties(to, from) { + for (var key in from) { + if (from.hasOwnProperty(key)) { + to[key] = from[key]; + } + } } -function iter(key, value) { - var valueProvided = arguments.length === 2; +mixinProperties(Binding, +/** @scope Ember.Binding */ { - function i(item) { - var cur = get(item, key); - return valueProvided ? value===cur : !!cur; - } - return i ; -} + /** + @see Ember.Binding.prototype.from + */ + from: function() { + var C = this, binding = new C(); + return binding.from.apply(binding, arguments); + }, -function xform(target, method, params) { - method.call(target, params[0], params[2], params[3]); -} + /** + @see Ember.Binding.prototype.to + */ + to: function() { + var C = this, binding = new C(); + return binding.to.apply(binding, arguments); + }, -/** - @class + /** + @see Ember.Binding.prototype.oneWay + */ + oneWay: function(from, flag) { + var C = this, binding = new C(null, from); + return binding.oneWay(flag); + }, - This mixin defines the common interface implemented by enumerable objects - in Ember. Most of these methods follow the standard Array iteration - API defined up to JavaScript 1.8 (excluding language-specific features that - cannot be emulated in older versions of JavaScript). + /** + @see Ember.Binding.prototype.single + */ + single: function(from) { + var C = this, binding = new C(null, from); + return binding.single(); + }, - This mixin is applied automatically to the Array class on page load, so you - can use any of these methods on simple arrays. If Array already implements - one of these methods, the mixin will not override them. + /** + @see Ember.Binding.prototype.multiple + */ + multiple: function(from) { + var C = this, binding = new C(null, from); + return binding.multiple(); + }, - h3. Writing Your Own Enumerable + /** + @see Ember.Binding.prototype.transform + */ + transform: function(func) { + var C = this, binding = new C(); + return binding.transform(func); + }, - To make your own custom class enumerable, you need two items: + /** + @see Ember.Binding.prototype.notEmpty + */ + notEmpty: function(from, placeholder) { + var C = this, binding = new C(null, from); + return binding.notEmpty(placeholder); + }, - 1. You must have a length property. This property should change whenever - the number of items in your enumerable object changes. If you using this - with an Ember.Object subclass, you should be sure to change the length - property using set(). - - 2. If you must implement nextObject(). See documentation. - - Once you have these two methods implement, apply the Ember.Enumerable mixin - to your class and you will be able to enumerate the contents of your object - like any other collection. - - h3. Using Ember Enumeration with Other Libraries - - Many other libraries provide some kind of iterator or enumeration like - facility. This is often where the most common API conflicts occur. - Ember's API is designed to be as friendly as possible with other - libraries by implementing only methods that mostly correspond to the - JavaScript 1.8 API. - - @since Ember 0.9 -*/ -Ember.Enumerable = Ember.Mixin.create( /** @lends Ember.Enumerable */ { - - /** @private - compatibility */ - isEnumerable: true, - /** - Implement this method to make your class enumerable. - - This method will be call 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 - requested index is 0. - - The previousObject is the object that was returned from the last call - 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 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 - the index parameter is 0. - - Generally iterators will continue to call nextObject until the index - 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. - This works great on any Array-like objects. + @see Ember.Binding.prototype.bool + */ + bool: function(from) { + var C = this, binding = new C(null, from); + return binding.bool(); + }, - @param index {Number} the current index of the iteration - @param previousObject {Object} the value returned by the last call to nextObject. - @param context {Object} a context object you can use to maintain state. - @returns {Object} the next object in the iteration or undefined + /** + @see Ember.Binding.prototype.not */ - nextObject: Ember.required(Function), + not: function(from) { + var C = this, binding = new C(null, from); + return binding.not(); + }, /** - Helper method returns the first object from a collection. This is usually - used by bindings and other parts of the framework to extract a single - object if the enumerable contains only one item. + Adds a transform that forwards the logical 'AND' of values at 'pathA' and + 'pathB' whenever either source changes. Note that the transform acts + strictly as a one-way binding, working only in the direction - If you override this method, you should implement it so that it will - always return the same value each time it is called. If your enumerable - contains only one object, this method should always return that object. - If your enumerable is empty, this method should return undefined. + 'pathA' AND 'pathB' --> value (value returned is the result of ('pathA' && 'pathB')) - @returns {Object} the object or undefined + Usage example where a delete button's `isEnabled` value is determined by + whether something is selected in a list and whether the current user is + allowed to delete: - @example - var arr = ["a", "b", "c"]; - arr.firstObject(); => "a" + deleteButton: Ember.ButtonView.design({ + isEnabledBinding: Ember.Binding.and('MyApp.itemsController.hasSelection', 'MyApp.userController.canDelete') + }) - var arr = []; - arr.firstObject(); => undefined + @param {String} pathA The first part of the conditional + @param {String} pathB The second part of the conditional */ - firstObject: Ember.computed(function() { - if (get(this, 'length')===0) return undefined ; - if (Ember.Array && Ember.Array.detect(this)) return this.objectAt(0); - - // handle generic enumerables - var context = popCtx(), ret; - ret = this.nextObject(0, null, context); - pushCtx(context); - return ret ; - }).property(), + and: function(pathA, pathB) { + var C = this, binding = new C(null, pathA).oneWay(); + binding._operand = pathB; + binding._operation = AND_OPERATION; + return binding; + }, /** - Helper method returns the last object from a collection. If your enumerable - contains only one object, this method should always return that object. - If your enumerable is empty, this method should return undefined. - - @returns {Object} the last object or undefined + Adds a transform that forwards the 'OR' of values at 'pathA' and + 'pathB' whenever either source changes. Note that the transform acts + strictly as a one-way binding, working only in the direction - @example - var arr = ["a", "b", "c"]; - arr.lastObject(); => "c" + 'pathA' AND 'pathB' --> value (value returned is the result of ('pathA' || 'pathB')) - var arr = []; - arr.lastObject(); => undefined + @param {String} pathA The first part of the conditional + @param {String} pathB The second part of the conditional */ - lastObject: Ember.computed(function() { - var len = get(this, 'length'); - if (len===0) return undefined ; - if (Ember.Array && Ember.Array.detect(this)) { - return this.objectAt(len-1); - } else { - var context = popCtx(), idx=0, cur, last = null; - do { - last = cur; - cur = this.nextObject(idx++, last, context); - } while (cur !== undefined); - pushCtx(context); - return last; - } - }).property(), + or: function(pathA, pathB) { + var C = this, binding = new C(null, pathA).oneWay(); + binding._operand = pathB; + binding._operation = OR_OPERATION; + return binding; + } - /** - Returns true if the passed object can be found in the receiver. The - default version will iterate through the enumerable until the object - is found. You may want to override this with a more efficient version. - - @param {Object} obj - The object to search for. - - @returns {Boolean} true if object is found in enumerable. - */ - contains: function(obj) { - return this.find(function(item) { return item===obj; }) !== undefined; - }, - - /** - Iterates through the enumerable, calling the passed function on each - item. This method corresponds to the forEach() method defined in - JavaScript 1.6. +}); - The callback method you provide should have the following signature (all - parameters are optional): +/** + @class - function(item, index, enumerable); + A binding simply connects the properties of two objects so that whenever the + value of one property changes, the other property will be changed also. You + do not usually work with Binding objects directly but instead describe + bindings in your class definition using something like: - - *item* is the current item in the iteration. - - *index* is the current index in the iteration - - *enumerable* is the enumerable object itself. + valueBinding: "MyApp.someController.title" - Note that in addition to a callback, you can also pass an optional target - object that will be set as "this" on the context. This is a good way - to give your iterator function access to the current object. + This will create a binding from `MyApp.someController.title` to the `value` + property of your object instance automatically. Now the two values will be + kept in sync. - @param {Function} callback The callback to execute - @param {Object} target The target object to use - @returns {Object} receiver - */ - forEach: function(callback, target) { - if (typeof callback !== "function") throw new TypeError() ; - var len = get(this, 'length'), last = null, context = popCtx(); + ## Customizing Your Bindings - if (target === undefined) target = null; + In addition to synchronizing values, bindings can also perform some basic + transforms on values. These transforms can help to make sure the data fed + into one object always meets the expectations of that object regardless of + what the other object outputs. - for(var idx=0;idx w. +*/ +Ember.compare = function compare(v, w) { + if (v === w) { return 0; } + + var type1 = Ember.typeOf(v); + var type2 = Ember.typeOf(w); + + var Comparable = Ember.Comparable; + if (Comparable) { + if (type1==='instance' && Comparable.detect(v.constructor)) { + return v.constructor.compare(v, w); + } + + if (type2 === 'instance' && Comparable.detect(w.constructor)) { + return 1-w.constructor.compare(w, v); + } + } + + // If we haven't yet generated a reverse-mapping of Ember.ORDER_DEFINITION, + // do so now. + var mapping = Ember.ORDER_DEFINITION_MAPPING; + if (!mapping) { + var order = Ember.ORDER_DEFINITION; + mapping = Ember.ORDER_DEFINITION_MAPPING = {}; + var idx, len; + for (idx = 0, len = order.length; idx < len; ++idx) { + mapping[order[idx]] = idx; + } + + // We no longer need Ember.ORDER_DEFINITION. + delete Ember.ORDER_DEFINITION; + } + + var type1Index = mapping[type1]; + var type2Index = mapping[type2]; + + if (type1Index < type2Index) { return -1; } + if (type1Index > type2Index) { return 1; } + + // types are equal - so we have to check values now + switch (type1) { + case 'boolean': + case 'number': + if (v < w) { return -1; } + if (v > w) { return 1; } + return 0; + + case 'string': + var comp = v.localeCompare(w); + if (comp < 0) { return -1; } + if (comp > 0) { return 1; } + return 0; + + case 'array': + var vLen = v.length; + var wLen = w.length; + var l = Math.min(vLen, wLen); + var r = 0; + var i = 0; + while (r === 0 && i < l) { + r = compare(v[i],w[i]); + i++; + } + if (r !== 0) { return r; } + + // all elements are equal now + // shorter array should be ordered first + if (vLen < wLen) { return -1; } + if (vLen > wLen) { return 1; } + // arrays are equal now + return 0; + + case 'instance': + if (Ember.Comparable && Ember.Comparable.detect(v)) { + return v.compare(v, w); + } + return 0; + + default: + return 0; + } +}; + +/** @private */ +function _copy(obj, deep, seen, copies) { + var ret, loc, key; + + // primitive data types are immutable, just return them. + if ('object' !== typeof obj || obj===null) return obj; + + // avoid cyclical loops + if (deep && (loc=indexOf(seen, obj))>=0) return copies[loc]; + + ember_assert('Cannot clone an Ember.Object that does not implement Ember.Copyable', !(obj instanceof Ember.Object) || (Ember.Copyable && Ember.Copyable.detect(obj))); + + // IMPORTANT: this specific test will detect a native array only. Any other + // object will need to implement Copyable. + if (Ember.typeOf(obj) === 'array') { + ret = obj.slice(); + if (deep) { + loc = ret.length; + while(--loc>=0) ret[loc] = _copy(ret[loc], deep, seen, copies); + } + } else if (Ember.Copyable && Ember.Copyable.detect(obj)) { + ret = obj.copy(deep, seen, copies); + } else { + ret = {}; + for(key in obj) { + if (!obj.hasOwnProperty(key)) continue; + ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key]; + } + } + + if (deep) { + seen.push(obj); + copies.push(ret); + } + + return ret; +} + +/** + Creates a clone of the passed object. This function can take just about + any type of object and create a clone of it, including primitive values + (which are not actually cloned because they are immutable). + + If the passed object implements the clone() method, then this function + will simply call that method and return the result. + + @param {Object} object The object to clone + @param {Boolean} deep If true, a deep copy of the object is made + @returns {Object} The cloned object +*/ +Ember.copy = function(obj, deep) { + // fast paths + if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives + if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep); + return _copy(obj, deep, deep ? [] : null, deep ? [] : null); +}; + +/** + Convenience method to inspect an object. This method will attempt to + convert the object into a useful string description. + + @param {Object} obj The object you want to inspect. + @returns {String} A description of the object +*/ +Ember.inspect = function(obj) { + var v, ret = []; + for(var key in obj) { + if (obj.hasOwnProperty(key)) { + v = obj[key]; + if (v === 'toString') { continue; } // ignore useless items + if (Ember.typeOf(v) === 'function') { v = "function() { ... }"; } + ret.push(key + ": " + v); + } + } + return "{" + ret.join(" , ") + "}"; +}; + +/** + Compares two objects, returning true if they are logically equal. This is + a deeper comparison than a simple triple equal. For sets it will compare the + internal objects. For any other object that implements `isEqual()` it will + respect that method. + + @param {Object} a first object to compare + @param {Object} b second object to compare + @returns {Boolean} +*/ +Ember.isEqual = function(a, b) { + if (a && 'function'===typeof a.isEqual) return a.isEqual(b); + return a === b; +}; + +/** + @private + Used by Ember.compare +*/ +Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ + 'undefined', + 'null', + 'boolean', + 'number', + 'string', + 'array', + 'object', + 'instance', + 'function', + 'class' +]; + +/** + Returns all of the keys defined on an object or hash. This is useful + when inspecting objects for debugging. On browsers that support it, this + uses the native Object.keys implementation. + + @function + @param {Object} obj + @returns {Array} Array containing keys of obj +*/ +Ember.keys = Object.keys; + +if (!Ember.keys) { + Ember.keys = function(obj) { + var ret = []; + for(var key in obj) { + if (obj.hasOwnProperty(key)) { ret.push(key); } + } + return ret; + }; +} + +// .......................................................... +// ERROR +// + +/** + @class + + A subclass of the JavaScript Error object for use in Ember. +*/ +Ember.Error = function() { + var tmp = Error.prototype.constructor.apply(this, arguments); + + for (var p in tmp) { + if (tmp.hasOwnProperty(p)) { this[p] = tmp[p]; } + } + this.message = tmp.message; +}; + +Ember.Error.prototype = Ember.create(Error.prototype); + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. +// License: Licensed under MIT license (see license.js) +// ========================================================================== + +/** @private **/ +var STRING_DASHERIZE_REGEXP = (/[ _]/g); +var STRING_DASHERIZE_CACHE = {}; +var STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g); +var STRING_CAMELIZE_REGEXP = (/(\-|_|\s)+(.)?/g); +var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g); +var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g); + +/** + Defines the hash of localized strings for the current language. Used by + the `Ember.String.loc()` helper. To localize, add string values to this + hash. + + @property {String} +*/ +Ember.STRINGS = {}; + +/** + Defines string helper methods including string formatting and localization. + Unless Ember.EXTEND_PROTOTYPES = false these methods will also be added to the + String.prototype as well. + + @namespace +*/ +Ember.String = { + + /** + Apply formatting options to the string. This will look for occurrences + of %@ in your string and substitute them with the arguments you pass into + this method. If you want to control the specific order of replacement, + you can add a number after the key as well to indicate which argument + you want to insert. + + Ordered insertions are most useful when building loc strings where values + you need to insert may appear in different orders. + + "Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe" + "Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John" + + @param {Object...} [args] + @returns {String} formatted string + */ + fmt: function(str, formats) { + // first, replace any ORDERED replacements. + var idx = 0; // the current index for non-numerical replacements + return str.replace(/%@([0-9]+)?/g, function(s, argIndex) { + argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ; + s = formats[argIndex]; + return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString(); + }) ; + }, + + /** + Formats the passed string, but first looks up the string in the localized + strings hash. This is a convenient way to localize text. See + `Ember.String.fmt()` for more information on formatting. + + Note that it is traditional but not required to prefix localized string + keys with an underscore or other character so you can easily identify + localized strings. + + Ember.STRINGS = { + '_Hello World': 'Bonjour le monde', + '_Hello %@ %@': 'Bonjour %@ %@' + }; + + Ember.String.loc("_Hello World"); + => 'Bonjour le monde'; + + Ember.String.loc("_Hello %@ %@", ["John", "Smith"]); + => "Bonjour John Smith"; + + @param {String} str + The string to format + + @param {Array} formats + Optional array of parameters to interpolate into string. + + @returns {String} formatted string + */ + loc: function(str, formats) { + str = Ember.STRINGS[str] || str; + return Ember.String.fmt(str, formats) ; + }, + + /** + Splits a string into separate units separated by spaces, eliminating any + empty strings in the process. This is a convenience method for split that + is mostly useful when applied to the String.prototype. + + Ember.String.w("alpha beta gamma").forEach(function(key) { + console.log(key); + }); + > alpha + > beta + > gamma + + @param {String} str + The string to split + + @returns {String} split string + */ + w: function(str) { return str.split(/\s+/); }, + + /** + Converts a camelized string into all lower case separated by underscores. + + 'innerHTML'.decamelize() => 'inner_html' + 'action_name'.decamelize() => 'action_name' + 'css-class-name'.decamelize() => 'css-class-name' + 'my favorite items'.decamelize() => 'my favorite items' + + @param {String} str + The string to decamelize. + + @returns {String} the decamelized string. + */ + decamelize: function(str) { + return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase(); + }, + + /** + Replaces underscores or spaces with dashes. + + 'innerHTML'.dasherize() => 'inner-html' + 'action_name'.dasherize() => 'action-name' + 'css-class-name'.dasherize() => 'css-class-name' + 'my favorite items'.dasherize() => 'my-favorite-items' + + @param {String} str + The string to dasherize. + + @returns {String} the dasherized string. + */ + dasherize: function(str) { + var cache = STRING_DASHERIZE_CACHE, + ret = cache[str]; + + if (ret) { + return ret; + } else { + ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-'); + cache[str] = ret; + } + + return ret; + }, + + /** + Returns the lowerCaseCamel form of a string. + + 'innerHTML'.camelize() => 'innerHTML' + 'action_name'.camelize() => 'actionName' + 'css-class-name'.camelize() => 'cssClassName' + 'my favorite items'.camelize() => 'myFavoriteItems' + + @param {String} str + The string to camelize. + + @returns {String} the camelized string. + */ + camelize: function(str) { + return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) { + return chr ? chr.toUpperCase() : ''; + }); + }, + + /** + More general than decamelize. Returns the lower_case_and_underscored + form of a string. + + 'innerHTML'.underscore() => 'inner_html' + 'action_name'.underscore() => 'action_name' + 'css-class-name'.underscore() => 'css_class_name' + 'my favorite items'.underscore() => 'my_favorite_items' + + @param {String} str + The string to underscore. + + @returns {String} the underscored string. + */ + underscore: function(str) { + return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2'). + replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase(); + } +}; +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2011 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var fmt = Ember.String.fmt, + w = Ember.String.w, + loc = Ember.String.loc, + camelize = Ember.String.camelize, + decamelize = Ember.String.decamelize, + dasherize = Ember.String.dasherize, + underscore = Ember.String.underscore; + +if (Ember.EXTEND_PROTOTYPES) { + + /** + @see Ember.String.fmt + */ + String.prototype.fmt = function() { + return fmt(this, arguments); + }; + + /** + @see Ember.String.w + */ + String.prototype.w = function() { + return w(this); + }; + + /** + @see Ember.String.loc + */ + String.prototype.loc = function() { + return loc(this, arguments); + }; + + /** + @see Ember.String.camelize + */ + String.prototype.camelize = function() { + return camelize(this); + }; + + /** + @see Ember.String.decamelize + */ + String.prototype.decamelize = function() { + return decamelize(this); + }; + + /** + @see Ember.String.dasherize + */ + String.prototype.dasherize = function() { + return dasherize(this); + }; + + /** + @see Ember.String.underscore + */ + String.prototype.underscore = function() { + return underscore(this); + }; + +} + + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2011 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var a_slice = Array.prototype.slice; + +if (Ember.EXTEND_PROTOTYPES) { + + /** + The `property` extension of Javascript's Function prototype is available + when Ember.EXTEND_PROTOTYPES is true, which is the default. + + Computed properties allow you to treat a function like a property: + + MyApp.president = Ember.Object.create({ + firstName: "Barack", + lastName: "Obama", + + fullName: function() { + return this.get('firstName') + ' ' + this.get('lastName'); + + // Call this flag to mark the function as a property + }.property() + }); + + MyApp.president.get('fullName'); => "Barack Obama" + + Treating a function like a property is useful because they can work with + bindings, just like any other property. + + Many computed properties have dependencies on other properties. For + example, in the above example, the `fullName` property depends on + `firstName` and `lastName` to determine its value. You can tell Ember.js + about these dependencies like this: + + MyApp.president = Ember.Object.create({ + firstName: "Barack", + lastName: "Obama", + + fullName: function() { + return this.get('firstName') + ' ' + this.get('lastName'); + + // Tell Ember.js that this computed property depends on firstName + // and lastName + }.property('firstName', 'lastName') + }); + + Make sure you list these dependencies so Ember.js knows when to update + bindings that connect to a computed property. + + Note: you will usually want to use `property(...)` with `cacheable()`. + + @see Ember.ComputedProperty + @see Ember.computed + */ + Function.prototype.property = function() { + var ret = Ember.computed(this); + return ret.property.apply(ret, arguments); + }; + + /** + The `observes` extension of Javascript's Function prototype is available + when Ember.EXTEND_PROTOTYPES is true, which is the default. + + You can observe property changes simply by adding the `observes` + call to the end of your method declarations in classes that you write. + For example: + + Ember.Object.create({ + valueObserver: function() { + // Executes whenever the "value" property changes + }.observes('value') + }); + + @see Ember.Observable + */ + Function.prototype.observes = function() { + this.__ember_observes__ = a_slice.call(arguments); + return this; + }; + + /** + The `observesBefore` extension of Javascript's Function prototype is + available when Ember.EXTEND_PROTOTYPES is true, which is the default. + + You can get notified when a property changes is about to happen by + by adding the `observesBefore` call to the end of your method + declarations in classes that you write. For example: + + Ember.Object.create({ + valueObserver: function() { + // Executes whenever the "value" property is about to change + }.observesBefore('value') + }); + + @see Ember.Observable + */ + Function.prototype.observesBefore = function() { + this.__ember_observesBefore__ = a_slice.call(arguments); + return this; + }; + +} + + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2011 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var IS_BINDING = Ember.IS_BINDING = /^.+Binding$/; + +Ember._mixinBindings = function(obj, key, value, m) { + if (IS_BINDING.test(key)) { + if (!(value instanceof Ember.Binding)) { + value = new Ember.Binding(key.slice(0,-7), value); // make binding + } else { + value.to(key.slice(0, -7)); + } + value.connect(obj); + + // keep a set of bindings in the meta so that when we rewatch we can + // resync them... + var bindings = m.bindings; + if (!bindings) { + bindings = m.bindings = { __emberproto__: obj }; + } else if (bindings.__emberproto__ !== obj) { + bindings = m.bindings = Ember.create(m.bindings); + bindings.__emberproto__ = obj; + } + + bindings[key] = true; + } + + return value; +}; + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== + + + + + +// .......................................................... +// HELPERS +// + +var get = Ember.get, set = Ember.set; +var a_slice = Array.prototype.slice; +var a_indexOf = Ember.ArrayUtils.indexOf; + +var contexts = []; +/** @private */ +function popCtx() { + return contexts.length===0 ? {} : contexts.pop(); +} + +/** @private */ +function pushCtx(ctx) { + contexts.push(ctx); + return null; +} + +/** @private */ +function iter(key, value) { + var valueProvided = arguments.length === 2; + + function i(item) { + var cur = get(item, key); + return valueProvided ? value===cur : !!cur; + } + return i ; +} + +/** @private */ +function xform(target, method, params) { + method.call(target, params[0], params[2], params[3]); +} + +/** + @class + + This mixin defines the common interface implemented by enumerable objects + in Ember. Most of these methods follow the standard Array iteration + API defined up to JavaScript 1.8 (excluding language-specific features that + cannot be emulated in older versions of JavaScript). + + This mixin is applied automatically to the Array class on page load, so you + can use any of these methods on simple arrays. If Array already implements + one of these methods, the mixin will not override them. + + h3. Writing Your Own Enumerable + + To make your own custom class enumerable, you need two items: + + 1. You must have a length property. This property should change whenever + the number of items in your enumerable object changes. If you using this + with an Ember.Object subclass, you should be sure to change the length + property using set(). + + 2. If you must implement nextObject(). See documentation. + + Once you have these two methods implement, apply the Ember.Enumerable mixin + to your class and you will be able to enumerate the contents of your object + like any other collection. + + h3. Using Ember Enumeration with Other Libraries + + Many other libraries provide some kind of iterator or enumeration like + facility. This is often where the most common API conflicts occur. + Ember's API is designed to be as friendly as possible with other + libraries by implementing only methods that mostly correspond to the + JavaScript 1.8 API. + + @since Ember 0.9 +*/ +Ember.Enumerable = Ember.Mixin.create( /** @lends Ember.Enumerable */ { + + /** @private - compatibility */ + isEnumerable: true, + + /** + Implement this method to make your class enumerable. + + This method will be call 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 + requested index is 0. + + The previousObject is the object that was returned from the last call + 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 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 + the index parameter is 0. + + Generally iterators will continue to call nextObject until the index + 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. + This works great on any Array-like objects. + + @param index {Number} the current index of the iteration + @param previousObject {Object} the value returned by the last call to nextObject. + @param context {Object} a context object you can use to maintain state. + @returns {Object} the next object in the iteration or undefined + */ + nextObject: Ember.required(Function), + + /** + Helper method returns the first object from a collection. This is usually + used by bindings and other parts of the framework to extract a single + object if the enumerable contains only one item. + + If you override this method, you should implement it so that it will + always return the same value each time it is called. If your enumerable + contains only one object, this method should always return that object. + If your enumerable is empty, this method should return undefined. + + var arr = ["a", "b", "c"]; + arr.firstObject(); => "a" + + var arr = []; + arr.firstObject(); => undefined + + @returns {Object} the object or undefined + */ + firstObject: Ember.computed(function() { + if (get(this, 'length')===0) return undefined ; + if (Ember.Array && Ember.Array.detect(this)) return this.objectAt(0); + + // handle generic enumerables + var context = popCtx(), ret; + ret = this.nextObject(0, null, context); + pushCtx(context); + return ret ; + }).property(), + + /** + Helper method returns the last object from a collection. If your enumerable + contains only one object, this method should always return that object. + If your enumerable is empty, this method should return undefined. + + var arr = ["a", "b", "c"]; + arr.lastObject(); => "c" + + var arr = []; + arr.lastObject(); => undefined + + @returns {Object} the last object or undefined + */ + lastObject: Ember.computed(function() { + var len = get(this, 'length'); + if (len===0) return undefined ; + if (Ember.Array && Ember.Array.detect(this)) { + return this.objectAt(len-1); + } else { + var context = popCtx(), idx=0, cur, last = null; + do { + last = cur; + cur = this.nextObject(idx++, last, context); + } while (cur !== undefined); + pushCtx(context); + return last; + } + }).property(), + + /** + Returns true if the passed object can be found in the receiver. The + default version will iterate through the enumerable until the object + is found. You may want to override this with a more efficient version. + + var arr = ["a", "b", "c"]; + arr.contains("a"); => true + arr.contains("z"); => false + + @param {Object} obj + The object to search for. + + @returns {Boolean} true if object is found in enumerable. + */ + contains: function(obj) { + return this.find(function(item) { return item===obj; }) !== undefined; + }, + + /** + Iterates through the enumerable, calling the passed function on each + item. This method corresponds to the forEach() method defined in + JavaScript 1.6. + + The callback method you provide should have the following signature (all + parameters are optional): + + function(item, index, enumerable); + + - *item* is the current item in the iteration. + - *index* is the current index in the iteration + - *enumerable* is the enumerable object itself. + + Note that in addition to a callback, you can also pass an optional target + object that will be set as "this" on the context. This is a good way + to give your iterator function access to the current object. + + @param {Function} callback The callback to execute + @param {Object} target The target object to use + @returns {Object} receiver + */ + forEach: function(callback, target) { + if (typeof callback !== "function") throw new TypeError() ; + var len = get(this, 'length'), last = null, context = popCtx(); + + if (target === undefined) target = null; + + for(var idx=0;idx1) args = a_slice.call(arguments, 1); - - this.forEach(function(x, idx) { - var method = x && x[methodName]; - if ('function' === typeof method) { - ret[idx] = args ? method.apply(x, args) : method.call(x); - } - }, this); - - return ret; + mapProperty: function(key) { + return this.map(function(next) { + return get(next, key); + }); }, /** - Simply converts the enumerable into a genuine array. The order is not - guaranteed. Corresponds to the method implemented by Prototype. + Returns an array with all of the items in the enumeration that the passed + function returns true for. This method corresponds to filter() defined in + JavaScript 1.6. - @returns {Array} the enumerable as an array. - */ - toArray: function() { - var ret = []; - this.forEach(function(o, idx) { ret[idx] = o; }); - return ret ; - }, + The callback method you provide should have the following signature (all + parameters are optional): - /** - Generates a new array with the contents of the old array, sans any null - values. + function(item, index, enumerable); - @returns {Array} - */ - compact: function() { return this.without(null); }, + - *item* is the current item in the iteration. + - *index* is the current index in the iteration + - *enumerable* is the enumerable object itself. - /** - Returns a new enumerable that excludes the passed value. The default - implementation returns an array regardless of the receiver type unless - the receiver does not contain the value. + It should return the true to include the item in the results, false otherwise. - @param {Object} value - @returns {Ember.Enumerable} + Note that in addition to a callback, you can also pass an optional target + object that will be set as "this" on the context. This is a good way + to give your iterator function access to the current object. + + @param {Function} callback The callback to execute + @param {Object} target The target object to use + @returns {Array} A filtered array. */ - without: function(value) { - if (!this.contains(value)) return this; // nothing to do - var ret = [] ; - this.forEach(function(k) { - if (k !== value) ret[ret.length] = k; - }) ; + filter: function(callback, target) { + var ret = []; + this.forEach(function(x, idx, i) { + if (callback.call(target, x, idx, i)) ret.push(x); + }); return ret ; }, /** - Returns a new enumerable that contains only unique values. The default - implementation returns an array regardless of the receiver type. - - @returns {Ember.Enumerable} + Returns an array with just the items with the matched property. You + can pass an optional second argument with the target value. Otherwise + this will match any property that evaluates to true. + + @params key {String} the property to test + @param value {String} optional value to test against. + @returns {Array} filtered array */ - uniq: function() { - var ret = []; - this.forEach(function(k){ - if (ret.indexOf(k)<0) ret.push(k); - }); - return ret; + filterProperty: function(key, value) { + return this.filter(iter.apply(this, arguments)); }, /** - This property will trigger anytime the enumerable's content changes. - You can observe this property to be notified of changes to the enumerables - content. + Returns the first item in the array for which the callback returns true. + This method works similar to the filter() method defined in JavaScript 1.6 + except that it will stop working on the array once a match is found. - For plain enumerables, this property is read only. Ember.Array overrides - this method. + The callback method you provide should have the following signature (all + parameters are optional): - @property {Ember.Array} - */ - '[]': Ember.computed(function(key, value) { - return this; - }).property().cacheable(), + function(item, index, enumerable); - // .......................................................... - // ENUMERABLE OBSERVERS - // - - /** - Registers an enumerable observer. Must implement Ember.EnumerableObserver - mixin. - */ - addEnumerableObserver: function(target, opts) { - var willChange = (opts && opts.willChange) || 'enumerableWillChange', - didChange = (opts && opts.didChange) || 'enumerableDidChange'; + - *item* is the current item in the iteration. + - *index* is the current index in the iteration + - *enumerable* is the enumerable object itself. - var hasObservers = get(this, 'hasEnumerableObservers'); - if (!hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); - Ember.addListener(this, '@enumerable:before', target, willChange, xform); - Ember.addListener(this, '@enumerable:change', target, didChange, xform); - if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); - return this; - }, + It should return the true to include the item in the results, false otherwise. - /** - Removes a registered enumerable observer. + Note that in addition to a callback, you can also pass an optional target + object that will be set as "this" on the context. This is a good way + to give your iterator function access to the current object. + + @param {Function} callback The callback to execute + @param {Object} target The target object to use + @returns {Object} Found item or null. */ - removeEnumerableObserver: function(target, opts) { - var willChange = (opts && opts.willChange) || 'enumerableWillChange', - didChange = (opts && opts.didChange) || 'enumerableDidChange'; + find: function(callback, target) { + var len = get(this, 'length') ; + if (target === undefined) target = null; - var hasObservers = get(this, 'hasEnumerableObservers'); - if (hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); - Ember.removeListener(this, '@enumerable:before', target, willChange); - Ember.removeListener(this, '@enumerable:change', target, didChange); - if (hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); - return this; + var last = null, next, found = false, ret ; + var context = popCtx(); + for(var idx=0;idx1) args = a_slice.call(arguments, 1); + + this.forEach(function(x, idx) { + var method = x && x[methodName]; + if ('function' === typeof method) { + ret[idx] = args ? method.apply(x, args) : method.call(x); + } + }, this); + + return ret; + }, /** - This is one of the primitives you must implement to support Ember.Array. - Returns the object at the named index. If your object supports retrieving - the value of an array item using get() (i.e. myArray.get(0)), then you do - not need to implement this method yourself. + Simply converts the enumerable into a genuine array. The order is not + guaranteed. Corresponds to the method implemented by Prototype. - @param {Number} idx - The index of the item to return. If idx exceeds the current length, - return null. + @returns {Array} the enumerable as an array. */ - objectAt: function(idx) { - if ((idx < 0) || (idx>=get(this, 'length'))) return undefined ; - return get(this, idx); + toArray: function() { + var ret = []; + this.forEach(function(o, idx) { ret[idx] = o; }); + return ret ; }, - /** @private (nodoc) - overrides Ember.Enumerable version */ - nextObject: function(idx) { - return this.objectAt(idx); - }, - /** - @field [] - - This is the handler for the special array content property. If you get - this property, it will return this. If you set this property it a new - array, it will replace the current content. + Returns a copy of the array with all null elements removed. + + var arr = ["a", null, "c", null]; + arr.compact(); => ["a", "c"] - This property overrides the default property defined in Ember.Enumerable. + @returns {Array} the array without null elements. */ - '[]': Ember.computed(function(key, value) { - if (value !== undefined) this.replace(0, get(this, 'length'), value) ; - return this ; - }).property().cacheable(), + compact: function() { return this.without(null); }, - /** @private (nodoc) - optimized version from Enumerable */ - contains: function(obj){ - return this.indexOf(obj) >= 0; - }, + /** + Returns a new enumerable that excludes the passed value. The default + implementation returns an array regardless of the receiver type unless + the receiver does not contain the value. - // Add any extra methods to Ember.Array that are native to the built-in Array. - /** - Returns a new array that is a slice of the receiver. This implementation - uses the observable array methods to retrieve the objects for the new - slice. + var arr = ["a", "b", "a", "c"]; + arr.without("a"); => ["b", "c"] - @param beginIndex {Integer} (Optional) index to begin slicing from. - @param endIndex {Integer} (Optional) index to end the slice at. - @returns {Array} New array with specified slice + @param {Object} value + @returns {Ember.Enumerable} */ - slice: function(beginIndex, endIndex) { - var ret = []; - var length = get(this, 'length') ; - if (none(beginIndex)) beginIndex = 0 ; - if (none(endIndex) || (endIndex > length)) endIndex = length ; - while(beginIndex < endIndex) { - ret[ret.length] = this.objectAt(beginIndex++) ; - } + without: function(value) { + if (!this.contains(value)) return this; // nothing to do + var ret = [] ; + this.forEach(function(k) { + if (k !== value) ret[ret.length] = k; + }) ; return ret ; }, /** - Returns the index of the given object's first occurrence. - If no startAt argument is given, the starting location to - search is 0. If it's negative, will count backward from - the end of the array. Returns -1 if no match is found. + Returns a new enumerable that contains only unique values. The default + implementation returns an array regardless of the receiver type. - @param {Object} object the item to search for - @param {Number} startAt optional starting location to search, default 0 - @returns {Number} index or -1 if not found + var arr = ["a", "a", "b", "b"]; + arr.uniq(); => ["a", "b"] - @example - var arr = ["a", "b", "c", "d", "a"]; - arr.indexOf("a"); => 0 - arr.indexOf("z"); => -1 - arr.indexOf("a", 2); => 4 - arr.indexOf("a", -1); => 4 - arr.indexOf("b", 3); => -1 - arr.indexOf("a", 100); => -1 + @returns {Ember.Enumerable} */ - indexOf: function(object, startAt) { - var idx, len = get(this, 'length'); - - if (startAt === undefined) startAt = 0; - if (startAt < 0) startAt += len; - - for(idx=startAt;idx 4 - arr.lastIndexOf("z"); => -1 - arr.lastIndexOf("a", 2); => 0 - arr.lastIndexOf("a", -1); => 4 - arr.lastIndexOf("b", 3); => 1 - arr.lastIndexOf("a", 100); => 4 + @property {Ember.Array} */ - lastIndexOf: function(object, startAt) { - var idx, len = get(this, 'length'); - - if (startAt === undefined || startAt >= len) startAt = len-1; - if (startAt < 0) startAt += len; + '[]': Ember.computed(function(key, value) { + return this; + }).property().cacheable(), - for(idx=startAt;idx>=0;idx--) { - if (this.objectAt(idx) === object) return idx ; - } - return -1; - }, - // .......................................................... - // ARRAY OBSERVERS - // - + // ENUMERABLE OBSERVERS + // + /** - Adds an array observer to the receiving array. The array observer object - normally must implement two methods: - - * `arrayWillChange(start, removeCount, addCount)` - This method will be - called just before the array is modified. - * `arrayDidChange(start, removeCount, addCount)` - This method will be - called just after the array is modified. - - Both callbacks will be passed the starting index of the change as well a - a count of the items to be removed and added. You can use these callbacks - to optionally inspect the array during the change, clear caches, or do - any other bookkeeping necessary. - - In addition to passing a target, you can also include an options hash - which you can use to override the method names that will be invoked on the - target. - - @param {Object} target - The observer object. - - @param {Hash} opts - Optional hash of configuration options including willChange, didChange, - and a context option. - - @returns {Ember.Array} receiver + Registers an enumerable observer. Must implement Ember.EnumerableObserver + mixin. */ - addArrayObserver: function(target, opts) { - var willChange = (opts && opts.willChange) || 'arrayWillChange', - didChange = (opts && opts.didChange) || 'arrayDidChange'; + addEnumerableObserver: function(target, opts) { + var willChange = (opts && opts.willChange) || 'enumerableWillChange', + didChange = (opts && opts.didChange) || 'enumerableDidChange'; - var hasObservers = get(this, 'hasArrayObservers'); - if (!hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); - Ember.addListener(this, '@array:before', target, willChange, xform); - Ember.addListener(this, '@array:change', target, didChange, xform); - if (!hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); + var hasObservers = get(this, 'hasEnumerableObservers'); + if (!hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); + Ember.addListener(this, '@enumerable:before', target, willChange, xform); + Ember.addListener(this, '@enumerable:change', target, didChange, xform); + if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, - + /** - Removes an array observer from the object if the observer is current - registered. Calling this method multiple times with the same object will - have no effect. - - @param {Object} target - The object observing the array. - - @returns {Ember.Array} receiver + Removes a registered enumerable observer. */ - removeArrayObserver: function(target, opts) { - var willChange = (opts && opts.willChange) || 'arrayWillChange', - didChange = (opts && opts.didChange) || 'arrayDidChange'; + removeEnumerableObserver: function(target, opts) { + var willChange = (opts && opts.willChange) || 'enumerableWillChange', + didChange = (opts && opts.didChange) || 'enumerableDidChange'; - var hasObservers = get(this, 'hasArrayObservers'); - if (hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); - Ember.removeListener(this, '@array:before', target, willChange, xform); - Ember.removeListener(this, '@array:change', target, didChange, xform); - if (hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); + var hasObservers = get(this, 'hasEnumerableObservers'); + if (hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); + Ember.removeListener(this, '@enumerable:before', target, willChange); + Ember.removeListener(this, '@enumerable:change', target, didChange); + if (hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, - + /** Becomes true whenever the array currently has observers watching changes on the array. - - @property {Boolean} - */ - hasArrayObservers: Ember.computed(function() { - return Ember.hasListeners(this, '@array:change') || Ember.hasListeners(this, '@array:before'); - }).property().cacheable(), - - /** - If you are implementing an object that supports Ember.Array, call this - method just before the array content changes to notify any observers and - invalidate any related properties. Pass the starting index of the change - as well as a delta of the amounts to change. - - @param {Number} startIdx - The starting index in the array that will change. - - @param {Number} removeAmt - The number of items that will be removed. If you pass null assumes 0 - - @param {Number} addAmt - The number of items that will be added. If you pass null assumes 0. - - @returns {Ember.Array} receiver - */ - arrayContentWillChange: function(startIdx, removeAmt, addAmt) { - - // if no args are passed assume everything changes - if (startIdx===undefined) { - startIdx = 0; - removeAmt = addAmt = -1; - } else { - if (!removeAmt) removeAmt=0; - if (!addAmt) addAmt=0; - } - - Ember.sendEvent(this, '@array:before', startIdx, removeAmt, addAmt); - - var removing, lim; - if (startIdx>=0 && removeAmt>=0 && get(this, 'hasEnumerableObservers')) { - removing = []; - lim = startIdx+removeAmt; - for(var idx=startIdx;idx=0 && addAmt>=0 && get(this, 'hasEnumerableObservers')) { - adding = []; - lim = startIdx+addAmt; - for(var idx=startIdx;idx= length, then append - to the end of the array. - - @param {Number} amt - Number of elements that should be removed from the array, starting at - *idx*. - - @param {Array} objects - An array of zero or more objects that should be inserted into the array - at *idx* - */ - replace: Ember.required(), - - /** - This will use the primitive replace() method to insert an object at the - specified index. +var get = Ember.get, set = Ember.set, meta = Ember.meta; - @param {Number} idx index of insert the object at. - @param {Object} object object to insert - */ - insertAt: function(idx, object) { - if (idx > get(this, 'length')) throw new Error(OUT_OF_RANGE_EXCEPTION) ; - this.replace(idx, 0, [object]) ; - return this ; - }, +/** @private */ +function none(obj) { return obj===null || obj===undefined; } - /** - Remove an object at the specified index using the replace() primitive - method. You can pass either a single index, a start and a length or an - index set. +/** @private */ +function xform(target, method, params) { + method.call(target, params[0], params[2], params[3], params[4]); +} - If you pass a single index or a start and length that is beyond the - length this method will throw an Ember.OUT_OF_RANGE_EXCEPTION +// .......................................................... +// ARRAY +// +/** + @namespace - @param {Number|Ember.IndexSet} start index, start of range, or index set - @param {Number} len length of passing range - @returns {Object} receiver - */ - removeAt: function(start, len) { + This module implements Observer-friendly Array-like behavior. This mixin is + picked up by the Array class as well as other controllers, etc. that want to + appear to be arrays. - var delta = 0; + Unlike Ember.Enumerable, this mixin defines methods specifically for + collections that provide index-ordered access to their contents. When you + are designing code that needs to accept any kind of Array-like object, you + should use these methods instead of Array primitives because these will + properly notify observers of changes to the array. - if ('number' === typeof start) { + Although these methods are efficient, they do add a layer of indirection to + your application so it is a good idea to use them only when you need the + flexibility of using both true JavaScript arrays and "virtual" arrays such + as controllers and collections. - if ((start < 0) || (start >= get(this, 'length'))) { - throw new Error(OUT_OF_RANGE_EXCEPTION); - } + You can use the methods defined in this module to access and modify array + contents in a KVO-friendly way. You can also be notified whenever the + membership if an array changes by changing the syntax of the property to + .observes('*myProperty.[]') . - // fast case - if (len === undefined) len = 1; - this.replace(start, len, EMPTY); - } + To support Ember.Array in your own class, you must override two + primitives to use it: replace() and objectAt(). - // TODO: Reintroduce Ember.IndexSet support - // this.beginPropertyChanges(); - // start.forEachRange(function(start, length) { - // start -= delta ; - // delta += length ; - // this.replace(start, length, empty); // remove! - // }, this); - // this.endPropertyChanges(); + Note that the Ember.Array mixin also incorporates the Ember.Enumerable mixin. All + Ember.Array-like objects are also enumerable. - return this ; - }, + @extends Ember.Enumerable + @since Ember 0.9.0 +*/ +Ember.Array = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.Array.prototype */ { + /** @private - compatibility */ + isSCArray: true, + /** - Push the object onto the end of the array. Works just like push() but it - is KVO-compliant. - */ - pushObject: function(obj) { - this.insertAt(get(this, 'length'), obj) ; - return obj ; - }, + @field {Number} length + Your array must support the length property. Your replace methods should + set this property whenever it changes. + */ + length: Ember.required(), /** - Add the objects in the passed numerable to the end of the array. Defers - notifying observers of the change until all objects are added. + This is one of the primitives you must implement to support Ember.Array. + Returns the object at the named index. If your object supports retrieving + the value of an array item using get() (i.e. myArray.get(0)), then you do + not need to implement this method yourself. - @param {Ember.Enumerable} objects the objects to add - @returns {Ember.Array} receiver + @param {Number} idx + The index of the item to return. If idx exceeds the current length, + return null. */ - pushObjects: function(objects) { - this.replace(get(this, 'length'), 0, objects); - return this; + objectAt: function(idx) { + if ((idx < 0) || (idx>=get(this, 'length'))) return undefined ; + return get(this, idx); }, + /** @private (nodoc) - overrides Ember.Enumerable version */ + nextObject: function(idx) { + return this.objectAt(idx); + }, + /** - Pop object from array or nil if none are left. Works just like pop() but - it is KVO-compliant. + @field [] + + This is the handler for the special array content property. If you get + this property, it will return this. If you set this property it a new + array, it will replace the current content. + + This property overrides the default property defined in Ember.Enumerable. */ - popObject: function() { - var len = get(this, 'length') ; - if (len === 0) return null ; + '[]': Ember.computed(function(key, value) { + if (value !== undefined) this.replace(0, get(this, 'length'), value) ; + return this ; + }).property().cacheable(), - var ret = this.objectAt(len-1) ; - this.removeAt(len-1, 1) ; - return ret ; + /** @private (nodoc) - optimized version from Enumerable */ + contains: function(obj){ + return this.indexOf(obj) >= 0; }, + // Add any extra methods to Ember.Array that are native to the built-in Array. /** - Shift an object from start of array or nil if none are left. Works just - like shift() but it is KVO-compliant. + Returns a new array that is a slice of the receiver. This implementation + uses the observable array methods to retrieve the objects for the new + slice. + + var arr = ['red', 'green', 'blue']; + arr.slice(0); => ['red', 'green', 'blue'] + arr.slice(0, 2); => ['red', 'green'] + arr.slice(1, 100); => ['green', 'blue'] + + @param beginIndex {Integer} (Optional) index to begin slicing from. + @param endIndex {Integer} (Optional) index to end the slice at. + @returns {Array} New array with specified slice */ - shiftObject: function() { - if (get(this, 'length') === 0) return null ; - var ret = this.objectAt(0) ; - this.removeAt(0) ; + slice: function(beginIndex, endIndex) { + var ret = []; + var length = get(this, 'length') ; + if (none(beginIndex)) beginIndex = 0 ; + if (none(endIndex) || (endIndex > length)) endIndex = length ; + while(beginIndex < endIndex) { + ret[ret.length] = this.objectAt(beginIndex++) ; + } return ret ; }, /** - Unshift an object to start of array. Works just like unshift() but it is - KVO-compliant. - */ - unshiftObject: function(obj) { - this.insertAt(0, obj) ; - return obj ; - }, - + Returns the index of the given object's first occurrence. + If no startAt argument is given, the starting location to + search is 0. If it's negative, will count backward from + the end of the array. Returns -1 if no match is found. - /** - Adds the named objects to the beginning of the array. Defers notifying - observers until all objects have been added. + @param {Object} object the item to search for + @param {Number} startAt optional starting location to search, default 0 + @returns {Number} index or -1 if not found - @param {Ember.Enumerable} objects the objects to add - @returns {Ember.Array} receiver + @example + var arr = ["a", "b", "c", "d", "a"]; + arr.indexOf("a"); => 0 + arr.indexOf("z"); => -1 + arr.indexOf("a", 2); => 4 + arr.indexOf("a", -1); => 4 + arr.indexOf("b", 3); => -1 + arr.indexOf("a", 100); => -1 */ - unshiftObjects: function(objects) { - this.beginPropertyChanges(); - objects.forEach(function(obj) { this.unshiftObject(obj); }, this); - this.endPropertyChanges(); - return this; - }, - - // .......................................................... - // IMPLEMENT Ember.MutableEnumerable - // + indexOf: function(object, startAt) { + var idx, len = get(this, 'length'); - /** @private (nodoc) */ - removeObject: function(obj) { - var loc = get(this, 'length') || 0; - while(--loc >= 0) { - var curObject = this.objectAt(loc) ; - if (curObject === obj) this.removeAt(loc) ; + if (startAt === undefined) startAt = 0; + if (startAt < 0) startAt += len; + + for(idx=startAt;idx 4 + arr.lastIndexOf("z"); => -1 + arr.lastIndexOf("a", 2); => 0 + arr.lastIndexOf("a", -1); => 4 + arr.lastIndexOf("b", 3); => 1 + arr.lastIndexOf("a", 100); => 4 + */ + lastIndexOf: function(object, startAt) { + var idx, len = get(this, 'length'); -var get = Ember.get, set = Ember.set; - -/** - @class + if (startAt === undefined || startAt >= len) startAt = len-1; + if (startAt < 0) startAt += len; - Restores some of the Ember 1.x Ember.Observable mixin API. The new property - observing system does not require Ember.Observable to be applied anymore. - Instead, on most browsers you can just access properties directly. For - code that needs to run on IE7 or IE8 you should use Ember.get() and Ember.set() - instead. - - If you have older code and you want to bring back the older Ember 1.x observable - API, you can do so by readding Ember.Observable to Ember.Object like so: + for(idx=startAt;idx>=0;idx--) { + if (this.objectAt(idx) === object) return idx ; + } + return -1; + }, - Ember.Object.reopen(Ember.Observable); - - You will then be able to use the traditional get(), set() and other - observable methods on your objects. - - @extends Ember.Mixin -*/ -Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { - - /** @private - compatibility */ - isObserverable: true, + // .......................................................... + // ARRAY OBSERVERS + // /** - Retrieves the value of key from the object. - - This method is generally very similar to using object[key] or object.key, - however it supports both computed properties and the unknownProperty - handler. - - ## Computed Properties - - Computed properties are methods defined with the property() modifier - declared at the end, such as: - - fullName: function() { - return this.getEach('firstName', 'lastName').compact().join(' '); - }.property('firstName', 'lastName') - - When you call get() on a computed property, the property function will be - called and the return value will be returned instead of the function - itself. - - ## Unknown Properties - - Likewise, if you try to call get() on a property whose values is - undefined, the unknownProperty() method will be called on the object. - If this method reutrns any value other than undefined, it will be returned - instead. This allows you to implement "virtual" properties that are - not defined upfront. + Adds an array observer to the receiving array. The array observer object + normally must implement two methods: + + * `arrayWillChange(start, removeCount, addCount)` - This method will be + called just before the array is modified. + * `arrayDidChange(start, removeCount, addCount)` - This method will be + called just after the array is modified. + + Both callbacks will be passed the starting index of the change as well a + a count of the items to be removed and added. You can use these callbacks + to optionally inspect the array during the change, clear caches, or do + any other bookkeeping necessary. + + In addition to passing a target, you can also include an options hash + which you can use to override the method names that will be invoked on the + target. + + @param {Object} target + The observer object. + + @param {Hash} opts + Optional hash of configuration options including willChange, didChange, + and a context option. + + @returns {Ember.Array} receiver + */ + addArrayObserver: function(target, opts) { + var willChange = (opts && opts.willChange) || 'arrayWillChange', + didChange = (opts && opts.didChange) || 'arrayDidChange'; - @param {String} key The property to retrieve - @returns {Object} The property value or undefined. - */ - get: function(keyName) { - return get(this, keyName); + var hasObservers = get(this, 'hasArrayObservers'); + if (!hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); + Ember.addListener(this, '@array:before', target, willChange, xform); + Ember.addListener(this, '@array:change', target, didChange, xform); + if (!hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); + return this; }, - + /** - To get multiple properties at once, call getProperties - with a list of strings: - - record.getProperties('firstName', 'lastName', 'zipCode'); - - @param {String...} list of keys to get - @returns {Hash} + Removes an array observer from the object if the observer is current + registered. Calling this method multiple times with the same object will + have no effect. + + @param {Object} target + The object observing the array. + + @returns {Ember.Array} receiver */ - getProperties: function() { - var ret = {}; - for(var i = 0; i < arguments.length; i++) { - ret[arguments[i]] = get(this, arguments[i]); - } - return ret; + removeArrayObserver: function(target, opts) { + var willChange = (opts && opts.willChange) || 'arrayWillChange', + didChange = (opts && opts.didChange) || 'arrayDidChange'; + + var hasObservers = get(this, 'hasArrayObservers'); + if (hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); + Ember.removeListener(this, '@array:before', target, willChange, xform); + Ember.removeListener(this, '@array:change', target, didChange, xform); + if (hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); + return this; }, /** - Sets the key equal to value. - - This method is generally very similar to calling object[key] = value or - object.key = value, except that it provides support for computed - properties, the unknownProperty() method and property observers. - - ## Computed Properties - - If you try to set a value on a key that has a computed property handler - defined (see the get() method for an example), then set() will call - that method, passing both the value and key instead of simply changing - the value itself. This is useful for those times when you need to - implement a property that is composed of one or more member - properties. - - ## Unknown Properties - - If you try to set a value on a key that is undefined in the target - object, then the unknownProperty() handler will be called instead. This - gives you an opportunity to implement complex "virtual" properties that - are not predefined on the obejct. If unknownProperty() returns - undefined, then set() will simply set the value on the object. - - ## Property Observers - - In addition to changing the property, set() will also register a - property change with the object. Unless you have placed this call - inside of a beginPropertyChanges() and endPropertyChanges(), any "local" - observers (i.e. observer methods declared on the same object), will be - called immediately. Any "remote" observers (i.e. observer methods - declared on another object) will be placed in a queue and called at a - later time in a coelesced manner. - - ## Chaining - - In addition to property changes, set() returns the value of the object - itself so you can do chaining like this: - - record.set('firstName', 'Charles').set('lastName', 'Jolley'); - - @param {String} key The property to set - @param {Object} value The value to set or null. - @returns {Ember.Observable} + Becomes true whenever the array currently has observers watching changes + on the array. + + @property {Boolean} */ - set: function(keyName, value) { - set(this, keyName, value); - return this; - }, + hasArrayObservers: Ember.computed(function() { + return Ember.hasListeners(this, '@array:change') || Ember.hasListeners(this, '@array:before'); + }).property().cacheable(), /** - To set multiple properties at once, call setProperties - with a Hash: - - record.setProperties({ firstName: 'Charles', lastName: 'Jolley' }); - - @param {Hash} hash the hash of keys and values to set - @returns {Ember.Observable} + If you are implementing an object that supports Ember.Array, call this + method just before the array content changes to notify any observers and + invalidate any related properties. Pass the starting index of the change + as well as a delta of the amounts to change. + + @param {Number} startIdx + The starting index in the array that will change. + + @param {Number} removeAmt + The number of items that will be removed. If you pass null assumes 0 + + @param {Number} addAmt + The number of items that will be added. If you pass null assumes 0. + + @returns {Ember.Array} receiver */ - setProperties: function(hash) { - var self = this; - Ember.changeProperties(function(){ - for(var prop in hash) { - if (hash.hasOwnProperty(prop)) set(self, prop, hash[prop]); - } - }); - return this; - }, + arrayContentWillChange: function(startIdx, removeAmt, addAmt) { - /** - Begins a grouping of property changes. + // if no args are passed assume everything changes + if (startIdx===undefined) { + startIdx = 0; + removeAmt = addAmt = -1; + } else { + if (!removeAmt) removeAmt=0; + if (!addAmt) addAmt=0; + } - You can use this method to group property changes so that notifications - will not be sent until the changes are finished. If you plan to make a - large number of changes to an object at one time, you should call this - method at the beginning of the changes to suspend change notifications. - When you are done making changes, call endPropertyChanges() to allow - notification to resume. + Ember.sendEvent(this, '@array:before', startIdx, removeAmt, addAmt); - @returns {Ember.Observable} - */ - beginPropertyChanges: function() { - Ember.beginPropertyChanges(); + var removing, lim; + if (startIdx>=0 && removeAmt>=0 && get(this, 'hasEnumerableObservers')) { + removing = []; + lim = startIdx+removeAmt; + for(var idx=startIdx;idx=0 && addAmt>=0 && get(this, 'hasEnumerableObservers')) { + adding = []; + lim = startIdx+addAmt; + for(var idx=startIdx;idx b` - Once you call this method, anytime the key's value is set, your observer - will be notified. Note that the observers are triggered anytime the - value is set, regardless of whether it has actually changed. Your - observer should be prepared to handle that. + Default implementation raises an exception. - You can also pass an optional context parameter to this method. The - context will be passed to your observer method whenever it is triggered. - Note that if you add the same target/method pair on a key multiple times - with different context parameters, your observer will only be called once - with the last context you passed. + @param a {Object} the first object to compare + @param b {Object} the second object to compare + @returns {Integer} the result of the comparison + */ + compare: Ember.required(Function) - ## Observer Methods +}); - Observer methods you pass should generally have the following signature if - you do not pass a "context" parameter: - fooDidChange: function(sender, key, value, rev); +})({}); - The sender is the object that changed. The key is the property that - changes. The value property is currently reserved and unused. The rev - is the last property revision of the object when it changed, which you can - use to detect if the key value has really changed or not. +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2010 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var get = Ember.get, set = Ember.set; - If you pass a "context" parameter, the context will be passed before the - revision like so: +/** + @namespace - fooDidChange: function(sender, key, value, context, rev); + Implements some standard methods for copying an object. Add this mixin to + any object you create that can create a copy of itself. This mixin is + added automatically to the built-in array. - Usually you will not need the value, context or revision parameters at - the end. In this case, it is common to write observer methods that take - only a sender and key value as parameters or, if you aren't interested in - any of these values, to write an observer that has no parameters at all. + You should generally implement the copy() method to return a copy of the + receiver. + + Note that frozenCopy() will only work if you also implement Ember.Freezable. + + @since Ember 0.9 +*/ +Ember.Copyable = Ember.Mixin.create( +/** @scope Ember.Copyable.prototype */ { - @param {String} key The key to observer - @param {Object} target The target object to invoke - @param {String|Function} method The method to invoke. - @returns {Ember.Object} self - */ - addObserver: function(key, target, method) { - Ember.addObserver(this, key, target, method); - }, - /** - Remove an observer you have previously registered on this object. Pass - the same key, target, and method you passed to addObserver() and your - target will no longer receive notifications. + Override to return a copy of the receiver. Default implementation raises + an exception. - @param {String} key The key to observer - @param {Object} target The target object to invoke - @param {String|Function} method The method to invoke. - @returns {Ember.Observable} reciever + @param deep {Boolean} if true, a deep copy of the object should be made + @returns {Object} copy of receiver */ - removeObserver: function(key, target, method) { - Ember.removeObserver(this, key, target, method); - }, - + copy: Ember.required(Function), + /** - Returns YES if the object currently has observers registered for a - particular key. You can use this method to potentially defer performing - an expensive action until someone begins observing a particular property - on the object. + If the object implements Ember.Freezable, then this will return a new copy + if the object is not frozen and the receiver if the object is frozen. - @param {String} key Key to check - @returns {Boolean} - */ - hasObserverFor: function(key) { - return Ember.hasListeners(this, key+':change'); - }, + Raises an exception if you try to call this method on a object that does + not support freezing. - unknownProperty: function(key) { - return undefined; - }, - - setUnknownProperty: function(key, value) { - this[key] = value; - }, - - getPath: function(path) { - return Ember.getPath(this, path); - }, - - setPath: function(path, value) { - Ember.setPath(this, path, value); - return this; - }, - - incrementProperty: function(keyName, increment) { - if (!increment) { increment = 1; } - set(this, keyName, (get(this, keyName) || 0)+increment); - return get(this, keyName); - }, - - decrementProperty: function(keyName, increment) { - if (!increment) { increment = 1; } - set(this, keyName, (get(this, keyName) || 0)-increment); - return get(this, keyName); - }, - - toggleProperty: function(keyName) { - set(this, keyName, !get(this, keyName)); - return get(this, keyName); - }, - - observersForKey: function(keyName) { - return Ember.observersFor(this, keyName); + You should use this method whenever you want a copy of a freezable object + since a freezable object can simply return itself without actually + consuming more memory. + + @returns {Object} copy of receiver or receiver + */ + frozenCopy: function() { + if (Ember.Freezable && Ember.Freezable.detect(this)) { + return get(this, 'isFrozen') ? this : this.copy().freeze(); + } else { + throw new Error(Ember.String.fmt("%@ does not support freezing", [this])); + } } - }); @@ -8096,868 +8814,945 @@ Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime -// Copyright: ©2011 Strobe Inc. and contributors. +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2010 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== -// NOTE: this object should never be included directly. Instead use Ember. -// Ember.Object. We only define this separately so that Ember.Set can depend on it +var get = Ember.get, set = Ember.set; -var rewatch = Ember.rewatch; -var classToString = Ember.Mixin.prototype.toString; -var set = Ember.set, get = Ember.get; -var o_create = Ember.platform.create, - meta = Ember.meta; +/** + @namespace -function makeCtor() { + The Ember.Freezable mixin implements some basic methods for marking an object + as frozen. Once an object is frozen it should be read only. No changes + may be made the internal state of the object. - // Note: avoid accessing any properties on the object since it makes the - // method a lot faster. This is glue code so we want it to be as fast as - // possible. + ## Enforcement - var isPrepared = false, initMixins, init = false, hasChains = false; + To fully support freezing in your subclass, you must include this mixin and + override any method that might alter any property on the object to instead + raise an exception. You can check the state of an object by checking the + isFrozen property. - var Class = function() { - if (!isPrepared) { get(Class, 'proto'); } // prepare prototype... - if (initMixins) { - this.reopen.apply(this, initMixins); - initMixins = null; - rewatch(this); // ålways rewatch just in case - this.init.apply(this, arguments); - } else { - if (hasChains) { - rewatch(this); - } else { - this[Ember.GUID_KEY] = undefined; - } - if (init===false) { init = this.init; } // cache for later instantiations - init.apply(this, arguments); - } - }; + Although future versions of JavaScript may support language-level freezing + object objects, that is not the case today. Even if an object is freezable, + it is still technically possible to modify the object, even though it could + break other parts of your application that do not expect a frozen object to + change. It is, therefore, very important that you always respect the + isFrozen property on all freezable objects. - Class.toString = classToString; - Class._prototypeMixinDidChange = function() { isPrepared = false; }; - Class._initMixins = function(args) { initMixins = args; }; + ## Example Usage - Ember.defineProperty(Class, 'proto', Ember.computed(function() { - if (!isPrepared) { - isPrepared = true; - Class.PrototypeMixin.applyPartial(Class.prototype); - hasChains = !!meta(Class.prototype, false).chains; // avoid rewatch - } - return this.prototype; - })); + The example below shows a simple object that implement the Ember.Freezable + protocol. - return Class; + Contact = Ember.Object.extend(Ember.Freezable, { -} + firstName: null, -var CoreObject = makeCtor(); + lastName: null, -CoreObject.PrototypeMixin = Ember.Mixin.create( -/** @scope Ember.CoreObject */ { + // swaps the names + swapNames: function() { + if (this.get('isFrozen')) throw Ember.FROZEN_ERROR; + var tmp = this.get('firstName'); + this.set('firstName', this.get('lastName')); + this.set('lastName', tmp); + return this; + } - reopen: function() { - Ember.Mixin._apply(this, arguments, true); - return this; - }, + }); + + c = Context.create({ firstName: "John", lastName: "Doe" }); + c.swapNames(); => returns c + c.freeze(); + c.swapNames(); => EXCEPTION + + ## Copying + + Usually the Ember.Freezable protocol is implemented in cooperation with the + Ember.Copyable protocol, which defines a frozenCopy() method that will return + a frozen object, if the object implements this method as well. + + @since Ember 0.9 +*/ +Ember.Freezable = Ember.Mixin.create( +/** @scope Ember.Freezable.prototype */ { + + /** + Set to true when the object is frozen. Use this property to detect whether + your object is frozen or not. + + @property {Boolean} + */ + isFrozen: false, + + /** + Freezes the object. Once this method has been called the object should + no longer allow any properties to be edited. - isInstance: true, + @returns {Object} reciever + */ + freeze: function() { + if (get(this, 'isFrozen')) return this; + set(this, 'isFrozen', true); + return this; + } - init: function() {}, +}); - isDestroyed: false, +Ember.FROZEN_ERROR = "Frozen object cannot be modified."; - /** - Destroys an object by setting the isDestroyed flag and removing its - metadata, which effectively destroys observers and bindings. - If you try to set a property on a destroyed object, an exception will be - raised. - Note that destruction is scheduled for the end of the run loop and does not - happen immediately. - @returns {Ember.Object} receiver - */ - destroy: function() { - set(this, 'isDestroyed', true); - Ember.run.schedule('destroy', this, this._scheduledDestroy); - return this; - }, +})({}); - /** - Invoked by the run loop to actually destroy the object. This is - scheduled for execution by the `destroy` method. +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var forEach = Ember.ArrayUtils.forEach; - @private - */ - _scheduledDestroy: function() { - Ember.destroy(this); - }, +/** + @class - bind: function(to, from) { - if (!(from instanceof Ember.Binding)) { from = Ember.Binding.from(from); } - from.to(to).connect(this); - return from; - }, + This mixin defines the API for modifying generic enumerables. These methods + can be applied to an object regardless of whether it is ordered or + unordered. - toString: function() { - return '<'+this.constructor.toString()+':'+Ember.guidFor(this)+'>'; - } -}); + Note that an Enumerable can change even if it does not implement this mixin. + For example, a MappedEnumerable cannot be directly modified but if its + underlying enumerable changes, it will change also. -CoreObject.__super__ = null; + ## Adding Objects -var ClassMixin = Ember.Mixin.create({ + To add an object to an enumerable, use the addObject() method. This + method will only add the object to the enumerable if the object is not + already present and the object if of a type supported by the enumerable. - ClassMixin: Ember.required(), + javascript: + set.addObject(contact); - PrototypeMixin: Ember.required(), + ## Removing Objects - isClass: true, + To remove an object form an enumerable, use the removeObject() method. This + will only remove the object if it is already in the enumerable, otherwise + this method has no effect. - isMethod: false, + javascript: + set.removeObject(contact); - extend: function() { - var Class = makeCtor(), proto; - Class.ClassMixin = Ember.Mixin.create(this.ClassMixin); - Class.PrototypeMixin = Ember.Mixin.create(this.PrototypeMixin); + ## Implementing In Your Own Code - Class.ClassMixin.ownerConstructor = Class; - Class.PrototypeMixin.ownerConstructor = Class; + If you are implementing an object and want to support this API, just include + this mixin in your class and implement the required methods. In your unit + tests, be sure to apply the Ember.MutableEnumerableTests to your object. - var PrototypeMixin = Class.PrototypeMixin; - PrototypeMixin.reopen.apply(PrototypeMixin, arguments); + @extends Ember.Mixin + @extends Ember.Enumerable +*/ +Ember.MutableEnumerable = Ember.Mixin.create(Ember.Enumerable, + /** @scope Ember.MutableEnumerable.prototype */ { - Class.superclass = this; - Class.__super__ = this.prototype; + /** + __Required.__ You must implement this method to apply this mixin. - proto = Class.prototype = o_create(this.prototype); - proto.constructor = Class; - Ember.generateGuid(proto, 'ember'); - meta(proto).proto = proto; // this will disable observers on prototype - Ember.rewatch(proto); // setup watch chains if needed. + Attempts to add the passed object to the receiver if the object is not + already present in the collection. If the object is present, this method + has no effect. + If the passed object is of a type not supported by the receiver + then this method should raise an exception. - Class.subclasses = Ember.Set ? new Ember.Set() : null; - if (this.subclasses) { this.subclasses.add(Class); } + @param {Object} object + The object to add to the enumerable. - Class.ClassMixin.apply(Class); - return Class; - }, + @returns {Object} the passed object + */ + addObject: Ember.required(Function), - create: function() { - var C = this; - if (arguments.length>0) { this._initMixins(arguments); } - return new C(); - }, + /** + Adds each object in the passed enumerable to the receiver. - reopen: function() { - var PrototypeMixin = this.PrototypeMixin; - PrototypeMixin.reopen.apply(PrototypeMixin, arguments); - this._prototypeMixinDidChange(); + @param {Ember.Enumerable} objects the objects to add. + @returns {Object} receiver + */ + addObjects: function(objects) { + Ember.beginPropertyChanges(this); + forEach(objects, function(obj) { this.addObject(obj); }, this); + Ember.endPropertyChanges(this); return this; }, - reopenClass: function() { - var ClassMixin = this.ClassMixin; - ClassMixin.reopen.apply(ClassMixin, arguments); - Ember.Mixin._apply(this, arguments, false); - return this; - }, + /** + __Required.__ You must implement this method to apply this mixin. - detect: function(obj) { - if ('function' !== typeof obj) { return false; } - while(obj) { - if (obj===this) { return true; } - obj = obj.superclass; - } - return false; - }, + Attempts to remove the passed object from the receiver collection if the + object is in present in the collection. If the object is not present, + this method has no effect. - detectInstance: function(obj) { - return this.PrototypeMixin.detect(obj); - } + If the passed object is of a type not supported by the receiver + then this method should raise an exception. -}); + @param {Object} object + The object to remove from the enumerable. -CoreObject.ClassMixin = ClassMixin; -ClassMixin.apply(CoreObject); + @returns {Object} the passed object + */ + removeObject: Ember.required(Function), -/** - @class -*/ -Ember.CoreObject = CoreObject; + /** + Removes each objects in the passed enumerable from the receiver. + @param {Ember.Enumerable} objects the objects to remove + @returns {Object} receiver + */ + removeObjects: function(objects) { + Ember.beginPropertyChanges(this); + forEach(objects, function(obj) { this.removeObject(obj); }, this); + Ember.endPropertyChanges(this); + return this; + } +}); })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals ENV ember_assert */ -// ........................................ -// GLOBAL CONSTANTS -// - -/** - @name YES - @static - @type Boolean - @default true - @constant -*/ -YES = true; - -/** - @name NO - @static - @type Boolean - @default NO - @constant -*/ -NO = false; - -// ensure no undefined errors in browsers where console doesn't exist -if (typeof console === 'undefined') { - window.console = {}; - console.log = console.info = console.warn = console.error = function() {}; -} - // .......................................................... -// BOOTSTRAP -// - -/** - @static - @type Boolean - @default YES - @constant - - Determines whether Ember should enhances some built-in object - prototypes to provide a more friendly API. If enabled, a few methods - will be added to Function, String, and Array. Object.prototype will not be - enhanced, which is the one that causes most troubles for people. - - In general we recommend leaving this option set to true since it rarely - conflicts with other code. If you need to turn it off however, you can - define an ENV.EXTEND_PROTOTYPES config to disable it. -*/ -Ember.EXTEND_PROTOTYPES = (Ember.ENV.EXTEND_PROTOTYPES !== false); - -// ........................................ -// TYPING & ARRAY MESSAGING +// CONSTANTS // -var TYPE_MAP = {}; -var t ="Boolean Number String Function Array Date RegExp Object".split(" "); -t.forEach(function(name) { - TYPE_MAP[ "[object " + name + "]" ] = name.toLowerCase(); -}); - -var toString = Object.prototype.toString; - -/** - Returns a consistent type for the passed item. - - Use this instead of the built-in Ember.typeOf() to get the type of an item. - It will return the same result across all browsers and includes a bit - more detail. Here is what will be returned: - - | Return Value Constant | Meaning | - | 'string' | String primitive | - | 'number' | Number primitive | - | 'boolean' | Boolean primitive | - | 'null' | Null value | - | 'undefined' | Undefined value | - | 'function' | A function | - | 'array' | An instance of Array | - | 'class' | A Ember class (created using Ember.Object.extend()) | - | 'instance' | A Ember object instance | - | 'error' | An instance of the Error object | - | 'object' | A JavaScript object not inheriting from Ember.Object | - - @param item {Object} the item to check - @returns {String} the type -*/ -Ember.typeOf = function(item) { - var ret; - - ret = item==null ? String(item) : TYPE_MAP[toString.call(item)]||'object'; +var OUT_OF_RANGE_EXCEPTION = "Index out of range" ; +var EMPTY = []; - if (ret === 'function') { - if (Ember.Object && Ember.Object.detect(item)) ret = 'class'; - } else if (ret === 'object') { - if (item instanceof Error) ret = 'error'; - else if (Ember.Object && item instanceof Ember.Object) ret = 'instance'; - else ret = 'object'; - } - - return ret; -}; +// .......................................................... +// HELPERS +// + +var get = Ember.get, set = Ember.set, forEach = Ember.ArrayUtils.forEach; /** - Returns YES if the passed value is null or undefined. This avoids errors - from JSLint complaining about use of ==, which can be technically - confusing. + @class - @param {Object} obj Value to test - @returns {Boolean} -*/ -Ember.none = function(obj) { - return obj === null || obj === undefined; -}; + This mixin defines the API for modifying array-like objects. These methods + can be applied only to a collection that keeps its items in an ordered set. -/** - Verifies that a value is null or an empty string | array | function. + Note that an Array can change even if it does not implement this mixin. + For example, a SparyArray may not be directly modified but if its + underlying enumerable changes, it will change also. - @param {Object} obj Value to test - @returns {Boolean} + @extends Ember.Mixin + @extends Ember.Array + @extends Ember.MutableEnumerable */ -Ember.empty = function(obj) { - return obj === null || obj === undefined || (obj.length === 0 && typeof obj !== 'function'); -}; +Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable, + /** @scope Ember.MutableArray.prototype */ { -/** - Ember.isArray defined in ember-metal/lib/utils -**/ + /** + __Required.__ You must implement this method to apply this mixin. -/** - This will compare two javascript values of possibly different types. - It will tell you which one is greater than the other by returning: + This is one of the primitves you must implement to support Ember.Array. You + should replace amt objects started at idx with the objects in the passed + array. You should also call this.enumerableContentDidChange() ; - - -1 if the first is smaller than the second, - - 0 if both are equal, - - 1 if the first is greater than the second. + @param {Number} idx + Starting index in the array to replace. If idx >= length, then append + to the end of the array. - The order is calculated based on Ember.ORDER_DEFINITION, if types are different. - In case they have the same type an appropriate comparison for this type is made. + @param {Number} amt + Number of elements that should be removed from the array, starting at + *idx*. - @param {Object} v First value to compare - @param {Object} w Second value to compare - @returns {Number} -1 if v < w, 0 if v = w and 1 if v > w. -*/ -Ember.compare = function (v, w) { - if (v === w) { return 0; } + @param {Array} objects + An array of zero or more objects that should be inserted into the array + at *idx* + */ + replace: Ember.required(), - var type1 = Ember.typeOf(v); - var type2 = Ember.typeOf(w); + /** + Remove all elements from self. This is useful if you + want to reuse an existing array without having to recreate it. - var Comparable = Ember.Comparable; - if (Comparable) { - if (type1==='instance' && Comparable.detect(v.constructor)) { - return v.constructor.compare(v, w); - } - - if (type2 === 'instance' && Comparable.detect(w.constructor)) { - return 1-w.constructor.compare(w, v); - } - } + var colors = ["red", "green", "blue"]; + color.length(); => 3 + colors.clear(); => [] + colors.length(); => 0 - // If we haven't yet generated a reverse-mapping of Ember.ORDER_DEFINITION, - // do so now. - var mapping = Ember.ORDER_DEFINITION_MAPPING; - if (!mapping) { - var order = Ember.ORDER_DEFINITION; - mapping = Ember.ORDER_DEFINITION_MAPPING = {}; - var idx, len; - for (idx = 0, len = order.length; idx < len; ++idx) { - mapping[order[idx]] = idx; - } + @returns {Ember.Array} An empty Array. + */ + clear: function () { + var len = get(this, 'length'); + if (len === 0) return this; + this.replace(0, len, EMPTY); + return this; + }, - // We no longer need Ember.ORDER_DEFINITION. - delete Ember.ORDER_DEFINITION; - } + /** + This will use the primitive replace() method to insert an object at the + specified index. - var type1Index = mapping[type1]; - var type2Index = mapping[type2]; + var colors = ["red", "green", "blue"]; + colors.insertAt(2, "yellow"); => ["red", "green", "yellow", "blue"] + colors.insertAt(5, "orange"); => Error: Index out of range - if (type1Index < type2Index) { return -1; } - if (type1Index > type2Index) { return 1; } + @param {Number} idx index of insert the object at. + @param {Object} object object to insert + */ + insertAt: function(idx, object) { + if (idx > get(this, 'length')) throw new Error(OUT_OF_RANGE_EXCEPTION) ; + this.replace(idx, 0, [object]) ; + return this ; + }, - // types are equal - so we have to check values now - switch (type1) { - case 'boolean': - case 'number': - if (v < w) { return -1; } - if (v > w) { return 1; } - return 0; + /** + Remove an object at the specified index using the replace() primitive + method. You can pass either a single index, or a start and a length. - case 'string': - var comp = v.localeCompare(w); - if (comp < 0) { return -1; } - if (comp > 0) { return 1; } - return 0; + If you pass a start and length that is beyond the + length this method will throw an Ember.OUT_OF_RANGE_EXCEPTION - case 'array': - var vLen = v.length; - var wLen = w.length; - var l = Math.min(vLen, wLen); - var r = 0; - var i = 0; - var thisFunc = arguments.callee; - while (r === 0 && i < l) { - r = thisFunc(v[i],w[i]); - i++; - } - if (r !== 0) { return r; } + var colors = ["red", "green", "blue", "yellow", "orange"]; + colors.removeAt(0); => ["green", "blue", "yellow", "orange"] + colors.removeAt(2, 2); => ["green", "blue"] + colors.removeAt(4, 2); => Error: Index out of range - // all elements are equal now - // shorter array should be ordered first - if (vLen < wLen) { return -1; } - if (vLen > wLen) { return 1; } - // arrays are equal now - return 0; + @param {Number|Ember.IndexSet} start index, start of range, or index set + @param {Number} len length of passing range + @returns {Object} receiver + */ + removeAt: function(start, len) { - case 'instance': - if (Ember.Comparable && Ember.Comparable.detect(v)) { - return v.compare(v, w); + var delta = 0; + + if ('number' === typeof start) { + + if ((start < 0) || (start >= get(this, 'length'))) { + throw new Error(OUT_OF_RANGE_EXCEPTION); } - return 0; - default: - return 0; - } -}; + // fast case + if (len === undefined) len = 1; + this.replace(start, len, EMPTY); + } -function _copy(obj, deep, seen, copies) { - var ret, loc, key; + return this ; + }, - // primitive data types are immutable, just return them. - if ('object' !== typeof obj || obj===null) return obj; + /** + Push the object onto the end of the array. Works just like push() but it + is KVO-compliant. - // avoid cyclical loops - if (deep && (loc=seen.indexOf(obj))>=0) return copies[loc]; - - ember_assert('Cannot clone an Ember.Object that does not implement Ember.Copyable', !(obj instanceof Ember.Object) || (Ember.Copyable && Ember.Copyable.detect(obj))); + var colors = ["red", "green", "blue"]; + colors.pushObject("black"); => ["red", "green", "blue", "black"] + colors.pushObject(["yellow", "orange"]); => ["red", "green", "blue", "black", ["yellow", "orange"]] - // IMPORTANT: this specific test will detect a native array only. Any other - // object will need to implement Copyable. - if (Ember.typeOf(obj) === 'array') { - ret = obj.slice(); - if (deep) { - loc = ret.length; - while(--loc>=0) ret[loc] = _copy(ret[loc], deep, seen, copies); - } - } else if (Ember.Copyable && Ember.Copyable.detect(obj)) { - ret = obj.copy(deep, seen, copies); - } else { - ret = {}; - for(key in obj) { - if (!obj.hasOwnProperty(key)) continue; - ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key]; - } - } - - if (deep) { - seen.push(obj); - copies.push(ret); - } + */ + pushObject: function(obj) { + this.insertAt(get(this, 'length'), obj) ; + return obj ; + }, - return ret; -} + /** + Add the objects in the passed numerable to the end of the array. Defers + notifying observers of the change until all objects are added. -/** - Creates a clone of the passed object. This function can take just about - any type of object and create a clone of it, including primitive values - (which are not actually cloned because they are immutable). + var colors = ["red", "green", "blue"]; + colors.pushObjects("black"); => ["red", "green", "blue", "black"] + colors.pushObjects(["yellow", "orange"]); => ["red", "green", "blue", "black", "yellow", "orange"] - If the passed object implements the clone() method, then this function - will simply call that method and return the result. + @param {Ember.Enumerable} objects the objects to add + @returns {Ember.Array} receiver + */ + pushObjects: function(objects) { + this.replace(get(this, 'length'), 0, objects); + return this; + }, - @param {Object} object The object to clone - @param {Boolean} deep If true, a deep copy of the object is made - @returns {Object} The cloned object -*/ -Ember.copy = function(obj, deep) { - // fast paths - if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives - if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep); - return _copy(obj, deep, deep ? [] : null, deep ? [] : null); -}; + /** + Pop object from array or nil if none are left. Works just like pop() but + it is KVO-compliant. -/** - Convenience method to inspect an object. This method will attempt to - convert the object into a useful string description. + var colors = ["red", "green", "blue"]; + colors.popObject(); => "blue" + console.log(colors); => ["red", "green"] - @param {Object} obj The object you want to inspect. - @returns {String} A description of the object -*/ -Ember.inspect = function(obj) { - var v, ret = []; - for(var key in obj) { - if (obj.hasOwnProperty(key)) { - v = obj[key]; - if (v === 'toString') { continue; } // ignore useless items - if (Ember.typeOf(v) === 'function') { v = "function() { ... }"; } - ret.push(key + ": " + v); - } - } - return "{" + ret.join(" , ") + "}"; -}; + */ + popObject: function() { + var len = get(this, 'length') ; + if (len === 0) return null ; + + var ret = this.objectAt(len-1) ; + this.removeAt(len-1, 1) ; + return ret ; + }, + + /** + Shift an object from start of array or nil if none are left. Works just + like shift() but it is KVO-compliant. -/** - Compares two objects, returning true if they are logically equal. This is - a deeper comparison than a simple triple equal. For arrays and enumerables - it will compare the internal objects. For any other object that implements - `isEqual()` it will respect that method. - - @param {Object} a first object to compare - @param {Object} b second object to compare - @returns {Boolean} -*/ -Ember.isEqual = function(a, b) { - if (a && 'function'===typeof a.isEqual) return a.isEqual(b); - return a === b; -}; + var colors = ["red", "green", "blue"]; + colors.shiftObject(); => "red" + console.log(colors); => ["green", "blue"] -/** - @private - Used by Ember.compare -*/ -Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ - 'undefined', - 'null', - 'boolean', - 'number', - 'string', - 'array', - 'object', - 'instance', - 'function', - 'class' -]; + */ + shiftObject: function() { + if (get(this, 'length') === 0) return null ; + var ret = this.objectAt(0) ; + this.removeAt(0) ; + return ret ; + }, -/** - Returns all of the keys defined on an object or hash. This is useful - when inspecting objects for debugging. On browsers that support it, this - uses the native Object.keys implementation. + /** + Unshift an object to start of array. Works just like unshift() but it is + KVO-compliant. - @function - @param {Object} obj - @returns {Array} Array containing keys of obj -*/ -Ember.keys = Object.keys; + var colors = ["red", "green", "blue"]; + colors.unshiftObject("yellow"); => ["yellow", "red", "green", "blue"] + colors.unshiftObject(["black", "white"]); => [["black", "white"], "yellow", "red", "green", "blue"] -if (!Ember.keys) { - Ember.keys = function(obj) { - var ret = []; - for(var key in obj) { - if (obj.hasOwnProperty(key)) { ret.push(key); } - } - return ret; - }; -} + */ + unshiftObject: function(obj) { + this.insertAt(0, obj) ; + return obj ; + }, -// .......................................................... -// ERROR -// + /** + Adds the named objects to the beginning of the array. Defers notifying + observers until all objects have been added. -/** - @class + var colors = ["red", "green", "blue"]; + colors.unshiftObjects(["black", "white"]); => ["black", "white", "red", "green", "blue"] + colors.unshiftObjects("yellow"); => Type Error: 'undefined' is not a function - A subclass of the JavaScript Error object for use in Ember. -*/ -Ember.Error = function() { - var tmp = Error.prototype.constructor.apply(this, arguments); + @param {Ember.Enumerable} objects the objects to add + @returns {Ember.Array} receiver + */ + unshiftObjects: function(objects) { + this.beginPropertyChanges(); + forEach(objects, function(obj) { this.unshiftObject(obj); }, this); + this.endPropertyChanges(); + return this; + }, - for (var p in tmp) { - if (tmp.hasOwnProperty(p)) { this[p] = tmp[p]; } + // .......................................................... + // IMPLEMENT Ember.MutableEnumerable + // + + /** @private (nodoc) */ + removeObject: function(obj) { + var loc = get(this, 'length') || 0; + while(--loc >= 0) { + var curObject = this.objectAt(loc) ; + if (curObject === obj) this.removeAt(loc) ; + } + return this ; + }, + + /** @private (nodoc) */ + addObject: function(obj) { + if (!this.contains(obj)) this.pushObject(obj); + return this ; } - this.message = tmp.message; -}; -Ember.Error.prototype = Ember.create(Error.prototype); +}); -})({}); +})({}); (function(exports) { // ========================================================================== // Project: Ember Runtime -// Copyright: ©2011 Strobe Inc. +// Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== +var get = Ember.get, set = Ember.set; +/** + @class + ## Overview + + This mixin provides properties and property observing functionality, core + features of the Ember object model. + + Properties and observers allow one object to observe changes to a + property on another object. This is one of the fundamental ways that + models, controllers and views communicate with each other in an Ember + application. + + Any object that has this mixin applied can be used in observer + operations. That includes Ember.Object and most objects you will + interact with as you write your Ember application. + Note that you will not generally apply this mixin to classes yourself, + but you will use the features provided by this module frequently, so it + is important to understand how to use it. + + ## Using get() and set() + + Because of Ember's support for bindings and observers, you will always + access properties using the get method, and set properties using the + set method. This allows the observing objects to be notified and + computed properties to be handled properly. + + More documentation about `get` and `set` are below. + + ## Observing Property Changes -/** @private **/ -var STRING_DASHERIZE_REGEXP = (/[ _]/g); -var STRING_DASHERIZE_CACHE = {}; -var STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g); -var STRING_CAMELIZE_REGEXP = (/(\-|_|\s)+(.)?/g); -var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g); -var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g); + You typically observe property changes simply by adding the `observes` + call to the end of your method declarations in classes that you write. + For example: -/** - Defines the hash of localized strings for the current language. Used by - the `Ember.String.loc()` helper. To localize, add string values to this - hash. + Ember.Object.create({ + valueObserver: function() { + // Executes whenever the "value" property changes + }.observes('value') + }); + + Although this is the most common way to add an observer, this capability + is actually built into the Ember.Object class on top of two methods + defined in this mixin: `addObserver` and `removeObserver`. You can use + these two methods to add and remove observers yourself if you need to + do so at runtime. - @property {String} -*/ -Ember.STRINGS = {}; + To add an observer for a property, call: -/** - Defines string helper methods including string formatting and localization. - Unless Ember.EXTEND_PROTOTYPES = false these methods will also be added to the - String.prototype as well. + object.addObserver('propertyKey', targetObject, targetAction) - @namespace + This will call the `targetAction` method on the `targetObject` to be called + whenever the value of the `propertyKey` changes. + + @extends Ember.Mixin */ -Ember.String = { +Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { + + /** @private - compatibility */ + isObserverable: true, /** - Apply formatting options to the string. This will look for occurrences - of %@ in your string and substitute them with the arguments you pass into - this method. If you want to control the specific order of replacement, - you can add a number after the key as well to indicate which argument - you want to insert. + Retrieves the value of a property from the object. - Ordered insertions are most useful when building loc strings where values - you need to insert may appear in different orders. + This method is usually similar to using object[keyName] or object.keyName, + however it supports both computed properties and the unknownProperty + handler. + + Because `get` unifies the syntax for accessing all these kinds + of properties, it can make many refactorings easier, such as replacing a + simple property with a computed property, or vice versa. - ## Examples + ### Computed Properties - "Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe" - "Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John" + Computed properties are methods defined with the `property` modifier + declared at the end, such as: - @param {Object...} [args] - @returns {String} formatted string + fullName: function() { + return this.getEach('firstName', 'lastName').compact().join(' '); + }.property('firstName', 'lastName') + + When you call `get` on a computed property, the function will be + called and the return value will be returned instead of the function + itself. + + ### Unknown Properties + + Likewise, if you try to call `get` on a property whose value is + undefined, the unknownProperty() method will be called on the object. + If this method returns any value other than undefined, it will be returned + instead. This allows you to implement "virtual" properties that are + not defined upfront. + + @param {String} key The property to retrieve + @returns {Object} The property value or undefined. */ - fmt: function(str, formats) { - // first, replace any ORDERED replacements. - var idx = 0; // the current index for non-numerical replacements - return str.replace(/%@([0-9]+)?/g, function(s, argIndex) { - argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ; - s = formats[argIndex]; - return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString(); - }) ; + get: function(keyName) { + return get(this, keyName); }, /** - Formats the passed string, but first looks up the string in the localized - strings hash. This is a convenient way to localize text. See - `Ember.String.fmt()` for more information on formatting. + To get multiple properties at once, call getProperties + with a list of strings: - Note that it is traditional but not required to prefix localized string - keys with an underscore or other character so you can easily identify - localized strings. + record.getProperties('firstName', 'lastName', 'zipCode'); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' } - # Example Usage + @param {String...} list of keys to get + @returns {Hash} + */ + getProperties: function() { + var ret = {}; + for(var i = 0; i < arguments.length; i++) { + ret[arguments[i]] = get(this, arguments[i]); + } + return ret; + }, - @javascript@ - Ember.STRINGS = { - '_Hello World': 'Bonjour le monde', - '_Hello %@ %@': 'Bonjour %@ %@' - }; + /** + Sets the key equal to value. - Ember.String.loc("_Hello World"); - => 'Bonjour le monde'; + This method is generally very similar to calling object[key] = value or + object.key = value, except that it provides support for computed + properties, the unknownProperty() method and property observers. - Ember.String.loc("_Hello %@ %@", ["John", "Smith"]); - => "Bonjour John Smith"; + ### Computed Properties + If you try to set a value on a key that has a computed property handler + defined (see the get() method for an example), then set() will call + that method, passing both the value and key instead of simply changing + the value itself. This is useful for those times when you need to + implement a property that is composed of one or more member + properties. + ### Unknown Properties - @param {String} str - The string to format + If you try to set a value on a key that is undefined in the target + object, then the unknownProperty() handler will be called instead. This + gives you an opportunity to implement complex "virtual" properties that + are not predefined on the obejct. If unknownProperty() returns + undefined, then set() will simply set the value on the object. + + ### Property Observers + + In addition to changing the property, set() will also register a + property change with the object. Unless you have placed this call + inside of a beginPropertyChanges() and endPropertyChanges(), any "local" + observers (i.e. observer methods declared on the same object), will be + called immediately. Any "remote" observers (i.e. observer methods + declared on another object) will be placed in a queue and called at a + later time in a coelesced manner. + + ### Chaining + + In addition to property changes, set() returns the value of the object + itself so you can do chaining like this: + + record.set('firstName', 'Charles').set('lastName', 'Jolley'); + + @param {String} key The property to set + @param {Object} value The value to set or null. + @returns {Ember.Observable} + */ + set: function(keyName, value) { + set(this, keyName, value); + return this; + }, + + /** + To set multiple properties at once, call setProperties + with a Hash: - @param {Array} formats - Optional array of parameters to interpolate into string. + record.setProperties({ firstName: 'Charles', lastName: 'Jolley' }); - @returns {String} formatted string + @param {Hash} hash the hash of keys and values to set + @returns {Ember.Observable} */ - loc: function(str, formats) { - str = Ember.STRINGS[str] || str; - return Ember.String.fmt(str, formats) ; + setProperties: function(hash) { + return Ember.setProperties(this, hash); }, /** - Splits a string into separate units separated by spaces, eliminating any - empty strings in the process. This is a convenience method for split that - is mostly useful when applied to the String.prototype. - - # Example Usage - - @javascript@ - Ember.String.w("alpha beta gamma").forEach(function(key) { - console.log(key); - }); - > alpha - > beta - > gamma + Begins a grouping of property changes. - @param {String} str - The string to split + You can use this method to group property changes so that notifications + will not be sent until the changes are finished. If you plan to make a + large number of changes to an object at one time, you should call this + method at the beginning of the changes to begin deferring change + notifications. When you are done making changes, call endPropertyChanges() + to deliver the deferred change notifications and end deferring. - @returns {String} split string + @returns {Ember.Observable} */ - w: function(str) { return str.split(/\s+/); }, + beginPropertyChanges: function() { + Ember.beginPropertyChanges(); + return this; + }, /** - Converts a camelized string into all lower case separated by underscores. - - h2. Examples + Ends a grouping of property changes. - | *Input String* | *Output String* | - | my favorite items | my favorite items | - | css-class-name | css-class-name | - | action_name | action_name | - | innerHTML | inner_html | + You can use this method to group property changes so that notifications + will not be sent until the changes are finished. If you plan to make a + large number of changes to an object at one time, you should call + beginPropertyChanges() at the beginning of the changes to defer change + notifications. When you are done making changes, call this method to + deliver the deferred change notifications and end deferring. - @returns {String} the decamelized string. + @returns {Ember.Observable} */ - decamelize: function(str) { - return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase(); + endPropertyChanges: function() { + Ember.endPropertyChanges(); + return this; }, /** - Converts a camelized string or a string with spaces or underscores into - a string with components separated by dashes. + Notify the observer system that a property is about to change. - h2. Examples + Sometimes you need to change a value directly or indirectly without + actually calling get() or set() on it. In this case, you can use this + method and propertyDidChange() instead. Calling these two methods + together will notify all observers that the property has potentially + changed value. - | *Input String* | *Output String* | - | my favorite items | my-favorite-items | - | css-class-name | css-class-name | - | action_name | action-name | - | innerHTML | inner-html | + Note that you must always call propertyWillChange and propertyDidChange as + a pair. If you do not, it may get the property change groups out of order + and cause notifications to be delivered more often than you would like. - @returns {String} the dasherized string. + @param {String} key The property key that is about to change. + @returns {Ember.Observable} */ - dasherize: function(str) { - var cache = STRING_DASHERIZE_CACHE, - ret = cache[str]; - - if (ret) { - return ret; - } else { - ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-'); - cache[str] = ret; - } - - return ret; + propertyWillChange: function(keyName){ + Ember.propertyWillChange(this, keyName); + return this; }, /** - Converts a dasherized string or a string with spaces or underscores into - camelized string. + Notify the observer system that a property has just changed. - h2. Examples + Sometimes you need to change a value directly or indirectly without + actually calling get() or set() on it. In this case, you can use this + method and propertyWillChange() instead. Calling these two methods + together will notify all observers that the property has potentially + changed value. - | *Input String* | *Output String* | - | my favorite items | myFavoriteItems | - | css-class-name | cssClassName | - | action_name | actionName | - | innerHTML | innerHTML | + Note that you must always call propertyWillChange and propertyDidChange as + a pair. If you do not, it may get the property change groups out of order + and cause notifications to be delivered more often than you would like. - @returns {String} the camelized string. + @param {String} keyName The property key that has just changed. + @returns {Ember.Observable} */ - camelize: function(str) { - return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) { - return chr ? chr.toUpperCase() : ''; - }); + propertyDidChange: function(keyName) { + Ember.propertyDidChange(this, keyName); + return this; + }, + + /** + Convenience method to call `propertyWillChange` and `propertyDidChange` in + succession. + + @param {String} keyName The property key to be notified about. + @returns {Ember.Observable} + */ + notifyPropertyChange: function(keyName) { + this.propertyWillChange(keyName); + this.propertyDidChange(keyName); + return this; }, /** - More general than decamelize, converts a dasherized or camelcased string or a string with spaces into - all lower case separated by undescores. + Adds an observer on a property. - h2. Examples + This is the core method used to register an observer for a property. - | *Input String* | *Output String* | - | my favorite items | my_favorite_items | - | css-class-name | css_class_name | - | action_name | action_name | - | innerHTML | inner_html | + Once you call this method, anytime the key's value is set, your observer + will be notified. Note that the observers are triggered anytime the + value is set, regardless of whether it has actually changed. Your + observer should be prepared to handle that. - @returns {String} the camelized string. - */ - underscore: function(str) { - return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2'). - replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase(); - } -}; + You can also pass an optional context parameter to this method. The + context will be passed to your observer method whenever it is triggered. + Note that if you add the same target/method pair on a key multiple times + with different context parameters, your observer will only be called once + with the last context you passed. + ### Observer Methods + Observer methods you pass should generally have the following signature if + you do not pass a "context" parameter: + fooDidChange: function(sender, key, value, rev); -})({}); + The sender is the object that changed. The key is the property that + changes. The value property is currently reserved and unused. The rev + is the last property revision of the object when it changed, which you can + use to detect if the key value has really changed or not. + If you pass a "context" parameter, the context will be passed before the + revision like so: -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2010 Apple Inc. All rights reserved. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var get = Ember.get, set = Ember.set; + fooDidChange: function(sender, key, value, context, rev); -/** - @namespace + Usually you will not need the value, context or revision parameters at + the end. In this case, it is common to write observer methods that take + only a sender and key value as parameters or, if you aren't interested in + any of these values, to write an observer that has no parameters at all. - Implements some standard methods for copying an object. Add this mixin to - any object you create that can create a copy of itself. This mixin is - added automatically to the built-in array. + @param {String} key The key to observer + @param {Object} target The target object to invoke + @param {String|Function} method The method to invoke. + @returns {Ember.Object} self + */ + addObserver: function(key, target, method) { + Ember.addObserver(this, key, target, method); + }, - You should generally implement the copy() method to return a copy of the - receiver. + /** + Remove an observer you have previously registered on this object. Pass + the same key, target, and method you passed to addObserver() and your + target will no longer receive notifications. - Note that frozenCopy() will only work if you also implement Ember.Freezable. + @param {String} key The key to observer + @param {Object} target The target object to invoke + @param {String|Function} method The method to invoke. + @returns {Ember.Observable} reciever + */ + removeObserver: function(key, target, method) { + Ember.removeObserver(this, key, target, method); + }, - @since Ember 0.9 -*/ -Ember.Copyable = Ember.Mixin.create( -/** @scope Ember.Copyable.prototype */ { + /** + Returns true if the object currently has observers registered for a + particular key. You can use this method to potentially defer performing + an expensive action until someone begins observing a particular property + on the object. + + @param {String} key Key to check + @returns {Boolean} + */ + hasObserverFor: function(key) { + return Ember.hasListeners(this, key+':change'); + }, /** - Override to return a copy of the receiver. Default implementation raises - an exception. + This method will be called when a client attempts to get the value of a + property that has not been defined in one of the typical ways. Override + this method to create "virtual" properties. + + @param {String} key The name of the unknown property that was requested. + @returns {Object} The property value or undefined. Default is undefined. + */ + unknownProperty: function(key) { + return undefined; + }, - @param deep {Boolean} if true, a deep copy of the object should be made - @returns {Object} copy of receiver + /** + This method will be called when a client attempts to set the value of a + property that has not been defined in one of the typical ways. Override + this method to create "virtual" properties. + + @param {String} key The name of the unknown property to be set. + @param {Object} value The value the unknown property is to be set to. */ - copy: Ember.required(Function), + setUnknownProperty: function(key, value) { + this[key] = value; + }, /** - If the object implements Ember.Freezable, then this will return a new copy - if the object is not frozen and the receiver if the object is frozen. + This is like `get`, but allows you to pass in a dot-separated property + path. + + person.getPath('address.zip'); // return the zip + person.getPath('children.firstObject.age'); // return the first kid's age - Raises an exception if you try to call this method on a object that does - not support freezing. + This reads much better than chained `get` calls. - You should use this method whenever you want a copy of a freezable object - since a freezable object can simply return itself without actually - consuming more memory. + @param {String} path The property path to retrieve + @returns {Object} The property value or undefined. + */ + getPath: function(path) { + return Ember.getPath(this, path); + }, - @returns {Object} copy of receiver or receiver + /** + This is like `set`, but allows you to specify the property you want to + set as a dot-separated property path. + + person.setPath('address.zip', 10011); // set the zip to 10011 + person.setPath('children.firstObject.age', 6); // set the first kid's age to 6 + + This is not as commonly used as `getPath`, but it can be useful. + + @param {String} path The path to the property that will be set + @param {Object} value The value to set or null. + @returns {Ember.Observable} + */ + setPath: function(path, value) { + Ember.setPath(this, path, value); + return this; + }, + + /** + Retrieves the value of a property, or a default value in the case that the property + returns undefined. + + person.getWithDefault('lastName', 'Doe'); + + @param {String} keyName The name of the property to retrieve + @param {Object} defaultValue The value to return if the property value is undefined + @returns {Object} The property value or the defaultValue. + */ + getWithDefault: function(keyName, defaultValue) { + return Ember.getWithDefault(this, keyName, defaultValue); + }, + + /** + Set the value of a property to the current value plus some amount. + + person.incrementProperty('age'); + team.incrementProperty('score', 2); + + @param {String} keyName The name of the property to increment + @param {Object} increment The amount to increment by. Defaults to 1 + @returns {Object} The new property value + */ + incrementProperty: function(keyName, increment) { + if (!increment) { increment = 1; } + set(this, keyName, (get(this, keyName) || 0)+increment); + return get(this, keyName); + }, + + /** + Set the value of a property to the current value minus some amount. + + player.decrementProperty('lives'); + orc.decrementProperty('health', 5); + + @param {String} keyName The name of the property to decrement + @param {Object} increment The amount to decrement by. Defaults to 1 + @returns {Object} The new property value + */ + decrementProperty: function(keyName, increment) { + if (!increment) { increment = 1; } + set(this, keyName, (get(this, keyName) || 0)-increment); + return get(this, keyName); + }, + + /** + Set the value of a boolean property to the opposite of it's + current value. + + starship.toggleProperty('warpDriveEnaged'); + + @param {String} keyName The name of the property to toggle + @returns {Object} The new property value */ - frozenCopy: function() { - if (Ember.Freezable && Ember.Freezable.detect(this)) { - return get(this, 'isFrozen') ? this : this.copy().freeze(); - } else { - throw new Error(Ember.String.fmt("%@ does not support freezing", [this])); - } + toggleProperty: function(keyName) { + set(this, keyName, !get(this, keyName)); + return get(this, keyName); + }, + + /** @private - intended for debugging purposes */ + observersForKey: function(keyName) { + return Ember.observersFor(this, keyName); } + }); @@ -8965,955 +9760,845 @@ Ember.Copyable = Ember.Mixin.create( })({}); - (function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2010 Apple Inc. All rights reserved. -// License: Licensed under MIT license (see license.js) -// ========================================================================== - - - - - -var get = Ember.get, set = Ember.set; - -/** - @namespace - - The Ember.Freezable mixin implements some basic methods for marking an object - as frozen. Once an object is frozen it should be read only. No changes - may be made the internal state of the object. - - ## Enforcement - - To fully support freezing in your subclass, you must include this mixin and - override any method that might alter any property on the object to instead - raise an exception. You can check the state of an object by checking the - isFrozen property. - - Although future versions of JavaScript may support language-level freezing - object objects, that is not the case today. Even if an object is freezable, - it is still technically possible to modify the object, even though it could - break other parts of your application that do not expect a frozen object to - change. It is, therefore, very important that you always respect the - isFrozen property on all freezable objects. - - ## Example Usage +var get = Ember.get, set = Ember.set, getPath = Ember.getPath; - The example below shows a simple object that implement the Ember.Freezable - protocol. +Ember.TargetActionSupport = Ember.Mixin.create({ + target: null, + action: null, - Contact = Ember.Object.extend(Ember.Freezable, { + targetObject: Ember.computed(function() { + var target = get(this, 'target'); - firstName: null, + if (Ember.typeOf(target) === "string") { + // TODO: Remove the false when deprecation is done + var value = getPath(this, target, false); + if (value === undefined) { value = getPath(window, target); } + return value; + } else { + return target; + } + }).property('target').cacheable(), - lastName: null, + triggerAction: function() { + var action = get(this, 'action'), + target = get(this, 'targetObject'); - // swaps the names - swapNames: function() { - if (this.get('isFrozen')) throw Ember.FROZEN_ERROR; - var tmp = this.get('firstName'); - this.set('firstName', this.get('lastName')); - this.set('lastName', tmp); - return this; - } + if (target && action) { + var ret; - }); + if (typeof target.send === 'function') { + ret = target.send(action, this); + } else { + if (typeof action === 'string') { + action = target[action]; + } + ret = action.call(target, this); + } + if (ret !== false) ret = true; - c = Context.create({ firstName: "John", lastName: "Doe" }); - c.swapNames(); => returns c - c.freeze(); - c.swapNames(); => EXCEPTION + return ret; + } else { + return false; + } + } +}); - ## Copying +})({}); - Usually the Ember.Freezable protocol is implemented in cooperation with the - Ember.Copyable protocol, which defines a frozenCopy() method that will return - a frozen object, if the object implements this method as well. +(function(exports) { +var get = Ember.get, set = Ember.set, a_slice = Array.prototype.slice; - @since Ember 0.9 -*/ -Ember.Freezable = Ember.Mixin.create( -/** @scope Ember.Freezable.prototype */ { +/** @private */ +function xform(target, method, params) { + var args = a_slice.call(params, 2); + method.apply(target, args); +} - /** - Set to YES when the object is frozen. Use this property to detect whether - your object is frozen or not. +Ember.Evented = Ember.Mixin.create({ + on: function(name, target, method) { + if (!method) { + method = target; + target = null; + } - @property {Boolean} - */ - isFrozen: false, + Ember.addListener(this, name, target, method, xform); + }, - /** - Freezes the object. Once this method has been called the object should - no longer allow any properties to be edited. + fire: function(name) { + Ember.sendEvent.apply(null, [this, name].concat(a_slice.call(arguments, 1))); + }, - @returns {Object} reciever - */ - freeze: function() { - if (get(this, 'isFrozen')) return this; - set(this, 'isFrozen', true); - return this; + off: function(name, target, method) { + Ember.removeListener(this, name, target, method); } - }); -Ember.FROZEN_ERROR = "Frozen object cannot be modified."; - - - - })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.none; - -/** - @class - An unordered collection of objects. +})({}); - A Set works a bit like an array except that its items are not ordered. - You can create a set to efficiently test for membership for an object. You - can also iterate through a set just like an array, even accessing objects - by index, however there is no gaurantee as to their order. +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== - Starting with Ember 2.0 all Sets are now observable since there is no - added cost to providing this support. Sets also do away with the more - specialized Set Observer API in favor of the more generic Enumerable - Observer API - which works on any enumerable object including both Sets and - Arrays. - ## Creating a Set - You can create a set like you would most objects using - `new Ember.Set()`. Most new sets you create will be empty, but you can - also initialize the set with some content by passing an array or other - enumerable of objects to the constructor. +// NOTE: this object should never be included directly. Instead use Ember. +// Ember.Object. We only define this separately so that Ember.Set can depend on it - Finally, you can pass in an existing set and the set will be copied. You - can also create a copy of a set by calling `Ember.Set#copy()`. - #js - // creates a new empty set - var foundNames = new Ember.Set(); - // creates a set with four names in it. - var names = new Ember.Set(["Charles", "Tom", "Juan", "Alex"]); // :P +var rewatch = Ember.rewatch; +var classToString = Ember.Mixin.prototype.toString; +var set = Ember.set, get = Ember.get; +var o_create = Ember.platform.create, + o_defineProperty = Ember.platform.defineProperty, + a_slice = Array.prototype.slice, + meta = Ember.meta; - // creates a copy of the names set. - var namesCopy = new Ember.Set(names); +/** @private */ +function makeCtor() { - // same as above. - var anotherNamesCopy = names.copy(); + // Note: avoid accessing any properties on the object since it makes the + // method a lot faster. This is glue code so we want it to be as fast as + // possible. - ## Adding/Removing Objects + var wasApplied = false, initMixins, defaults, init = false, hasChains = false; - You generally add or remove objects from a set using `add()` or - `remove()`. You can add any type of object including primitives such as - numbers, strings, and booleans. + var Class = function() { + if (defaults) { + for (var prop in defaults) { + if (!defaults.hasOwnProperty(prop)) { continue; } + Ember.defineProperty(this, prop, undefined, defaults[prop]); + } - Unlike arrays, objects can only exist one time in a set. If you call `add()` - on a set with the same object multiple times, the object will only be added - once. Likewise, calling `remove()` with the same object multiple times will - remove the object the first time and have no effect on future calls until - you add the object to the set again. + defaults = null; + } - NOTE: You cannot add/remove null or undefined to a set. Any attempt to do so - will be ignored. + if (!wasApplied) { Class.proto(); } // prepare prototype... + if (initMixins) { + this.reopen.apply(this, initMixins); + initMixins = null; + rewatch(this); // always rewatch just in case + this.init.apply(this, arguments); + } else { + if (hasChains) { + rewatch(this); + } else { + Ember.GUID_DESC.value = undefined; + o_defineProperty(this, Ember.GUID_KEY, Ember.GUID_DESC); + } + if (init===false) { init = this.init; } // cache for later instantiations + Ember.GUID_DESC.value = undefined; + o_defineProperty(this, '_super', Ember.GUID_DESC); + init.apply(this, arguments); + } + }; - In addition to add/remove you can also call `push()`/`pop()`. Push behaves - just like `add()` but `pop()`, unlike `remove()` will pick an arbitrary - object, remove it and return it. This is a good way to use a set as a job - queue when you don't care which order the jobs are executed in. + Class.toString = classToString; + Class.willReopen = function() { + if (wasApplied) { + Class.PrototypeMixin = Ember.Mixin.create(Class.PrototypeMixin); + } - ## Testing for an Object + wasApplied = false; + }; + Class._initMixins = function(args) { initMixins = args; }; + Class._setDefaults = function(arg) { defaults = arg; }; - To test for an object's presence in a set you simply call - `Ember.Set#contains()`. + Class.proto = function() { + var superclass = Class.superclass; + if (superclass) { superclass.proto(); } - ## Observing changes + if (!wasApplied) { + wasApplied = true; + Class.PrototypeMixin.applyPartial(Class.prototype); + Ember.rewatch(Class.prototype); // setup watch chains if needed. + hasChains = !!meta(Class.prototype, false).chains; // avoid rewatch + } - When using `Ember.Set`, you can observe the `"[]"` property to be - alerted whenever the content changes. You can also add an enumerable - observer to the set to be notified of specific objects that are added and - removed from the set. See `Ember.Enumerable` for more information on - enumerables. + return this.prototype; + }; - This is often unhelpful. If you are filtering sets of objects, for instance, - it is very inefficient to re-filter all of the items each time the set - changes. It would be better if you could just adjust the filtered set based - on what was changed on the original set. The same issue applies to merging - sets, as well. + return Class; - ## Other Methods +} - `Ember.Set` primary implements other mixin APIs. For a complete reference - on the methods you will use with `Ember.Set`, please consult these mixins. - The most useful ones will be `Ember.Enumerable` and - `Ember.MutableEnumerable` which implement most of the common iterator - methods you are used to on Array. +var CoreObject = makeCtor(); - Note that you can also use the `Ember.Copyable` and `Ember.Freezable` - APIs on `Ember.Set` as well. Once a set is frozen it can no longer be - modified. The benefit of this is that when you call frozenCopy() on it, - Ember will avoid making copies of the set. This allows you to write - code that can know with certainty when the underlying set data will or - will not be modified. +CoreObject.PrototypeMixin = Ember.Mixin.create( +/** @scope Ember.CoreObject */ { - @extends Ember.Enumerable - @extends Ember.MutableEnumerable - @extends Ember.Copyable - @extends Ember.Freezable + reopen: function() { + Ember.Mixin._apply(this, arguments, true); + return this; + }, - @since Ember 0.9 -*/ -Ember.Set = Ember.CoreObject.extend(Ember.MutableEnumerable, Ember.Copyable, Ember.Freezable, - /** @scope Ember.Set.prototype */ { + isInstance: true, - // .......................................................... - // IMPLEMENT ENUMERABLE APIS - // + init: function() {}, + + isDestroyed: false, + isDestroying: false, /** - This property will change as the number of objects in the set changes. + Destroys an object by setting the isDestroyed flag and removing its + metadata, which effectively destroys observers and bindings. - @property Number - @default 0 - */ - length: 0, + If you try to set a property on a destroyed object, an exception will be + raised. - /** - Clears the set. This is useful if you want to reuse an existing set - without having to recreate it. + Note that destruction is scheduled for the end of the run loop and does not + happen immediately. - @returns {Ember.Set} + @returns {Ember.Object} receiver */ - clear: function() { - if (this.isFrozen) { throw new Error(Ember.FROZEN_ERROR); } - var len = get(this, 'length'); - this.enumerableContentWillChange(len, 0); - set(this, 'length', 0); - this.enumerableContentDidChange(len, 0); + destroy: function() { + if (this.isDestroying) { return; } + + this.isDestroying = true; + + if (this.willDestroy) { this.willDestroy(); } + + set(this, 'isDestroyed', true); + Ember.run.schedule('destroy', this, this._scheduledDestroy); return this; }, /** - Returns true if the passed object is also an enumerable that contains the - same objects as the receiver. + Invoked by the run loop to actually destroy the object. This is + scheduled for execution by the `destroy` method. - @param {Ember.Set} obj the other object - @returns {Boolean} + @private */ - isEqual: function(obj) { - // fail fast - if (!Ember.Enumerable.detect(obj)) return false; - - var loc = get(this, 'length'); - if (get(obj, 'length') !== loc) return false; - - while(--loc >= 0) { - if (!obj.contains(this[loc])) return false; - } - - return true; + _scheduledDestroy: function() { + Ember.destroy(this); + if (this.didDestroy) { this.didDestroy(); } }, - - /** - Adds an object to the set. Only non-null objects can be added to a set - and those can only be added once. If the object is already in the set or - the passed value is null this method will have no effect. - This is an alias for `Ember.MutableEnumerable.addObject()`. + bind: function(to, from) { + if (!(from instanceof Ember.Binding)) { from = Ember.Binding.from(from); } + from.to(to).connect(this); + return from; + }, - @function - @param {Object} obj The object to add - @returns {Ember.Set} receiver - */ - add: Ember.alias('addObject'), + toString: function() { + return '<'+this.constructor.toString()+':'+Ember.guidFor(this)+'>'; + } +}); - /** - Removes the object from the set if it is found. If you pass a null value - or an object that is already not in the set, this method will have no - effect. This is an alias for `Ember.MutableEnumerable.removeObject()`. +CoreObject.__super__ = null; - @function - @param {Object} obj The object to remove - @returns {Ember.Set} receiver - */ - remove: Ember.alias('removeObject'), - - /** - Removes an arbitrary object from the set and returns it. +var ClassMixin = Ember.Mixin.create({ - @returns {Object} An object from the set or null - */ - pop: function() { - if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); - var obj = this.length > 0 ? this[this.length-1] : null; - this.remove(obj); - return obj; - }, + ClassMixin: Ember.required(), - /** - This is an alias for `Ember.MutableEnumerable.addObject()`. + PrototypeMixin: Ember.required(), - @function - */ - push: Ember.alias('addObject'), - - /** - This is an alias for `Ember.Set.pop()`. - @function - */ - shift: Ember.alias('pop'), + isClass: true, - /** - This is an alias of `Ember.Set.push()` - @function - */ - unshift: Ember.alias('push'), + isMethod: false, - /** - This is an alias of `Ember.MutableEnumerable.addObjects()` - @function - */ - addEach: Ember.alias('addObjects'), + extend: function() { + var Class = makeCtor(), proto; + Class.ClassMixin = Ember.Mixin.create(this.ClassMixin); + Class.PrototypeMixin = Ember.Mixin.create(this.PrototypeMixin); - /** - This is an alias of `Ember.MutableEnumerable.removeObjects()` - @function - */ - removeEach: Ember.alias('removeObjects'), + Class.ClassMixin.ownerConstructor = Class; + Class.PrototypeMixin.ownerConstructor = Class; - // .......................................................... - // PRIVATE ENUMERABLE SUPPORT - // + var PrototypeMixin = Class.PrototypeMixin; + PrototypeMixin.reopen.apply(PrototypeMixin, arguments); - /** @private */ - init: function(items) { - this._super(); - if (items) this.addObjects(items); - }, + Class.superclass = this; + Class.__super__ = this.prototype; - /** @private (nodoc) - implement Ember.Enumerable */ - nextObject: function(idx) { - return this[idx]; - }, + proto = Class.prototype = o_create(this.prototype); + proto.constructor = Class; + Ember.generateGuid(proto, 'ember'); + meta(proto).proto = proto; // this will disable observers on prototype - /** @private - more optimized version */ - firstObject: Ember.computed(function() { - return this.length > 0 ? this[0] : undefined; - }).property('[]').cacheable(), - /** @private - more optimized version */ - lastObject: Ember.computed(function() { - return this.length > 0 ? this[this.length-1] : undefined; - }).property('[]').cacheable(), + Class.subclasses = Ember.Set ? new Ember.Set() : null; + if (this.subclasses) { this.subclasses.add(Class); } - /** @private (nodoc) - implements Ember.MutableEnumerable */ - addObject: function(obj) { - if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); - if (none(obj)) return this; // nothing to do - - var guid = guidFor(obj), - idx = this[guid], - len = get(this, 'length'), - added ; - - if (idx>=0 && idx0) { this._initMixins(arguments); } + return new C(); }, - - /** @private (nodoc) - implements Ember.MutableEnumerable */ - removeObject: function(obj) { - if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); - if (none(obj)) return this; // nothing to do - - var guid = guidFor(obj), - idx = this[guid], - len = get(this, 'length'), - last, removed; - - - if (idx>=0 && idx0) { this._initMixins(a_slice.call(arguments, 1)); } + if (defaults) { this._setDefaults(defaults); } + return new C(); + }, - this.enumerableContentDidChange(removed, null); - } - + reopen: function() { + this.willReopen(); + var PrototypeMixin = this.PrototypeMixin; + PrototypeMixin.reopen.apply(PrototypeMixin, arguments); return this; }, - /** @private (nodoc) - optimized version */ - contains: function(obj) { - return this[guidFor(obj)]>=0; + reopenClass: function() { + var ClassMixin = this.ClassMixin; + ClassMixin.reopen.apply(ClassMixin, arguments); + Ember.Mixin._apply(this, arguments, false); + return this; }, - - /** @private (nodoc) */ - copy: function() { - var C = this.constructor, ret = new C(), loc = get(this, 'length'); - set(ret, 'length', loc); - while(--loc>=0) { - ret[loc] = this[loc]; - ret[guidFor(this[loc])] = loc; + + detect: function(obj) { + if ('function' !== typeof obj) { return false; } + while(obj) { + if (obj===this) { return true; } + obj = obj.superclass; } - return ret; + return false; }, - - /** @private */ - toString: function() { - var len = this.length, idx, array = []; - for(idx = 0; idx < len; idx++) { - array[idx] = this[idx]; - } - return "Ember.Set<%@>".fmt(array.join(',')); + + detectInstance: function(obj) { + return obj instanceof this; }, - - // .......................................................... - // DEPRECATED - // - /** @deprecated + /** + In some cases, you may want to annotate computed properties with additional + metadata about how they function or what values they operate on. For example, + computed property functions may close over variables that are then no longer + available for introspection. - This property is often used to determine that a given object is a set. - Instead you should use instanceof: + You can pass a hash of these values to a computed property like this: - #js: - // SproutCore 1.x: - isSet = myobject && myobject.isSet; + person: function() { + var personId = this.get('personId'); + return App.Person.create({ id: personId }); + }.property().meta({ type: App.Person }) + + Once you've done this, you can retrieve the values saved to the computed + property from your class like this: - // Ember: - isSet = myobject instanceof Ember.Set + MyClass.metaForProperty('person'); - @type Boolean - @default true + This will return the original hash that was passed to `meta()`. */ - isSet: true - -}); + metaForProperty: function(key) { + var desc = meta(this.proto(), false).descs[key]; -// Support the older API -var o_create = Ember.Set.create; -Ember.Set.create = function(items) { - if (items && Ember.Enumerable.detect(items)) { - Ember.Logger.warn('Passing an enumerable to Ember.Set.create() is deprecated and will be removed in a future version of Ember. Use new Ember.Set(items) instead'); - return new Ember.Set(items); - } else { - return o_create.apply(this, arguments); - } -}; + ember_assert("metaForProperty() could not find a computed property with key '"+key+"'.", !!desc && desc instanceof Ember.ComputedProperty); + return desc._meta || {}; + }, + /** + Iterate over each computed property for the class, passing its name + and any associated metadata (see `metaForProperty`) to the callback. + */ + eachComputedProperty: function(callback, binding) { + var proto = this.proto(), + descs = meta(proto).descs, + empty = {}, + property; + for (var name in descs) { + property = descs[name]; -})({}); + if (property instanceof Ember.ComputedProperty) { + callback.call(binding || this, name, property._meta || empty); + } + } + } +}); -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -Ember.CoreObject.subclasses = new Ember.Set(); +CoreObject.ClassMixin = ClassMixin; +ClassMixin.apply(CoreObject); /** @class - @extends Ember.CoreObject - @extends Ember.Observable */ -Ember.Object = Ember.CoreObject.extend(Ember.Observable); +Ember.CoreObject = CoreObject; })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -var get = Ember.get, set = Ember.set; +var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.none; /** @class - An ArrayProxy wraps any other object that implements Ember.Array and/or - Ember.MutableArray, forwarding all requests. ArrayProxy isn't useful by itself - but you can extend it to do specialized things like transforming values, - etc. + An unordered collection of objects. - @extends Ember.Object - @extends Ember.Array - @extends Ember.MutableArray -*/ -Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray, -/** @scope Ember.ArrayProxy.prototype */ { - - /** - The content array. Must be an object that implements Ember.Array and or - Ember.MutableArray. - - @property {Ember.Array} - */ - content: null, + A Set works a bit like an array except that its items are not ordered. + You can create a set to efficiently test for membership for an object. You + can also iterate through a set just like an array, even accessing objects + by index, however there is no guarantee as to their order. - /** - Should actually retrieve the object at the specified index from the - content. You can override this method in subclasses to transform the - content item to something new. - - This method will only be called if content is non-null. - - @param {Number} idx - The index to retreive. - - @returns {Object} the value or undefined if none found - */ - objectAtContent: function(idx) { - return get(this, 'content').objectAt(idx); - }, - - /** - Should actually replace the specified objects on the content array. - You can override this method in subclasses to transform the content item - into something new. - - This method will only be called if content is non-null. - - @param {Number} idx - The starting index - - @param {Number} amt - The number of items to remove from the content. - - @param {Array} objects - Optional array of objects to insert or null if no objects. - - @returns {void} - */ - replaceContent: function(idx, amt, objects) { - get(this, 'content').replace(idx, amt, objects); - }, - - contentWillChange: Ember.beforeObserver(function() { - var content = get(this, 'content'), - len = content ? get(content, 'length') : 0; - this.arrayWillChange(content, 0, len, undefined); - if (content) content.removeArrayObserver(this); - }, 'content'), - - /** - Invoked when the content property changes. Notifies observers that the - entire array content has changed. - */ - contentDidChange: Ember.observer(function() { - var content = get(this, 'content'), - len = content ? get(content, 'length') : 0; - if (content) content.addArrayObserver(this); - this.arrayDidChange(content, 0, undefined, len); - }, 'content'), - - /** @private (nodoc) */ - objectAt: function(idx) { - return get(this, 'content') && this.objectAtContent(idx); - }, - - /** @private (nodoc) */ - length: Ember.computed(function() { - var content = get(this, 'content'); - return content ? get(content, 'length') : 0; - }).property('content.length').cacheable(), - - /** @private (nodoc) */ - replace: function(idx, amt, objects) { - if (get(this, 'content')) this.replaceContent(idx, amt, objects); - return this; - }, - - /** @private (nodoc) */ - arrayWillChange: function(item, idx, removedCnt, addedCnt) { - this.arrayContentWillChange(idx, removedCnt, addedCnt); - }, - - /** @private (nodoc) */ - arrayDidChange: function(item, idx, removedCnt, addedCnt) { - this.arrayContentDidChange(idx, removedCnt, addedCnt); - }, - - init: function() { - this._super(); - this.contentDidChange(); - } - -}); + Starting with Ember 2.0 all Sets are now observable since there is no + added cost to providing this support. Sets also do away with the more + specialized Set Observer API in favor of the more generic Enumerable + Observer API - which works on any enumerable object including both Sets and + Arrays. + ## Creating a Set + You can create a set like you would most objects using + `new Ember.Set()`. Most new sets you create will be empty, but you can + also initialize the set with some content by passing an array or other + enumerable of objects to the constructor. + Finally, you can pass in an existing set and the set will be copied. You + can also create a copy of a set by calling `Ember.Set#copy()`. -})({}); + #js + // creates a new empty set + var foundNames = new Ember.Set(); + // creates a set with four names in it. + var names = new Ember.Set(["Charles", "Tom", "Juan", "Alex"]); // :P -(function(exports) { -// ========================================================================== -// Project: Ember Metal -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -/** - @class + // creates a copy of the names set. + var namesCopy = new Ember.Set(names); - Ember.ArrayController provides a way for you to publish an array of objects for - Ember.CollectionView or other controllers to work with. To work with an - ArrayController, set the content property to the array you want the controller - to manage. Then work directly with the controller object as if it were the - array itself. + // same as above. + var anotherNamesCopy = names.copy(); - For example, imagine you wanted to display a list of items fetched via an XHR - request. Create an Ember.ArrayController and set its `content` property: + ## Adding/Removing Objects - MyApp.listController = Ember.ArrayController.create(); + You generally add or remove objects from a set using `add()` or + `remove()`. You can add any type of object including primitives such as + numbers, strings, and booleans. - $.get('people.json', function(data) { - MyApp.listController.set('content', data); - }); + Unlike arrays, objects can only exist one time in a set. If you call `add()` + on a set with the same object multiple times, the object will only be added + once. Likewise, calling `remove()` with the same object multiple times will + remove the object the first time and have no effect on future calls until + you add the object to the set again. - Then, create a view that binds to your new controller: + NOTE: You cannot add/remove null or undefined to a set. Any attempt to do so + will be ignored. - {{#collection contentBinding="MyApp.listController"}} - {{content.firstName}} {{content.lastName}} - {{/collection}} + In addition to add/remove you can also call `push()`/`pop()`. Push behaves + just like `add()` but `pop()`, unlike `remove()` will pick an arbitrary + object, remove it and return it. This is a good way to use a set as a job + queue when you don't care which order the jobs are executed in. - The advantage of using an array controller is that you only have to set up - your view bindings once; to change what's displayed, simply swap out the - `content` property on the controller. + ## Testing for an Object - @extends Ember.ArrayProxy + To test for an object's presence in a set you simply call + `Ember.Set#contains()`. + + ## Observing changes + + When using `Ember.Set`, you can observe the `"[]"` property to be + alerted whenever the content changes. You can also add an enumerable + observer to the set to be notified of specific objects that are added and + removed from the set. See `Ember.Enumerable` for more information on + enumerables. + + This is often unhelpful. If you are filtering sets of objects, for instance, + it is very inefficient to re-filter all of the items each time the set + changes. It would be better if you could just adjust the filtered set based + on what was changed on the original set. The same issue applies to merging + sets, as well. + + ## Other Methods + + `Ember.Set` primary implements other mixin APIs. For a complete reference + on the methods you will use with `Ember.Set`, please consult these mixins. + The most useful ones will be `Ember.Enumerable` and + `Ember.MutableEnumerable` which implement most of the common iterator + methods you are used to on Array. + + Note that you can also use the `Ember.Copyable` and `Ember.Freezable` + APIs on `Ember.Set` as well. Once a set is frozen it can no longer be + modified. The benefit of this is that when you call frozenCopy() on it, + Ember will avoid making copies of the set. This allows you to write + code that can know with certainty when the underlying set data will or + will not be modified. + + @extends Ember.Enumerable + @extends Ember.MutableEnumerable + @extends Ember.Copyable + @extends Ember.Freezable + + @since Ember 0.9 */ +Ember.Set = Ember.CoreObject.extend(Ember.MutableEnumerable, Ember.Copyable, Ember.Freezable, + /** @scope Ember.Set.prototype */ { -Ember.ArrayController = Ember.ArrayProxy.extend(); + // .......................................................... + // IMPLEMENT ENUMERABLE APIS + // -})({}); + /** + This property will change as the number of objects in the set changes. + @property Number + @default 0 + */ + length: 0, -(function(exports) { -})({}); + /** + Clears the set. This is useful if you want to reuse an existing set + without having to recreate it. + var colors = new Ember.Set(["red", "green", "blue"]); + colors.length; => 3 + colors.clear(); + colors.length; => 0 -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2011 Apple Inc. All rights reserved. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var fmt = Ember.String.fmt, - w = Ember.String.w, - loc = Ember.String.loc, - camelize = Ember.String.camelize, - decamelize = Ember.String.decamelize, - dasherize = Ember.String.dasherize, - underscore = Ember.String.underscore; - -if (Ember.EXTEND_PROTOTYPES) { + @returns {Ember.Set} An empty Set + */ + clear: function() { + if (this.isFrozen) { throw new Error(Ember.FROZEN_ERROR); } + var len = get(this, 'length'); + var guid; + this.enumerableContentWillChange(len, 0); + for (var i=0; i < len; i++){ + guid = guidFor(this[i]); + delete this[guid]; + delete this[i]; + } + set(this, 'length', 0); + this.enumerableContentDidChange(len, 0); + return this; + }, /** - @see Ember.String.fmt - */ - String.prototype.fmt = function() { - return fmt(this, arguments); - }; - - /** - @see Ember.String.w + Returns true if the passed object is also an enumerable that contains the + same objects as the receiver. + + var colors = ["red", "green", "blue"], + same_colors = new Ember.Set(colors); + same_colors.isEqual(colors); => true + same_colors.isEqual(["purple", "brown"]); => false + + @param {Ember.Set} obj the other object. + @returns {Boolean} */ - String.prototype.w = function() { - return w(this); - }; - + isEqual: function(obj) { + // fail fast + if (!Ember.Enumerable.detect(obj)) return false; + + var loc = get(this, 'length'); + if (get(obj, 'length') !== loc) return false; + + while(--loc >= 0) { + if (!obj.contains(this[loc])) return false; + } + + return true; + }, + /** - @see Ember.String.loc + Adds an object to the set. Only non-null objects can be added to a set + and those can only be added once. If the object is already in the set or + the passed value is null this method will have no effect. + + This is an alias for `Ember.MutableEnumerable.addObject()`. + + var colors = new Ember.Set(); + colors.add("blue"); => ["blue"] + colors.add("blue"); => ["blue"] + colors.add("red"); => ["blue", "red"] + colors.add(null); => ["blue", "red"] + colors.add(undefined); => ["blue", "red"] + + @function + @param {Object} obj The object to add. + @returns {Ember.Set} The set itself. */ - String.prototype.loc = function() { - return loc(this, arguments); - }; + add: Ember.alias('addObject'), /** - @see Ember.String.camelize + Removes the object from the set if it is found. If you pass a null value + or an object that is already not in the set, this method will have no + effect. This is an alias for `Ember.MutableEnumerable.removeObject()`. + + var colors = new Ember.Set(["red", "green", "blue"]); + colors.remove("red"); => ["blue", "green"] + colors.remove("purple"); => ["blue", "green"] + colors.remove(null); => ["blue", "green"] + + @function + @param {Object} obj The object to remove + @returns {Ember.Set} The set itself. */ - String.prototype.camelize = function() { - return camelize(this); - }; + remove: Ember.alias('removeObject'), /** - @see Ember.String.decamelize + Removes the last element from the set and returns it, or null if it's empty. + + var colors = new Ember.Set(["green", "blue"]); + colors.pop(); => "blue" + colors.pop(); => "green" + colors.pop(); => null + + @returns {Object} The removed object from the set or null. */ - String.prototype.decamelize = function() { - return decamelize(this); - }; + pop: function() { + if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); + var obj = this.length > 0 ? this[this.length-1] : null; + this.remove(obj); + return obj; + }, /** - @see Ember.String.dasherize + Inserts the given object on to the end of the set. It returns + the set itself. + + This is an alias for `Ember.MutableEnumerable.addObject()`. + + var colors = new Ember.Set(); + colors.push("red"); => ["red"] + colors.push("green"); => ["red", "green"] + colors.push("blue"); => ["red", "green", "blue"] + + @function + @returns {Ember.Set} The set itself. */ - String.prototype.dasherize = function() { - return dasherize(this); - }; + push: Ember.alias('addObject'), /** - @see Ember.String.underscore - */ - String.prototype.underscore = function() { - return underscore(this); - }; + Removes the last element from the set and returns it, or null if it's empty. -} + This is an alias for `Ember.Set.pop()`. + var colors = new Ember.Set(["green", "blue"]); + colors.shift(); => "blue" + colors.shift(); => "green" + colors.shift(); => null -})({}); + @function + @returns {Object} The removed object from the set or null. + */ + shift: Ember.alias('pop'), + /** + Inserts the given object on to the end of the set. It returns + the set itself. -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2011 Apple Inc. All rights reserved. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var a_slice = Array.prototype.slice; + This is an alias of `Ember.Set.push()` -if (Ember.EXTEND_PROTOTYPES) { + var colors = new Ember.Set(); + colors.unshift("red"); => ["red"] + colors.unshift("green"); => ["red", "green"] + colors.unshift("blue"); => ["red", "green", "blue"] - Function.prototype.property = function() { - var ret = Ember.computed(this); - return ret.property.apply(ret, arguments); - }; + @function + @returns {Ember.Set} The set itself. + */ + unshift: Ember.alias('push'), - Function.prototype.observes = function() { - this.__ember_observes__ = a_slice.call(arguments); - return this; - }; + /** + Adds each object in the passed enumerable to the set. - Function.prototype.observesBefore = function() { - this.__ember_observesBefore__ = a_slice.call(arguments); - return this; - }; + This is an alias of `Ember.MutableEnumerable.addObjects()` -} + var colors = new Ember.Set(); + colors.addEach(["red", "green", "blue"]); => ["red", "green", "blue"] + @function + @param {Ember.Enumerable} objects the objects to add. + @returns {Ember.Set} The set itself. + */ + addEach: Ember.alias('addObjects'), -})({}); + /** + Removes each object in the passed enumerable to the set. + This is an alias of `Ember.MutableEnumerable.removeObjects()` -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2006-2011 Strobe Inc. and contributors. -// Portions ©2008-2011 Apple Inc. All rights reserved. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var IS_BINDING = Ember.IS_BINDING = /^.+Binding$/; + var colors = new Ember.Set(["red", "green", "blue"]); + colors.removeEach(["red", "blue"]); => ["green"] -Ember._mixinBindings = function(obj, key, value, m) { - if (IS_BINDING.test(key)) { - if (!(value instanceof Ember.Binding)) { - value = new Ember.Binding(key.slice(0,-7), value); // make binding - } else { - value.to(key.slice(0, -7)); - } - value.connect(obj); + @function + @param {Ember.Enumerable} objects the objects to remove. + @returns {Ember.Set} The set itself. + */ + removeEach: Ember.alias('removeObjects'), - // keep a set of bindings in the meta so that when we rewatch we can - // resync them... - var bindings = m.bindings; - if (!bindings) { - bindings = m.bindings = { __emberproto__: obj }; - } else if (bindings.__emberproto__ !== obj) { - bindings = m.bindings = Ember.create(m.bindings); - bindings.__emberproto__ = obj; - } + // .......................................................... + // PRIVATE ENUMERABLE SUPPORT + // - bindings[key] = true; - } - - return value; -}; + /** @private */ + init: function(items) { + this._super(); + if (items) this.addObjects(items); + }, -})({}); + /** @private (nodoc) - implement Ember.Enumerable */ + nextObject: function(idx) { + return this[idx]; + }, + /** @private - more optimized version */ + firstObject: Ember.computed(function() { + return this.length > 0 ? this[0] : undefined; + }).property('[]').cacheable(), -(function(exports) { -// ========================================================================== -// Project: Ember Runtime -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -})({}); + /** @private - more optimized version */ + lastObject: Ember.computed(function() { + return this.length > 0 ? this[this.length-1] : undefined; + }).property('[]').cacheable(), + /** @private (nodoc) - implements Ember.MutableEnumerable */ + addObject: function(obj) { + if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); + if (none(obj)) return this; // nothing to do -(function(exports) { -/** - * @license - * ========================================================================== - * Ember - * Copyright ©2006-2011, Strobe Inc. and contributors. - * Portions copyright ©2008-2011 Apple Inc. All rights reserved. - * - * Permission is hereby granted, free of charge, to any person obtaining a - * copy of this software and associated documentation files (the "Software"), - * to deal in the Software without restriction, including without limitation - * the rights to use, copy, modify, merge, publish, distribute, sublicense, - * and/or sell copies of the Software, and to permit persons to whom the - * Software is furnished to do so, subject to the following conditions: - * - * The above copyright notice and this permission notice shall be included in - * all copies or substantial portions of the Software. - * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR - * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, - * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE - * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER - * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING - * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER - * DEALINGS IN THE SOFTWARE. - * - * For more information about Ember, visit http://www.emberjs.com - * - * ========================================================================== - */ + var guid = guidFor(obj), + idx = this[guid], + len = get(this, 'length'), + added ; -})({}); + if (idx>=0 && idx=0 && idx b + delete this[guid]; + delete this[len-1]; + set(this, 'length', len-1); - Default implementation raises an exception. + this.enumerableContentDidChange(removed, null); + } - @param a {Object} the first object to compare - @param b {Object} the second object to compare - @returns {Integer} the result of the comparison - */ - compare: Ember.required(Function) + return this; + }, -}); + /** @private (nodoc) - optimized version */ + contains: function(obj) { + return this[guidFor(obj)]>=0; + }, + /** @private (nodoc) */ + copy: function() { + var C = this.constructor, ret = new C(), loc = get(this, 'length'); + set(ret, 'length', loc); + while(--loc>=0) { + ret[loc] = this[loc]; + ret[guidFor(this[loc])] = loc; + } + return ret; + }, -})({}); + /** @private */ + toString: function() { + var len = this.length, idx, array = []; + for(idx = 0; idx < len; idx++) { + array[idx] = this[idx]; + } + return "Ember.Set<%@>".fmt(array.join(',')); + }, + // .......................................................... + // DEPRECATED + // -(function(exports) { -var get = Ember.get, set = Ember.set, getPath = Ember.getPath; + /** @deprecated -Ember.TargetActionSupport = Ember.Mixin.create({ - target: null, - action: null, + This property is often used to determine that a given object is a set. + Instead you should use instanceof: - targetObject: Ember.computed(function() { - var target = get(this, 'target'); + #js: + // SproutCore 1.x: + isSet = myobject && myobject.isSet; - if (Ember.typeOf(target) === "string") { - // TODO: Remove the false when deprecation is done - var value = getPath(this, target, false); - if (value === undefined) { value = getPath(window, target); } - return value; - } else { - return target; - } - }).property('target').cacheable(), + // Ember: + isSet = myobject instanceof Ember.Set - triggerAction: function() { - var action = get(this, 'action'), - target = get(this, 'targetObject'); + @type Boolean + @default true + */ + isSet: true - if (target && action) { - var ret; - - if (typeof target.send === 'function') { - ret = target.send(action, this); - } else { - if (typeof action === 'string') { - action = target[action]; - } - ret = action.call(target, this); - } - if (ret !== false) ret = true; - - return ret; - } else { - return false; - } - } }); -})({}); +// Support the older API +var o_create = Ember.Set.create; +Ember.Set.create = function(items) { + if (items && Ember.Enumerable.detect(items)) { + ember_deprecate('Passing an enumerable to Ember.Set.create() is deprecated and will be removed in a future version of Ember. Use new Ember.Set(items) instead.'); + return new Ember.Set(items); + } else { + return o_create.apply(this, arguments); + } +}; +})({}); (function(exports) { // ========================================================================== @@ -9921,8 +10606,19 @@ Ember.TargetActionSupport = Ember.Mixin.create({ // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -})({}); +Ember.CoreObject.subclasses = new Ember.Set(); + +/** + @class + @extends Ember.CoreObject + @extends Ember.Observable +*/ +Ember.Object = Ember.CoreObject.extend(Ember.Observable); + + + +})({}); (function(exports) { // ========================================================================== @@ -9930,6 +10626,8 @@ Ember.TargetActionSupport = Ember.Mixin.create({ // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== +var indexOf = Ember.ArrayUtils.indexOf; + /** @private A Namespace is an object usually used to contain other objects or methods @@ -9959,7 +10657,7 @@ Ember.Namespace = Ember.Object.extend({ destroy: function() { var namespaces = Ember.Namespace.NAMESPACES; window[this.toString()] = undefined; - namespaces.splice(namespaces.indexOf(this), 1); + namespaces.splice(indexOf(namespaces, this), 1); this._super(); } }); @@ -9969,7 +10667,6 @@ Ember.Namespace.PROCESSED = false; })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime @@ -9982,28 +10679,180 @@ Ember.Namespace.PROCESSED = false; Defines a namespace that will contain an executable application. This is very similar to a normal namespace except that it is expected to include at least a 'ready' function which can be run to initialize the application. - + Currently Ember.Application is very similar to Ember.Namespace. However, this class may be augmented by additional frameworks so it is important to use this instance when building new applications. - + # Example Usage - + MyApp = Ember.Application.create({ VERSION: '1.0.0', store: Ember.Store.create().from(Ember.fixtures) }); - - MyApp.ready = function() { + + MyApp.ready = function() { //..init code goes here... } - + */ Ember.Application = Ember.Namespace.extend(); })({}); +(function(exports) { +// ========================================================================== +// Project: Ember Runtime +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var get = Ember.get, set = Ember.set; + +/** + @class + + An ArrayProxy wraps any other object that implements Ember.Array and/or + Ember.MutableArray, forwarding all requests. This makes it very useful for + a number of binding use cases or other cases where being able to swap + out the underlying array is useful. + + A simple example of usage: + + var pets = ['dog', 'cat', 'fish']; + var arrayProxy = Ember.ArrayProxy.create({ content: Ember.A(pets) }); + ap.get('firstObject'); // => 'dog' + ap.set('content', ['amoeba', 'paramecium']); + ap.get('firstObject'); // => 'amoeba' + + This class can also be useful as a layer to transform the contents of + an array, as they are accessed. This can be done by overriding + `objectAtContent`: + + var pets = ['dog', 'cat', 'fish']; + var ap = Ember.ArrayProxy.create({ + content: Ember.A(pets), + objectAtContent: function(idx) { + return this.get('content').objectAt(idx).toUpperCase(); + } + }); + ap.get('firstObject'); // => 'DOG' + + + @extends Ember.Object + @extends Ember.Array + @extends Ember.MutableArray +*/ +Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray, +/** @scope Ember.ArrayProxy.prototype */ { + + /** + The content array. Must be an object that implements Ember.Array and/or + Ember.MutableArray. + + @property {Ember.Array} + */ + content: null, + + /** + Should actually retrieve the object at the specified index from the + content. You can override this method in subclasses to transform the + content item to something new. + + This method will only be called if content is non-null. + + @param {Number} idx + The index to retreive. + + @returns {Object} the value or undefined if none found + */ + objectAtContent: function(idx) { + return get(this, 'content').objectAt(idx); + }, + + /** + Should actually replace the specified objects on the content array. + You can override this method in subclasses to transform the content item + into something new. + + This method will only be called if content is non-null. + + @param {Number} idx + The starting index + + @param {Number} amt + The number of items to remove from the content. + + @param {Array} objects + Optional array of objects to insert or null if no objects. + + @returns {void} + */ + replaceContent: function(idx, amt, objects) { + get(this, 'content').replace(idx, amt, objects); + }, + + /** + Invoked when the content property is about to change. Notifies observers that the + entire array content will change. + */ + contentWillChange: Ember.beforeObserver(function() { + var content = get(this, 'content'), + len = content ? get(content, 'length') : 0; + this.arrayWillChange(content, 0, len, undefined); + if (content) content.removeArrayObserver(this); + }, 'content'), + + /** + Invoked when the content property changes. Notifies observers that the + entire array content has changed. + */ + contentDidChange: Ember.observer(function() { + var content = get(this, 'content'), + len = content ? get(content, 'length') : 0; + if (content) content.addArrayObserver(this); + this.arrayDidChange(content, 0, undefined, len); + }, 'content'), + + /** @private (nodoc) */ + objectAt: function(idx) { + return get(this, 'content') && this.objectAtContent(idx); + }, + + /** @private (nodoc) */ + length: Ember.computed(function() { + var content = get(this, 'content'); + return content ? get(content, 'length') : 0; + }).property('content.length').cacheable(), + + /** @private (nodoc) */ + replace: function(idx, amt, objects) { + if (get(this, 'content')) this.replaceContent(idx, amt, objects); + return this; + }, + + /** @private (nodoc) */ + arrayWillChange: function(item, idx, removedCnt, addedCnt) { + this.arrayContentWillChange(idx, removedCnt, addedCnt); + }, + + /** @private (nodoc) */ + arrayDidChange: function(item, idx, removedCnt, addedCnt) { + this.arrayContentDidChange(idx, removedCnt, addedCnt); + }, + + /** @private (nodoc) */ + init: function() { + this._super(); + this.contentDidChange(); + } + +}); + + + + +})({}); (function(exports) { // ========================================================================== @@ -10012,6 +10861,7 @@ Ember.Application = Ember.Namespace.extend(); // License: Licensed under MIT license (see license.js) // ========================================================================== var set = Ember.set, get = Ember.get, guidFor = Ember.guidFor; +var forEach = Ember.ArrayUtils.forEach; var EachArray = Ember.Object.extend(Ember.Array, { @@ -10036,6 +10886,7 @@ var EachArray = Ember.Object.extend(Ember.Array, { var IS_OBSERVER = /^.+:(before|change)$/; +/** @private */ function addObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects, guid; if (!objects) objects = proxy._objects = {}; @@ -10055,6 +10906,7 @@ function addObserverForContentKey(content, keyName, proxy, idx, loc) { } } +/** @private */ function removeObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects; if (!objects) objects = proxy._objects = {}; @@ -10092,7 +10944,7 @@ Ember.EachProxy = Ember.Object.extend({ // in case someone is already observing some keys make sure they are // added - Ember.watchedEvents(this).forEach(function(eventName) { + forEach(Ember.watchedEvents(this), function(eventName) { this.didAddListener(eventName); }, this); }, @@ -10205,7 +11057,6 @@ Ember.EachProxy = Ember.Object.extend({ })({}); - (function(exports) { // ========================================================================== // Project: Ember Runtime @@ -10213,24 +11064,24 @@ Ember.EachProxy = Ember.Object.extend({ // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; - -// Add Ember.Array to Array.prototype. Remove methods with native + +// Add Ember.Array to Array.prototype. Remove methods with native // implementations and supply some more optimized versions of generic methods // because they are so common. var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember.Copyable, { - // because length is a built-in property we need to know to just get the + // because length is a built-in property we need to know to just get the // original property. get: function(key) { if (key==='length') return this.length; else if ('number' === typeof key) return this[key]; - else return this._super(key); + else return this._super(key); }, - + objectAt: function(idx) { return this[idx]; }, - + // primitive for array support. replace: function(idx, amt, objects) { @@ -10241,7 +11092,7 @@ var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember // since everything has shifted var len = objects ? get(objects, 'length') : 0; this.arrayContentWillChange(idx, amt, len); - + if (!objects || objects.length === 0) { this.splice(idx, amt) ; } else { @@ -10290,7 +11141,7 @@ var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember } return -1; }, - + copy: function() { return this.slice(); } @@ -10298,7 +11149,7 @@ var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember // Remove any methods implemented natively so we don't override them var ignore = ['length']; -NativeArray.keys().forEach(function(methodName) { +Ember.ArrayUtils.forEach(NativeArray.keys(), function(methodName) { if (Array.prototype[methodName]) ignore.push(methodName); }); @@ -10308,11 +11159,11 @@ if (ignore.length>0) { /** The NativeArray mixin contains the properties needed to to make the native - Array support Ember.MutableArray and all of its dependent APIs. Unless you + Array support Ember.MutableArray and all of its dependent APIs. Unless you have Ember.EXTEND_PROTOTYPES set to false, this will be applied automatically. - Otherwise you can apply the mixin at anytime by calling + Otherwise you can apply the mixin at anytime by calling `Ember.NativeArray.activate`. - + @namespace @extends Ember.MutableArray @extends Ember.Array @@ -10337,13 +11188,13 @@ Ember.A = function(arr){ /** Activates the mixin on the Array.prototype if not already applied. Calling this method more than once is safe. - + @returns {void} */ Ember.NativeArray.activate = function() { NativeArray.apply(Array.prototype); - Ember.A = function(arr) { return arr || []; } + Ember.A = function(arr) { return arr || []; }; }; if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); @@ -10352,6 +11203,206 @@ if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); })({}); +(function(exports) { +/** + JavaScript (before ES6) does not have a Map implementation. Objects, + which are often used as dictionaries, may only have Strings as keys. + + Because Ember has a way to get a unique identifier for every object + via `Ember.guidFor`, we can implement a performant Map with arbitrary + keys. Because it is commonly used in low-level bookkeeping, Map is + implemented as a pure JavaScript object for performance. + + This implementation follows the current iteration of the ES6 proposal + for maps (http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets), + with two exceptions. First, because we need our implementation to be + pleasant on older browsers, we do not use the `delete` name (using + `remove` instead). Second, as we do not have the luxury of in-VM + iteration, we implement a forEach method for iteration. + + Map is mocked out to look like an Ember object, so you can do + `Ember.Map.create()` for symmetry with other Ember classes. +*/ + +/** @private */ +var guidFor = Ember.guidFor; +var indexOf = Ember.ArrayUtils.indexOf; + +// This class is used internally by Ember.js and Ember Data. +// Please do not use it at this time. We plan to clean it up +// and add many tests soon. +var OrderedSet = Ember.OrderedSet = function() { + this.clear(); +}; + +OrderedSet.create = function() { + return new OrderedSet(); +}; + +OrderedSet.prototype = { + clear: function() { + this.presenceSet = {}; + this.list = []; + }, + + add: function(obj) { + var guid = guidFor(obj), + presenceSet = this.presenceSet, + list = this.list; + + if (guid in presenceSet) { return; } + + presenceSet[guid] = true; + list.push(obj); + }, + + remove: function(obj) { + var guid = guidFor(obj), + presenceSet = this.presenceSet, + list = this.list; + + delete presenceSet[guid]; + + var index = indexOf(list, obj); + if (index > -1) { + list.splice(index, 1); + } + }, + + isEmpty: function() { + return this.list.length === 0; + }, + + forEach: function(fn, self) { + // allow mutation during iteration + var list = this.list.slice(); + + for (var i = 0, j = list.length; i < j; i++) { + fn.call(self, list[i]); + } + }, + + toArray: function() { + return this.list.slice(); + } +}; + +/** + A Map stores values indexed by keys. Unlike JavaScript's + default Objects, the keys of a Map can be any JavaScript + object. + + Internally, a Map has two data structures: + + `keys`: an OrderedSet of all of the existing keys + `values`: a JavaScript Object indexed by the + Ember.guidFor(key) + + When a key/value pair is added for the first time, we + add the key to the `keys` OrderedSet, and create or + replace an entry in `values`. When an entry is deleted, + we delete its entry in `keys` and `values`. +*/ + +/** @private */ +var Map = Ember.Map = function() { + this.keys = Ember.OrderedSet.create(); + this.values = {}; +}; + +Map.create = function() { + return new Map(); +}; + +Map.prototype = { + /** + Retrieve the value associated with a given key. + + @param {anything} key + @return {anything} the value associated with the key, or undefined + */ + get: function(key) { + var values = this.values, + guid = guidFor(key); + + return values[guid]; + }, + + /** + Adds a value to the map. If a value for the given key has already been + provided, the new value will replace the old value. + + @param {anything} key + @param {anything} value + */ + set: function(key, value) { + var keys = this.keys, + values = this.values, + guid = guidFor(key); + + keys.add(key); + values[guid] = value; + }, + + /** + Removes a value from the map for an associated key. + + @param {anything} key + @returns {Boolean} true if an item was removed, false otherwise + */ + remove: function(key) { + // don't use ES6 "delete" because it will be annoying + // to use in browsers that are not ES6 friendly; + var keys = this.keys, + values = this.values, + guid = guidFor(key), + value; + + if (values.hasOwnProperty(guid)) { + keys.remove(key); + value = values[guid]; + delete values[guid]; + return true; + } else { + return false; + } + }, + + /** + Check whether a key is present. + + @param {anything} key + @returns {Boolean} true if the item was present, false otherwise + */ + has: function(key) { + var values = this.values, + guid = guidFor(key); + + return values.hasOwnProperty(guid); + }, + + /** + Iterate over all the keys and values. Calls the function once + for each key, passing in the key and value, in that order. + + The keys are guaranteed to be iterated over in insertion order. + + @param {Function} callback + @param {anything} self if passed, the `this` value inside the + callback. By default, `this` is the map. + */ + forEach: function(callback, self) { + var keys = this.keys, + values = this.values; + + keys.forEach(function(key) { + var guid = guidFor(key); + callback.call(self, key, values[guid]); + }); + } +}; + +})({}); (function(exports) { // ========================================================================== @@ -10359,8 +11410,61 @@ if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Metal +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +/** + @class + + Ember.ArrayController provides a way for you to publish a collection of objects + so that you can easily bind to the collection from a Handlebars #each helper, + an Ember.CollectionView, or other controllers. + + The advantage of using an ArrayController is that you only have to set up + your view bindings once; to change what's displayed, simply swap out the + `content` property on the controller. + + For example, imagine you wanted to display a list of items fetched via an XHR + request. Create an Ember.ArrayController and set its `content` property: + + MyApp.listController = Ember.ArrayController.create(); + + $.get('people.json', function(data) { + MyApp.listController.set('content', data); + }); + + Then, create a view that binds to your new controller: + + {{#each MyApp.listController}} + {{firstName}} {{lastName}} + {{/each}} + + Although you are binding to the controller, the behavior of this controller + is to pass through any methods or properties to the underlying array. This + capability comes from `Ember.ArrayProxy`, which this class inherits from. + + Note: As of this writing, `ArrayController` does not add any functionality + to its superclass, `ArrayProxy`. The Ember team plans to add additional + controller-specific functionality in the future, e.g. single or multiple + selection support. If you are creating something that is conceptually a + controller, use this class. + + @extends Ember.ArrayProxy +*/ + +Ember.ArrayController = Ember.ArrayProxy.extend(); + })({}); +(function(exports) { + +})({}); (function(exports) { // ========================================================================== @@ -10368,6 +11472,20 @@ if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== + +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember - JavaScript Application Framework +// Copyright: ©2006-2011 Strobe Inc. and contributors. +// Portions ©2008-2011 Apple Inc. All rights reserved. +// License: Licensed under MIT license (see license.js) +// ========================================================================== + +ember_assert("Ember requires jQuery 1.6 or 1.7", window.jQuery && window.jQuery().jquery.match(/^1\.[67](.\d+)?$/)); +Ember.$ = window.jQuery; + })({}); (function(exports) { @@ -10379,6 +11497,26 @@ if (Ember.EXTEND_PROTOTYPES) Ember.NativeArray.activate(); // ========================================================================== var get = Ember.get, set = Ember.set; +var forEach = Ember.ArrayUtils.forEach; +var indexOf = Ember.ArrayUtils.indexOf; + +var ClassSet = function() { + this.seen = {}; + this.list = []; +}; + +ClassSet.prototype = { + add: function(string) { + if (string in this.seen) { return; } + this.seen[string] = true; + + this.list.push(string); + }, + + toDOM: function() { + return this.list.join(" "); + } +}; /** @class @@ -10390,10 +11528,15 @@ var get = Ember.get, set = Ember.set; @extends Ember.Object */ Ember.RenderBuffer = function(tagName) { - return Ember._RenderBuffer.create({ elementTag: tagName }); + return new Ember._RenderBuffer(tagName); }; -Ember._RenderBuffer = Ember.Object.extend( +Ember._RenderBuffer = function(tagName) { + this.elementTag = tagName; + this.childBuffers = []; +}; + +Ember._RenderBuffer.prototype = /** @scope Ember.RenderBuffer.prototype */ { /** @@ -10467,17 +11610,6 @@ Ember._RenderBuffer = Ember.Object.extend( */ parentBuffer: null, - /** @private */ - init: function() { - this._super(); - - set(this ,'elementClasses', Ember.A()); - set(this, 'elementAttributes', {}); - set(this, 'elementStyle', {}); - set(this, 'childBuffers', []); - set(this, 'elements', {}); - }, - /** Adds a string of HTML to the RenderBuffer. @@ -10485,7 +11617,7 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} this */ push: function(string) { - get(this, 'childBuffers').push(String(string)); + this.childBuffers.push(String(string)); return this; }, @@ -10496,7 +11628,10 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} this */ addClass: function(className) { - get(this, 'elementClasses').addObject(className); + // lazily create elementClasses + var elementClasses = this.elementClasses = (this.elementClasses || new ClassSet()); + this.elementClasses.add(className); + return this; }, @@ -10507,7 +11642,7 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} this */ id: function(id) { - set(this, 'elementId', id); + this.elementId = id; return this; }, @@ -10522,10 +11657,10 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer|String} this or the current attribute value */ attr: function(name, value) { - var attributes = get(this, 'elementAttributes'); + var attributes = this.elementAttributes = (this.elementAttributes || {}); if (arguments.length === 1) { - return attributes[name] + return attributes[name]; } else { attributes[name] = value; } @@ -10540,8 +11675,8 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} this */ removeAttr: function(name) { - var attributes = get(this, 'elementAttributes'); - delete attributes[name]; + var attributes = this.elementAttributes; + if (attributes) { delete attributes[name]; } return this; }, @@ -10554,7 +11689,9 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} this */ style: function(name, value) { - get(this, 'elementStyle')[name] = value; + var style = this.elementStyle = (this.elementStyle || {}); + + this.elementStyle[name] = value; return this; }, @@ -10575,10 +11712,8 @@ Ember._RenderBuffer = Ember.Object.extend( buffer. */ newBuffer: function(tagName, parent, fn, other) { - var buffer = Ember._RenderBuffer.create({ - parentBuffer: parent, - elementTag: tagName - }); + var buffer = new Ember._RenderBuffer(tagName); + buffer.parentBuffer = parent; if (other) { buffer.setProperties(other); } if (fn) { fn.call(this, buffer); } @@ -10596,12 +11731,12 @@ Ember._RenderBuffer = Ember.Object.extend( the existing buffer. */ replaceWithBuffer: function(newBuffer) { - var parent = get(this, 'parentBuffer'); + var parent = this.parentBuffer; if (!parent) { return; } - var childBuffers = get(parent, 'childBuffers'); + var childBuffers = parent.childBuffers; - var index = childBuffers.indexOf(this); + var index = indexOf(childBuffers, this); if (newBuffer) { childBuffers.splice(index, 1, newBuffer); @@ -10620,7 +11755,7 @@ Ember._RenderBuffer = Ember.Object.extend( */ begin: function(tagName) { return this.newBuffer(tagName, this, function(buffer) { - get(this, 'childBuffers').push(buffer); + this.childBuffers.push(buffer); }); }, @@ -10631,7 +11766,7 @@ Ember._RenderBuffer = Ember.Object.extend( */ prepend: function(tagName) { return this.newBuffer(tagName, this, function(buffer) { - get(this, 'childBuffers').splice(0, 0, buffer); + this.childBuffers.splice(0, 0, buffer); }); }, @@ -10641,7 +11776,7 @@ Ember._RenderBuffer = Ember.Object.extend( @param {String} tagName Tag name to use for the new buffer's element */ replaceWith: function(tagName) { - var parentBuffer = get(this, 'parentBuffer'); + var parentBuffer = this.parentBuffer; return this.newBuffer(tagName, parentBuffer, function(buffer) { this.replaceWithBuffer(buffer); @@ -10657,8 +11792,8 @@ Ember._RenderBuffer = Ember.Object.extend( var parentBuffer = get(this, 'parentBuffer'); return this.newBuffer(tagName, parentBuffer, function(buffer) { - var siblings = get(parentBuffer, 'childBuffers'); - var index = siblings.indexOf(this); + var siblings = parentBuffer.childBuffers; + var index = indexOf(siblings, this); siblings.splice(index + 1, 0, buffer); }); }, @@ -10669,7 +11804,7 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {Ember.RenderBuffer} The parentBuffer, if one exists. Otherwise, this */ end: function() { - var parent = get(this, 'parentBuffer'); + var parent = this.parentBuffer; return parent || this; }, @@ -10691,42 +11826,44 @@ Ember._RenderBuffer = Ember.Object.extend( @returns {String} The generated HTMl */ string: function() { - var id = get(this, 'elementId'), - classes = get(this, 'elementClasses'), - attrs = get(this, 'elementAttributes'), - style = get(this, 'elementStyle'), - tag = get(this, 'elementTag'), - content = '', - styleBuffer = [], prop; + var content = '', tag = this.elementTag, openTag; if (tag) { - var openTag = ["<" + tag]; + var id = this.elementId, + classes = this.elementClasses, + attrs = this.elementAttributes, + style = this.elementStyle, + styleBuffer = '', prop; + + openTag = ["<" + tag]; if (id) { openTag.push('id="' + id + '"'); } - if (classes.length) { openTag.push('class="' + classes.join(" ") + '"'); } + if (classes) { openTag.push('class="' + classes.toDOM() + '"'); } - if (!jQuery.isEmptyObject(style)) { + if (style) { for (prop in style) { if (style.hasOwnProperty(prop)) { - styleBuffer.push(prop + ':' + style[prop] + ';'); + styleBuffer += (prop + ':' + style[prop] + ';'); } } - openTag.push('style="' + styleBuffer.join("") + '"'); + openTag.push('style="' + styleBuffer + '"'); } - for (prop in attrs) { - if (attrs.hasOwnProperty(prop)) { - openTag.push(prop + '="' + attrs[prop] + '"'); + if (attrs) { + for (prop in attrs) { + if (attrs.hasOwnProperty(prop)) { + openTag.push(prop + '="' + attrs[prop] + '"'); + } } } openTag = openTag.join(" ") + '>'; } - var childBuffers = get(this, 'childBuffers'); + var childBuffers = this.childBuffers; - childBuffers.forEach(function(buffer) { + forEach(childBuffers, function(buffer) { var stringy = typeof buffer === 'string'; content += (stringy ? buffer : buffer.string()); }); @@ -10738,11 +11875,10 @@ Ember._RenderBuffer = Ember.Object.extend( } } -}); +}; })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -10786,7 +11922,7 @@ Ember.EventDispatcher = Ember.Object.extend( This will be called after the browser sends a DOMContentReady event. By default, it will set up all of the listeners on the document body. If you - would like to register the listeners on different element, set the event + would like to register the listeners on a different element, set the event dispatcher's `root` property. */ setup: function(addedEvents) { @@ -10800,6 +11936,7 @@ Ember.EventDispatcher = Ember.Object.extend( keypress : 'keyPress', mousedown : 'mouseDown', mouseup : 'mouseUp', + contextmenu : 'contextMenu', click : 'click', dblclick : 'doubleClick', mousemove : 'mouseMove', @@ -10818,7 +11955,7 @@ Ember.EventDispatcher = Ember.Object.extend( dragend : 'dragEnd' }; - jQuery.extend(events, addedEvents || {}); + Ember.$.extend(events, addedEvents || {}); var rootElement = Ember.$(get(this, 'rootElement')); @@ -10828,7 +11965,7 @@ Ember.EventDispatcher = Ember.Object.extend( rootElement.addClass('ember-application'); - ember_assert('Unable to add "ember-application" class to rootElement. Make sure you the body or an element in the body.', rootElement.is('.ember-application')); + ember_assert('Unable to add "ember-application" class to rootElement. Make sure you set rootElement to the body or an element in the body.', rootElement.is('.ember-application')); for (event in events) { if (events.hasOwnProperty(event)) { @@ -10876,6 +12013,16 @@ Ember.EventDispatcher = Ember.Object.extend( return result; }); + + rootElement.delegate('[data-ember-action]', event + '.ember', function(evt) { + var actionId = Ember.$(evt.currentTarget).attr('data-ember-action'), + action = Ember.Handlebars.ActionHelper.registeredActions[actionId], + handler = action.handler; + + if (action.eventName === eventName) { + return handler(evt); + } + }); }, /** @private */ @@ -10896,7 +12043,7 @@ Ember.EventDispatcher = Ember.Object.extend( _dispatchEvent: function(object, evt, eventName, view) { var result = true; - handler = object[eventName]; + var handler = object[eventName]; if (Ember.typeOf(handler) === 'function') { result = handler.call(object, evt, view); evt.stopPropagation(); @@ -10925,7 +12072,6 @@ Ember.EventDispatcher = Ember.Object.extend( })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -10956,7 +12102,7 @@ var get = Ember.get, set = Ember.set; entire page, and are not embedding any third-party Ember applications in your page, use the default document root for your application. - You only need to specify the root if your page contains multiple instances + You only need to specify the root if your page contains multiple instances of Ember.Application. @since Ember 2.0 @@ -11008,8 +12154,6 @@ Ember.Application = Ember.Namespace.extend( self.didBecomeReady(); }); } - - this._super(); }, /** @private */ @@ -11039,7 +12183,6 @@ Ember.Application = Ember.Namespace.extend( })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -11051,11 +12194,10 @@ Ember.Application = Ember.Namespace.extend( // Add a new named queue for rendering views that happens // after bindings have synced. var queues = Ember.run.queues; -queues.splice(jQuery.inArray('actions', queues)+1, 0, 'render'); +queues.splice(Ember.$.inArray('actions', queues)+1, 0, 'render'); })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -11063,8 +12205,8 @@ queues.splice(jQuery.inArray('actions', queues)+1, 0, 'render'); // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== -})({}); +})({}); (function(exports) { // ========================================================================== @@ -11077,13 +12219,14 @@ queues.splice(jQuery.inArray('actions', queues)+1, 0, 'render'); var get = Ember.get, set = Ember.set, addObserver = Ember.addObserver; var getPath = Ember.getPath, meta = Ember.meta, fmt = Ember.String.fmt; var a_slice = Array.prototype.slice; +var a_forEach = Ember.ArrayUtils.forEach; var childViewsProperty = Ember.computed(function() { var childViews = get(this, '_childViews'); var ret = Ember.A(); - childViews.forEach(function(view) { + a_forEach(childViews, function(view) { if (view.isVirtual) { ret.pushObjects(get(view, 'childViews')); } else { @@ -11092,7 +12235,7 @@ var childViewsProperty = Ember.computed(function() { }); return ret; -}).property('_childViews.@each').cacheable(); +}).property().cacheable(); /** @static @@ -11105,12 +12248,20 @@ var childViewsProperty = Ember.computed(function() { */ Ember.TEMPLATES = {}; +var invokeForState = { + preRender: {}, + inBuffer: {}, + hasElement: {}, + inDOM: {}, + destroyed: {} +}; + /** @class @since Ember 0.9 @extends Ember.Object */ -Ember.View = Ember.Object.extend( +Ember.View = Ember.Object.extend(Ember.Evented, /** @scope Ember.View.prototype */ { /** @private */ @@ -11118,10 +12269,10 @@ Ember.View = Ember.Object.extend( /** @type Boolean - @default YES + @default true @constant */ - isView: YES, + isView: true, // .......................................................... // TEMPLATE SUPPORT @@ -11139,6 +12290,18 @@ Ember.View = Ember.Object.extend( */ templateName: null, + /** + The name of the layout to lookup if no layout is provided. + + Ember.View will look for a template with this name in this view's + `templates` object. By default, this will be a global object + shared in `Ember.TEMPLATES`. + + @type String + @default null + */ + layoutName: null, + /** The hash in which to look for `templateName`. @@ -11161,25 +12324,46 @@ Ember.View = Ember.Object.extend( template: Ember.computed(function(key, value) { if (value !== undefined) { return value; } - var templateName = get(this, 'templateName'), template; + var templateName = get(this, 'templateName'), + template = this.templateForName(templateName, 'template'); - if (templateName) { template = get(get(this, 'templates'), templateName); } + return template || get(this, 'defaultTemplate'); + }).property('templateName').cacheable(), - // If there is no template but a templateName has been specified, - // try to lookup as a spade module - if (!template && templateName) { - if ('undefined' !== require && require.exists) { - if (require.exists(templateName)) { template = require(templateName); } - } + /** + A view may contain a layout. A layout is a regular template but + supercedes the `template` property during rendering. It is the + responsibility of the layout template to retrieve the `template` + property from the view and render it in the correct location. - if (!template) { - throw new Ember.Error(fmt('%@ - Unable to find template "%@".', [this, templateName])); - } + This is useful for a view that has a shared wrapper, but which delegates + the rendering of the contents of the wrapper to the `template` property + on a subclass. + + @field + @type Function + */ + layout: Ember.computed(function(key, value) { + if (arguments.length === 2) { return value; } + + var layoutName = get(this, 'layoutName'), + layout = this.templateForName(layoutName, 'layout'); + + return layout || get(this, 'defaultLayout'); + }).property('layoutName').cacheable(), + + templateForName: function(name, type) { + if (!name) { return; } + + var templates = get(this, 'templates'), + template = get(templates, name); + + if (!template) { + throw new Ember.Error(fmt('%@ - Unable to find %@ "%@".', [this, type, name])); } - // return the template, or undefined if no template was found - return template || get(this, 'defaultTemplate'); - }).property('templateName').cacheable(), + return template; + }, /** The object from which templates should access properties. @@ -11227,7 +12411,7 @@ Ember.View = Ember.Object.extend( @type Boolean @default null */ - isVisible: null, + isVisible: true, /** Array of child views. You should never edit this array directly. @@ -11239,7 +12423,7 @@ Ember.View = Ember.Object.extend( */ childViews: childViewsProperty, - _childViews: Ember.A(), + _childViews: [], /** Return the nearest ancestor that is an instance of the provided @@ -11324,6 +12508,8 @@ Ember.View = Ember.Object.extend( collectionView, itemView, and contentView */ _parentViewDidChange: Ember.observer(function() { + if (this.isDestroying) { return; } + this.invokeRecursively(function(view) { view.propertyDidChange('collectionView'); view.propertyDidChange('itemView'); @@ -11343,7 +12529,10 @@ Ember.View = Ember.Object.extend( @param {Ember.RenderBuffer} buffer The render buffer */ render: function(buffer) { - var template = get(this, 'template'); + // If this view has a layout, it is the responsibility of the + // the layout to render the view's template. Otherwise, render the template + // directly. + var template = get(this, 'layout') || get(this, 'template'); if (template) { var context = get(this, 'templateContext'), @@ -11364,8 +12553,18 @@ Ember.View = Ember.Object.extend( }, invokeForState: function(name) { - var parent = this, states = parent.states; - var stateName = get(this, 'state'), state; + var stateName = this.state, args; + + // try to find the function for the state in the cache + if (fn = invokeForState[stateName][name]) { + args = a_slice.call(arguments); + args[0] = this; + + return fn.apply(this, args); + } + + // otherwise, find and cache the function for this state + var parent = this, states = parent.states, state; while (states) { state = states[stateName]; @@ -11374,7 +12573,9 @@ Ember.View = Ember.Object.extend( var fn = state[name]; if (fn) { - var args = a_slice.call(arguments, 1); + invokeForState[stateName][name] = fn; + + args = a_slice.call(arguments, 1); args.unshift(this); return fn.apply(this, args); @@ -11406,9 +12607,8 @@ Ember.View = Ember.Object.extend( }, clearRenderedChildren: function() { - var viewMeta = meta(this)['Ember.View'], - lengthBefore = viewMeta.lengthBeforeRender, - lengthAfter = viewMeta.lengthAfterRender; + var lengthBefore = this.lengthBeforeRender, + lengthAfter = this.lengthAfterRender; // If there were child views created during the last call to render(), // remove them under the assumption that they will be re-created when @@ -11439,7 +12639,7 @@ Ember.View = Ember.Object.extend( // Loop through all of the configured bindings. These will be either // property names ('isUrgent') or property paths relative to the view // ('content.isUrgent') - classBindings.forEach(function(binding) { + a_forEach(classBindings, function(binding) { // Variable in which the old class value is saved. The observer function // closes over this variable, so it knows which string to remove when @@ -11503,21 +12703,25 @@ Ember.View = Ember.Object.extend( if (!attributeBindings) { return; } - attributeBindings.forEach(function(attributeName) { + a_forEach(attributeBindings, function(binding) { + var split = binding.split(':'), + property = split[0], + attributeName = split[1] || property; + // Create an observer to add/remove/change the attribute if the // JavaScript property changes. var observer = function() { elem = this.$(); - attributeValue = get(this, attributeName); + attributeValue = get(this, property); - Ember.View.applyAttributeBindings(elem, attributeName, attributeValue) + Ember.View.applyAttributeBindings(elem, attributeName, attributeValue); }; - addObserver(this, attributeName, observer); + addObserver(this, property, observer); // Determine the current value and add it to the render buffer // if necessary. - attributeValue = get(this, attributeName); + attributeValue = get(this, property); Ember.View.applyAttributeBindings(buffer, attributeName, attributeValue); }, this); }, @@ -11533,14 +12737,19 @@ Ember.View = Ember.Object.extend( */ _classStringForProperty: function(property) { var split = property.split(':'), - property = split[0], className = split[1]; - var val = Ember.getPath(this, property); + property = split[0]; + + // TODO: Remove this `false` when the `getPath` globals support is removed + var val = Ember.getPath(this, property, false); + if (val === undefined && Ember.isGlobalPath(property)) { + val = Ember.getPath(window, property); + } // If value is a Boolean and true, return the dasherized property // name. - if (val === YES) { + if (val === true) { if (className) { return className; } // Normalize property path to be suitable for use @@ -11549,9 +12758,9 @@ Ember.View = Ember.Object.extend( var parts = property.split('.'); return Ember.String.dasherize(parts[parts.length-1]); - // If the value is not NO, undefined, or null, return the current + // If the value is not false, undefined, or null, return the current // value of the property. - } else if (val !== NO && val !== undefined && val !== null) { + } else if (val !== false && val !== undefined && val !== null) { return val; // Nothing to display. Return null so that the old class is removed @@ -11642,9 +12851,6 @@ Ember.View = Ember.Object.extend( // Schedule the DOM element to be created and appended to the given // element after bindings have synchronized. this._insertElementLater(function() { - if (get(this, 'isVisible') === null) { - set(this, 'isVisible', true); - } this.$().appendTo(target); }); @@ -11694,7 +12900,7 @@ Ember.View = Ember.Object.extend( @param {Function} fn the function that inserts the element into the DOM */ _insertElementLater: function(fn) { - Ember.run.schedule('render', this, 'invokeForState', 'insertElement', fn); + Ember.run.schedule('render', this, this.invokeForState, 'insertElement', fn); }, /** @@ -11741,6 +12947,11 @@ Ember.View = Ember.Object.extend( return value !== undefined ? value : Ember.guidFor(this); }).cacheable(), + /** @private */ + _elementIdDidChange: Ember.beforeObserver(function() { + throw "Changing a view's elementId after creation is not allowed."; + }, 'elementId'), + /** Attempts to discover the element in the parent element. The default implementation looks for an element with an ID of elementId (or the view's @@ -11753,7 +12964,7 @@ Ember.View = Ember.Object.extend( */ findElementInParentElement: function(parentElem) { var id = "#" + get(this, 'elementId'); - return jQuery(id)[0] || jQuery(id, parentElem)[0]; + return Ember.$(id)[0] || Ember.$(id, parentElem)[0]; }, /** @@ -11765,7 +12976,12 @@ Ember.View = Ember.Object.extend( */ renderBuffer: function(tagName) { tagName = tagName || get(this, 'tagName'); - if (tagName == null) { tagName = 'div'; } + + // Explicitly check for null or undefined, as tagName + // may be an empty string, which would evaluate to false. + if (tagName === null || tagName === undefined) { + tagName = 'div'; + } return Ember.RenderBuffer(tagName); }, @@ -11800,6 +13016,13 @@ Ember.View = Ember.Object.extend( */ didInsertElement: Ember.K, + /** + Called when the view is about to rerender, but before anything has + been torn down. This is a good opportunity to tear down any manual + observers you have installed based on the DOM state + */ + willRerender: Ember.K, + /** Run this callback on the current view and recursively on child views. @@ -11834,7 +13057,7 @@ Ember.View = Ember.Object.extend( _notifyWillInsertElement: function(fromPreRender) { this.invokeRecursively(function(view) { if (fromPreRender) { view._willInsertElementAccessUnsupported = true; } - view.willInsertElement(); + view.fire('willInsertElement'); view._willInsertElementAccessUnsupported = false; }); }, @@ -11847,7 +13070,19 @@ Ember.View = Ember.Object.extend( */ _notifyDidInsertElement: function() { this.invokeRecursively(function(view) { - view.didInsertElement(); + view.fire('didInsertElement'); + }); + }, + + /** + @private + + Invokes the receiver's willRerender() method if it exists and then + invokes the same on all child views. + */ + _notifyWillRerender: function() { + this.invokeRecursively(function(view) { + view.fire('willRerender'); }); }, @@ -11886,7 +13121,7 @@ Ember.View = Ember.Object.extend( */ _notifyWillDestroyElement: function() { this.invokeRecursively(function(view) { - view.willDestroyElement(); + view.fire('willDestroyElement'); }); }, @@ -11937,7 +13172,6 @@ Ember.View = Ember.Object.extend( be used. */ renderToBuffer: function(parentBuffer, bufferOperation) { - var viewMeta = meta(this)['Ember.View']; var buffer; Ember.run.sync(); @@ -11954,23 +13188,25 @@ Ember.View = Ember.Object.extend( // insert a new buffer after the "parent buffer"). if (parentBuffer) { var tagName = get(this, 'tagName'); - if (tagName == null) { tagName = 'div'; } + if (tagName === null || tagName === undefined) { + tagName = 'div'; + } buffer = parentBuffer[bufferOperation](tagName); } else { buffer = this.renderBuffer(); } - viewMeta.buffer = buffer; - this.transitionTo('inBuffer'); + this.buffer = buffer; + this.transitionTo('inBuffer', false); - viewMeta.lengthBeforeRender = getPath(this, '_childViews.length'); + this.lengthBeforeRender = get(get(this, '_childViews'), 'length'); this.beforeRender(buffer); this.render(buffer); this.afterRender(buffer); - viewMeta.lengthAfterRender = getPath(this, '_childViews.length'); + this.lengthAfterRender = get(get(this, '_childViews'), 'length'); return buffer; }, @@ -11995,7 +13231,7 @@ Ember.View = Ember.Object.extend( this._applyAttributeBindings(buffer); - get(this, 'classNames').forEach(function(name){ buffer.addClass(name); }); + a_forEach(get(this, 'classNames'), function(name){ buffer.addClass(name); }); buffer.id(get(this, 'elementId')); var role = get(this, 'ariaRole'); @@ -12109,6 +13345,8 @@ Ember.View = Ember.Object.extend( */ attributeBindings: [], + state: 'preRender', + // ....................................................... // CORE DISPLAY METHODS // @@ -12122,27 +13360,22 @@ Ember.View = Ember.Object.extend( dispatch */ init: function() { - set(this, 'state', 'preRender'); - - var parentView = get(this, '_parentView'); - this._super(); // Register the view for event handling. This hash is used by // Ember.RootResponder to dispatch incoming events. Ember.View.views[get(this, 'elementId')] = this; - var childViews = Ember.A(get(this, '_childViews').slice()); + var childViews = get(this, '_childViews').slice(); + // setup child views. be sure to clone the child views array first set(this, '_childViews', childViews); + ember_assert("Only arrays are allowed for 'classNameBindings'", Ember.typeOf(this.classNameBindings) === 'array'); + this.classNameBindings = Ember.A(this.classNameBindings.slice()); - this.classNameBindings = Ember.A(get(this, 'classNameBindings').slice()); - this.classNames = Ember.A(get(this, 'classNames').slice()); - - set(this, 'domManager', this.domManagerClass.create({ view: this })); - - meta(this)["Ember.View"] = {}; + ember_assert("Only arrays are allowed for 'classNames'", Ember.typeOf(this.classNames) === 'array'); + this.classNames = Ember.A(this.classNames.slice()); var viewController = get(this, 'viewController'); if (viewController) { @@ -12164,12 +13397,19 @@ Ember.View = Ember.Object.extend( @returns {Ember.View} receiver */ removeChild: function(view) { + // If we're destroying, the entire subtree will be + // freed, and the DOM will be handled separately, + // so no need to mess with childViews. + if (this.isDestroying) { return; } + // update parent node set(view, '_parentView', null); // remove view from childViews array. var childViews = get(this, '_childViews'); - childViews.removeObject(view); + Ember.ArrayUtils.removeObject(childViews, view); + + this.propertyDidChange('childViews'); return this; }, @@ -12208,35 +13448,39 @@ Ember.View = Ember.Object.extend( }, /** - You must call this method on a view to destroy the view (and all of its + You must call `destroy` on a view to destroy the view (and all of its child views). This will remove the view from any parent node, then make sure that the DOM element managed by the view can be released by the memory manager. */ - destroy: function() { - if (get(this, 'isDestroyed')) { return; } - + willDestroy: function() { // calling this._super() will nuke computed properties and observers, // so collect any information we need before calling super. - var viewMeta = meta(this)['Ember.View'], - childViews = get(this, '_childViews'), + var childViews = get(this, '_childViews'), parent = get(this, '_parentView'), elementId = get(this, 'elementId'), - childLen = childViews.length; + childLen; // destroy the element -- this will avoid each child view destroying // the element over and over again... if (!this.removedFromDOM) { this.destroyElement(); } + // remove from non-virtual parent view if viewName was specified + if (this.viewName) { + var nonVirtualParentView = get(this, 'parentView'); + if (nonVirtualParentView) { + set(nonVirtualParentView, this.viewName, null); + } + } + // remove from parent if found. Don't call removeFromParent, // as removeFromParent will try to remove the element from // the DOM again. if (parent) { parent.removeChild(this); } - Ember.Descriptor.setup(this, 'state', 'destroyed'); - - this._super(); + this.state = 'destroyed'; + childLen = get(childViews, 'length'); for (var i=childLen-1; i>=0; i--) { childViews[i].removedFromDOM = true; childViews[i].destroy(); @@ -12244,8 +13488,6 @@ Ember.View = Ember.Object.extend( // next remove view from global hash delete Ember.View.views[get(this, 'elementId')]; - - return this; // done with cleanup }, /** @@ -12262,9 +13504,13 @@ Ember.View = Ember.Object.extend( */ createChildView: function(view, attrs) { if (Ember.View.detect(view)) { - view = view.create(attrs || {}, { _parentView: this }); + if (attrs) { + view = view.createWith({ _parentView: this }, attrs); + } else { + view = view.createWith({ _parentView: this }); + } - var viewName = attrs && attrs.viewName || view.viewName; + var viewName = view.viewName; // don't set the property on a virtual view, as they are invisible to // consumers of the view API @@ -12300,7 +13546,7 @@ Ember.View = Ember.Object.extend( }, 'isVisible'), _notifyBecameVisible: function() { - this.becameVisible(); + this.fire('becameVisible'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); @@ -12312,7 +13558,7 @@ Ember.View = Ember.Object.extend( }, _notifyBecameHidden: function() { - this.becameHidden(); + this.fire('becameHidden'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); @@ -12336,12 +13582,12 @@ Ember.View = Ember.Object.extend( clearBuffer: function() { this.invokeRecursively(function(view) { - meta(view)['Ember.View'].buffer = null; + this.buffer = null; }); }, transitionTo: function(state, children) { - set(this, 'state', state); + this.state = state; if (children !== false) { this.forEachChildView(function(view) { @@ -12350,6 +13596,17 @@ Ember.View = Ember.Object.extend( } }, + /** + @private + + Override the default event firing from Ember.Evented to + also call methods with the given name. + */ + fire: function(name) { + this[name].apply(this, [].slice.call(arguments, 1)); + this._super.apply(this, arguments); + }, + // ....................................................... // EVENT HANDLING // @@ -12390,49 +13647,48 @@ Ember.View = Ember.Object.extend( // once the view has been inserted into the DOM, legal manipulations // are done on the DOM element. -Ember.View.reopen({ - states: Ember.View.states, - domManagerClass: Ember.Object.extend({ - view: this, - - prepend: function(childView) { - var view = get(this, 'view'); +/** @private */ +var DOMManager = { + prepend: function(view, childView) { + childView._insertElementLater(function() { + var element = view.$(); + element.prepend(childView.$()); + }); + }, - childView._insertElementLater(function() { - var element = view.$(); - element.prepend(childView.$()); - }); - }, + after: function(view, nextView) { + nextView._insertElementLater(function() { + var element = view.$(); + element.after(nextView.$()); + }); + }, - after: function(nextView) { - var view = get(this, 'view'); + replace: function(view) { + var element = get(view, 'element'); - nextView._insertElementLater(function() { - var element = view.$(); - element.after(nextView.$()); - }); - }, + set(view, 'element', null); - replace: function() { - var view = get(this, 'view'); - var element = get(view, 'element'); + view._insertElementLater(function() { + Ember.$(element).replaceWith(get(view, 'element')); + }); + }, - set(view, 'element', null); + remove: function(view) { + var elem = get(view, 'element'); - view._insertElementLater(function() { - Ember.$(element).replaceWith(get(view, 'element')); - }); - }, + set(view, 'element', null); - remove: function() { - var view = get(this, 'view'); - var elem = get(view, 'element'); + Ember.$(elem).remove(); + }, - set(view, 'element', null); + empty: function(view) { + view.$().empty(); + } +}; - Ember.$(elem).remove(); - } - }) +Ember.View.reopen({ + states: Ember.View.states, + domManager: DOMManager }); // Create a global view hash. @@ -12446,7 +13702,7 @@ Ember.View.views = {}; Ember.View.childViewsProperty = childViewsProperty; Ember.View.applyAttributeBindings = function(elem, name, value) { - var type = typeof value; + var type = Ember.typeOf(value); var currentValue = elem.attr(name); // if this changes, also change the logic in ember-handlebars/lib/helpers/binding.js @@ -12461,7 +13717,6 @@ Ember.View.applyAttributeBindings = function(elem, name, value) { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12499,7 +13754,6 @@ Ember.View.reopen({ })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12529,6 +13783,8 @@ Ember.View.states.preRender = { return Ember.$(); }, + empty: Ember.K, + // This exists for the removal warning, remove later getElement: function(view){ if (view._willInsertElementAccessUnsupported) { @@ -12553,7 +13809,6 @@ Ember.View.states.preRender = { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12578,21 +13833,27 @@ Ember.View.states.inBuffer = { // when a view is rendered in a buffer, rerendering it simply // replaces the existing buffer with a new one rerender: function(view) { - var buffer = meta(view)['Ember.View'].buffer; + ember_deprecate("Something you did caused a view to re-render after it rendered but before it was inserted into the DOM. Because this is avoidable and the cause of significant performance issues in applications, this behavior is deprecated. If you want to use the debugger to find out what caused this, you can set ENV.RAISE_ON_DEPRECATION to true."); + + view._notifyWillRerender(); view.clearRenderedChildren(); - view.renderToBuffer(buffer, 'replaceWith'); + view.renderToBuffer(view.buffer, 'replaceWith'); }, // when a view is rendered in a buffer, appending a child // view will render that view and append the resulting // buffer into its buffer. appendChild: function(view, childView, options) { - var buffer = meta(view)['Ember.View'].buffer; + var buffer = view.buffer; childView = this.createChildView(childView, options); - get(view, '_childViews').pushObject(childView); + get(view, '_childViews').push(childView); + childView.renderToBuffer(buffer); + + view.propertyDidChange('childViews'); + return childView; }, @@ -12607,6 +13868,10 @@ Ember.View.states.inBuffer = { return view; }, + empty: function() { + throw "EWOT"; + }, + // It should be impossible for a rendered view to be scheduled for // insertion. insertElement: function() { @@ -12630,7 +13895,6 @@ Ember.View.states.inBuffer = { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12669,9 +13933,11 @@ Ember.View.states.hasElement = { // once the view has been inserted into the DOM, rerendering is // deferred to allow bindings to synchronize. rerender: function(view) { + view._notifyWillRerender(); + view.clearRenderedChildren(); - get(view, 'domManager').replace(); + view.domManager.replace(view); return view; }, @@ -12679,14 +13945,16 @@ Ember.View.states.hasElement = { // from the DOM, nukes its element, and puts it back into the // preRender state. destroyElement: function(view) { - view.invokeRecursively(function(view) { - this.willDestroyElement(); - }); + view._notifyWillDestroyElement(); - get(view, 'domManager').remove(); + view.domManager.remove(view); return view; }, + empty: function(view) { + view.domManager.empty(view); + }, + // Handle events from `Ember.EventDispatcher` handleEvent: function(view, eventName, evt) { var handler = view[eventName]; @@ -12708,7 +13976,6 @@ Ember.View.states.inDOM = { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12730,6 +13997,9 @@ Ember.View.states.destroyed = { destroyElement: function() { throw fmt(destroyedError, ['destroyElement']); }, + empty: function() { + throw fmt(destroyedError, ['empty']); + }, setElement: function() { throw fmt(destroyedError, ["set('element', ...)"]); @@ -12743,7 +14013,6 @@ Ember.View.states.destroyed = { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -12751,8 +14020,8 @@ Ember.View.states.destroyed = { // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== -})({}); +})({}); (function(exports) { // ========================================================================== @@ -12762,6 +14031,7 @@ Ember.View.states.destroyed = { // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set, meta = Ember.meta; +var forEach = Ember.ArrayUtils.forEach; var childViewsProperty = Ember.computed(function() { return get(this, '_childViews'); @@ -12777,7 +14047,7 @@ Ember.ContainerView = Ember.View.extend({ var _childViews = get(this, '_childViews'); - childViews.forEach(function(viewName, idx) { + forEach(childViews, function(viewName, idx) { var view; if ('string' === typeof viewName) { @@ -12790,29 +14060,17 @@ Ember.ContainerView = Ember.View.extend({ _childViews[idx] = view; }, this); - }, - - /** - Extends Ember.View's implementation of renderToBuffer to - set up an array observer on the child views array. This - observer will detect when child views are added or removed - and update the DOM to reflect the mutation. - Note that we set up this array observer in the `renderToBuffer` - method because any views set up previously will be rendered the first - time the container is rendered. - - @private - */ - renderToBuffer: function() { - var ret = this._super.apply(this, arguments); + // Make the _childViews array observable + Ember.A(_childViews); + // Sets up an array observer on the child views array. This + // observer will detect when child views are added or removed + // and update the DOM to reflect the mutation. get(this, 'childViews').addArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' }); - - return ret; }, /** @@ -12833,7 +14091,7 @@ Ember.ContainerView = Ember.View.extend({ @private */ - destroy: function() { + willDestroy: function() { get(this, 'childViews').removeArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' @@ -12857,7 +14115,7 @@ Ember.ContainerView = Ember.View.extend({ childViewsWillChange: function(views, start, removed) { if (removed === 0) { return; } - var changedViews = views.slice(start, removed); + var changedViews = views.slice(start, start+removed); this.setParentView(changedViews, null); this.invokeForState('childViewsWillChange', views, start, removed); @@ -12884,7 +14142,7 @@ Ember.ContainerView = Ember.View.extend({ // No new child views were added; bail out. if (added === 0) return; - var changedViews = views.slice(start, added); + var changedViews = views.slice(start, start+added); this.setParentView(changedViews, this); // Let the current state handle the changes @@ -12892,7 +14150,7 @@ Ember.ContainerView = Ember.View.extend({ }, setParentView: function(views, parentView) { - views.forEach(function(view) { + forEach(views, function(view) { set(view, '_parentView', parentView); }); }, @@ -12908,9 +14166,9 @@ Ember.ContainerView = Ember.View.extend({ */ _scheduleInsertion: function(view, prev) { if (prev) { - prev.get('domManager').after(view); + prev.domManager.after(prev, view); } else { - this.get('domManager').prepend(view); + this.domManager.prepend(this, view); } } }); @@ -12922,7 +14180,7 @@ Ember.ContainerView.states = { inBuffer: { childViewsDidChange: function(parentView, views, start, added) { - var buffer = meta(parentView)['Ember.View'].buffer, + var buffer = parentView.buffer, startWith, prev, prevBuffer, view; // Determine where to begin inserting the child view(s) in the @@ -12944,7 +14202,7 @@ Ember.ContainerView.states = { for (var i=startWith; i= start; idx--) { - childViews[idx].destroy(); + childView = childViews[idx]; + if (removingAll) { childView.removedFromDOM = true; } + childView.destroy(); } }, @@ -13137,10 +14401,10 @@ Ember.CollectionView = Ember.ContainerView.extend( }, createChildView: function(view, attrs) { - var view = this._super(view, attrs); + view = this._super(view, attrs); var itemTagName = get(view, 'tagName'); - var tagName = itemTagName == null ? Ember.CollectionView.CONTAINER_MAP[get(this, 'tagName')] : itemTagName; + var tagName = (itemTagName === null || itemTagName === undefined) ? Ember.CollectionView.CONTAINER_MAP[get(this, 'tagName')] : itemTagName; set(view, 'tagName', tagName); @@ -13171,7 +14435,6 @@ Ember.CollectionView.CONTAINER_MAP = { })({}); - (function(exports) { // ========================================================================== // Project: Ember - JavaScript Application Framework @@ -13179,8 +14442,8 @@ Ember.CollectionView.CONTAINER_MAP = { // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== -})({}); +})({}); (function(exports) { // ========================================================================== @@ -13189,20 +14452,33 @@ Ember.CollectionView.CONTAINER_MAP = { // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== -ember_assert("Ember requires jQuery 1.6 or 1.7", window.jQuery && jQuery().jquery.match(/^1\.[67](.\d+)?$/)); -Ember.$ = window.jQuery; + +/*globals jQuery*/ + })({}); (function(exports) { -var get = Ember.get, set = Ember.set; +var get = Ember.get, set = Ember.set, getPath = Ember.getPath; Ember.State = Ember.Object.extend({ isState: true, parentState: null, start: null, + name: null, + path: Ember.computed(function() { + var parentPath = getPath(this, 'parentState.path'), + path = get(this, 'name'); + + if (parentPath) { + path = parentPath + '.' + path; + } + + return path; + }).property().cacheable(), init: function() { var states = get(this, 'states'), foundStates; + var name; // As a convenience, loop over the properties // of this state and look for any that are other @@ -13212,40 +14488,37 @@ Ember.State = Ember.Object.extend({ if (!states) { states = {}; - for (var name in this) { - if (name === "constructor") { continue; } - value = this.setupChild(name, this[name]); - if (value) { - foundStates = true; - states[name] = value; - } + for (name in this) { + if (name === "constructor") { continue; } + this.setupChild(states, name, this[name]); } - if (foundStates) { set(this, 'states', states); } + set(this, 'states', states); } else { - for (var name in states) { - this.setupChild(name, states[name]); + for (name in states) { + this.setupChild(states, name, states[name]); } } set(this, 'routes', {}); }, - setupChild: function(name, value) { + setupChild: function(states, name, value) { if (!value) { return false; } if (Ember.State.detect(value)) { - value = value.create(); + value = value.create({ + name: name + }); + } else if (value.isState) { + set(value, 'name', name); } if (value.isState) { set(value, 'parentState', this); - set(value, 'name', (get(this, 'name') || '') + '.' + name); - return value; + states[name] = value; } - - return false; }, enter: Ember.K, @@ -13254,11 +14527,8 @@ Ember.State = Ember.Object.extend({ })({}); - (function(exports) { var get = Ember.get, set = Ember.set, getPath = Ember.getPath, fmt = Ember.String.fmt; -Ember.LOG_STATE_TRANSITIONS = false; - /** @class */ @@ -13275,7 +14545,7 @@ Ember.StateManager = Ember.State.extend( var initialState = get(this, 'initialState'); - if (!initialState && get(this, 'start')) { + if (!initialState && getPath(this, 'states.start')) { initialState = 'start'; } @@ -13286,6 +14556,15 @@ Ember.StateManager = Ember.State.extend( currentState: null, + /** + @property + + If set to true, `errorOnUnhandledEvents` will cause an exception to be + raised if you attempt to send an event to a state manager that is not + handled by the current state or any of its parent states. + */ + errorOnUnhandledEvent: true, + /** @property @@ -13314,16 +14593,20 @@ Ember.StateManager = Ember.State.extend( }, sendRecursively: function(event, currentState, context) { - var log = Ember.LOG_STATE_TRANSITIONS; + var log = this.enableLogging; var action = currentState[event]; if (action) { - if (log) { console.log(fmt("STATEMANAGER: Sending event '%@' to state %@.", [event, currentState.name])); } + if (log) { console.log(fmt("STATEMANAGER: Sending event '%@' to state %@.", [event, get(currentState, 'path')])); } action.call(currentState, this, context); } else { var parentState = get(currentState, 'parentState'); - if (parentState) { this.sendRecursively(event, parentState, context); } + if (parentState) { + this.sendRecursively(event, parentState, context); + } else if (get(this, 'errorOnUnhandledEvent')) { + throw new Ember.Error(this.toString() + " could not respond to event " + event + " in state " + getPath(this, 'currentState.path') + "."); + } } }, @@ -13374,7 +14657,8 @@ Ember.StateManager = Ember.State.extend( newState = this.findStatesByRoute(state, name); } - enterStates = newState.slice(0), exitStates = exitStates.slice(0); + enterStates = newState.slice(0); + exitStates = exitStates.slice(0); if (enterStates.length > 0) { state = enterStates[enterStates.length - 1]; @@ -13430,29 +14714,38 @@ Ember.StateManager = Ember.State.extend( }, enterState: function(exitStates, enterStates, state) { - var log = Ember.LOG_STATE_TRANSITIONS; + var log = this.enableLogging; var stateManager = this; + exitStates = exitStates.slice(0).reverse(); this.asyncEach(exitStates, function(state, transition) { state.exit(stateManager, transition); }, function() { this.asyncEach(enterStates, function(state, transition) { - if (log) { console.log("STATEMANAGER: Entering " + state.name); } + if (log) { console.log("STATEMANAGER: Entering " + get(state, 'path')); } state.enter(stateManager, transition); }, function() { - var startState = state, enteredState, initialSubstate; + var startState = state, enteredState, initialState; - initialSubstate = get(startState, 'initialSubstate'); + initialState = get(startState, 'initialState'); - if (!initialSubstate) { - initialSubstate = 'start'; + if (!initialState) { + initialState = 'start'; } // right now, start states cannot be entered asynchronously - while (startState = get(startState, initialSubstate)) { + while (startState = get(get(startState, 'states'), initialState)) { enteredState = startState; + + if (log) { console.log("STATEMANAGER: Entering " + get(startState, 'path')); } startState.enter(stateManager); + + initialState = get(startState, 'initialState'); + + if (!initialState) { + initialState = 'start'; + } } set(this, 'currentState', enteredState || state); @@ -13463,7 +14756,6 @@ Ember.StateManager = Ember.State.extend( })({}); - (function(exports) { var get = Ember.get, set = Ember.set; @@ -13514,13 +14806,13 @@ Ember.ViewState = Ember.State.extend({ })({}); - (function(exports) { // ========================================================================== // Project: Ember Statecharts // Copyright: ©2011 Living Social Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== + })({}); (function(exports) { @@ -13550,7 +14842,7 @@ Ember.ViewState = Ember.State.extend({ // Constructor that supports either Metamorph('foo') or new // Metamorph('foo'); - // + // // Takes a string of HTML as the argument. var Metamorph = function(html) { @@ -13589,17 +14881,6 @@ Ember.ViewState = Ember.State.extend({ // If we have the W3C range API, this process is relatively straight forward. if (supportsRange) { - // IE 9 supports ranges but doesn't define createContextualFragment - if (!Range.prototype.createContextualFragment) { - Range.prototype.createContextualFragment = function(html) { - var frag = document.createDocumentFragment(), - div = document.createElement("div"); - frag.appendChild(div); - div.outerHTML = html; - return frag; - }; - } - // Get a range for the current morph. Optionally include the starting and // ending placeholders. rangeFor = function(morph, outerToo) { @@ -13860,6 +15141,7 @@ Ember.ViewState = Ember.State.extend({ afterFunc = function(html) { // get the real starting node. see realNode for details. var end = document.getElementById(this.end); + var insertBefore = end.nextSibling; var parentNode = end.parentNode; var nextSibling; var node; @@ -13873,7 +15155,7 @@ Ember.ViewState = Ember.State.extend({ // placeholder. while (node) { nextSibling = node.nextSibling; - parentNode.insertBefore(node, end.nextSibling); + parentNode.insertBefore(node, insertBefore); node = nextSibling; } }; @@ -14104,652 +15386,811 @@ Ember.Handlebars.registerHelper('helperMissing', function(path, options) { })({}); - (function(exports) { -// ========================================================================== -// Project: Ember Handlebar Views -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var set = Ember.set, get = Ember.get; +/*jshint newcap:false*/ +var set = Ember.set, get = Ember.get, getPath = Ember.getPath; -// TODO: Be explicit in the class documentation that you -// *MUST* set the value of a checkbox through Ember. -// Updating the value of a checkbox directly via jQuery objects -// will not work. +var DOMManager = { + remove: function(view) { + var morph = view.morph; + if (morph.isRemoved()) { return; } + morph.remove(); + }, -Ember.Checkbox = Ember.View.extend({ - title: null, - value: false, - disabled: false, + prepend: function(view, childView) { + childView._insertElementLater(function() { + var morph = view.morph; + morph.prepend(childView.outerHTML); + childView.outerHTML = null; + }); + }, - classNames: ['ember-checkbox'], + after: function(view, nextView) { + nextView._insertElementLater(function() { + var morph = view.morph; + morph.after(nextView.outerHTML); + nextView.outerHTML = null; + }); + }, - defaultTemplate: Ember.Handlebars.compile(''), + replace: function(view) { + var morph = view.morph; - change: function() { - Ember.run.once(this, this._updateElementValue); - // returning false will cause IE to not change checkbox state + view.transitionTo('preRender'); + view.clearRenderedChildren(); + var buffer = view.renderToBuffer(); + + Ember.run.schedule('render', this, function() { + if (get(view, 'isDestroyed')) { return; } + view.invalidateRecursively('element'); + view._notifyWillInsertElement(); + morph.replaceWith(buffer.string()); + view.transitionTo('inDOM'); + view._notifyDidInsertElement(); + }); }, - _updateElementValue: function() { - var input = this.$('input:checkbox'); - set(this, 'value', input.prop('checked')); + empty: function(view) { + view.morph.html(""); } +}; + +// The `morph` and `outerHTML` properties are internal only +// and not observable. + +Ember.Metamorph = Ember.Mixin.create({ + isVirtual: true, + tagName: '', + + init: function() { + this._super(); + this.morph = Metamorph(); + }, + + beforeRender: function(buffer) { + buffer.push(this.morph.startTag()); + }, + + afterRender: function(buffer) { + buffer.push(this.morph.endTag()); + }, + + createElement: function() { + var buffer = this.renderToBuffer(); + this.outerHTML = buffer.string(); + this.clearBuffer(); + }, + + domManager: DOMManager }); })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -var get = Ember.get, set = Ember.set; +/*globals Handlebars */ -/** @class */ -Ember.TextSupport = Ember.Mixin.create( -/** @scope Ember.TextSupport.prototype */ { +var get = Ember.get, set = Ember.set, getPath = Ember.Handlebars.getPath; +/** + @ignore + @private + @class - value: "", + Ember._BindableSpanView is a private view created by the Handlebars `{{bind}}` + helpers that is used to keep track of bound properties. - attributeBindings: ['placeholder', 'disabled'], - placeholder: null, - disabled: false, + Every time a property is bound using a `{{mustache}}`, an anonymous subclass + of Ember._BindableSpanView is created with the appropriate sub-template and + context set up. When the associated property changes, just the template for + this view will re-render. +*/ +Ember._BindableSpanView = Ember.View.extend(Ember.Metamorph, +/** @scope Ember._BindableSpanView.prototype */{ - insertNewline: Ember.K, - cancel: Ember.K, + /** + The function used to determine if the `displayTemplate` or + `inverseTemplate` should be rendered. This should be a function that takes + a value and returns a Boolean. - focusOut: function(event) { - this._elementValueDidChange(); - }, + @type Function + @default null + */ + shouldDisplayFunc: null, - change: function(event) { - this._elementValueDidChange(); - }, + /** + Whether the template rendered by this view gets passed the context object + of its parent template, or gets passed the value of retrieving `property` + from the previous context. + + For example, this is true when using the `{{#if}}` helper, because the + template inside the helper should look up properties relative to the same + object as outside the block. This would be false when used with `{{#with + foo}}` because the template should receive the object found by evaluating + `foo`. + + @type Boolean + @default false + */ + preserveContext: false, + + /** + The template to render when `shouldDisplayFunc` evaluates to true. + + @type Function + @default null + */ + displayTemplate: null, + + /** + The template to render when `shouldDisplayFunc` evaluates to false. + + @type Function + @default null + */ + inverseTemplate: null, + + /** + The key to look up on `previousContext` that is passed to + `shouldDisplayFunc` to determine which template to render. + + In addition, if `preserveContext` is false, this object will be passed to + the template when rendering. + + @type String + @default null + */ + property: null, + + normalizedValue: Ember.computed(function() { + var property = get(this, 'property'), + context = get(this, 'previousContext'), + valueNormalizer = get(this, 'valueNormalizerFunc'), + result; + + // Use the current context as the result if no + // property is provided. + if (property === '') { + result = context; + } else { + result = getPath(context, property); + } - keyUp: function(event) { - this.interpretKeyEvents(event); + return valueNormalizer ? valueNormalizer(result) : result; + }).property('property', 'previousContext', 'valueNormalizerFunc'), + + rerenderIfNeeded: function() { + if (!get(this, 'isDestroyed') && get(this, 'normalizedValue') !== this._lastNormalizedValue) { + this.rerender(); + } }, /** - @private - */ - interpretKeyEvents: function(event) { - var map = Ember.TextSupport.KEY_EVENTS; - var method = map[event.keyCode]; + Determines which template to invoke, sets up the correct state based on + that logic, then invokes the default Ember.View `render` implementation. - this._elementValueDidChange(); - if (method) { return this[method](event); } - }, + This method will first look up the `property` key on `previousContext`, + then pass that value to the `shouldDisplayFunc` function. If that returns + true, the `displayTemplate` function will be rendered to DOM. Otherwise, + `inverseTemplate`, if specified, will be rendered. - _elementValueDidChange: function() { - set(this, 'value', this.$().val()); - } + For example, if this Ember._BindableSpan represented the {{#with foo}} + helper, it would look up the `foo` property of its context, and + `shouldDisplayFunc` would always return true. The object found by looking + up `foo` would be passed to `displayTemplate`. -}); + @param {Ember.RenderBuffer} buffer + */ + render: function(buffer) { + // If not invoked via a triple-mustache ({{{foo}}}), escape + // the content of the template. + var escape = get(this, 'isEscaped'); -Ember.TextSupport.KEY_EVENTS = { - 13: 'insertNewline', - 27: 'cancel' -}; + var shouldDisplay = get(this, 'shouldDisplayFunc'), + preserveContext = get(this, 'preserveContext'), + context = get(this, 'previousContext'); -})({}); + var inverseTemplate = get(this, 'inverseTemplate'), + displayTemplate = get(this, 'displayTemplate'); + var result = get(this, 'normalizedValue'); + this._lastNormalizedValue = result; -(function(exports) { -// ========================================================================== -// Project: Ember Handlebar Views -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var get = Ember.get, set = Ember.set; + // First, test the conditional to see if we should + // render the template or not. + if (shouldDisplay(result)) { + set(this, 'template', displayTemplate); -/** - @class - @extends Ember.TextSupport -*/ -Ember.TextField = Ember.View.extend(Ember.TextSupport, - /** @scope Ember.TextField.prototype */ { + // If we are preserving the context (for example, if this + // is an #if block, call the template with the same object. + if (preserveContext) { + set(this, 'templateContext', context); + } else { + // Otherwise, determine if this is a block bind or not. + // If so, pass the specified object to the template + if (displayTemplate) { + set(this, 'templateContext', result); + } else { + // This is not a bind block, just push the result of the + // expression to the render context and return. + if (result === null || result === undefined) { + result = ""; + } else { + result = String(result); + } - classNames: ['ember-text-field'], + if (escape) { result = Handlebars.Utils.escapeExpression(result); } + buffer.push(result); + return; + } + } + } else if (inverseTemplate) { + set(this, 'template', inverseTemplate); - tagName: "input", - attributeBindings: ['type', 'value'], - type: "text" + if (preserveContext) { + set(this, 'templateContext', context); + } else { + set(this, 'templateContext', result); + } + } else { + set(this, 'template', function() { return ''; }); + } + return this._super(buffer); + } }); })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -var get = Ember.get, set = Ember.set; - -Ember.Button = Ember.View.extend(Ember.TargetActionSupport, { - classNames: ['ember-button'], - classNameBindings: ['isActive'], - - tagName: 'button', - - propagateEvents: false, - - attributeBindings: ['type', 'disabled', 'href'], +var get = Ember.get, getPath = Ember.Handlebars.getPath, set = Ember.set, fmt = Ember.String.fmt; +var forEach = Ember.ArrayUtils.forEach; - // Defaults to 'button' if tagName is 'input' or 'button' - type: Ember.computed(function(key, value) { - var tagName = this.get('tagName'); - if (value !== undefined) { this._type = value; } - if (this._type !== undefined) { return this._type; } - if (tagName === 'input' || tagName === 'button') { return 'button'; } - }).property('tagName').cacheable(), +var EmberHandlebars = Ember.Handlebars, helpers = EmberHandlebars.helpers; - disabled: false, +(function() { + // Binds a property into the DOM. This will create a hook in DOM that the + // KVO system will look for and update if the property changes. + var bind = function(property, options, preserveContext, shouldDisplay, valueNormalizer) { + var data = options.data, + fn = options.fn, + inverse = options.inverse, + view = data.view, + ctx = this; - // Allow 'a' tags to act like buttons - href: Ember.computed(function() { - return this.get('tagName') === 'a' ? '#' : null; - }).property('tagName').cacheable(), + // Set up observers for observable objects + if ('object' === typeof this) { + // Create the view that will wrap the output of this template/property + // and add it to the nearest view's childViews array. + // See the documentation of Ember._BindableSpanView for more. + var bindView = view.createChildView(Ember._BindableSpanView, { + preserveContext: preserveContext, + shouldDisplayFunc: shouldDisplay, + valueNormalizerFunc: valueNormalizer, + displayTemplate: fn, + inverseTemplate: inverse, + property: property, + previousContext: ctx, + isEscaped: options.hash.escaped + }); - mouseDown: function() { - if (!get(this, 'disabled')) { - set(this, 'isActive', true); - this._mouseDown = true; - this._mouseEntered = true; - } - return get(this, 'propagateEvents'); - }, + view.appendChild(bindView); - mouseLeave: function() { - if (this._mouseDown) { - set(this, 'isActive', false); - this._mouseEntered = false; - } - }, + /** @private */ + var observer = function() { + Ember.run.once(bindView, 'rerenderIfNeeded'); + }; - mouseEnter: function() { - if (this._mouseDown) { - set(this, 'isActive', true); - this._mouseEntered = true; + // Observes the given property on the context and + // tells the Ember._BindableSpan to re-render. If property + // is an empty string, we are printing the current context + // object ({{this}}) so updating it is not our responsibility. + if (property !== '') { + Ember.addObserver(ctx, property, observer); + } + } else { + // The object is not observable, so just render it out and + // be done with it. + data.buffer.push(getPath(this, property)); } - }, + }; - mouseUp: function(event) { - if (get(this, 'isActive')) { - // Actually invoke the button's target and action. - // This method comes from the Ember.TargetActionSupport mixin. - this.triggerAction(); - set(this, 'isActive', false); - } + /** + '_triageMustache' is used internally select between a binding and helper for + the given context. Until this point, it would be hard to determine if the + mustache is a property reference or a regular helper reference. This triage + helper resolves that. - this._mouseDown = false; - this._mouseEntered = false; - return get(this, 'propagateEvents'); - }, + This would not be typically invoked by directly. - keyDown: function(event) { - // Handle space or enter - if (event.keyCode === 13 || event.keyCode === 32) { - this.mouseDown(); + @private + @name Handlebars.helpers._triageMustache + @param {String} property Property/helperID to triage + @param {Function} fn Context to provide for rendering + @returns {String} HTML string + */ + EmberHandlebars.registerHelper('_triageMustache', function(property, fn) { + ember_assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2); + if (helpers[property]) { + return helpers[property].call(this, fn); } - }, - - keyUp: function(event) { - // Handle space or enter - if (event.keyCode === 13 || event.keyCode === 32) { - this.mouseUp(); + else { + return helpers.bind.apply(this, arguments); } - }, - - // TODO: Handle proper touch behavior. Including should make inactive when - // finger moves more than 20x outside of the edge of the button (vs mouse - // which goes inactive as soon as mouse goes out of edges.) - - touchStart: function(touch) { - return this.mouseDown(touch); - }, - - touchEnd: function(touch) { - return this.mouseUp(touch); - } -}); + }); -})({}); + /** + `bind` can be used to display a value, then update that value if it + changes. For example, if you wanted to print the `title` property of + `content`: + {{bind "content.title"}} -(function(exports) { -// ========================================================================== -// Project: Ember Handlebar Views -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -var get = Ember.get, set = Ember.set; + This will return the `title` property as a string, then create a new + observer at the specified path. If it changes, it will update the value in + DOM. Note that if you need to support IE7 and IE8 you must modify the + model objects properties using Ember.get() and Ember.set() for this to work as + it relies on Ember's KVO system. For all other browsers this will be handled + for you automatically. -/** - @class - @extends Ember.TextSupport -*/ -Ember.TextArea = Ember.View.extend(Ember.TextSupport, -/** @scope Ember.TextArea.prototype */ { + @private + @name Handlebars.helpers.bind + @param {String} property Property to bind + @param {Function} fn Context to provide for rendering + @returns {String} HTML string + */ + EmberHandlebars.registerHelper('bind', function(property, fn) { + ember_assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2); - classNames: ['ember-text-area'], + var context = (fn.contexts && fn.contexts[0]) || this; - tagName: "textarea", + return bind.call(context, property, fn, false, function(result) { + return !Ember.none(result); + }); + }); /** + Use the `boundIf` helper to create a conditional that re-evaluates + whenever the bound value changes. + + {{#boundIf "content.shouldDisplayTitle"}} + {{content.title}} + {{/boundIf}} + @private + @name Handlebars.helpers.boundIf + @param {String} property Property to bind + @param {Function} fn Context to provide for rendering + @returns {String} HTML string */ - didInsertElement: function() { - this._updateElementValue(); - }, + EmberHandlebars.registerHelper('boundIf', function(property, fn) { + var context = (fn.contexts && fn.contexts[0]) || this; + var func = function(result) { + if (Ember.typeOf(result) === 'array') { + return get(result, 'length') !== 0; + } else { + return !!result; + } + }; - _updateElementValue: Ember.observer(function() { - this.$().val(get(this, 'value')); - }, 'value') + return bind.call(context, property, fn, true, func, func); + }); +})(); -}); +/** + @name Handlebars.helpers.with + @param {Function} context + @param {Hash} options + @returns {String} HTML string +*/ +EmberHandlebars.registerHelper('with', function(context, options) { + ember_assert("You must pass exactly one argument to the with helper", arguments.length === 2); + ember_assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); -})({}); + return helpers.bind.call(options.contexts[0], context, options); +}); -(function(exports) { -Ember.TabContainerView = Ember.View.extend(); +/** + @name Handlebars.helpers.if + @param {Function} context + @param {Hash} options + @returns {String} HTML string +*/ +EmberHandlebars.registerHelper('if', function(context, options) { + ember_assert("You must pass exactly one argument to the if helper", arguments.length === 2); + ember_assert("You must pass a block to the if helper", options.fn && options.fn !== Handlebars.VM.noop); -})({}); + return helpers.boundIf.call(options.contexts[0], context, options); +}); +/** + @name Handlebars.helpers.unless + @param {Function} context + @param {Hash} options + @returns {String} HTML string +*/ +EmberHandlebars.registerHelper('unless', function(context, options) { + ember_assert("You must pass exactly one argument to the unless helper", arguments.length === 2); + ember_assert("You must pass a block to the unless helper", options.fn && options.fn !== Handlebars.VM.noop); -(function(exports) { -var get = Ember.get, getPath = Ember.getPath; + var fn = options.fn, inverse = options.inverse; -Ember.TabPaneView = Ember.View.extend({ - tabsContainer: Ember.computed(function() { - return this.nearestInstanceOf(Ember.TabContainerView); - }).property(), + options.fn = inverse; + options.inverse = fn; - isVisible: Ember.computed(function() { - return get(this, 'viewName') === getPath(this, 'tabsContainer.currentView'); - }).property('tabsContainer.currentView') + return helpers.boundIf.call(options.contexts[0], context, options); }); -})({}); - +/** + `bindAttr` allows you to create a binding between DOM element attributes and + Ember objects. For example: -(function(exports) { -var get = Ember.get, setPath = Ember.setPath; + imageTitle -Ember.TabView = Ember.View.extend({ - tabsContainer: Ember.computed(function() { - return this.nearestInstanceOf(Ember.TabContainerView); - }).property(), + @name Handlebars.helpers.bindAttr + @param {Hash} options + @returns {String} HTML string +*/ +EmberHandlebars.registerHelper('bindAttr', function(options) { - mouseUp: function() { - setPath(this, 'tabsContainer.currentView', get(this, 'value')); - } -}); + var attrs = options.hash; -})({}); + ember_assert("You must specify at least one hash argument to bindAttr", !!Ember.keys(attrs).length); + var view = options.data.view; + var ret = []; + var ctx = this; -(function(exports) { -})({}); + // Generate a unique id for this element. This will be added as a + // data attribute to the element so it can be looked up when + // the bound property changes. + var dataId = ++Ember.$.uuid; + // Handle classes differently, as we can bind multiple classes + var classBindings = attrs['class']; + if (classBindings !== null && classBindings !== undefined) { + var classResults = EmberHandlebars.bindClasses(this, classBindings, view, dataId); + ret.push('class="' + classResults.join(' ') + '"'); + delete attrs['class']; + } -(function(exports) { -var set = Ember.set, get = Ember.get, getPath = Ember.getPath; + var attrKeys = Ember.keys(attrs); -Ember.Select = Ember.View.extend({ - tagName: 'select', - template: Ember.Handlebars.compile( - '{{#if prompt}}{{/if}}' + - '{{#each content}}{{view Ember.SelectOption contentBinding="this"}}{{/each}}' - ), + // For each attribute passed, create an observer and emit the + // current value of the property as an attribute. + forEach(attrKeys, function(attr) { + var property = attrs[attr]; - content: null, - selection: null, - prompt: null, + ember_assert(fmt("You must provide a String for a bound attribute, not %@", [property]), typeof property === 'string'); - optionLabelPath: 'content', - optionValuePath: 'content', + var value = (property === 'this') ? ctx : getPath(ctx, property), + type = Ember.typeOf(value); + ember_assert(fmt("Attributes must be numbers, strings or booleans, not %@", [value]), value === null || value === undefined || type === 'number' || type === 'string' || type === 'boolean'); - didInsertElement: function() { - var selection = get(this, 'selection'); + var observer, invoker; - if (selection) { this.selectionDidChange(); } + /** @private */ + observer = function observer() { + var result = getPath(ctx, property); - this.change(); - }, + ember_assert(fmt("Attributes must be numbers, strings or booleans, not %@", [result]), result === null || result === undefined || typeof result === 'number' || typeof result === 'string' || typeof result === 'boolean'); - change: function() { - var selectedIndex = this.$()[0].selectedIndex, - content = get(this, 'content'), - prompt = get(this, 'prompt'); + var elem = view.$("[data-bindattr-" + dataId + "='" + dataId + "']"); - if (!content) { return; } - if (prompt && selectedIndex === 0) { set(this, 'selection', null); return; } + // If we aren't able to find the element, it means the element + // to which we were bound has been removed from the view. + // In that case, we can assume the template has been re-rendered + // and we need to clean up the observer. + if (elem.length === 0) { + Ember.removeObserver(ctx, property, invoker); + return; + } - if (prompt) { selectedIndex -= 1; } - set(this, 'selection', content.objectAt(selectedIndex)); - }, + Ember.View.applyAttributeBindings(elem, attr, result); + }; - selectionDidChange: Ember.observer(function() { - var el = this.$()[0], - content = get(this, 'content'), - selection = get(this, 'selection'), - selectionIndex = content.indexOf(selection), - prompt = get(this, 'prompt'); + /** @private */ + invoker = function() { + Ember.run.once(observer); + }; - if (prompt) { selectionIndex += 1; } - if (el) { el.selectedIndex = selectionIndex; } - }, 'selection') -}); + // Add an observer to the view for when the property changes. + // When the observer fires, find the element using the + // unique data id and update the attribute to the new value. + if (property !== 'this') { + Ember.addObserver(ctx, property, invoker); + } -Ember.SelectOption = Ember.View.extend({ - tagName: 'option', - template: Ember.Handlebars.compile("{{label}}"), - attributeBindings: ['value'], + // if this changes, also change the logic in ember-views/lib/views/view.js + if ((type === 'string' || (type === 'number' && !isNaN(value)))) { + ret.push(attr + '="' + value + '"'); + } else if (value && type === 'boolean') { + ret.push(attr + '="' + attr + '"'); + } + }, this); - init: function() { - this.labelPathDidChange(); - this.valuePathDidChange(); + // Add the unique identifier + // NOTE: We use all lower-case since Firefox has problems with mixed case in SVG + ret.push('data-bindattr-' + dataId + '="' + dataId + '"'); + return new EmberHandlebars.SafeString(ret.join(' ')); +}); - this._super(); - }, +/** + Helper that, given a space-separated string of property paths and a context, + returns an array of class names. Calling this method also has the side + effect of setting up observers at those property paths, such that if they + change, the correct class name will be reapplied to the DOM element. - labelPathDidChange: Ember.observer(function() { - var labelPath = getPath(this, 'parentView.optionLabelPath'); + For example, if you pass the string "fooBar", it will first look up the + "fooBar" value of the context. If that value is true, it will add the + "foo-bar" class to the current element (i.e., the dasherized form of + "fooBar"). If the value is a string, it will add that string as the class. + Otherwise, it will not add any new class name. - if (!labelPath) { return; } + @param {Ember.Object} context + The context from which to lookup properties - Ember.defineProperty(this, 'label', Ember.computed(function() { - return getPath(this, labelPath); - }).property(labelPath).cacheable()); - }, 'parentView.optionLabelPath'), + @param {String} classBindings + A string, space-separated, of class bindings to use - valuePathDidChange: Ember.observer(function() { - var valuePath = getPath(this, 'parentView.optionValuePath'); + @param {Ember.View} view + The view in which observers should look for the element to update - if (!valuePath) { return; } + @param {Srting} bindAttrId + Optional bindAttr id used to lookup elements - Ember.defineProperty(this, 'value', Ember.computed(function() { - return getPath(this, valuePath); - }).property(valuePath).cacheable()); - }, 'parentView.optionValuePath') -}); + @returns {Array} An array of class names to add +*/ +EmberHandlebars.bindClasses = function(context, classBindings, view, bindAttrId) { + var ret = [], newClass, value, elem; + // Helper method to retrieve the property from the context and + // determine which class string to return, based on whether it is + // a Boolean or not. + var classStringForProperty = function(property) { + var split = property.split(':'), + className = split[1]; -})({}); + property = split[0]; + var val = property !== '' ? getPath(context, property) : true; -(function(exports) { -// ========================================================================== -// Project: Ember Handlebar Views -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -})({}); + // If value is a Boolean and true, return the dasherized property + // name. + if (val === true) { + if (className) { return className; } + // Normalize property path to be suitable for use + // as a class name. For exaple, content.foo.barBaz + // becomes bar-baz. + var parts = property.split('.'); + return Ember.String.dasherize(parts[parts.length-1]); -(function(exports) { -var set = Ember.set, get = Ember.get, getPath = Ember.getPath; + // If the value is not false, undefined, or null, return the current + // value of the property. + } else if (val !== false && val !== undefined && val !== null) { + return val; -Ember.Metamorph = Ember.Mixin.create({ - isVirtual: true, - tagName: '', + // Nothing to display. Return null so that the old class is removed + // but no new class is added. + } else { + return null; + } + }; - init: function() { - this._super(); - set(this, 'morph', Metamorph()); - }, + // For each property passed, loop through and setup + // an observer. + forEach(classBindings.split(' '), function(binding) { - beforeRender: function(buffer) { - var morph = get(this, 'morph'); - buffer.push(morph.startTag()); - }, + // Variable in which the old class value is saved. The observer function + // closes over this variable, so it knows which string to remove when + // the property changes. + var oldClass; - afterRender: function(buffer) { - var morph = get(this, 'morph'); - buffer.push(morph.endTag()); - }, + var observer, invoker; - createElement: function() { - var buffer = this.renderToBuffer(); - set(this, 'outerHTML', buffer.string()); - this.clearBuffer(); - }, + // Set up an observer on the context. If the property changes, toggle the + // class name. + /** @private */ + observer = function() { + // Get the current value of the property + newClass = classStringForProperty(binding); + elem = bindAttrId ? view.$("[data-bindattr-" + bindAttrId + "='" + bindAttrId + "']") : view.$(); - domManagerClass: Ember.Object.extend({ - remove: function(view) { - var morph = getPath(this, 'view.morph'); - if (morph.isRemoved()) { return; } - getPath(this, 'view.morph').remove(); - }, + // If we can't find the element anymore, a parent template has been + // re-rendered and we've been nuked. Remove the observer. + if (elem.length === 0) { + Ember.removeObserver(context, binding, invoker); + } else { + // If we had previously added a class to the element, remove it. + if (oldClass) { + elem.removeClass(oldClass); + } - prepend: function(childView) { - var view = get(this, 'view'); + // If necessary, add a new class. Make sure we keep track of it so + // it can be removed in the future. + if (newClass) { + elem.addClass(newClass); + oldClass = newClass; + } else { + oldClass = null; + } + } + }; - childView._insertElementLater(function() { - var morph = get(view, 'morph'); - morph.prepend(get(childView, 'outerHTML')); - childView.set('outerHTML', null); - }); - }, + /** @private */ + invoker = function() { + Ember.run.once(observer); + }; - after: function(nextView) { - var view = get(this, 'view'); + var property = binding.split(':')[0]; + if (property !== '') { + Ember.addObserver(context, property, invoker); + } - nextView._insertElementLater(function() { - var morph = get(view, 'morph'); - morph.after(get(nextView, 'outerHTML')); - nextView.set('outerHTML', null); - }); - }, + // We've already setup the observer; now we just need to figure out the + // correct behavior right now on the first pass through. + value = classStringForProperty(binding); - replace: function() { - var view = get(this, 'view'); - var morph = getPath(this, 'view.morph'); + if (value) { + ret.push(value); - view.transitionTo('preRender'); - view.clearRenderedChildren(); - var buffer = view.renderToBuffer(); - - Ember.run.schedule('render', this, function() { - if (get(view, 'isDestroyed')) { return; } - view._notifyWillInsertElement(); - morph.replaceWith(buffer.string()); - view.transitionTo('inDOM'); - view._notifyDidInsertElement(); - }); + // Make sure we save the current value so that it can be removed if the + // observer fires. + oldClass = value; } - }) -}); + }); + + return ret; +}; })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals Handlebars */ - -var get = Ember.get, set = Ember.set, getPath = Ember.Handlebars.getPath; -/** - @ignore - @private - @class - - Ember._BindableSpanView is a private view created by the Handlebars `{{bind}}` - helpers that is used to keep track of bound properties. - - Every time a property is bound using a `{{mustache}}`, an anonymous subclass - of Ember._BindableSpanView is created with the appropriate sub-template and - context set up. When the associated property changes, just the template for - this view will re-render. -*/ -Ember._BindableSpanView = Ember.View.extend(Ember.Metamorph, -/** @scope Ember._BindableSpanView.prototype */{ - - /** - The function used to determine if the `displayTemplate` or - `inverseTemplate` should be rendered. This should be a function that takes - a value and returns a Boolean. - - @type Function - @default null - */ - shouldDisplayFunc: null, - - /** - Whether the template rendered by this view gets passed the context object - of its parent template, or gets passed the value of retrieving `property` - from the previous context. - - For example, this is true when using the `{{#if}}` helper, because the - template inside the helper should look up properties relative to the same - object as outside the block. This would be NO when used with `{{#with - foo}}` because the template should receive the object found by evaluating - `foo`. - - @type Boolean - @default false - */ - preserveContext: false, - - /** - The template to render when `shouldDisplayFunc` evaluates to true. - - @type Function - @default null - */ - displayTemplate: null, - - /** - The template to render when `shouldDisplayFunc` evaluates to false. - - @type Function - @default null - */ - inverseTemplate: null, - - /** - The key to look up on `previousContext` that is passed to - `shouldDisplayFunc` to determine which template to render. +/*globals Handlebars ember_assert */ - In addition, if `preserveContext` is false, this object will be passed to - the template when rendering. +// TODO: Don't require the entire module +var get = Ember.get, set = Ember.set; +var indexOf = Ember.ArrayUtils.indexOf; +var PARENT_VIEW_PATH = /^parentView\./; - @type String - @default null - */ - property: null, +/** @private */ +Ember.Handlebars.ViewHelper = Ember.Object.create({ - normalizedValue: Ember.computed(function() { - var property = get(this, 'property'), - context = get(this, 'previousContext'), - valueNormalizer = get(this, 'valueNormalizerFunc'), - result; + viewClassFromHTMLOptions: function(viewClass, options, thisContext) { + var extensions = {}, + classes = options['class'], + dup = false; - // Use the current context as the result if no - // property is provided. - if (property === '') { - result = context; - } else { - result = getPath(context, property); + if (options.id) { + extensions.elementId = options.id; + dup = true; } - return valueNormalizer ? valueNormalizer(result) : result; - }).property('property', 'previousContext', 'valueNormalizerFunc'), - - rerenderIfNeeded: function() { - if (!get(this, 'isDestroyed') && get(this, 'normalizedValue') !== this._lastNormalizedValue) { - this.rerender(); + if (classes) { + classes = classes.split(' '); + extensions.classNames = classes; + dup = true; } - }, - - /** - Determines which template to invoke, sets up the correct state based on - that logic, then invokes the default Ember.View `render` implementation. - - This method will first look up the `property` key on `previousContext`, - then pass that value to the `shouldDisplayFunc` function. If that returns - true, the `displayTemplate` function will be rendered to DOM. Otherwise, - `inverseTemplate`, if specified, will be rendered. - For example, if this Ember._BindableSpan represented the {{#with foo}} - helper, it would look up the `foo` property of its context, and - `shouldDisplayFunc` would always return true. The object found by looking - up `foo` would be passed to `displayTemplate`. + if (options.classBinding) { + extensions.classNameBindings = options.classBinding.split(' '); + dup = true; + } - @param {Ember.RenderBuffer} buffer - */ - render: function(buffer) { - // If not invoked via a triple-mustache ({{{foo}}}), escape - // the content of the template. - var escape = get(this, 'isEscaped'); + if (options.classNameBindings) { + extensions.classNameBindings = options.classNameBindings.split(' '); + dup = true; + } - var shouldDisplay = get(this, 'shouldDisplayFunc'), - preserveContext = get(this, 'preserveContext'), - context = get(this, 'previousContext'); + if (options.attributeBindings) { + ember_assert("Setting 'attributeBindings' via Handlebars is not allowed. Please subclass Ember.View and set it there instead."); + extensions.attributeBindings = null; + dup = true; + } - var inverseTemplate = get(this, 'inverseTemplate'), - displayTemplate = get(this, 'displayTemplate'); + if (dup) { + options = Ember.$.extend({}, options); + delete options.id; + delete options['class']; + delete options.classBinding; + } - var result = get(this, 'normalizedValue'); - this._lastNormalizedValue = result; + // Look for bindings passed to the helper and, if they are + // local, make them relative to the current context instead of the + // view. + var path; - // First, test the conditional to see if we should - // render the template or not. - if (shouldDisplay(result)) { - set(this, 'template', displayTemplate); + for (var prop in options) { + if (!options.hasOwnProperty(prop)) { continue; } - // If we are preserving the context (for example, if this - // is an #if block, call the template with the same object. - if (preserveContext) { - set(this, 'templateContext', context); - } else { - // Otherwise, determine if this is a block bind or not. - // If so, pass the specified object to the template - if (displayTemplate) { - set(this, 'templateContext', result); - } else { - // This is not a bind block, just push the result of the - // expression to the render context and return. - if (result == null) { result = ""; } else { result = String(result); } - if (escape) { result = Handlebars.Utils.escapeExpression(result); } - buffer.push(result); - return; + // Test if the property ends in "Binding" + if (Ember.IS_BINDING.test(prop)) { + path = options[prop]; + if (!Ember.isGlobalPath(path)) { + if (path === 'this') { + options[prop] = 'bindingContext'; + } else { + options[prop] = 'bindingContext.'+path; + } } } - } else if (inverseTemplate) { - set(this, 'template', inverseTemplate); + } + + // Make the current template context available to the view + // for the bindings set up above. + extensions.bindingContext = thisContext; - if (preserveContext) { - set(this, 'templateContext', context); - } else { - set(this, 'templateContext', result); - } + return viewClass.extend(options, extensions); + }, + + helper: function(thisContext, path, options) { + var inverse = options.inverse, + data = options.data, + view = data.view, + fn = options.fn, + hash = options.hash, + newView; + + if ('string' === typeof path) { + newView = Ember.Handlebars.getPath(thisContext, path); + ember_assert("Unable to find view at path '" + path + "'", !!newView); } else { - set(this, 'template', function() { return ''; }); + newView = path; } - return this._super(buffer); + ember_assert(Ember.String.fmt('You must pass a view class to the #view helper, not %@ (%@)', [path, newView]), Ember.View.detect(newView)); + + newView = this.viewClassFromHTMLOptions(newView, hash, thisContext); + var currentView = data.view; + var viewOptions = {}; + + if (fn) { + ember_assert("You cannot provide a template block if you also specified a templateName", !(get(viewOptions, 'templateName')) && (indexOf(newView.PrototypeMixin.keys(), 'templateName') >= 0)); + viewOptions.template = fn; + } + + currentView.appendChild(newView, viewOptions); } }); -})({}); +/** + @name Handlebars.helpers.view + @param {String} path + @param {Hash} options + @returns {String} HTML string +*/ +Ember.Handlebars.registerHelper('view', function(path, options) { + ember_assert("The view helper only takes a single argument", arguments.length <= 2); + + // If no path is provided, treat path param as options. + if (path && path.data && path.data.isRenderData) { + options = path; + path = "Ember.View"; + } + return Ember.Handlebars.ViewHelper.helper(this, path, options); +}); + + +})({}); (function(exports) { // ========================================================================== @@ -14757,804 +16198,692 @@ Ember._BindableSpanView = Ember.View.extend(Ember.Metamorph, // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals Handlebars */ -var get = Ember.get, getPath = Ember.Handlebars.getPath, set = Ember.set, fmt = Ember.String.fmt; - -var EmberHandlebars = Ember.Handlebars, helpers = EmberHandlebars.helpers; -var helpers = EmberHandlebars.helpers; +/*globals Handlebars ember_assert */ -(function() { - // Binds a property into the DOM. This will create a hook in DOM that the - // KVO system will look for and update if the property changes. - var bind = function(property, options, preserveContext, shouldDisplay, valueNormalizer) { - var data = options.data, - fn = options.fn, - inverse = options.inverse, - view = data.view, - ctx = this; +// TODO: Don't require all of this module +var get = Ember.get, getPath = Ember.Handlebars.getPath, fmt = Ember.String.fmt; - // Set up observers for observable objects - if ('object' === typeof this) { - // Create the view that will wrap the output of this template/property - // and add it to the nearest view's childViews array. - // See the documentation of Ember._BindableSpanView for more. - var bindView = view.createChildView(Ember._BindableSpanView, { - preserveContext: preserveContext, - shouldDisplayFunc: shouldDisplay, - valueNormalizerFunc: valueNormalizer, - displayTemplate: fn, - inverseTemplate: inverse, - property: property, - previousContext: ctx, - isEscaped: options.hash.escaped - }); +/** + @name Handlebars.helpers.collection + @param {String} path + @param {Hash} options + @returns {String} HTML string +*/ +Ember.Handlebars.registerHelper('collection', function(path, options) { + // If no path is provided, treat path param as options. + if (path && path.data && path.data.isRenderData) { + options = path; + path = undefined; + ember_assert("You cannot pass more than one argument to the collection helper", arguments.length === 1); + } else { + ember_assert("You cannot pass more than one argument to the collection helper", arguments.length === 2); + } - view.appendChild(bindView); + var fn = options.fn; + var data = options.data; + var inverse = options.inverse; - /** @private */ - var observer = function() { - Ember.run.once(bindView, 'rerenderIfNeeded'); - }; + // If passed a path string, convert that into an object. + // Otherwise, just default to the standard class. + var collectionClass; + collectionClass = path ? getPath(this, path) : Ember.CollectionView; + ember_assert(fmt("%@ #collection: Could not find %@", data.view, path), !!collectionClass); - // Observes the given property on the context and - // tells the Ember._BindableSpan to re-render. If property - // is an empty string, we are printing the current context - // object ({{this}}) so updating it is not our responsibility. - if (property !== '') { - Ember.addObserver(ctx, property, observer); - } - } else { - // The object is not observable, so just render it out and - // be done with it. - data.buffer.push(getPath(this, property)); - } - }; + var hash = options.hash, itemHash = {}, match; - /** - '_triageMustache' is used internally select between a binding and helper for - the given context. Until this point, it would be hard to determine if the - mustache is a property reference or a regular helper reference. This triage - helper resolves that. + // Extract item view class if provided else default to the standard class + var itemViewClass, itemViewPath = hash.itemViewClass; + var collectionPrototype = collectionClass.proto(); + delete hash.itemViewClass; + itemViewClass = itemViewPath ? getPath(collectionPrototype, itemViewPath) : collectionPrototype.itemViewClass; + ember_assert(fmt("%@ #collection: Could not find %@", data.view, itemViewPath), !!itemViewClass); - This would not be typically invoked by directly. + // Go through options passed to the {{collection}} helper and extract options + // that configure item views instead of the collection itself. + for (var prop in hash) { + if (hash.hasOwnProperty(prop)) { + match = prop.match(/^item(.)(.*)$/); - @private - @name Handlebars.helpers._triageMustache - @param {String} property Property/helperID to triage - @param {Function} fn Context to provide for rendering - @returns {String} HTML string - */ - EmberHandlebars.registerHelper('_triageMustache', function(property, fn) { - ember_assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2); - if (helpers[property]) { - return helpers[property].call(this, fn); - } - else { - return helpers.bind.apply(this, arguments); + if(match) { + // Convert itemShouldFoo -> shouldFoo + itemHash[match[1].toLowerCase() + match[2]] = hash[prop]; + // Delete from hash as this will end up getting passed to the + // {{view}} helper method. + delete hash[prop]; + } } - }); - - /** - `bind` can be used to display a value, then update that value if it - changes. For example, if you wanted to print the `title` property of - `content`: + } - {{bind "content.title"}} + var tagName = hash.tagName || collectionPrototype.tagName; - This will return the `title` property as a string, then create a new - observer at the specified path. If it changes, it will update the value in - DOM. Note that if you need to support IE7 and IE8 you must modify the - model objects properties using Ember.get() and Ember.set() for this to work as - it relies on Ember's KVO system. For all other browsers this will be handled - for you automatically. + if (fn) { + itemHash.template = fn; + delete options.fn; + } - @private - @name Handlebars.helpers.bind - @param {String} property Property to bind - @param {Function} fn Context to provide for rendering - @returns {String} HTML string - */ - EmberHandlebars.registerHelper('bind', function(property, fn) { - ember_assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2); + if (inverse && inverse !== Handlebars.VM.noop) { + var emptyViewClass = Ember.View; - var context = (fn.contexts && fn.contexts[0]) || this; + if (hash.emptyViewClass) { + emptyViewClass = Ember.View.detect(hash.emptyViewClass) ? + hash.emptyViewClass : getPath(this, hash.emptyViewClass); + } - return bind.call(context, property, fn, false, function(result) { - return !Ember.none(result); + hash.emptyView = emptyViewClass.extend({ + template: inverse, + tagName: itemHash.tagName }); - }); + } - /** - Use the `boundIf` helper to create a conditional that re-evaluates - whenever the bound value changes. + if (hash.preserveContext) { + itemHash.templateContext = Ember.computed(function() { + return get(this, 'content'); + }).property('content'); + delete hash.preserveContext; + } - {{#boundIf "content.shouldDisplayTitle"}} - {{content.title}} - {{/boundIf}} + hash.itemViewClass = Ember.Handlebars.ViewHelper.viewClassFromHTMLOptions(itemViewClass, itemHash, this); - @private - @name Handlebars.helpers.boundIf - @param {String} property Property to bind - @param {Function} fn Context to provide for rendering - @returns {String} HTML string - */ - EmberHandlebars.registerHelper('boundIf', function(property, fn) { - var context = (fn.contexts && fn.contexts[0]) || this; - var func = function(result) { - if (Ember.typeOf(result) === 'array') { - return get(result, 'length') !== 0; - } else { - return !!result; - } - }; + return Ember.Handlebars.helpers.view.call(this, collectionClass, options); +}); - return bind.call(context, property, fn, true, func, func); - }); -})(); -/** - @name Handlebars.helpers.with - @param {Function} context - @param {Hash} options - @returns {String} HTML string -*/ -EmberHandlebars.registerHelper('with', function(context, options) { - ember_assert("You must pass exactly one argument to the with helper", arguments.length == 2); - ember_assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); - return helpers.bind.call(options.contexts[0], context, options); -}); +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +/*globals Handlebars */ +var getPath = Ember.Handlebars.getPath; /** - @name Handlebars.helpers.if - @param {Function} context - @param {Hash} options - @returns {String} HTML string -*/ -EmberHandlebars.registerHelper('if', function(context, options) { - ember_assert("You must pass exactly one argument to the if helper", arguments.length == 2); - ember_assert("You must pass a block to the if helper", options.fn && options.fn !== Handlebars.VM.noop); + `unbound` allows you to output a property without binding. *Important:* The + output will not be updated if the property changes. Use with caution. - return helpers.boundIf.call(options.contexts[0], context, options); -}); +
{{unbound somePropertyThatDoesntChange}}
-/** - @name Handlebars.helpers.unless - @param {Function} context - @param {Hash} options + @name Handlebars.helpers.unbound + @param {String} property @returns {String} HTML string */ -EmberHandlebars.registerHelper('unless', function(context, options) { - ember_assert("You must pass exactly one argument to the unless helper", arguments.length == 2); - ember_assert("You must pass a block to the unless helper", options.fn && options.fn !== Handlebars.VM.noop); +Ember.Handlebars.registerHelper('unbound', function(property, fn) { + var context = (fn.contexts && fn.contexts[0]) || this; + return getPath(context, property); +}); - var fn = options.fn, inverse = options.inverse; +})({}); - options.fn = inverse; - options.inverse = fn; +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== - return helpers.boundIf.call(options.contexts[0], context, options); -}); +/*jshint debug:true*/ +var getPath = Ember.getPath; /** - `bindAttr` allows you to create a binding between DOM element attributes and - Ember objects. For example: + `log` allows you to output the value of a value in the current rendering + context. - imageTitle + {{log myVariable}} - @name Handlebars.helpers.bindAttr - @param {Hash} options - @returns {String} HTML string + @name Handlebars.helpers.log + @param {String} property */ -EmberHandlebars.registerHelper('bindAttr', function(options) { +Ember.Handlebars.registerHelper('log', function(property, fn) { + var context = (fn.contexts && fn.contexts[0]) || this; + Ember.Logger.log(getPath(context, property)); +}); - var attrs = options.hash; +/** + The `debugger` helper executes the `debugger` statement in the current + context. - ember_assert("You must specify at least one hash argument to bindAttr", !!Ember.keys(attrs).length); + {{debugger}} - var view = options.data.view; - var ret = []; - var ctx = this; + @name Handlebars.helpers.debugger + @param {String} property +*/ +Ember.Handlebars.registerHelper('debugger', function() { + debugger; +}); - // Generate a unique id for this element. This will be added as a - // data attribute to the element so it can be looked up when - // the bound property changes. - var dataId = ++jQuery.uuid; +})({}); - // Handle classes differently, as we can bind multiple classes - var classBindings = attrs['class']; - if (classBindings !== null && classBindings !== undefined) { - var classResults = EmberHandlebars.bindClasses(this, classBindings, view, dataId); - ret.push('class="' + classResults.join(' ') + '"'); - delete attrs['class']; - } +(function(exports) { +Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember.Metamorph, { + itemViewClass: Ember.View.extend(Ember.Metamorph) +}); - var attrKeys = Ember.keys(attrs); +Ember.Handlebars.registerHelper('each', function(path, options) { + options.hash.contentBinding = path; + options.hash.preserveContext = true; - // For each attribute passed, create an observer and emit the - // current value of the property as an attribute. - attrKeys.forEach(function(attr) { - var property = attrs[attr]; + // Set up emptyView as a metamorph with no tag + options.hash.itemTagName = ''; + options.hash.emptyViewClass = Ember.View.extend(Ember.Metamorph); - ember_assert(fmt("You must provide a String for a bound attribute, not %@", [property]), typeof property === 'string'); + return Ember.Handlebars.helpers.collection.call(this, 'Ember.Handlebars.EachView', options); +}); - var value = getPath(ctx, property); +})({}); - ember_assert(fmt("Attributes must be numbers, strings or booleans, not %@", [value]), value == null || typeof value === 'number' || typeof value === 'string' || typeof value === 'boolean'); +(function(exports) { +/** + `template` allows you to render a template from inside another template. + This allows you to re-use the same template in multiple places. For example: - var observer, invoker; + - /** @private */ - observer = function observer() { - var result = getPath(ctx, property); + - ember_assert(fmt("Attributes must be numbers, strings or booleans, not %@", [result]), result == null || typeof result === 'number' || typeof result === 'string' || typeof result === 'boolean'); + This helper looks for templates in the global Ember.TEMPLATES hash. If you + add <script> tags to your page with the `data-template-name` attribute set, + they will be compiled and placed in this hash automatically. - var elem = view.$("[data-bindAttr-" + dataId + "='" + dataId + "']"); + You can also manually register templates by adding them to the hash: - // If we aren't able to find the element, it means the element - // to which we were bound has been removed from the view. - // In that case, we can assume the template has been re-rendered - // and we need to clean up the observer. - if (elem.length === 0) { - Ember.removeObserver(ctx, property, invoker); - return; - } + Ember.TEMPLATES["my_cool_template"] = Ember.Handlebars.compile('{{user}}'); - Ember.View.applyAttributeBindings(elem, attr, result); - }; + @name Handlebars.helpers.template + @param {String} templateName the template to render +*/ - /** @private */ - invoker = function() { - Ember.run.once(observer); - }; +Ember.Handlebars.registerHelper('template', function(name, options) { + var template = Ember.TEMPLATES[name]; - // Add an observer to the view for when the property changes. - // When the observer fires, find the element using the - // unique data id and update the attribute to the new value. - Ember.addObserver(ctx, property, invoker); + ember_assert("Unable to find template with name '"+name+"'.", !!template); - // if this changes, also change the logic in ember-views/lib/views/view.js - var type = typeof value; + Ember.TEMPLATES[name](this, { data: options.data }); +}); - if ((type === 'string' || (type === 'number' && !isNaN(value)))) { - ret.push(attr + '="' + value + '"'); - } else if (value && type === 'boolean') { - ret.push(attr + '="' + attr + '"'); - } - }, this); +})({}); - // Add the unique identifier - ret.push('data-bindAttr-' + dataId + '="' + dataId + '"'); - return new EmberHandlebars.SafeString(ret.join(' ')); -}); +(function(exports) { +var EmberHandlebars = Ember.Handlebars, getPath = Ember.Handlebars.getPath; -/** - Helper that, given a space-separated string of property paths and a context, - returns an array of class names. Calling this method also has the side - effect of setting up observers at those property paths, such that if they - change, the correct class name will be reapplied to the DOM element. +var ActionHelper = EmberHandlebars.ActionHelper = { + registeredActions: {} +}; - For example, if you pass the string "fooBar", it will first look up the - "fooBar" value of the context. If that value is YES, it will add the - "foo-bar" class to the current element (i.e., the dasherized form of - "fooBar"). If the value is a string, it will add that string as the class. - Otherwise, it will not add any new class name. +ActionHelper.registerAction = function(actionName, eventName, target, view, context) { + var actionId = (++Ember.$.uuid).toString(); - @param {Ember.Object} context - The context from which to lookup properties + ActionHelper.registeredActions[actionId] = { + eventName: eventName, + handler: function(event) { + event.view = view; + event.context = context; - @param {String} classBindings - A string, space-separated, of class bindings to use + if (Ember.StateManager && Ember.StateManager.detectInstance(target)) { + return target.send(actionName, event); + } else { + return target[actionName].call(target, event); + } + } + }; - @param {Ember.View} view - The view in which observers should look for the element to update + view.on('willRerender', function() { + delete ActionHelper.registeredActions[actionId]; + }); - @param {Srting} bindAttrId - Optional bindAttr id used to lookup elements + return actionId; +}; - @returns {Array} An array of class names to add -*/ -EmberHandlebars.bindClasses = function(context, classBindings, view, bindAttrId) { - var ret = [], newClass, value, elem; +EmberHandlebars.registerHelper('action', function(actionName, options) { + var hash = options.hash || {}, + eventName = options.hash.on || "click", + view = options.data.view, + target, context; - // Helper method to retrieve the property from the context and - // determine which class string to return, based on whether it is - // a Boolean or not. - var classStringForProperty = function(property) { - var split = property.split(':'), - className = split[1]; + if (view.isVirtual) { view = view.get('parentView'); } + target = options.hash.target ? getPath(this, options.hash.target) : view; + context = options.contexts[0]; - property = split[0]; + var actionId = ActionHelper.registerAction(actionName, eventName, target, view, context); + return new EmberHandlebars.SafeString('data-ember-action="' + actionId + '"'); +}); - var val = getPath(context, property); +})({}); - // If value is a Boolean and true, return the dasherized property - // name. - if (val === YES) { - if (className) { return className; } +(function(exports) { +var get = Ember.get, set = Ember.set; - // Normalize property path to be suitable for use - // as a class name. For exaple, content.foo.barBaz - // becomes bar-baz. - var parts = property.split('.'); - return Ember.String.dasherize(parts[parts.length-1]); +Ember.Handlebars.registerHelper('yield', function(options) { + var view = options.data.view, template; - // If the value is not NO, undefined, or null, return the current - // value of the property. - } else if (val !== NO && val !== undefined && val !== null) { - return val; + while (view && !get(view, 'layout')) { + view = get(view, 'parentView'); + } - // Nothing to display. Return null so that the old class is removed - // but no new class is added. - } else { - return null; - } - }; + ember_assert("You called yield in a template that was not a layout", !!view); - // For each property passed, loop through and setup - // an observer. - classBindings.split(' ').forEach(function(binding) { + template = get(view, 'template'); - // Variable in which the old class value is saved. The observer function - // closes over this variable, so it knows which string to remove when - // the property changes. - var oldClass; + ember_assert("You called yield on " + view.toString() + " without supplying a template", !!template); + template(this, options); +}); - var observer, invoker; +})({}); - // Set up an observer on the context. If the property changes, toggle the - // class name. - /** @private */ - observer = function() { - // Get the current value of the property - newClass = classStringForProperty(binding); - elem = bindAttrId ? view.$("[data-bindAttr-" + bindAttrId + "='" + bindAttrId + "']") : view.$(); +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== - // If we can't find the element anymore, a parent template has been - // re-rendered and we've been nuked. Remove the observer. - if (elem.length === 0) { - Ember.removeObserver(context, binding, invoker); - } else { - // If we had previously added a class to the element, remove it. - if (oldClass) { - elem.removeClass(oldClass); - } +})({}); - // If necessary, add a new class. Make sure we keep track of it so - // it can be removed in the future. - if (newClass) { - elem.addClass(newClass); - oldClass = newClass; - } else { - oldClass = null; - } - } - }; +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== - /** @private */ - invoker = function() { - Ember.run.once(observer); - }; +})({}); + +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var set = Ember.set, get = Ember.get; + +// TODO: Be explicit in the class documentation that you +// *MUST* set the value of a checkbox through Ember. +// Updating the value of a checkbox directly via jQuery objects +// will not work. - property = binding.split(':')[0]; - Ember.addObserver(context, property, invoker); +Ember.Checkbox = Ember.View.extend({ + title: null, + value: false, + disabled: false, - // We've already setup the observer; now we just need to figure out the - // correct behavior right now on the first pass through. - value = classStringForProperty(binding); + classNames: ['ember-checkbox'], - if (value) { - ret.push(value); + defaultTemplate: Ember.Handlebars.compile(''), - // Make sure we save the current value so that it can be removed if the - // observer fires. - oldClass = value; - } - }); + change: function() { + Ember.run.once(this, this._updateElementValue); + // returning false will cause IE to not change checkbox state + }, - return ret; -}; + _updateElementValue: function() { + var input = this.$('input:checkbox'); + set(this, 'value', input.prop('checked')); + } +}); })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals Handlebars ember_assert */ - -// TODO: Don't require the entire module var get = Ember.get, set = Ember.set; -var PARENT_VIEW_PATH = /^parentView\./; - -/** @private */ -Ember.Handlebars.ViewHelper = Ember.Object.create({ - - viewClassFromHTMLOptions: function(viewClass, options, thisContext) { - var extensions = {}, - classes = options['class'], - dup = false; - if (options.id) { - extensions.elementId = options.id; - dup = true; - } +/** @class */ +Ember.TextSupport = Ember.Mixin.create( +/** @scope Ember.TextSupport.prototype */ { - if (classes) { - classes = classes.split(' '); - extensions.classNames = classes; - dup = true; - } + value: "", - if (options.classBinding) { - extensions.classNameBindings = options.classBinding.split(' '); - dup = true; - } + attributeBindings: ['placeholder', 'disabled', 'maxlength'], + placeholder: null, + disabled: false, + maxlength: null, - if (dup) { - options = jQuery.extend({}, options); - delete options.id; - delete options['class']; - delete options.classBinding; - } + insertNewline: Ember.K, + cancel: Ember.K, - // Look for bindings passed to the helper and, if they are - // local, make them relative to the current context instead of the - // view. - var path; + focusOut: function(event) { + this._elementValueDidChange(); + }, - for (var prop in options) { - if (!options.hasOwnProperty(prop)) { continue; } + change: function(event) { + this._elementValueDidChange(); + }, - // Test if the property ends in "Binding" - if (Ember.IS_BINDING.test(prop)) { - path = options[prop]; - if (!Ember.isGlobalPath(path)) { - if (path === 'this') { - options[prop] = 'bindingContext'; - } else { - options[prop] = 'bindingContext.'+path; - } - } - } - } + keyUp: function(event) { + this.interpretKeyEvents(event); + }, - // Make the current template context available to the view - // for the bindings set up above. - extensions.bindingContext = thisContext; + /** + @private + */ + interpretKeyEvents: function(event) { + var map = Ember.TextSupport.KEY_EVENTS; + var method = map[event.keyCode]; - return viewClass.extend(options, extensions); + this._elementValueDidChange(); + if (method) { return this[method](event); } }, - helper: function(thisContext, path, options) { - var inverse = options.inverse, - data = options.data, - view = data.view, - fn = options.fn, - hash = options.hash, - newView; - - if ('string' === typeof path) { - newView = Ember.Handlebars.getPath(thisContext, path); - ember_assert("Unable to find view at path '" + path + "'", !!newView); - } else { - newView = path; - } + _elementValueDidChange: function() { + set(this, 'value', this.$().val()); + } - ember_assert(Ember.String.fmt('You must pass a view class to the #view helper, not %@ (%@)', [path, newView]), Ember.View.detect(newView)); +}); - newView = this.viewClassFromHTMLOptions(newView, hash, thisContext); - var currentView = data.view; - var viewOptions = {}; +Ember.TextSupport.KEY_EVENTS = { + 13: 'insertNewline', + 27: 'cancel' +}; - if (fn) { - ember_assert("You cannot provide a template block if you also specified a templateName", !get(viewOptions, 'templateName') && !newView.PrototypeMixin.keys().indexOf('templateName') >= 0); - viewOptions.template = fn; - } +})({}); - currentView.appendChild(newView, viewOptions); - } -}); +(function(exports) { +// ========================================================================== +// Project: Ember Handlebar Views +// Copyright: ©2011 Strobe Inc. and contributors. +// License: Licensed under MIT license (see license.js) +// ========================================================================== +var get = Ember.get, set = Ember.set; /** - @name Handlebars.helpers.view - @param {String} path - @param {Hash} options - @returns {String} HTML string + @class + @extends Ember.TextSupport */ -Ember.Handlebars.registerHelper('view', function(path, options) { - ember_assert("The view helper only takes a single argument", arguments.length <= 2); +Ember.TextField = Ember.View.extend(Ember.TextSupport, + /** @scope Ember.TextField.prototype */ { - // If no path is provided, treat path param as options. - if (path && path.data && path.data.isRenderData) { - options = path; - path = "Ember.View"; - } + classNames: ['ember-text-field'], - return Ember.Handlebars.ViewHelper.helper(this, path, options); + tagName: "input", + attributeBindings: ['type', 'value', 'size'], + type: "text", + size: null }); - })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals Handlebars ember_assert */ +var get = Ember.get, set = Ember.set; -// TODO: Don't require all of this module -var get = Ember.get, getPath = Ember.Handlebars.getPath, fmt = Ember.String.fmt; +Ember.Button = Ember.View.extend(Ember.TargetActionSupport, { + classNames: ['ember-button'], + classNameBindings: ['isActive'], -/** - @name Handlebars.helpers.collection - @param {String} path - @param {Hash} options - @returns {String} HTML string -*/ -Ember.Handlebars.registerHelper('collection', function(path, options) { - // If no path is provided, treat path param as options. - if (path && path.data && path.data.isRenderData) { - options = path; - path = undefined; - ember_assert("You cannot pass more than one argument to the collection helper", arguments.length === 1); - } else { - ember_assert("You cannot pass more than one argument to the collection helper", arguments.length === 2); - } + tagName: 'button', - var fn = options.fn; - var data = options.data; - var inverse = options.inverse; + propagateEvents: false, - // If passed a path string, convert that into an object. - // Otherwise, just default to the standard class. - var collectionClass; - collectionClass = path ? getPath(this, path) : Ember.CollectionView; - ember_assert(fmt("%@ #collection: Could not find %@", data.view, path), !!collectionClass); + attributeBindings: ['type', 'disabled', 'href'], - var hash = options.hash, itemHash = {}, match; + // Defaults to 'button' if tagName is 'input' or 'button' + type: Ember.computed(function(key, value) { + var tagName = this.get('tagName'); + if (value !== undefined) { this._type = value; } + if (this._type !== undefined) { return this._type; } + if (tagName === 'input' || tagName === 'button') { return 'button'; } + }).property('tagName').cacheable(), - // Extract item view class if provided else default to the standard class - var itemViewClass, itemViewPath = hash.itemViewClass; - var collectionPrototype = get(collectionClass, 'proto'); - delete hash.itemViewClass; - itemViewClass = itemViewPath ? getPath(collectionPrototype, itemViewPath) : collectionPrototype.itemViewClass; - ember_assert(fmt("%@ #collection: Could not find %@", data.view, itemViewPath), !!itemViewClass); + disabled: false, - // Go through options passed to the {{collection}} helper and extract options - // that configure item views instead of the collection itself. - for (var prop in hash) { - if (hash.hasOwnProperty(prop)) { - match = prop.match(/^item(.)(.*)$/); + // Allow 'a' tags to act like buttons + href: Ember.computed(function() { + return this.get('tagName') === 'a' ? '#' : null; + }).property('tagName').cacheable(), - if(match) { - // Convert itemShouldFoo -> shouldFoo - itemHash[match[1].toLowerCase() + match[2]] = hash[prop]; - // Delete from hash as this will end up getting passed to the - // {{view}} helper method. - delete hash[prop]; - } + mouseDown: function() { + if (!get(this, 'disabled')) { + set(this, 'isActive', true); + this._mouseDown = true; + this._mouseEntered = true; + } + return get(this, 'propagateEvents'); + }, + + mouseLeave: function() { + if (this._mouseDown) { + set(this, 'isActive', false); + this._mouseEntered = false; + } + }, + + mouseEnter: function() { + if (this._mouseDown) { + set(this, 'isActive', true); + this._mouseEntered = true; + } + }, + + mouseUp: function(event) { + if (get(this, 'isActive')) { + // Actually invoke the button's target and action. + // This method comes from the Ember.TargetActionSupport mixin. + this.triggerAction(); + set(this, 'isActive', false); } - } - var tagName = hash.tagName || get(collectionClass, 'proto').tagName; + this._mouseDown = false; + this._mouseEntered = false; + return get(this, 'propagateEvents'); + }, - if (fn) { - itemHash.template = fn; - delete options.fn; - } + keyDown: function(event) { + // Handle space or enter + if (event.keyCode === 13 || event.keyCode === 32) { + this.mouseDown(); + } + }, - if (inverse && inverse !== Handlebars.VM.noop) { - hash.emptyView = Ember.View.extend({ - template: inverse, - tagName: itemHash.tagName - }); - } + keyUp: function(event) { + // Handle space or enter + if (event.keyCode === 13 || event.keyCode === 32) { + this.mouseUp(); + } + }, - if (hash.preserveContext) { - itemHash.templateContext = Ember.computed(function() { - return get(this, 'content'); - }).property('content'); - delete hash.preserveContext; - } + // TODO: Handle proper touch behavior. Including should make inactive when + // finger moves more than 20x outside of the edge of the button (vs mouse + // which goes inactive as soon as mouse goes out of edges.) - hash.itemViewClass = Ember.Handlebars.ViewHelper.viewClassFromHTMLOptions(itemViewClass, itemHash); + touchStart: function(touch) { + return this.mouseDown(touch); + }, - return Ember.Handlebars.helpers.view.call(this, collectionClass, options); + touchEnd: function(touch) { + return this.mouseUp(touch); + } }); - - - })({}); - (function(exports) { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== -/*globals Handlebars */ -var getPath = Ember.Handlebars.getPath; +var get = Ember.get, set = Ember.set; /** - `unbound` allows you to output a property without binding. *Important:* The - output will not be updated if the property changes. Use with caution. + @class + @extends Ember.TextSupport +*/ +Ember.TextArea = Ember.View.extend(Ember.TextSupport, +/** @scope Ember.TextArea.prototype */ { -
{{unbound somePropertyThatDoesntChange}}
+ classNames: ['ember-text-area'], - @name Handlebars.helpers.unbound - @param {String} property - @returns {String} HTML string -*/ -Ember.Handlebars.registerHelper('unbound', function(property, fn) { - var context = (fn.contexts && fn.contexts[0]) || this; - return getPath(context, property); -}); + tagName: "textarea", + attributeBindings: ['rows', 'cols'], + rows: null, + cols: null, -})({}); + /** + @private + */ + didInsertElement: function() { + this._updateElementValue(); + }, + _updateElementValue: Ember.observer(function() { + this.$().val(get(this, 'value')); + }, 'value') -(function(exports) { -// ========================================================================== -// Project: Ember Handlebar Views -// Copyright: ©2011 Strobe Inc. and contributors. -// License: Licensed under MIT license (see license.js) -// ========================================================================== -/*globals Handlebars */ -var getPath = Ember.getPath; +}); -/** - `log` allows you to output the value of a value in the current rendering - context. +})({}); - {{log myVariable}} +(function(exports) { +Ember.TabContainerView = Ember.View.extend(); - @name Handlebars.helpers.log - @param {String} property -*/ -Ember.Handlebars.registerHelper('log', function(property, fn) { - var context = (fn.contexts && fn.contexts[0]) || this; - Ember.Logger.log(getPath(context, property)); -}); +})({}); -/** - The `debugger` helper executes the `debugger` statement in the current - context. +(function(exports) { +var get = Ember.get, getPath = Ember.getPath; - {{debugger}} +Ember.TabPaneView = Ember.View.extend({ + tabsContainer: Ember.computed(function() { + return this.nearestInstanceOf(Ember.TabContainerView); + }).property(), - @name Handlebars.helpers.debugger - @param {String} property -*/ -Ember.Handlebars.registerHelper('debugger', function() { - debugger; + isVisible: Ember.computed(function() { + return get(this, 'viewName') === getPath(this, 'tabsContainer.currentView'); + }).property('tabsContainer.currentView') }); })({}); - (function(exports) { -Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember.Metamorph, { - itemViewClass: Ember.View.extend(Ember.Metamorph) -}); +var get = Ember.get, setPath = Ember.setPath; -Ember.Handlebars.registerHelper('each', function(path, options) { - options.hash.contentBinding = path; - options.hash.preserveContext = true; - return Ember.Handlebars.helpers.collection.call(this, 'Ember.Handlebars.EachView', options); +Ember.TabView = Ember.View.extend({ + tabsContainer: Ember.computed(function() { + return this.nearestInstanceOf(Ember.TabContainerView); + }).property(), + + mouseUp: function() { + setPath(this, 'tabsContainer.currentView', get(this, 'value')); + } }); })({}); +(function(exports) { + +})({}); (function(exports) { -/** - `template` allows you to render a template from inside another template. - This allows you to re-use the same template in multiple places. For example: +/*jshint eqeqeq:false */ - +var set = Ember.set, get = Ember.get, getPath = Ember.getPath; +var indexOf = Ember.ArrayUtils.indexOf; - +Ember.Select = Ember.View.extend({ + tagName: 'select', + template: Ember.Handlebars.compile( + '{{#if prompt}}{{/if}}' + + '{{#each content}}{{view Ember.SelectOption contentBinding="this"}}{{/each}}' + ), - This helper looks for templates in the global Ember.TEMPLATES hash. If you - add