emerson 0.0.1

data/.gemset.template

@@ -0,0 +1 @@
+RVM_GEMSET="ruby-1.9.3@emerson"

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+.gemset
+.rspec
+.rvmrc
+.import/

data/.rspec.template

@@ -0,0 +1 @@
+--colour

data/.rvmrc.template

@@ -0,0 +1,11 @@
+source .gemset
+export USE_BUNDLER=force
+
+rvm use --create --install $RVM_GEMSET
+
+if [[ -s "./bootstrap.gems" ]]; then
+  if ! rvm gemset import bootstrap.gems > /dev/null 2>&1; then
+    echo "ERROR: Unable to bootstrap the gems" >&2
+  fi
+fi
+

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in emerson.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Corey Innis
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Emerson
+
+transcendent views. (WIP)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'emerson'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install emerson
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bootstrap.gems

@@ -0,0 +1 @@
+bundler -v 1.1.3

data/emerson.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/emerson/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Corey Innis"]
+  gem.email         = ["corey@coolerator.net"]
+  gem.description   = %q{transcendent views}
+  gem.summary       = %q{emerson believes in the inherent good in...}
+  gem.homepage      = "https://github.com/coreyti/emerson"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "emerson"
+  gem.require_paths = ["lib"]
+  gem.version       = Emerson::VERSION
+end

data/lib/emerson.rb

@@ -0,0 +1,6 @@
+require "emerson/version"
+require "emerson/rails"
+
+module Emerson
+  # Your code goes here...
+end

data/lib/emerson/rails.rb

@@ -0,0 +1,7 @@
+require 'rails'
+
+module Emerson
+  module Rails
+    autoload :Engine, 'emerson/rails'
+  end
+end

data/lib/emerson/rails/engine.rb

@@ -0,0 +1,5 @@
+module Emerson
+  module Rails
+    class Engine < ::Rails::Engine ; end
+  end
+end

data/lib/emerson/version.rb

@@ -0,0 +1,3 @@
+module Emerson
+  VERSION = "0.0.1"
+end

data/vendor/assets/javascripts/emerson.js

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

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

@@ -0,0 +1,33 @@
+(function(){
+
+  // Initial Setup
+  // --------------------------------------------------------------------------
+
+  // Save a reference to the global object...
+  // `window` in the browser, `global` on the server.
+  var root = this;
+
+  // The top-level namespace. All public Emerson classes and modules will
+  // be attached to this. Exported for both CommonJS and the browser.
+  var Emerson;
+  if (typeof exports !== 'undefined') {
+    Emerson = exports;
+  } else {
+    Emerson = root.Emerson = {};
+  }
+
+  // Current version of the library. Keep in sync with `package.json`.
+  Emerson.VERSION = '0.0.1';
+
+  // Reference the base lib (one of jQuery, Zepto or Ender) as $.
+  var $ = Emerson.base = (root.jQuery || root.Zepto || root.ender);
+
+
+  // Primary API
+  // --------------------------------------------------------------------------
+  Emerson.init = function init() {
+    _.each(['sink', 'util', 'view'], function(mod) {
+      Emerson[mod] && Emerson[mod].init();
+    });
+  };
+}).call(this);

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

@@ -0,0 +1,77 @@
+//     Emerson HTTP
+//
+//     Adds...
+
+(function(ns) {
+
+  // Emerson Extension
+  // --------------------------------------------------------------------------
+
+  // ### Emerson.http module
+  // ...
+  //
+  // **Important Note:**
+  // > For now, `Emerson.http` depends on the Rails `jquery_ujs` extension.
+  var define = ns.http = function() {};
+
+  // ### Module API
+  //   * `ns` is a reference to the namespace.
+  //   * `init` is a hook for initializing the module.
+  _.extend(define, {
+    ns   : ns,
+    init : function init() {
+      if($.rails === undefined) {
+        throw("$.rails must be defined");
+      }
+
+      return (ns.sink) ? enable() : disable();
+    }
+  });
+
+
+  // "Base" Libary Extension
+  // --------------------------------------------------------------------------
+
+  // Make a local copy of Emerson.base. e.g., one of jQuery, Zepto or Ender.
+  var $ = ns.base;
+
+
+  // Event Handling
+  // --------------------------------------------------------------------------
+
+
+  // ### enable
+  // Attach event global listeners.
+  function enable() {
+    $(document)
+      .on('ajax:error',   handleError)
+      .on('ajax:success', handleSuccess);
+  }
+
+  // ### enable
+  // Detach event global listeners.
+  function disable() {
+    $(document)
+      .off('ajax:error',   handleError)
+      .off('ajax:success', handleSuccess);
+  }
+
+  // ### handleError
+  function handleError(e, xhr, status, error) {
+    sink(JSON.parse(xhr.responseText), status);
+  }
+
+  // ### handleSuccess
+  function handleSuccess(e, response, status, xhr) {
+    sink(response, status);
+  }
+
+  // ### sink
+  //
+  //     json: <response [action, data, path, view]>
+  //     html: <response> (string)
+  //     head: <response> single space string
+  function sink(response, status) {
+    $(response.view).view().sink();
+  }
+})(Emerson);

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

@@ -0,0 +1,93 @@
+//     Emerson Sink
+//
+//     Adds...
+
+(function(ns) {
+
+  // Emerson Extension
+  // --------------------------------------------------------------------------
+
+  // ### Emerson.sink module
+  var define = ns.sink = function(view) {};
+
+  // ### Module API
+  //   * `ns` is a reference to the namespace.
+  //   * `init` is a hook for initializing the module.
+  _.extend(define, {
+    ns     : ns,
+    init   : function init() {
+      _before.list = [];
+      _after.list  = [];
+    },
+    before : function before(callback) {
+      if(callback) {
+        _before(callback);
+      }
+    },
+    after  : function after(callback) {
+      if(callback) {
+        _after(callback);
+      }
+    }
+  });
+
+
+  // "Base" Libary Extension
+  // --------------------------------------------------------------------------
+
+  // Make a local copy of Emerson.base. e.g., one of jQuery, Zepto or Ender.
+  var $ = ns.base;
+
+  // ### $.fn.sink
+  //
+  //     $(target).sink()
+  //
+  $.fn.sink = function() {
+    _.each(this, function(e) {
+      var elem = $(e);
+      var key  = elem.data('sink');
+
+      if(key) {
+        _before.apply(elem);
+        elem.replaceAll('[data-sink="' + key + '"]', 'body');
+        _after.apply(elem);
+      }
+    });
+
+    return this;
+  };
+
+
+  // Internal Implementation
+  // --------------------------------------------------------------------------
+
+  // ### 'before' callbacks
+  var _before = function(callback) {
+    var view;
+    if(callback) {
+      _before.list.push(callback);
+    }
+    else {
+      view = this;
+      _.each(_before.list, function(fn) {
+        fn(view);
+      });
+    }
+  };
+  _.extend(_before,  { list : [] });
+
+  // ### 'after' callbacks
+  var _after = function(callback) {
+    var view;
+    if(callback) {
+      _after.list.push(callback);
+    }
+    else {
+      view = this;
+      _.each(_after.list, function(fn) {
+        fn(view);
+      });
+    }
+  };
+  _.extend(_after,  { list : [] });
+})(Emerson);

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

@@ -0,0 +1,26 @@
+//     Emerson Util
+//
+//     ...
+
+(function(ns){
+
+  // Emerson Extension
+  // --------------------------------------------------------------------------
+
+  // util
+  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?
+      }
+    }
+  };
+})(Emerson);

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

@@ -0,0 +1,285 @@
+//     Emerson View
+//
+//     A view...
+
+(function(ns) {
+
+  // Emerson Extension
+  // --------------------------------------------------------------------------
+
+  // ### Emerson.view module
+  // Entry point for defining a new View.
+  var define = ns.view = function(name, setup) {
+    return (library[name] = construct(name, setup || {}));
+  };
+
+  // ### Module API
+  //   * `ns` is a reference to the namespace.
+  //   * `init` is a hook for initializing the module.
+  _.extend(define, {
+    ns   : ns,
+    init : function init() {
+      $('body').view();
+    }
+  });
+
+
+  // "Base" Libary Extension
+  // --------------------------------------------------------------------------
+
+  // Make a local copy of Emerson.base. e.g., one of jQuery, Zepto or Ender.
+  var $ = ns.base;
+
+  // ### $.view
+  //
+  //     $.view(key);
+  //
+  // Accessor for defined Views.
+  //
+  // Note that, while it is possible to manually execute View methods on an
+  // object like so:
+  //
+  //     $.view(key).fn.method.apply(object, arguments);
+  //
+  // such usage is not recommended as it:
+  //
+  //   1. circumvents the intentional transience provided by the framework.
+  //   2. is likely to cause issues in that the called method will be working
+  //      with a non-initialized/-decorated object which may not have the
+  //      expected API.
+  //
+  $.view = function(key) {
+    return library[key];
+  };
+
+  // ### $.fn.view
+  //
+  //     $(target).view()
+  //
+  // Initializes a transiently-decorated object.  In the call to #initialized,
+  // and any additional methods called from there, `this` will be wrapped with
+  // the View definition.  The returned object is stock: no longer decorated.
+  //
+  // This method will apply, both, "view" and "trait" behaviors.  Additionally,
+  // it works on the surrounding DOM match, as well as nested matches.
+  $.fn.view = function() {
+    _.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]');
+
+      _.each(as_view, function(html) {
+        var element = $(html);
+        attach.apply(element, [element.data('view')]);
+      });
+
+      _.each(as_trait, function(html) {
+        var element = $(html);
+        attach.apply(element, _.map(element.data('traits').split(/\s+/), function(key) {
+          return [':', key].join('');
+        }));
+      });
+    });
+
+    return this;
+  };
+
+
+  // Internal Objects
+  // --------------------------------------------------------------------------
+
+  // ### 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.
+  _.extend(View, {
+    setup : {
+      initialize : function() {},
+      subscribe  : {}
+    }
+  });
+
+  // View instance prototype definition.
+  _.extend(View.prototype, {});
+
+
+  // Internal Implementation
+  // --------------------------------------------------------------------------
+
+  // Storage place for the defined Views.
+  // @private
+  var library = {};
+
+  // Storage place for attachments made.
+  // @private
+  var attachments = {};
+
+  // emerson id, for tracking attachments.
+  // @private
+  var _eid = 0;
+
+  // ### eid
+  // Retrieves a unique and persistent ID for the given DOM element.
+  // @private
+  function eid(element) {
+    return element._emerson || (element._emerson = (_eid += 1));
+  }
+
+  // ### construct
+  // Construct a definition made up of:
+  //
+  //   1. The provided setup block.
+  //   2. A "subclass", extended with the View prototype.
+  function construct(name, setup) {
+    var sub = _.extend($sub(), {
+      constructor : View,
+      setup       : _.extend({}, View.setup, setup)
+    });
+
+    _.extend(sub.fn, View.prototype);
+
+    return sub;
+  }
+
+  // ### attach
+  // Given a (complex) list of keys, search the library for applicable View and
+  // Trait definitions to apply to the object.
+  //
+  // Keeps track of which definitions have been applied, and does not re-apply.
+  //
+  // NOTE: `this`, in this call, should be a baselib-extended object containing
+  // a single element.  e.g.,
+  //
+  //     _.each($(selector), function(element) {
+  //       attach.apply($(element), [key, [subkey]]);
+  //     });
+  function attach() {
+    var self = this, def;
+    var id   = eid(this[0]);
+
+    _.each(_.flatten(arguments), function(key) {
+      var set = (attachments[key] || (attachments[key] = []));
+      var built, init, events;
+
+      if(_.include(set, id)) {
+        return; // do not re-apply.
+      }
+
+      // Build an instance, attach event handlers, initialize and record.
+      if(def = library[key]) {
+        built  = def(self, self.context);
+        init   = def.setup.initialize;
+        events = def.setup.subscribe;
+
+        _.each(events, function(handler, key) {
+          bind(built, key, handler);
+        });
+
+        init.call(built);
+        set.push(id);
+      }
+    });
+
+    return this;
+  }
+
+  // ### bind
+  // Attach event handler(s).
+  //
+  //     Emerson.view(key, {
+  //       subscribe : {
+  //         '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
+  //         }
+  //       }
+  //     });
+  //
+  // 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.
+  //
+  // 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) {
+    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);
+        });
+      }
+      else {
+        instance.on(key, selector, function() {
+          return handler.apply(instance, arguments);
+        });
+      }
+    }
+  }
+
+  // ### $sub
+  // Basically a copy of jQuery.sub, but more generic and with changes to:
+  //
+  //   1. `Sub.extend`
+  //      to ensure proper object context is maintained.
+  //   2. `Sub.fn.extend`
+  //      to ensure proper object context is maintained.
+  function $sub() {
+    var root;
+
+    function Sub(selector, context) {
+      return new Sub.fn.init(selector, context);
+    }
+
+    _.extend(true, Sub, $);
+
+    Sub.fn      = Sub.prototype = $();
+    Sub.fn.init = function init(selector, context) {
+      return $.fn.init.call(this, selector, context, root);
+    };
+
+    Sub.fn.constructor    = Sub;
+    Sub.fn.init.prototype = Sub.fn;
+
+    Sub.fn.extend = function extend() {
+      this.constructor.extend.apply(this.constructor, arguments);
+      return this;
+    };
+
+    Sub.extend = function extend() {
+      var self = this;
+      var keep = {
+        constructor : this.fn.constructor,
+        init        : this.fn.init
+      };
+
+      _.each(arguments, function(arg) {
+        if(arg.fn) {
+          $.extend(self.fn, arg.fn, keep);
+        }
+        else {
+          $.extend(self.fn, arg, keep);
+        }
+      });
+
+      return self;
+    };
+
+    root = Sub(document);
+    return Sub;
+  }
+})(Emerson);

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: emerson
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Corey Innis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-10 00:00:00.000000000 Z
+dependencies: []
+description: transcendent views
+email:
+- corey@coolerator.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gemset.template
+- .gitignore
+- .rspec.template
+- .rvmrc.template
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bootstrap.gems
+- emerson.gemspec
+- lib/emerson.rb
+- lib/emerson/rails.rb
+- lib/emerson/rails/engine.rb
+- lib/emerson/version.rb
+- vendor/assets/javascripts/emerson.js
+- vendor/assets/javascripts/emerson/base.js
+- vendor/assets/javascripts/emerson/http.js
+- vendor/assets/javascripts/emerson/sink.js
+- vendor/assets/javascripts/emerson/util.js
+- vendor/assets/javascripts/emerson/view.js
+homepage: https://github.com/coreyti/emerson
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: emerson believes in the inherent good in...
+test_files: []