emerson 0.0.2 → 0.0.3

data/lib/emerson/version.rb

@@ -1,3 +1,3 @@
 module Emerson
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/vendor/assets/javascripts/emerson.js

@@ -1,14 +1,12 @@
-//     Emerson.js 0.0.1
+//     Emerson.js 0.0.3
 //
 //     (c) 2012 Corey Innis
 //     Emerson may be freely distributed under the MIT license.
 //     For all details and documentation:
 //     http://coolerator.net
 
-//= require underscore
-//= require emerson/base
-//= require emerson/util
-//= require emerson/http
-//= require emerson/sink
-//= require emerson/view
-// @private
+//     = require emerson/base.js
+//     = require emerson/util.js
+//     = require emerson/http.js
+//     = require emerson/sink.js
+//     = require emerson/view.js

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

@@ -1,3 +1,7 @@
+//     Emerson Base
+//
+//     Defines the Emerson namespace (global).
+
 (function(){
 
   // Initial Setup
@@ -17,7 +21,7 @@
   }
 
   // Current version of the library. Keep in sync with `package.json`.
-  Emerson.VERSION = '0.0.1';
+  Emerson.VERSION = '0.0.3';
 
   // Reference the base lib (one of jQuery, Zepto or Ender) as $.
   var $ = Emerson.base = (root.jQuery || root.Zepto || root.ender);
@@ -25,9 +29,82 @@
 
   // Primary API
   // --------------------------------------------------------------------------
+
+  // ### .config
+  // Configures the library.
+  //
+  //   * Given an object the current configuration will be extended with that.
+  //   * Given a "dot-notated" string a lookup will be performed.
+  //   * With no argument a copy of the current configuration will be returned.
+  //
+  Emerson.config = function config() {
+    var arg = arguments[0];
+    var result;
+
+    if(arg === undefined) {
+      return _.clone(configuration);
+    }
+
+    if(typeof arg === 'string') {
+      result = configuration;
+
+      try {
+        _.each(arg.split('.'), function(part) {
+          result = result[part];
+        });
+      }
+      catch(e) {
+        return undefined;
+      }
+
+      return _.clone(result);
+    }
+    else {
+      _.extend(configuration, arg);
+    }
+  };
+
+  // ### .init
+  // Initializes the desired Emerson modules.
+  //
+  // By default, will run `.init` for all modules.  If passed specific module
+  // names, it will only initialize those.
   Emerson.init = function init() {
-    _.each(['sink', 'util', 'view'], function(mod) {
+    var modules = ['http', 'sink', 'util', 'view'];
+
+    if(arguments.length) {
+      modules = arguments;
+    }
+
+    _.each(modules, function(mod) {
       Emerson[mod] && Emerson[mod].init();
     });
   };
+
+
+  // Internal Implementation
+  // --------------------------------------------------------------------------
+
+  // ### configuration
+  // Stores library config, with defaults.
+  //
+  //   * `attrs` are mapped to `[data-attr]` for view/trait selectors.
+  //
+  // Previous (unpublished) versions of this library used `data-presents` to
+  // represent a view and `data-behavior` to represent traits.  This is still
+  // supported by way of:
+  //
+  //     Emerson.config({
+  //       attrs : {
+  //         view   : 'presents',
+  //         traits : 'behavior'
+  //       }
+  //     });
+  //     Emerson.init();
+  var configuration = {
+    attrs : {
+      view   : 'view',
+      traits : 'traits'
+    }
+  };
 }).call(this);

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

@@ -7,20 +7,11 @@
   // Emerson Extension
   // --------------------------------------------------------------------------
 
-  // util
+  // ### Emerson.util module
+  //   * `ns` is a reference to the namespace.
+  //   * `init` is a hook for initializing the module.
   var util = ns.util = {
-    // A reference to the namespace.
     ns   : ns,
-    init : function init() {},
-
-    // ...
-    augment : function augment(object, name, fn) {
-      var original = object[name];
-
-      object[name] = function() {
-        var result = (original && original.apply(this, arguments)) || this;
-        return fn.apply(result, arguments);                                    // closure issue?
-      }
-    }
+    init : function init() {}
   };
 })(Emerson);

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

@@ -19,6 +19,7 @@
   _.extend(define, {
     ns   : ns,
     init : function init() {
+      configure();
       $('body').view();
     }
   });
@@ -66,17 +67,17 @@
     _.each(this, function(e) {
       var keys     = [];
       var element  = $(e);
-      var as_view  = element.add(element.find('[data-view]')).filter('[data-view]');
-      var as_trait = element.add(element.find('[data-traits]')).filter('[data-traits]');
+      var as_view  = element.add(element.find(selectors.view)).filter(selectors.view);
+      var as_trait = element.add(element.find(selectors.traits)).filter(selectors.traits);
 
       _.each(as_view, function(html) {
         var element = $(html);
-        attach.apply(element, [element.data('view')]);
+        attach.apply(element, [element.data(attrs.view)]);
       });
 
       _.each(as_trait, function(html) {
         var element = $(html);
-        attach.apply(element, _.map(element.data('traits').split(/\s+/), function(key) {
+        attach.apply(element, _.map(element.data(attrs.traits).split(/\s+/), function(key) {
           return [':', key].join('');
         }));
       });
@@ -110,6 +111,14 @@
   // Internal Implementation
   // --------------------------------------------------------------------------
 
+  // Attr definitions.
+  // @private
+  var attrs = {};
+
+  // Selector definitions.
+  // @private
+  var selectors = {};
+
   // Storage place for the defined Views.
   // @private
   var library = {};
@@ -122,6 +131,17 @@
   // @private
   var _eid = 0;
 
+  // configure
+  // @private
+  function configure() {
+    var config = ns.config('attrs');
+
+    _.extend(attrs, config);
+    _.each(config, function(value, key) {
+      selectors[key] = '[data-' + value + ']';
+    });
+  }
+
   // ### eid
   // Retrieves a unique and persistent ID for the given DOM element.
   // @private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: emerson
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors: