sudojs-rails 0.1.7 → 0.1.9

data/vendor/assets/javascripts/sudo-x.js

@@ -11,19 +11,36 @@ var sudo = {
 	//
 	// `namespace`
 	ext: {},
-	// ###_inherit_
+	// ###getPath
+	// Extract a value located at `path` relative to the passed in object
+	//
+	// `param` {String} `path`. The key in the form of a dot-delimited path.
+	// `param` {object} `obj`. An object literal to operate on.
+	//
+	// `returns` {*|undefined}. The value at keypath or undefined if not found.
+	getPath: function getPath(path, obj) {
+		var key, p;
+		p = path.split('.');
+		for (key; p.length && (key = p.shift());) {
+			if(!p.length) {
+				return obj[key];
+			} else {
+				obj = obj[key] || {};
+			}
+		}
+		return obj;
+	},
+	// ###inherit
 	// Inherit the prototype from a parent to a child.
 	// Set the childs constructor for subclasses of child.
-	// A _private_ method as subclasses of the library base classes will not 
+	// Subclasses of the library base classes will not 
 	// want to use this function in *most* use-cases. Why? User Sudo Class Objects
 	// possess their own constructors and any call back to a `superclass` constructor
 	// will generally be looking for the library Object's constructor.
 	//
 	// `param` {function} `parent`
 	// `param` {function} `child`
-	//
-	// `private`
-	_inherit_: function _inherit_(parent, child) {
+	inherit: function inherit(parent, child) {
 		child.prototype = Object.create(parent.prototype);
 		child.prototype.constructor = child;
 	},
@@ -34,13 +51,12 @@ var sudo = {
 	// `returns` {string}
 	makeMeASandwich: function makeMeASandwich() {return 'Okay.';},
 	// ###namespace
-	// Convenience method for assuring a Namespace is defined. Uses
-	// the optional `obj` arg with the Base objects `setPath` method.
+	// Method for assuring a Namespace is defined.
 	//
 	// `param` {string} `path`. The path that leads to a blank Object.
 	namespace: function namespace(path) {
-		if (!sudo.Base.prototype.getPath.call(this, path, window)) {
-			sudo.Base.prototype.setPath.call(this, path, {}, window);
+		if (!this.getPath(path, window)) {
+			this.setPath(path, {}, window);
 		}
 	},
 	// ###premier
@@ -48,39 +64,69 @@ var sudo = {
 	//
 	// `type` {Object}
 	premier: null,
-	// ####_uid_
+	// ###setPath
+	// Traverse the keypath and get each object 
+	// (or make blank ones) eventually setting the value 
+	// at the end of the path
+	//
+	// `param` {string} `path`. The path to traverse when setting a value.
+	// `param` {*} `value`. What to set.
+	// `param` {Object} `obj`. The object literal to operate on.
+	setPath: function setPath(path, value, obj) {
+		var p = path.split('.'), key;
+		for (key; p.length && (key = p.shift());) {
+			if(!p.length) {
+				obj[key] = value;
+			} else if (obj[key]) {
+				obj = obj[key];
+			} else {
+				obj = obj[key] = {};
+			}
+		}
+	},
+	// ####uid
 	// Some sudo Objects use a unique integer as a `tag` for identification.
 	// (Views for example). This ensures they are indeed unique.
-	//
-	// `private`
-	_uid_: 0,
-	// ####_unique_
+	uid: 0,
+	// ####unique
 	// An integer used as 'tags' by some sudo Objects as well
 	// as a unique string for views when needed
 	//
 	// `param` {string} prefix. Optional string identifier
-	// 
-	// `private`
-	_unique_: function _unique_(prefix) {
-		return prefix ? prefix + this._uid_++ : this._uid_++;
+	unique: function unique(prefix) {
+		return prefix ? prefix + this.uid++ : this.uid++;
+	},
+	// ###unsetPath
+	// Remove a key:value pair from this object's data store
+	// located at <path>
+	//
+	// `param` {String} `path`
+	// `param` {Object} `obj` The object to operate on.
+	unsetPath: function unsetPath(path, obj) {
+		var p = path.split('.'), key;
+		for (key; p.length && (key = p.shift());) {
+			if(!p.length) {
+				delete obj[key];
+			} else {
+				// this can fail if a faulty path is passed.
+				// using getPath beforehand can prevent that
+				obj = obj[key];
+			}
+		}
 	}
 };
 // ##Base Class Object
 //
-// All sudo.js objects inherit base
-//
-// `param` {Object} data. An optional data object for this instance.
+// All sudo.js objects inherit base, giving the ability
+// to utilize delegation, the `base` function and the 
+// `construct` convenience method.
 //
 // `constructor`
-sudo.Base = function(data) {
-	this._data_ = data || {};
+sudo.Base = function() {
 	// can delegate
-	this._delegates_ = [];
-	// may implement `observable`
-	this._callbacks_ = [];
-	this._changeRecords_ = [];
+	this.delegates = [];
 	// a beautiful and unique snowflake
-	this._uid_ = sudo._unique_();
+	this.uid = sudo.unique();
 };
 // ###addDelegate
 // Push an instance of a Class Object into this object's `_delegates_` list.
@@ -88,8 +134,8 @@ sudo.Base = function(data) {
 // `param` {Object} an instance of a sudo.delegates Class Object
 // `returns` {Object} `this`
 sudo.Base.prototype.addDelegate = function addDelegate(del) {
-	del._delegator_ = this;
-	this._delegates_.push(del);
+	del.delegator = this;
+	this.delegates.push(del);
 	return this;
 };
 // ###base
@@ -99,6 +145,7 @@ sudo.Base.prototype.addDelegate = function addDelegate(del) {
 // that the first match is not the function that called `base`.
 //
 // `params` {*} any other number of arguments to be passed to the looked up method
+// along with the initial method name
 sudo.Base.prototype.base = function base() {
 	var args = Array.prototype.slice.call(arguments),
 		name = args.shift(), 
@@ -127,28 +174,20 @@ sudo.Base.prototype.construct = function construct() {
 // 1. if `meth` is falsy return the delegate.
 // 2 if `meth` is truthy bind its method (to the delegate) and return the method
 //
-// `param` {String} `role` The _role_ property to match in this object's delegates list
+// `param` {String} `role` The role property to match in this object's delegates list
 // `param` {String} `meth` Optional method to bind to the action this delegate is being used for
 // `returns`
 sudo.Base.prototype.delegate = function delegate(role, meth) {
-	var del = this._delegates_, i;
+	var del = this.delegates, i;
 	for(i = 0; i < del.length; i++) {
-		if(del[i]._role_ === role) {
+		if(del[i].role === role) {
 			if(!meth) return del[i];
 			return del[i][meth].bind(del[i]);
 		}
 	}
 };
-// ###get
-// Returns the value associated with a key in this object's data store.
-//
-// `param` {String} `key`. The name of the key
-// `returns` {*}. The value associated with the key or false if not found.
-sudo.Base.prototype.get = function get(key) {
-	return this._data_[key];
-};
 // ###getDelegate
-// Fetch a delegate whose _role_ property matches the passed in argument.
+// Fetch a delegate whose role property matches the passed in argument.
 // Uses the `delegate` method in its 'single argument' form, included for 
 // API consistency
 //
@@ -157,24 +196,59 @@ sudo.Base.prototype.get = function get(key) {
 sudo.Base.prototype.getDelegate = function getDelegate(role) {
 	return this.delegate(role);
 };
-// ###getPath
-// Extract a value located at `path` relative to this objects data store
+// ###removeDelegate
+// From this objects `delegates` list remove the object (there should only ever be 1)
+// whose role matches the passed in argument
 //
-// `param` {String} `path`. The key in the form of a dot-delimited path.
-// `param` {boolean} `obj`. Optional override, forcing getPath to operate on the passed in `obj`
-// argument rather than the default data store owned by `this` Object.
-// `returns` {*|undefined}. The value at keypath or undefined if not found.
-sudo.Base.prototype.getPath = function getPath(path, obj) {
-	var key, curr = obj || this._data_, p;
-	p = path.split('.');
-	for (key; p.length && (key = p.shift());) {
-		if(!p.length) {
-			return curr[key];
-		} else {
-			curr = curr[key] || {};
+// `param` {String} `role`
+// `returns` {Object} `this`
+sudo.Base.prototype.removeDelegate = function removeDelegate(role) {
+	var del = this.delegates, i;
+	for(i = 0; i < del.length; i++) {
+		if(del[i].role === role) {
+			// no _delegator_ for you
+			del[i].delegator = void 0;
+			del.splice(i, 1);
+			return this;
 		}
 	}
-	return curr;
+	return this;
+};
+// `private`
+sudo.Base.prototype.role = 'base';
+// ##Model Class Object
+//
+// Model Objects expose methods for setting and getting data, and
+// can be observed if implementing the `Observable Extension`
+//
+// `param` {object} data. An initial state for this model.
+//
+// `constructor`
+sudo.Model = function(data) {
+  this.data = data || {};
+  // only models are `observable`
+	this.callbacks = [];
+	this.changeRecords = [];
+};
+// Model inherits from sudo.Base
+// `private`
+sudo.inherit(sudo.Base, sudo.Model);
+// ###get
+// Returns the value associated with a key.
+//
+// `param` {String} `key`. The name of the key
+// `returns` {*}. The value associated with the key or false if not found.
+sudo.Model.prototype.get = function get(key) {
+	return this.data[key];
+};
+// ###getPath
+//
+// Uses the sudo namespace's getpath function operating on the model's
+// data hash.
+//
+// `returns` {*|undefined}. The value at keypath or undefined if not found.
+sudo.Model.prototype.getPath = function getPath(path) {
+	return sudo.getPath(path, this.data);
 };
 // ###gets
 // Assembles and returns an object of key:value pairs for each key
@@ -182,66 +256,38 @@ sudo.Base.prototype.getPath = function getPath(path, obj) {
 //
 // `param` {array} `ary`. An array of keys.
 // `returns` {object}
-sudo.Base.prototype.gets = function gets(ary) {
+sudo.Model.prototype.gets = function gets(ary) {
 	var i, obj = {};
 	for (i = 0; i < ary.length; i++) {
-		obj[ary[i]] = ary[i].indexOf('.') === -1 ? this._data_[ary[i]] :
+		obj[ary[i]] = ary[i].indexOf('.') === -1 ? this.data[ary[i]] :
 			this.getPath(ary[i]);
 	}
 	return obj;
 };
-// ###removeDelegate
-// From this objects `delegates` list remove the object (there should only ever be 1)
-// whose _role_ matches the passed in argument
-//
-// `param` {String} `role`
-// `returns` {Object} `this`
-sudo.Base.prototype.removeDelegate = function removeDelegate(role) {
-	var del = this._delegates_, i;
-	for(i = 0; i < del.length; i++) {
-		if(del[i]._role_ === role) {
-			// no _delegator_ for you
-			del[i]._delegator_ = void 0;
-			del.splice(i, 1);
-			return this;
-		}
-	}
-	return this;
-};
 // `private`
-sudo.Base.prototype._role_ = 'base';
+sudo.Model.prototype.role = 'model';
 // ###set
-// Set a key:value pair in `this` object's data store.
+// Set a key:value pair.
 //
 // `param` {String} `key`. The name of the key.
 // `param` {*} `value`. The value associated with the key.
 // `returns` {Object} `this`
-sudo.Base.prototype.set = function set(key, value) {
+sudo.Model.prototype.set = function set(key, value) {
 	// _NOTE: intentional possibilty of setting a falsy value_
-	this._data_[key] = value;
+	this.data[key] = value;
 	return this;
 };
 // ###setPath
-// Traverse the keypath and get each object 
-// (or make blank ones) eventually setting the value 
-// at the end of the path
 //
-// `param` {string} `path`. The path to traverse when setting a value.
-// `param` {*} `value`. What to set.
-// `param` {Object} `obj`. Optional flag to force setPath to operate on the passed object.
-// `returns` {Object} `this`
-sudo.Base.prototype.setPath = function setPath(path, value, obj) {
-	var curr = obj || this._data_, p = path.split('.'), key;
-	for (key; p.length && (key = p.shift());) {
-		if(!p.length) {
-			curr[key] = value;
-		} else if (curr[key]) {
-			curr = curr[key];
-		} else {
-			curr = curr[key] = {};
-		}
-	}
-	return this;
+// Uses the sudo namespace's setpath function operating on the model's
+// data hash.
+//
+// `param` {String} `path`
+// `param` {*} `value`
+// `returns` {Object} this.
+sudo.Model.prototype.setPath = function setPath(path, value) {
+	sudo.setPath(path, value, this.data);
+  return this;
 };
 // ###sets
 // Invokes `set()` or `setPath()` for each key value pair in `obj`.
@@ -249,7 +295,7 @@ sudo.Base.prototype.setPath = function setPath(path, value, obj) {
 //
 // `param` {Object} `obj`. The keys and values to set.
 // `returns` {Object} `this`
-sudo.Base.prototype.sets = function sets(obj) {
+sudo.Model.prototype.sets = function sets(obj) {
 	var i, k = Object.keys(obj);
 	for(i = 0; i < k.length; i++) {
 		k[i].indexOf('.') === -1 ? this.set(k[i], obj[k[i]]) :
@@ -262,35 +308,25 @@ sudo.Base.prototype.sets = function sets(obj) {
 //
 // `param` {String} key
 // `returns` {Object} `this`
-sudo.Base.prototype.unset = function unset(key) {
-	delete this._data_[key];
+sudo.Model.prototype.unset = function unset(key) {
+	delete this.data[key];
 	return this;
 };
 // ###unsetPath
-// Remove a key:value pair from this object's data store
-// located at <path>
+// Uses `sudo.unsetPath` operating on this models data hash
 //
 // `param` {String} path
 // `returns` {Object} `this`
-sudo.Base.prototype.unsetPath = function unsetPath(path) {
-	var curr = this._data_, p = path.split('.'), key;
-	for (key; p.length && (key = p.shift());) {
-		if(!p.length) {
-			delete curr[key];
-		} else {
-			// this can fail if a faulty path is passed.
-			// using getPath beforehand can prevent that
-			curr = curr[key];
-		}
-	}
-	return this;
+sudo.Model.prototype.unsetPath = function unsetPath(path) {
+  sudo.unsetPath(path, this.data);
+  return this;
 };
 // ###unsets
 // Deletes a number of keys or paths from this object's data store
 //
 // `param` {array} `ary`. An array of keys or paths.
 // `returns` {Objaect} `this`
-sudo.Base.prototype.unsets = function unsets(ary) {
+sudo.Model.prototype.unsets = function unsets(ary) {
 	var i;
 	for(i = 0; i < ary.length; i++) {
 		ary[i].indexOf('.') === -1 ? this.unset(ary[i]) :
@@ -304,13 +340,13 @@ sudo.Base.prototype.unsets = function unsets(ary) {
 // itself be contained
 //
 // `constructor`
-sudo.Container = function(data) {
-	sudo.Base.call(this, data);
-	this._children_ = [];
-	this._childNames_ = {};
+sudo.Container = function() {
+	sudo.Base.call(this);
+	this.children = [];
+	this.childNames = {};
 };
-// `private`
-sudo._inherit_(sudo.Base, sudo.Container);
+// Container is a subclass of sudo.Base
+sudo.inherit(sudo.Base, sudo.Container);
 // ###addChild
 // Adds a View to this container's list of children.
 // Also adds an 'index' property and an entry in the childNames hash.
@@ -320,12 +356,12 @@ sudo._inherit_(sudo.Base, sudo.Container);
 // `param` {String} `name`. An optional name for the child that will go in the childNames hash.
 // `returns` {Object} `this`
 sudo.Container.prototype.addChild = function addChild(child, name) {
-	var c = this._children_;
-	child._parent_ = this;
-	child._index_ = c.length;
+	var c = this.children;
+	child.parent = this;
+	child.index = c.length;
 	if(name) {
-		child._name_ = name;
-		this._childNames_[name] = child._index_;
+		child.name = name;
+		this.childNames[name] = child.index;
 	}
 	c.push(child);
 	if('addedToParent' in child) child.addedToParent(this);
@@ -335,7 +371,7 @@ sudo.Container.prototype.addChild = function addChild(child, name) {
 // By default, `bubble` returns the current view's parent (if it has one)
 //
 // `returns` {Object|undefined}
-sudo.Container.prototype.bubble = function bubble() {return this._parent_;};
+sudo.Container.prototype.bubble = function bubble() {return this.parent;};
 // ###getChild
 // If a child was added with a name, via `addChild`,
 // that object can be fetched by name. This prevents us from having to reference a 
@@ -344,8 +380,8 @@ sudo.Container.prototype.bubble = function bubble() {return this._parent_;};
 // `param` {String|Number} `id`. The string `name` or numeric `index` of the child to fetch.
 // `returns` {Object|undefined} The found child
 sudo.Container.prototype.getChild = function getChild(id) {
-	return typeof id === 'string' ? this._children_[this._childNames_[id]] :
-		this._children_[id];
+	return typeof id === 'string' ? this.children[this.childNames[id]] :
+		this.children[id];
 };
 // ###_indexChildren_
 // Method is called with the `index` property of a subview that is being removed.
@@ -353,11 +389,11 @@ sudo.Container.prototype.getChild = function getChild(id) {
 // `param` {Number} `i`
 // `private`
 sudo.Container.prototype._indexChildren_ = function _indexChildren_(i) {
-	var c = this._children_, obj = this._childNames_, len;
+	var c = this.children, obj = this.childNames, len;
 	for (len = c.length; i < len; i++) {
-		c[i]._index_--;
+		c[i].index--;
 		// adjust any entries in childNames
-		if(c[i]._name_ in obj) obj[c[i]._name_] = c[i]._index_; 
+		if(c[i].name in obj) obj[c[i].name] = c[i].index; 
 	}
 };
 // ###removeChild
@@ -370,28 +406,19 @@ sudo.Container.prototype._indexChildren_ = function _indexChildren_(i) {
 // An object will be assumed to be an actual sudo Class Object.
 // `returns` {Object} `this`
 sudo.Container.prototype.removeChild = function removeChild(arg) {
-	var t = typeof arg, c;
-	// passed an object (or an array - which will fail so don't do that), proceed
-	if(t === 'object') this._removeChild_(arg); 
-	else {
-		c = t === 'string' ? this._children_[this._childNames_[arg]] : this._children_[arg];
-		this._removeChild_(c);
-	}
-	return this;
-};
-// ###_removeChild_
-// Helper method for 'public' removeChild
-// `param` {Object} `child`. The view that is going to be removed.
-// `private`
-sudo.Container.prototype._removeChild_ = function _removeChild_(child) {
-	var i = child._index_;
+	var i, t = typeof arg, c;
+	// normalize the input
+	if(t === 'object') c = arg; 
+	else c = t === 'string' ? this.children[this.childNames[arg]] : this.children[arg];
+	i = c.index;
 	// remove from the children Array
-	this._children_.splice(i, 1);
+	this.children.splice(i, 1);
 	// remove from the named child hash if present
-	delete this._childNames_[child._name_];
+	delete this.childNames[c.name];
 	// child is now an `orphan`
-	delete child._parent_;
+	delete c.parent;
 	this._indexChildren_(i);
+	return this;
 };
 // ###removeFromParent
 // Remove this object from its parents list of children.
@@ -399,10 +426,10 @@ sudo.Container.prototype._removeChild_ = function _removeChild_(child) {
 // or chaining method calls
 sudo.Container.prototype.removeFromParent = function removeFromParent() {
 	// will error without a parent, but that would be your fault...
-	this._parent_._removeChild_(this);
+	this.parent.removeChild(this);
 	return this;
 };
-sudo.Container.prototype._role_ = 'container';
+sudo.Container.prototype.role = 'container';
 // ###send
 // The call to the specific method on a (un)specified target happens here.
 // If this Object is part of a `sudo.ext.container` maintained hierarchy
@@ -414,14 +441,14 @@ sudo.Container.prototype._role_ = 'container';
 // A sendMethod will be located by:
 //   1. using the first argument if it is a string
 //   2. looking for a `sendMethod` property if it is an object
-// In the case a specified target exists at `this.get('sendTarget')` it will be used
+// In the case a specified target exists at `this.model.get('sendTarget')` it will be used
 // Any other args will be passed to the sendMethod after `this`
 // `returns` {Object} `this`
 sudo.Container.prototype.send = function send(/*args*/) {
 	var args = Array.prototype.slice.call(arguments),
-		meth, targ, fn;
+		d = this.model && this.model.data, meth, targ, fn;
 	// normalize the input, common use cases first
-	if('sendMethod' in this._data_) meth = this._data_.sendMethod;
+	if(d && 'sendMethod' in d) meth = d.sendMethod;
 	else if(typeof args[0] === 'string') meth = args.shift();
 	// less common but viable options
 	if(!meth) {
@@ -431,7 +458,7 @@ sudo.Container.prototype.send = function send(/*args*/) {
 			args[0].sendMethod || void 0;
 	}
 	// target is either specified or my parent
-	targ = this._data_['sendTarget'] || this._parent_;
+	targ = d && d.sendTarget || this.parent;
 	// obvious chance for errors here, don't be dumb
 	fn = targ[meth];
 	while(!fn && (targ = targ.bubble())) {
@@ -459,17 +486,19 @@ sudo.Container.prototype.send = function send(/*args*/) {
 // a shortcut for `this.$el.find(selector)`
 //
 // `param` {string|element|jQuery} `el`. Otional el for the View instance.
-// `param` {Object} `data`. Optional data object.
+// `param` {Object} `data`. Optional data object which becomes the initial state
+// of a new model located at `this.model`.
 //
 // `constructor`
 sudo.View = function(el, data) {
-	sudo.Container.call(this, data);
+	sudo.Container.call(this);
+	if(data) this.model = new sudo.Model(data);
 	this.setEl(el);
-	if(this._role_ === 'view') this.init();
+	if(this.role === 'view') this.init();
 };
 // View inherits from Container
 // `private`
-sudo._inherit_(sudo.Container, sudo.View);
+sudo.inherit(sudo.Container, sudo.View);
 // ###becomePremier
 // Premier functionality provides hooks for behavioral differentiation
 // among elements or class objects.
@@ -477,11 +506,11 @@ sudo._inherit_(sudo.Container, sudo.View);
 // `returns` {Object} `this`
 sudo.View.prototype.becomePremier = function becomePremier() {
 	var p, f = function() {
-			this._isPremier_ = true;
+			this.isPremier = true;
 			sudo.premier = this;
 		}.bind(this);
 	// is there an existing premier that isn't me?
-	if((p = sudo.premier) && p._uid_ !== this._uid_) {
+	if((p = sudo.premier) && p.uid !== this.uid) {
 		// ask it to resign and call the cb
 		p.resignPremier(f);
 	} else f(); // no existing premier
@@ -510,9 +539,9 @@ sudo.View.prototype._normalizedEl_ = function _normalizedEl_(el) {
 // `returns` {Object} `this`
 sudo.View.prototype.resignPremier = function resignPremier(cb) {
 	var p;
-	this._isPremier_ = false;
+	this.isPremier = false;
 	// only remove the global premier if it is me
-	if((p = sudo.premier) && p._uid_ === this._uid_) {
+	if((p = sudo.premier) && p.uid === this.uid) {
 		sudo.premier = null;
 	}
 	// fire the cb if passed
@@ -520,7 +549,7 @@ sudo.View.prototype.resignPremier = function resignPremier(cb) {
 	return this;
 };
 // `private`
-sudo.View.prototype._role_ = 'view';
+sudo.View.prototype.role = 'view';
 // ###setEl
 // A view must have an element, set that here.
 // Stores a jquerified object as `this.$el` the raw
@@ -529,12 +558,12 @@ sudo.View.prototype._role_ = 'view';
 // `param` {string=|element} `el`
 // `returns` {Object} `this`
 sudo.View.prototype.setEl = function setEl(el) {
-	var a, t;
+	var d = this.model && this.model.data, a, t;
 	if(!el) {
 		// normalize any relevant data
-		t = this._data_['tagName'] || 'div';
+		t = d ? d.tagName || 'div': 'div';
 		this.$el = $(document.createElement(t));
-		if((a = this._data_['attributes'])) this.$el.attr(a);
+		if(d && (a = d.attributes)) this.$el.attr(a);
 	} else {
 		this.$el = this._normalizedEl_(el);
 	}
@@ -587,14 +616,16 @@ sudo.ViewController = function(el, data) {
 		'ajax:aborted:file': 'onAjaxAbortedFile'
 	};
 	// can be called again if mapping changes... 
-	this.doMapping();
-	if('descriptor' in this._data_) this.instantiateChildren([this._data_.descriptor]);
-	if('descriptors' in this._data_) this.instantiateChildren();
-	if(this._role_ === 'viewController') this.init();
+	if(data) {
+		this.doMapping();
+		if('descriptor' in data) this.instantiateChildren([data.descriptor]);
+		else if('descriptors' in data) this.instantiateChildren();
+	}
+	if(this.role === 'viewController') this.init();
 };
 // ViewController inherits from View.
 // `private`
-sudo._inherit_(sudo.View, sudo.ViewController);
+sudo.inherit(sudo.View, sudo.ViewController);
 // ###doMapping
 //
 // assign the proxy mapping for events. This can be called at any time
@@ -604,12 +635,12 @@ sudo._inherit_(sudo.View, sudo.ViewController);
 sudo.ViewController.prototype.doMapping = function() {
 	// either a single event or an array of them
 	var i,
-		toMap = this._data_['ujsEvent'] || this._data_['ujsEvents'];
+		toMap = this.model.data.ujsEvent || this.model.data.ujsEvents;
 	if(toMap) {
-		if(typeof toMap === 'string') this._mapEvent(toMap);
+		if(typeof toMap === 'string') this._mapEvent_(toMap);
 		else {
 			for(i = 0; i < toMap.length; i++) {
-				this._mapEvent(toMap[i]);
+				this._mapEvent_(toMap[i]);
 			}
 		}
 	}
@@ -628,7 +659,7 @@ sudo.ViewController.prototype._handleObserve_ = function _handleObserve_(obs, c)
 //
 // `returns` {object} `this`
 sudo.ViewController.prototype.instantiateChildren = function instantiateChildren(ary) {
-	var i, j, curr, c, d = ary || this._data_.descriptors;
+	var i, j, curr, c, d = ary || this.model.data.descriptors;
 	for(i = 0; i < d.length; i++) {
 		curr = d[i]; 
 		c = new curr.is_a(curr.el, curr.data);
@@ -645,10 +676,10 @@ sudo.ViewController.prototype.instantiateChildren = function instantiateChildren
 	}
 	return this;
 };
-// ###_mapEvent
+// ###_mapEvent_
 // Maps the ajax:event names to methods
 // `private`
-sudo.ViewController.prototype._mapEvent = function(name) {
+sudo.ViewController.prototype._mapEvent_ = function _mapEvent_(name) {
 		// because the signatures vary we need specific methods
 		this.$el.on(name, this[this.eventMap[name]].bind(this));
 };
@@ -658,7 +689,7 @@ sudo.ViewController.prototype._mapEvent = function(name) {
 // when viewController's are instantiated.
 // `private`
 sudo.ViewController.prototype._objectForPath_ = function _objectForPath_(path) {
-	return sudo.Base.prototype.getPath.call(this, path, window);
+	return sudo.getPath(path, window);
 };
 // Virtual methods to override in your child classes for
 // any events you chose to listen for
@@ -670,7 +701,7 @@ sudo.ViewController.prototype.onAjaxComplete = $.noop;
 sudo.ViewController.prototype.onAjaxSuccess = $.noop;
 sudo.ViewController.prototype.onAjaxError = $.noop;
 // `private`
-sudo.ViewController.prototype._role_ = 'viewController';
+sudo.ViewController.prototype.role = 'viewController';
 // ###Templating
 
 // Allow the default {{ js code }}, {{= key }}, and {{- escape stuff }} 
@@ -789,26 +820,29 @@ sudo.template = function template(str, data, scope) {
 //
 //`constructor`
 sudo.Dataview = function(el, data) {
-	var d, t;
-	sudo.View.call(this, el, data);
+	var d = data || {}, t;
+	sudo.View.call(this, el, d);
 	// implements the listener extension
 	$.extend(this, sudo.ext.listener);
-	d = this._data_;
-	// dont autoRender on the setting of events
+	// dataview's models are observable
+	$.extend(this.model, sudo.ext.observable);
+	// dont autoRender on the setting of events,
 	// add to this to prevent others if needed
-	d.autoRenderBlacklist = {event: true, events: true};
+	this.autoRenderBlacklist = {event: true, events: true};
+	// if autorendering, observe your own model
+	// use this ref to unobserve if desired
+	if(d.autoRender) this.observer = this.model.observe(this.render.bind(this));
 	// compile my template if not already done
 	if((t = d.template)) {
-		if(typeof t === 'string') d.template = sudo.template(t);
+		if(typeof t === 'string') this.model.data.template = sudo.template(t);
 	}
-	if(this._role_ === 'dataview') {
-		// as all events are delegated to this.$el binding can take place here
+	if(this.role === 'dataview') {
 		this.bindEvents();
 		this.init();
 	}
 };
 // `private`
-sudo._inherit_(sudo.View, sudo.Dataview);
+sudo.inherit(sudo.View, sudo.Dataview);
 // ###addedToParent
 // Container's will check for the presence of this method and call it if it is present
 // after adding a child - essentially, this will auto render the dataview when added to a parent
@@ -821,7 +855,7 @@ sudo.Dataview.prototype.addedToParent = function() {
 //
 // `returns` {Object} `this`
 sudo.Dataview.prototype.removeFromParent = function removeFromParent() {
-	this._parent_._removeChild_(this);
+	this.parent.removeChild(this);
 	this.$el.remove();
 	return this;
 };
@@ -833,9 +867,13 @@ sudo.Dataview.prototype.removeFromParent = function removeFromParent() {
 // Event unbinding/rebinding is generally not necessary for the Objects innerHTML as all events from the
 // Object's list of events (`this.get('event(s)'))` are delegated to the $el on instantiation.
 //
+// `param` {object} `change` dataviews may be observing their model if `autoRender: true`
+//
 // `returns` {Object} `this`
-sudo.Dataview.prototype.render = function render() {
-	var d = this._data_;
+sudo.Dataview.prototype.render = function render(change) {
+	// return early if a `blacklisted` key is set to my model
+	if(change && this.autoRenderBlacklist[change.name]) return this;
+	var d = this.model.data;
 	this.$el.html(d.template(d));
 	if(d.renderTarget) {
 		this._normalizedEl_(d.renderTarget)[d.renderMethod || 'append'](this.$el);
@@ -844,48 +882,11 @@ sudo.Dataview.prototype.render = function render() {
 	return this;
 };
 // `private`
-sudo.Dataview.prototype._role_ = 'dataview';
-// ###set
-// Override `sudo.Base.set` to provide auto rendering if desired
-//
-// `returns` {Object|*} `this` or call to `render`
-sudo.Dataview.prototype.set = function set(key, value) {
-	this._data_[key] = value;
-	if(this._data_['autoRender'] && !this._data_.autoRenderBlacklist[key]) return this.render();
-	return this;
-};
-// ###setPath
-// Override `sudo.Base.setPath` to provide auto rendering if desired
-//
-// `returns` {Object|*} `this` or call to `render`
-sudo.Dataview.prototype.setPath = function setPath(path, value) {
-	sudo.Base.prototype.setPath.call(this, path, value);
-	// the blacklist has no paths
-	if(this._data_['autoRender']) return this.render();
-	return this;
-};
-// ###sets
-// Override `sudo.Base.sets` in case of autoRender.being true
-// Temporarily sets `autoRender` to false (if true) to avoid unnecessary
-// rendering, calling `render` when finished with all `set` type operations,
-// returning `autoRender` to true (if appropriate)
-//
-// `returns` {Object|*} `this` or call to `render`
-sudo.Dataview.prototype.sets = function sets(obj) {
-	var a;
-	if(this._data_['autoRender']) {
-		this._data_['autoRender'] = false;
-		a = true;
-	}	
-	sudo.Base.prototype.sets.call(this, obj);
-	if(a) {
-		this._data_['autoRender'] = true;
-		return this.render();
-	}
-	return this;
-};
+sudo.Dataview.prototype.role = 'dataview';
 // ## Observable Extension Object
-// Implementaion of the ES6 Harmony Observer pattern
+// Implementaion of the ES6 Harmony Observer pattern.
+// Extend a `sudo.Model` class with this object if
+// data-mutation-observation is required
 sudo.ext.observable = {
 	// ###_deliver_
 	// Called from deliverChangeRecords when ready to send
@@ -893,7 +894,7 @@ sudo.ext.observable = {
 	//
 	// `private`
 	_deliver_: function _deliver_(obj) {
-		var i, cb = this._callbacks_;
+		var i, cb = this.callbacks;
 		for(i = 0; i < cb.length; i++) {
 			cb[i](obj);
 		}
@@ -904,7 +905,7 @@ sudo.ext.observable = {
 	//
 	// `returns` {Object} `this`
 	deliverChangeRecords: function deliverChangeRecords() {
-		var rec, cr = this._changeRecords_;
+		var rec, cr = this.changeRecords;
 		// FIFO
 		for(rec; cr.length && (rec = cr.shift());) {
 			this._deliver_(rec);
@@ -929,7 +930,7 @@ sudo.ext.observable = {
 	observe: function observe(fn) {
 		// this will fail if mixed-in and no `callbacks` created so don't do that.
 		// Per the spec, do not allow the same callback to be added
-		var d = this._callbacks_;
+		var d = this.callbacks;
 		if(d.indexOf(fn) === -1) d.push(fn);
 		return fn;
 	},
@@ -955,16 +956,16 @@ sudo.ext.observable = {
 	//
 	// `returns` {Object|*} `this` or calls deliverChangeRecords
 	set: function set(key, value, hold) {
-		var obj = {name: key, object: this._data_};
+		var obj = {name: key, object: this.data};
 		// did this key exist already
-		if(key in this._data_) {
+		if(key in this.data) {
 			obj.type = 'updated';
 			// then there is an oldValue
-			obj.oldValue = this._data_[key];
+			obj.oldValue = this.data[key];
 		} else obj.type = 'new';
 		// now actually set the value
-		this._data_[key] = value;
-		this._changeRecords_.push(obj);
+		this.data[key] = value;
+		this.changeRecords.push(obj);
 		// call the observers or not
 		if(hold) return this;
 		return this.deliverChangeRecords();
@@ -973,7 +974,7 @@ sudo.ext.observable = {
 	// Overrides sudo.Base.setPath to check for observers.
 	// Change records originating from a `setPath` operation
 	// send back the passed in `path` as `name` as well as the
-	// top level object being observed (this observable's _data_).
+	// top level object being observed (this observable's data).
 	// this allows for easy filtering either manually or via a 
 	// `change delegate`
 	//
@@ -983,7 +984,7 @@ sudo.ext.observable = {
 	// to be delivered upon a call to deliverChangeRecords (truthy)
 	// `returns` {Object|*} `this` or calls deliverChangeRecords
 	setPath: function setPath(path, value, hold) {
-		var curr = this._data_, obj = {name: path, object: this._data_},
+		var curr = this.data, obj = {name: path, object: this.data},
 			p = path.split('.'), key;
 		for (key; p.length && (key = p.shift());) {
 			if(!p.length) {
@@ -999,7 +1000,7 @@ sudo.ext.observable = {
 				curr = curr[key] = {};
 			}
 		}
-		this._changeRecords_.push(obj);
+		this.changeRecords.push(obj);
 		// call all observers or not
 		if(hold) return this;
 		return this.deliverChangeRecords();
@@ -1024,7 +1025,7 @@ sudo.ext.observable = {
 	// `param` {Function} the function passed in to `observe`
 	// `returns` {Object} `this`
 	unobserve: function unobserve(fn) {
-		var cb = this._callbacks_, i = cb.indexOf(fn);
+		var cb = this.callbacks, i = cb.indexOf(fn);
 		if(i !== -1) cb.splice(i, 1);
 		return this;
 	},
@@ -1048,9 +1049,9 @@ sudo.ext.observable = {
 	//
 	// `returns` {Object|*} `this` or calls deliverChangeRecords
 	unset: function unset(key, hold) {
-		var obj = {name: key, object: this._data_, type: 'deleted'}, 
-			val = !!this._data_[key];
-		delete this._data_[key];
+		var obj = {name: key, object: this.data, type: 'deleted'}, 
+			val = !!this.data[key];
+		delete this.data[key];
 		// call the observers if there was a val to delete
 		return this._unset_(obj, val, hold);
 	},
@@ -1060,7 +1061,7 @@ sudo.ext.observable = {
 	// `private`
 	_unset_: function _unset_(o, v, h) {
 		if(v) {
-			this._changeRecords_.push(o);
+			this.changeRecords.push(o);
 			if(h) return this;
 			return this.deliverChangeRecords();
 		}
@@ -1075,8 +1076,8 @@ sudo.ext.observable = {
 	//
 	// `returns` {Object|*} `this` or calls deliverChangeRecords
 	unsetPath: function unsetPath(path, hold) {
-		var obj = {name: path, object: this._data_, type: 'deleted'}, 
-			curr = this._data_, p = path.split('.'), 
+		var obj = {name: path, object: this.data, type: 'deleted'}, 
+			curr = this.data, p = path.split('.'), 
 			key, val;
 		for (key; p.length && (key = p.shift());) {
 			if(!p.length) {
@@ -1233,7 +1234,7 @@ sudo.ext.bindable = {
 	//
 	// `returns` {Object} `this`
 	setBinding: function setBinding() {
-		return this._setBinding_(this._data_.binding);
+		return this._setBinding_(this.model.data.binding);
 	},
 	// ###_setBinding_
 	// Given a single explicit binding, create it. Called from
@@ -1255,10 +1256,10 @@ sudo.ext.bindable = {
 	//
 	// `returns` {Object} `this`
 	setBindings: function setBindings() {
-		var b, i;
+		var d = this.model.data, b, i;
 		// handle the single binding use case
-		if((b = this._data_.binding)) return this._setBinding_(b);
-		if(!(b = this._data_.bindings)) return this;
+		if((b = d.binding)) return this._setBinding_(b);
+		if(!(b = d.bindings)) return this;
 		for(i = 0; i < b.length; i++) {
 			this._setBinding_(b[i]);
 		}
@@ -1300,7 +1301,7 @@ sudo.ext.listener = {
 	// `returns` {Object} `this`
 	bindEvents: function bindEvents() {
 		var e;
-		if((e = this._data_.event || this._data_.events)) this._handleEvents_(e, 1);
+		if((e = this.model.data.event || this.model.data.events)) this._handleEvents_(e, 1);
 		return this;
 	},
 	// Use the jQuery `on` or 'off' method, optionally delegating to a selector if present
@@ -1333,12 +1334,90 @@ sudo.ext.listener = {
 	// `returns` {Object} `this`
 	unbindEvents: function unbindEvents() {
 		var e;
-		if((e = this._data_.event || this._data_.events)) this._handleEvents_(e);
+		if((e = this.model.data.event || this.model.data.events)) this._handleEvents_(e);
 		return this;
 	}
 };
+//##Change Delegate
+
+// Delegates, if present, can override or extend the behavior
+// of objects. The change delegate is specifically designed to
+// filter change records from an Observable instance and only forward
+// the ones matching a given `filters` criteria (key or path).
+// The forwarded messages will be sent to the specified method
+// on the delegates `delegator` (bound to the _delegator_ scope)
+//
+// `param` {Object} data
+sudo.delegates.Change = function(data) {
+	this.construct(data);
+};
+// Delegates inherit from Model
+sudo.delegates.Change.prototype = Object.create(sudo.Model.prototype);
+// Change records are delivered here and filtered, calling any matching
+// methods specified in `this.get('filters').
+//
+// `returns` {Object} a call to the specified _delegator_ method, passing
+// a hash containing:
+// 1. the `type` of Change
+// 2. the value located at the key/path
+// 3. the `oldValue` of the key if present
+sudo.delegates.Change.prototype.filter = function(change) {
+	var filters = this.data.filters, name = change.name, obj = {};
+	// does my delegator care about this?
+	if(name in filters && filters.hasOwnProperty(name)) {
+		// assemble the object to return to the method
+		obj.type = change.type;
+		obj.value = name.indexOf('.') === -1 ? change.object[change.name] :
+			this.getPath(name, change.object);
+		obj.oldValue = change.oldValue;
+		return this.delegator[filters[name]].call(this.delegator, obj);
+	}
+};
+// `private`
+sudo.delegates.Change.prototype.role = 'change';
+//##Data Delegate
+
+// Delegates, if present, can extend the behavior
+// of objects, lessening the need for subclassing. 
+// The data delegate is specifically designed to
+// filter through an object, looking for specified keys or paths
+// and returning values for those if found
+//
+// `param` {Object} data
+// `returns` {*} the value found at the specified key/path if found
+sudo.delegates.Data = function(data) {
+	this.construct(data);
+};
+// inherits from Model
+sudo.delegates.Data.prototype = Object.create(sudo.Model.prototype);
+// ###filter
+// iterates over a given object literal and returns a value (if present)
+// located at a given key or path
+//
+// `param` {Object} `obj`
+sudo.delegates.Data.prototype.filter = function(obj) {
+	var filters = this.data.filters, key, o, k;
+	for(key in filters) {
+		if(filters.hasOwnProperty(key)) {
+			// keys and paths need different handling
+			if(key.indexOf('.') === -1) {
+				if(key in obj) this.delegator[filters[key]].call(
+					this.delegator, obj[key]);	
+			} else {
+				// the chars after the last refinement are the key we need to check for
+				k = key.slice(key.lastIndexOf('.') + 1);
+				// and the ones prior are the object
+				o = sudo.getPath(key.slice(0, key.lastIndexOf('.')), obj);
+				if(o && k in o) this.delegator[filters[key]].call(
+					this.delegator, o[k]);
+			}
+		}
+	}
+};
+// `private`
+sudo.delegates.Data.prototype.role = 'data';
 
-sudo.version = "0.8.0";
+sudo.version = "0.9.0";
 window.sudo = sudo;
 if(typeof window._ === "undefined") window._ = sudo;
 }).call(this, this);