emerson 0.0.6 → 0.0.7

data/.gitignore

@@ -20,4 +20,5 @@ tmp
 .rspec
 .rvmrc
 .import/
-.sublime*
+.sublime*
+.wiprc

data/lib/emerson/version.rb

@@ -1,3 +1,3 @@
 module Emerson
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/vendor/assets/javascripts/emerson.js

@@ -1,4 +1,4 @@
-//     Emerson.js 0.0.6
+//     Emerson.js 0.0.7
 //
 //     (c) 2012 Corey Innis
 //     Emerson may be freely distributed under the MIT license.

data/vendor/assets/javascripts/emerson/base.js

@@ -21,7 +21,7 @@
   }
 
   // Current version of the library. Keep in sync with `package.json`.
-  Emerson.VERSION = '0.0.6';
+  Emerson.VERSION = '0.0.7';
 
   // Reference the base lib (one of jQuery, Zepto or Ender) as $.
   var $ = Emerson.base = (root.jQuery || root.Zepto || root.ender);

data/vendor/assets/javascripts/emerson/view.js

@@ -79,12 +79,12 @@
       var as_trait = element.add(element.find(selectors.traits)).filter(selectors.traits);
 
       _.each(as_view, function(html) {
-        var element = $(html);
+        var element = $(html); // why jQuery here, if $sub() in a moment?
         attach.call(element, views, [element.data(attrs.view)]);
       });
 
       _.each(as_trait, function(html) {
-        var element = $(html);
+        var element = $(html); // why jQuery here, if $sub() in a moment?
         attach.call(element, traits, element.data(attrs.traits).split(/\s+/), true);
       });
     });
@@ -97,21 +97,68 @@
   // --------------------------------------------------------------------------
 
   // ### View constructor.
-  //
   // View instances are "subclasses" of the base lib object, decorated with our
   // View.prototype and the provided definition.
   function View() {}
 
-  // View instance setup definition.
+  // ### View setup definition.
   _.extend(View, {
     setup : {
       initialize : function() {},
+      connected  : false,
       subscribe  : {}
     }
   });
 
-  // View instance prototype definition.
-  _.extend(View.prototype, {});
+  // ### View prototype definition.
+  // **TODO**: Add specs for #connect & #outlet.
+  //
+  //   * `connect` specifies which, if any, `outlets` should be registered as
+  //     methods on the instance.
+  //
+  //         false       - do not connect any outlets (default)
+  //         true        - connect all outlets
+  //         [outlet(s)] - connect the named outlets.
+  //
+  //   * `outlet` returns descendent element(s) with matching a `data-outlet`
+  //     attribute.  This may be used for a given outlet whether or not it has
+  //     been "connected".  Outlets are useful as a means of allowing for View
+  //     and Trait definitions with somewhat flexible DOM.  Rather than using
+  //     specific selectors (or polluting the `class` attribute), the DOM for
+  //     a given instance indicates which nodes should match for the View.
+  _.extend(View.prototype, {
+    connect : function(config) {
+      var self    = this;
+      var outlets = this.find('[data-outlet]');
+
+      if(config === true) {
+        _.each(outlets, function(subject) {
+          var outlet = $(subject);
+
+          self[outlet.data('outlet')] = function() {
+            return outlet;
+          };
+        });
+      }
+      else if($.isArray(config)) {
+        _.each(config, function(key) {
+          var outlet = self.find('[data-outlet="' + key + '"]');
+
+          if(outlet.length) {
+            self[key] = function() {
+              return outlet;
+            };
+          }
+        });
+      }
+
+      return this;
+    },
+
+    outlet : function(key) {
+      return this.find('[data-outlet="' + key + '"]');
+    }
+  });
 
 
   // Internal Implementation
@@ -195,7 +242,7 @@
     var id   = eid(this[0]);
 
     _.each(_.flatten(keys), function(key) {
-      var mode, match, built, init, events, set;
+      var mode, match, built, init, events, set, setup;
 
       if(mode_p && (match = /^([^(]+)\((.+)\)/.exec(key))) {
         key  = match[1];
@@ -208,17 +255,17 @@
         return; // do not re-apply.
       }
 
-      // Build an instance, attach event handlers, initialize and record.
+      // Build an instance, connect outlets, bind events, init and record.
       if(def = library[key]) {
-        built  = def(self, self.context);
-        init   = def.setup.initialize;
-        events = def.setup.subscribe;
+        setup = def.setup;
+        built = def(self, self.context);
+        built.connect(setup.connected);
 
-        _.each(events, function(handler, key) {
+        _.each(setup.subscribe, function(handler, key) {
           bind(built, key, handler);
         });
 
-        init.call(built, mode);
+        setup.initialize.call(built, mode);
         set.push(id);
       }
     });
@@ -231,17 +278,20 @@
   //
   //     Emerson.view(key, {
   //       subscribe : {
-  //         'click'       : handler,    // simple
-  //         'click focus' : handler,    // multiple event types
-  //         'selector'    : {           // specific child target
+  //         'click'       : handler,     // simple
+  //         'click focus' : handler,     // multiple event types
+  //         'selector'    : {            // specific child target
   //           'click'     : handler,
   //           'focus'     : handler
   //         },
-  //         document      : {           // bind document, for events
-  //           'click'     : handler     // fired outside of the view
-  //           'selector'  : {           // TODO
+  //         document      : {            // bind document, for events
+  //           'click'     : handler      // fired outside of the view
+  //           'selector'  : {
   //             'click'   : handler
-  //           } 
+  //           }
+  //         },
+  //         'outlet:name' : {            // a custom key to specify a
+  //           'click' : handler          // defined outlet as the scope
   //         }
   //       }
   //     });
@@ -251,31 +301,38 @@
   // event argument is unadultered, allowing access to the full set of targets
   // as defined by the baselib (e.g., jQuery).
   //
-  // Note that, in the document-binding case, an event like `click` would be a
-  // bad idea.  A more useful (and less costly) use case would be a form of
-  // pub/sub.
+  // **Special notes regarding document-bound handlers**:
+  //
+  // Binding an event like `click` (without selector scope) to the document
+  // would likely be a bad idea.  A more useful (and less costly) use case
+  // would be a sort of pub/sub.  For example, view "A" could trigger an event
+  // indicating that it has rendered a new instance, to which "B" (elsewhere)
+  // would listen in order to update, say, a count of instances of "A".
   //
-  // For example, view "A" could trigger an event indicating that it has
-  // rendered a new instance, to which "B" (elsewhere) would listen in order
-  // to update, say, a count of instances of "A".
-  function bind(instance, key, handler, selector) {
+  // Additionally, event handlers bound to the document will not be cleaned
+  // up when the associated view instance is removed.
+  function bind(instance, key, handler, selector, binder) {
     if($.isPlainObject(handler)) {
-      _.each(handler, function(subhandler, subkey) {
-        bind(instance, subkey, subhandler, key);
-      });
-    }
-    else {
-      if(selector === 'document') {
-        $(document).on(key, function() {
-          return handler.apply(instance, arguments);
+      if(key === 'document') {
+        _.each(handler, function(subhandler, subkey) {
+          bind(instance, subkey, subhandler, undefined, $(document));
         });
       }
       else {
-        instance.on(key, selector, function() {
-          return handler.apply(instance, arguments);
+        _.each(handler, function(subhandler, subkey) {
+          bind(instance, subkey, subhandler, key, binder);
         });
       }
     }
+    else {
+      if(/^outlet/.test(selector)) {
+        selector = '[data-outlet="' + selector.split(':')[1] + '"]';
+      }
+
+      (binder || instance).on(key, selector, function() { // selector may be undefined
+        return handler.apply(instance, arguments);
+      });
+    }
   }
 
   // ### $sub

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: emerson
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-13 00:00:00.000000000 Z
+date: 2012-05-16 00:00:00.000000000 Z
 dependencies: []
 description: transcendent views
 email: