UNPKG

todomvc

Version:

> Helping you select an MV\* framework

1,544 lines (1,256 loc) 1.52 MB
/*! * @overview Ember - JavaScript Application Framework * @copyright Copyright 2011-2014 Tilde Inc. and contributors * Portions Copyright 2006-2011 Strobe Inc. * Portions Copyright 2008-2011 Apple Inc. All rights reserved. * @license Licensed under MIT license * See https://raw.github.com/emberjs/ember.js/master/LICENSE * @version 1.6.1 */ (function() { var define, requireModule, require, requirejs, Ember; (function() { Ember = this.Ember = this.Ember || {}; if (typeof Ember === 'undefined') { Ember = {} }; if (typeof Ember.__loader === 'undefined') { var registry = {}, seen = {}; define = function(name, deps, callback) { registry[name] = { deps: deps, callback: callback }; }; requirejs = require = requireModule = function(name) { if (seen.hasOwnProperty(name)) { return seen[name]; } seen[name] = {}; if (!registry[name]) { throw new Error("Could not find module " + name); } var mod = registry[name], deps = mod.deps, callback = mod.callback, reified = [], exports; for (var i=0, l=deps.length; i<l; i++) { if (deps[i] === 'exports') { reified.push(exports = {}); } else { reified.push(requireModule(resolve(deps[i]))); } } var value = callback.apply(this, reified); return seen[name] = exports || value; function resolve(child) { if (child.charAt(0) !== '.') { return child; } var parts = child.split("/"); var parentBase = name.split("/").slice(0, -1); for (var i=0, l=parts.length; i<l; i++) { var part = parts[i]; if (part === '..') { parentBase.pop(); } else if (part === '.') { continue; } else { parentBase.push(part); } } return parentBase.join("/"); } }; requirejs._eak_seen = registry; Ember.__loader = {define: define, require: require, registry: registry}; } else { define = Ember.__loader.define; requirejs = require = requireModule = Ember.__loader.require; } })(); (function() { define("ember-debug", ["ember-metal/core","ember-metal/error","ember-metal/logger"], function(__dependency1__, __dependency2__, __dependency3__) { "use strict"; /*global __fail__*/ var Ember = __dependency1__["default"]; var EmberError = __dependency2__["default"]; var Logger = __dependency3__["default"]; /** Ember Debug @module ember @submodule ember-debug */ /** @class Ember */ /** 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. Example: ```javascript // Test for truthiness Ember.assert('Must pass a valid object', obj); // Fail unconditionally Ember.assert('This code path should never be run'); ``` @method assert @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 be truthy for the assertion to pass. If falsy, an exception will be thrown. */ Ember.assert = function(desc, test) { if (!test) { throw new EmberError("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. @method warn @param {String} message A warning to display. @param {Boolean} test An optional boolean. If falsy, the warning will be displayed. */ Ember.warn = function(message, test) { if (!test) { Logger.warn("WARNING: "+message); if ('trace' in Logger) Logger.trace(); } }; /** Display a debug notice. Ember build tools will remove any calls to `Ember.debug()` when doing a production build. ```javascript Ember.debug('I\'m a debug notice!'); ``` @method debug @param {String} message A debug message to display. */ Ember.debug = function(message) { Logger.debug("DEBUG: "+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. @method deprecate @param {String} message A description of the deprecation. @param {Boolean} test An optional boolean. If falsy, the deprecation will be displayed. */ Ember.deprecate = function(message, test) { if (test) { return; } if (Ember.ENV.RAISE_ON_DEPRECATION) { throw new EmberError(message); } var error; // When using new Error, we can't do the arguments check for Chrome. Alternatives are welcome try { __fail__.fail(); } catch (e) { error = e; } if (Ember.LOG_STACKTRACE_ON_DEPRECATION && error.stack) { var stack, stackStr = ''; if (error['arguments']) { // Chrome stack = error.stack.replace(/^\s+at\s+/gm, ''). replace(/^([^\(]+?)([\n$])/gm, '{anonymous}($1)$2'). replace(/^Object.<anonymous>\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 "); message = message + stackStr; } Logger.warn("DEPRECATION: "+message); }; /** Alias an old, deprecated method with its new counterpart. Display a deprecation warning with the provided message and a stack trace (Chrome and Firefox only) when the assigned method is called. Ember build tools will not remove calls to `Ember.deprecateFunc()`, though no warnings will be shown in production. ```javascript Ember.oldMethod = Ember.deprecateFunc('Please use the new, updated method', Ember.newMethod); ``` @method deprecateFunc @param {String} message A description of the deprecation. @param {Function} func The new function called to replace its deprecated counterpart. @return {Function} a new function that wrapped the original function with a deprecation warning */ Ember.deprecateFunc = function(message, func) { return function() { Ember.deprecate(message); return func.apply(this, arguments); }; }; /** Run a function meant for debugging. Ember build tools will remove any calls to `Ember.runInDebug()` when doing a production build. ```javascript Ember.runInDebug(function() { Ember.Handlebars.EachView.reopen({ didInsertElement: function() { console.log('I\'m happy'); } }); }); ``` @method runInDebug @param {Function} func The function to be executed. @since 1.5.0 */ Ember.runInDebug = function(func) { func() }; // Inform the developer about the Ember Inspector if not installed. if (!Ember.testing) { var isFirefox = typeof InstallTrigger !== 'undefined'; var isChrome = !!window.chrome && !window.opera; if (typeof window !== 'undefined' && (isFirefox || isChrome) && window.addEventListener) { window.addEventListener("load", function() { if (document.documentElement && document.documentElement.dataset && !document.documentElement.dataset.emberExtension) { var downloadURL; if(isChrome) { downloadURL = 'https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi'; } else if(isFirefox) { downloadURL = 'https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/'; } Ember.debug('For more advanced debugging, install the Ember Inspector from ' + downloadURL); } }, false); } } }); })(); (function() { define("ember-metal/array", ["exports"], function(__exports__) { "use strict"; /*jshint newcap:false*/ /** @module ember-metal */ var ArrayPrototype = Array.prototype; // 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 to use native functions // if available, but not to use versions created by libraries like Prototype 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; }; // From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map var map = isNativeFunc(ArrayPrototype.map) ? ArrayPrototype.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 var forEach = isNativeFunc(ArrayPrototype.forEach) ? ArrayPrototype.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); } } }; var indexOf = isNativeFunc(ArrayPrototype.indexOf) ? ArrayPrototype.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; }; var filter = isNativeFunc(ArrayPrototype.filter) ? ArrayPrototype.filter : function (fn, context) { var i, value, result = [], length = this.length; for (i = 0; i < length; i++) { if (this.hasOwnProperty(i)) { value = this[i]; if (fn.call(context, value, i, this)) { result.push(value); } } } return result; }; if (Ember.SHIM_ES5) { if (!ArrayPrototype.map) { ArrayPrototype.map = map; } if (!ArrayPrototype.forEach) { ArrayPrototype.forEach = forEach; } if (!ArrayPrototype.filter) { ArrayPrototype.filter = filter; } if (!ArrayPrototype.indexOf) { ArrayPrototype.indexOf = indexOf; } } /** Array polyfills to support ES5 features in older browsers. @namespace Ember @property ArrayPolyfills */ __exports__.map = map; __exports__.forEach = forEach; __exports__.filter = filter; __exports__.indexOf = indexOf; }); define("ember-metal/binding", ["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/map","ember-metal/observer","ember-metal/run_loop","exports"], function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __exports__) { "use strict"; var Ember = __dependency1__["default"]; // Ember.Logger, Ember.LOG_BINDINGS, assert var get = __dependency2__.get; var set = __dependency3__.set; var trySet = __dependency3__.trySet; var guidFor = __dependency4__.guidFor; var Map = __dependency5__.Map; var addObserver = __dependency6__.addObserver; var removeObserver = __dependency6__.removeObserver; var _suspendObserver = __dependency6__._suspendObserver; var run = __dependency7__["default"]; // ES6TODO: where is Ember.lookup defined? /** @module ember-metal */ // .......................................................... // CONSTANTS // /** 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. @property LOG_BINDINGS @for Ember @type Boolean @default false */ Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; var IS_GLOBAL = /^([A-Z$]|([0-9][A-Z$]))/; /** Returns true if the provided path is global (e.g., `MyApp.fooController.bar`) instead of local (`foo.bar.baz`). @method isGlobalPath @for Ember @private @param {String} path @return Boolean */ function isGlobalPath(path) { return IS_GLOBAL.test(path); }; function getWithGlobals(obj, path) { return get(isGlobalPath(path) ? Ember.lookup : obj, path); } // .......................................................... // BINDING // var Binding = function(toPath, fromPath) { this._direction = 'fwd'; this._from = fromPath; this._to = toPath; this._directionMap = Map.create(); }; /** @class Binding @namespace Ember */ Binding.prototype = { /** This copies the Binding so it can be connected to another object. @method copy @return {Ember.Binding} `this` */ copy: function () { var copy = new Binding(this._to, this._from); if (this._oneWay) { copy._oneWay = true; } return copy; }, // .......................................................... // CONFIG // /** This will set `from` property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. 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 `get()` - see that method for more information. @method from @param {String} path the property path to connect to @return {Ember.Binding} `this` */ from: function(path) { this._from = path; return this; }, /** This will set the `to` property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. 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 `get()` - see that method for more information. @method to @param {String|Tuple} path A property path or tuple @return {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. @method oneWay @return {Ember.Binding} `this` */ oneWay: function() { this._oneWay = true; return this; }, /** @method toString @return {String} string representation of binding */ toString: function() { var oneWay = this._oneWay ? '[oneWay]' : ''; return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; }, // .......................................................... // CONNECT AND SYNC // /** 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. @method connect @param {Object} obj The root object for this binding. @return {Ember.Binding} `this` */ connect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.connect()', !!obj); var fromPath = this._from, toPath = this._to; trySet(obj, toPath, getWithGlobals(obj, fromPath)); // add an observer on the object to be notified when the binding should be updated addObserver(obj, fromPath, this, this.fromDidChange); // if the binding is a two-way binding, also set up an observer on the target if (!this._oneWay) { addObserver(obj, toPath, this, this.toDidChange); } this._readyToSync = true; return this; }, /** Disconnects the binding instance. Changes will no longer be relayed. You will not usually need to call this method. @method disconnect @param {Object} obj The root object you passed when connecting the binding. @return {Ember.Binding} `this` */ disconnect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.disconnect()', !!obj); var twoWay = !this._oneWay; // remove an observer on the object so we're no longer notified of // changes that should update bindings. removeObserver(obj, this._from, this, this.fromDidChange); // if the binding is two-way, remove the observer from the target as well if (twoWay) { removeObserver(obj, this._to, this, this.toDidChange); } this._readyToSync = false; // disable scheduled syncs... return this; }, // .......................................................... // PRIVATE // /* called when the from side changes */ fromDidChange: function(target) { this._scheduleSync(target, 'fwd'); }, /* called when the to side changes */ toDidChange: function(target) { this._scheduleSync(target, 'back'); }, _scheduleSync: function(obj, dir) { var directionMap = this._directionMap; var existingDir = directionMap.get(obj); // if we haven't scheduled the binding yet, schedule it if (!existingDir) { run.schedule('sync', this, this._sync, obj); directionMap.set(obj, dir); } // If both a 'back' and 'fwd' sync have been scheduled on the same object, // default to a 'fwd' sync so that it remains deterministic. if (existingDir === 'back' && dir === 'fwd') { directionMap.set(obj, 'fwd'); } }, _sync: function(obj) { var log = Ember.LOG_BINDINGS; // don't synchronize destroyed objects or disconnected bindings if (obj.isDestroyed || !this._readyToSync) { return; } // get the direction of the binding for the object we are // synchronizing from var directionMap = this._directionMap; var direction = directionMap.get(obj); var fromPath = this._from, toPath = this._to; directionMap.remove(obj); // if we're synchronizing from the remote object... if (direction === 'fwd') { var fromValue = getWithGlobals(obj, this._from); if (log) { Ember.Logger.log(' ', this.toString(), '->', fromValue, obj); } if (this._oneWay) { trySet(obj, toPath, fromValue); } else { _suspendObserver(obj, toPath, this, this.toDidChange, function () { trySet(obj, toPath, fromValue); }); } // if we're synchronizing *to* the remote object } else if (direction === 'back') { var toValue = get(obj, this._to); if (log) { Ember.Logger.log(' ', this.toString(), '<-', toValue, obj); } _suspendObserver(obj, fromPath, this, this.fromDidChange, function () { trySet(isGlobalPath(fromPath) ? Ember.lookup : obj, fromPath, toValue); }); } } }; function mixinProperties(to, from) { for (var key in from) { if (from.hasOwnProperty(key)) { to[key] = from[key]; } } } mixinProperties(Binding, { /* See `Ember.Binding.from`. @method from @static */ from: function() { var C = this, binding = new C(); return binding.from.apply(binding, arguments); }, /* See `Ember.Binding.to`. @method to @static */ to: function() { var C = this, binding = new C(); return binding.to.apply(binding, arguments); }, /** Creates a new Binding instance and makes it apply in a single direction. A one-way binding will relay changes on the `from` side object (supplied as the `from` argument) 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. See `Binding.oneWay`. @method oneWay @param {String} from from path. @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. @return {Ember.Binding} `this` */ oneWay: function(from, flag) { var C = this, binding = new C(null, from); return binding.oneWay(flag); } }); /** An `Ember.Binding` connects the properties of two objects so that whenever the value of one property changes, the other property will be changed also. ## Automatic Creation of Bindings with `/^*Binding/`-named Properties You do not usually create Binding objects directly but instead describe bindings in your class or object definition using automatic binding detection. Properties ending in a `Binding` suffix will be converted to `Ember.Binding` instances. The value of this property should be a string representing a path to another object or a custom binding instanced created using Binding helpers (see "One Way Bindings"): ``` valueBinding: "MyApp.someController.title" ``` 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. ## 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 Bindings Manually 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 instance. 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. 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. 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: ```javascript binding = Ember.Binding.from(this.valueBinding).to("value"); ``` 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: ```javascript binding.connect(this); ``` 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. Now that the binding is connected, it will observe both the from and to side and relay changes. 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): ```javascript Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value"); ``` Both of these code fragments have the same effect as doing the most friendly form of binding creation like so: ```javascript MyApp.anotherObject = Ember.Object.create({ valueBinding: "MyApp.someController.value", // OTHER CODE FOR THIS OBJECT... }); ``` 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 it works underneath. @class Binding @namespace Ember @since Ember 0.9 */ // Ember.Binding = Binding; ES6TODO: where to put this? /** 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. @method bind @for Ember @param {Object} obj The root object of the transform. @param {String} to The path to the 'to' side of the binding. Must be relative to obj. @param {String} from The path to the 'from' side of the binding. Must be relative to obj or a global path. @return {Ember.Binding} binding instance */ function bind(obj, to, from) { return new Binding(to, from).connect(obj); }; /** @method oneWay @for Ember @param {Object} obj The root object of the transform. @param {String} to The path to the 'to' side of the binding. Must be relative to obj. @param {String} from The path to the 'from' side of the binding. Must be relative to obj or a global path. @return {Ember.Binding} binding instance */ function oneWay(obj, to, from) { return new Binding(to, from).oneWay().connect(obj); }; __exports__.Binding = Binding; __exports__.bind = bind; __exports__.oneWay = oneWay; __exports__.isGlobalPath = isGlobalPath; }); define("ember-metal/chains", ["ember-metal/core","ember-metal/property_get","ember-metal/utils","ember-metal/array","ember-metal/watch_key","exports"], function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __exports__) { "use strict"; var Ember = __dependency1__["default"]; // warn, assert, etc; var get = __dependency2__.get; var normalizeTuple = __dependency2__.normalizeTuple; var meta = __dependency3__.meta; var META_KEY = __dependency3__.META_KEY; var forEach = __dependency4__.forEach; var watchKey = __dependency5__.watchKey; var unwatchKey = __dependency5__.unwatchKey; var metaFor = meta, warn = Ember.warn, FIRST_KEY = /^([^\.]+)/; function firstKey(path) { return path.match(FIRST_KEY)[0]; } var pendingQueue = []; // 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. function flushPendingChains() { if (pendingQueue.length === 0) { return; } // nothing to do var queue = pendingQueue; pendingQueue = []; forEach.call(queue, function(q) { q[0].add(q[1]); }); warn('Watching an undefined global, Ember expects watched globals to be setup by the time the run loop is flushed, check for typos', pendingQueue.length === 0); }; function addChainWatcher(obj, keyName, node) { if (!obj || ('object' !== typeof obj)) { return; } // nothing to do var m = metaFor(obj), nodes = m.chainWatchers; if (!m.hasOwnProperty('chainWatchers')) { nodes = m.chainWatchers = {}; } if (!nodes[keyName]) { nodes[keyName] = []; } nodes[keyName].push(node); watchKey(obj, keyName, m); } function removeChainWatcher(obj, keyName, node) { if (!obj || 'object' !== typeof obj) { return; } // nothing to do var m = obj[META_KEY]; if (m && !m.hasOwnProperty('chainWatchers')) { return; } // nothing to do var nodes = m && m.chainWatchers; if (nodes && nodes[keyName]) { nodes = nodes[keyName]; for (var i = 0, l = nodes.length; i < l; i++) { if (nodes[i] === node) { nodes.splice(i, 1); } } } unwatchKey(obj, keyName, m); }; // 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. function ChainNode(parent, key, value) { this._parent = parent; this._key = key; // _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; this._value = value; this._paths = {}; if (this._watching) { this._object = parent.value(); if (this._object) { addChainWatcher(this._object, this._key, this); } } // 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(); } }; var ChainNodePrototype = ChainNode.prototype; function lazyGet(obj, key) { if (!obj) return undefined; var meta = obj[META_KEY]; // check if object meant only to be a prototype if (meta && meta.proto === obj) return undefined; if (key === "@each") return get(obj, key); // if a CP only return cached value var desc = meta && meta.descs[key]; if (desc && desc._cacheable) { if (key in meta.cache) { return meta.cache[key]; } else { return undefined; } } return get(obj, key); } ChainNodePrototype.value = function() { if (this._value === undefined && this._watching) { var obj = this._parent.value(); this._value = lazyGet(obj, this._key); } return this._value; }; ChainNodePrototype.destroy = function() { if (this._watching) { var obj = this._object; if (obj) { removeChainWatcher(obj, this._key, this); } this._watching = false; // so future calls do nothing } }; // copies a top level object only ChainNodePrototype.copy = function(obj) { var ret = new ChainNode(null, null, obj), paths = this._paths, path; for (path in paths) { if (paths[path] <= 0) { continue; } // this check will also catch non-number vals. ret.add(path); } return ret; }; // called on the root node of a chain to setup watchers on the specified // path. ChainNodePrototype.add = function(path) { var obj, tuple, key, src, paths; paths = this._paths; paths[path] = (paths[path] || 0) + 1; obj = this.value(); tuple = normalizeTuple(obj, path); // the path was a local path if (tuple[0] && tuple[0] === obj) { path = tuple[1]; key = firstKey(path); path = path.slice(key.length+1); // 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; // global path, and object already exists } else { src = tuple[0]; key = path.slice(0, 0-(tuple[1].length+1)); path = tuple[1]; } tuple.length = 0; this.chain(key, path, src); }; // called on the root node of a chain to teardown watcher on the specified // path ChainNodePrototype.remove = function(path) { var obj, tuple, key, src, paths; paths = this._paths; if (paths[path] > 0) { paths[path]--; } 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]; } tuple.length = 0; this.unchain(key, path); }; ChainNodePrototype.count = 0; ChainNodePrototype.chain = function(key, path, src) { var chains = this._chains, node; if (!chains) { chains = this._chains = {}; } node = chains[key]; if (!node) { node = chains[key] = new ChainNode(this, key, src); } node.count++; // count chains... // 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... } }; ChainNodePrototype.unchain = function(key, path) { var chains = this._chains, node = chains[key]; // unchain rest of path first... if (path && path.length>1) { key = firstKey(path); path = path.slice(key.length+1); node.unchain(key, path); } // delete node if needed. node.count--; if (node.count<=0) { delete chains[node._key]; node.destroy(); } }; ChainNodePrototype.willChange = function(events) { var chains = this._chains; if (chains) { for(var key in chains) { if (!chains.hasOwnProperty(key)) { continue; } chains[key].willChange(events); } } if (this._parent) { this._parent.chainWillChange(this, this._key, 1, events); } }; ChainNodePrototype.chainWillChange = function(chain, path, depth, events) { if (this._key) { path = this._key + '.' + path; } if (this._parent) { this._parent.chainWillChange(this, path, depth+1, events); } else { if (depth > 1) { events.push(this.value(), path); } path = 'this.' + path; if (this._paths[path] > 0) { events.push(this.value(), path); } } }; ChainNodePrototype.chainDidChange = function(chain, path, depth, events) { if (this._key) { path = this._key + '.' + path; } if (this._parent) { this._parent.chainDidChange(this, path, depth+1, events); } else { if (depth > 1) { events.push(this.value(), path); } path = 'this.' + path; if (this._paths[path] > 0) { events.push(this.value(), path); } } }; ChainNodePrototype.didChange = function(events) { // 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(events); } } // if no events are passed in then we only care about the above wiring update if (events === null) { return; } // and finally tell parent about my path changing... if (this._parent) { this._parent.chainDidChange(this, this._key, 1, events); } }; function finishChains(obj) { // We only create meta if we really have to var m = obj[META_KEY], chains = m && m.chains; if (chains) { if (chains.value() !== obj) { metaFor(obj).chains = chains = chains.copy(obj); } else { chains.didChange(null); } } }; __exports__.flushPendingChains = flushPendingChains; __exports__.removeChainWatcher = removeChainWatcher; __exports__.ChainNode = ChainNode; __exports__.finishChains = finishChains; }); define("ember-metal/computed", ["ember-metal/core","ember-metal/property_get","ember-metal/property_set","ember-metal/utils","ember-metal/enumerable_utils","ember-metal/platform","ember-metal/watching","ember-metal/expand_properties","ember-metal/error","ember-metal/properties","ember-metal/property_events","ember-metal/is_empty","ember-metal/is_none","exports"], function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__, __dependency6__, __dependency7__, __dependency8__, __dependency9__, __dependency10__, __dependency11__, __dependency12__, __dependency13__, __exports__) { "use strict"; var Ember = __dependency1__["default"]; var get = __dependency2__.get; var set = __dependency3__.set; var meta = __dependency4__.meta; var META_KEY = __dependency4__.META_KEY; var guidFor = __dependency4__.guidFor; var typeOf = __dependency4__.typeOf; var inspect = __dependency4__.inspect; var EnumerableUtils = __dependency5__["default"]; var create = __dependency6__.create; var watch = __dependency7__.watch; var unwatch = __dependency7__.unwatch; var expandProperties = __dependency8__["default"]; var EmberError = __dependency9__["default"]; var Descriptor = __dependency10__.Descriptor; var defineProperty = __dependency10__.defineProperty; var propertyWillChange = __dependency11__.propertyWillChange; var propertyDidChange = __dependency11__.propertyDidChange; var isEmpty = __dependency12__["default"]; var isNone = __dependency13__.isNone; /** @module ember-metal */ Ember.warn("The CP_DEFAULT_CACHEABLE flag has been removed and computed properties are always cached by default. Use `volatile` if you don't want caching.", Ember.ENV.CP_DEFAULT_CACHEABLE !== false); var metaFor = meta, a_slice = [].slice, o_create = create; function UNDEFINED() { } var lengthPattern = /\.(length|\[\])$/; // .......................................................... // DEPENDENT KEYS // // data structure: // meta.deps = { // 'depKey': { // 'keyName': count, // } // } /* This function returns a map of unique dependencies for a given object and key. */ function keysForDep(depsMeta, depKey) { var keys = depsMeta[depKey]; if (!keys) { // if there are no dependencies yet for a the given key // create a new empty list of dependencies for the key keys = depsMeta[depKey] = {}; } else if (!depsMeta.hasOwnProperty(depKey)) { // otherwise if the dependency list is inherited from // a superclass, clone the hash keys = depsMeta[depKey] = o_create(keys); } return keys; } function metaForDeps(meta) { return keysForDep(meta, 'deps'); } function addDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) + 1; // Watch the depKey watch(obj, depKey, meta); } } function removeDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) - 1; // Watch the depKey unwatch(obj, depKey, meta); } } // .......................................................... // COMPUTED PROPERTY // /** A computed property transforms an objects function into a property. By default the function backing the computed property will only be called once and the result will be cached. You can specify various properties that your computed property is dependent on. This will force the cached result to be recomputed if the dependencies are modified. In the following example we declare a computed property (by calling `.property()` on the fullName function) and setup the properties dependencies (depending on firstName and lastName). The fullName function will be called once (regardless of how many times it is accessed) as long as it's dependencies have not been changed. Once firstName or lastName are updated any future calls (or anything bound) to fullName will incorporate the new values. ```javascript var Person = Ember.Object.extend({ // these will be supplied by `create` firstName: null, lastName: null, fullName: function() { var firstName = this.get('firstName'); var lastName = this.get('lastName'); return firstName + ' ' + lastName; }.property('firstName', 'lastName') }); var tom = Person.create({ firstName: 'Tom', lastName: 'Dale' }); tom.get('fullName') // 'Tom Dale' ``` You can also define what Ember should do when setting a computed property. If you try to set a computed property, it will be invoked with the key and value you want to set it to. You can also accept the previous value as the third parameter. ```javascript var Person = Ember.Object.extend({ // these will be supplied by `create` firstName: null, lastName: null, fullName: function(key, value, oldValue) { // getter if (arguments.length === 1) { var firstName = this.get('firstName'); var lastName = this.get('lastName'); return firstName + ' ' + lastName; // setter } else { var name = value.split(' '); this.set('firstName', name[0]); this.set('lastName', name[1]); return value; } }.property('firstName', 'lastName') }); var person = Person.create(); person.set('fullName', 'Peter Wagenet'); person.get('firstName'); // 'Peter' person.get('lastName'); // 'Wagenet' ``` @class ComputedProperty @namespace Ember @extends Ember.Descriptor @constructor */ function ComputedProperty(func, opts) { func.__ember_arity__ = func.length; this.func = func; this._cacheable = (opts && opts.cacheable !== undefined) ? opts.cacheable : true; this._dependentKeys = opts && opts.dependentKeys; this._readOnly = opts && (opts.readOnly !== undefined || !!opts.readOnly) || false; } ComputedProperty.prototype = new Descriptor(); var ComputedPropertyPrototype = ComputedProperty.prototype; ComputedPropertyPrototype._dependentKeys = undefined; ComputedPropertyPrototype._suspended = undefined; ComputedPropertyPrototype._meta = undefined; /** Properties are cacheable by default. Computed property will automatically cache the return value of your function until one of the dependent keys changes. Call `volatile()` to set it into non-cached mode. When in this mode the computed property will not automatically cache the return value. However, if a property is properly observable, there is no reason to disable caching. @method cacheable @param {Boolean} aFlag optional set to `false` to disable caching @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.cacheable = function(aFlag) { this._cacheable = aFlag !== false; return this; }; /** Call on a computed property to set it into non-cached mode. When in this mode the computed property will not automatically cache the return value. ```javascript var outsideService = Ember.Object.extend({ value: function() { return OutsideService.getValue(); }.property().volatile() }).create(); ``` @method volatile @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.volatile = function() { return this.cacheable(false); }; /** Call on a computed property to set it into read-only mode. When in this mode the computed property will throw an error when set. ```javascript var Person = Ember.Object.extend({ guid: function() { return 'guid-guid-guid'; }.property().readOnly() }); var person = Person.create(); person.set('guid', 'new-guid'); // will throw an exception ``` @method readOnly @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.readOnly = function(readOnly) { this._readOnly = readOnly === undefined || !!readOnly; return this; }; /** Sets the dependent keys on this computed property. Pass any number of arguments containing key paths that this computed property depends on. ```javascript var President = Ember.Object.extend({ fullName: computed(function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember that this computed property depends on firstName // and lastName }).property('firstName', 'lastName') }); var president = President.create({ firstName: 'Barack', lastName: 'Obama', }); president.get('fullName'); // 'Barack Obama' ``` @method property @param {String} path* zero or more property paths @return {Ember.ComputedProperty} this @chainable */ ComputedPropertyPrototype.property = function() { var args; var addArg = function (property) { args.push(property); }; args = []; for (var i = 0, l = arguments.length; i < l; i++) { expandProperties(arguments[i], addArg); } this._dependentKeys = args; return this; }; /** In some cases, you may want