Merge branch 'development'

Author: designfrontier

.editorconfig

@@ -0,0 +1,11 @@
+# editorconfig.org
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+indent_style = space
+indent_size = 4

package.json

@@ -1,6 +1,6 @@
 {
   "name": "action",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "releaseName": "Akshay Kumar",
   "private": true,
   "scripts": {

public/javascripts/action.js

@@ -35,7 +35,7 @@ var action = function(){
                         }else{
                             eventStack[i].call(eventDataIn, that.emitterId);
                         }
-                        
+
                         if(eventStack[i].once){
                             that.silence(eventNameIn, eventStack[i].call, true, isLocal);
                         }
@@ -179,7 +179,7 @@ var action = function(){
                 if(typeof eventNameIn === 'object'){
                     eventNameIn.local = true;
                     that.listenLocal(eventNameIn);
-                }else{                  
+                }else{
                     that.listenLocal({
                         eventName: eventNameIn
                         , handler: handlerIn
@@ -265,7 +265,7 @@ var action = function(){
                 if(typeof eventNameIn === 'object'){
                     eventNameIn.local = true;
                     that.silence(eventNameIn);
-                }else{                  
+                }else{
                     that.silence({
                         eventName: eventNameIn
                         , handler: handlerIn
@@ -373,9 +373,6 @@ var action = function(){
                     for(key in attributeName){
                         if(attributeName.hasOwnProperty(key)){
                             //this attribute does not belong to the prototype. Good.
-
-                            //TODO: maybe make this do a deep copy to prevent
-                            //  pass by reference or switch to clone()
                             if(key !== 'destroy' && key !== 'fetch' && key !== 'save' && typeof attributeName[key] !== 'function'){
                                 if(typeof attributeValue === 'object'){
                                     attributes[attributeName] = (Array.isArray(attributeName[key])) ? [] : {};
@@ -386,7 +383,7 @@ var action = function(){
                                 that.emitLocal('attribute:changed', key);
                             } else {
                                 if(typeof that[key] === 'function' && !that.super[key]){
-                                    //wrap the super version in a closure so that we can 
+                                    //wrap the super version in a closure so that we can
                                     //  still execute it correctly
                                     that.super[key] = that[key].bind(that);
                                 }
@@ -407,7 +404,7 @@ var action = function(){
                         that.emitLocal('attribute:changed', attributeName);
                     } else {
                         if(typeof that[attributeName] === 'function'){
-                            //wrap the super version in a closure so that we can 
+                            //wrap the super version in a closure so that we can
                             //  still execute it correctly
                             that.super[attributeName] = that[attributeName].bind(that);
                         }
@@ -545,7 +542,7 @@ var action = function(){
             newModel.clearChanges = function(){
                 changes = [];
             }
-            
+
             newModel.getChanges = function(){
                 return changes;
             }
@@ -558,18 +555,22 @@ var action = function(){
                 //TODO not really working... should get rid of this thing
                 //  and all of its parameters
                 var that = this
-                    , key;
-
-                setTimeout(function(){
-                    // delete me;
-                },0); // not quite working...
-
-                for(key in that){
-                    // delete this[key];
-                }
-
-                //TODO this still doesn't kill the attributes or changes
-                //  private data
+                    , events = that.eventStore
+                    , key
+                    , i;
+
+                //TODO: make this iterate over the events that have been
+                //  registered by this object and silence them
+                //  otherwise zombies.
+
+                // for(key in events){
+                //     for(i = 0; i < events[key].length; i++){
+                //         that.silence(key, events[key][i].call,events[key][i].once)
+                //     }
+                //     // if(that.hasOwnProperty(key)){
+                //     //     delete that[key];
+                //     // }
+                // }
             }
 
             newModel.set(objectIn); //set the inital attributes
@@ -585,10 +586,37 @@ var action = function(){
             return newModel;
         }
 
+        , routeMe: function(objectIn){
+            var that = this
+                , routeModel = that.modelMe(objectIn)
+
+                , init = function(){
+                    var that = this
+                        , atags = document.querySelectorAll('a')
+                        , i = 0;
+
+                    for(i = 0; i < atags.length; i++){
+                        atags[i].addEventListener('click', function(e){
+                           var location = this.attributes.href.textContent;
+
+                            if(typeof that.get(location) !== 'undefined'){
+                                //trigger the route
+                                that.emit('navigate', location);
+                                e.preventDefault();
+                            }
+                        });
+                    }
+                };
+
+                init();
+
+            return routeModel;
+        }
+
         //TODO: figure out if this is needed since the global:error...
         // , trace: function(emitterIdIn){
         //     //log out the function that has the emitterId attached
-            
+
         //     //create the traced object/stack
         //     action.traced = action.modelMe({
         //         stack: []
@@ -641,14 +669,14 @@ var action = function(){
     action.listen('global:error', function(errorIn) {
         console.group('An Error occured in an object with emitterid: ' + errorIn.createdBy.emitterId);
         console.log('It was a ' + errorIn.type + 'error.');
-        
+
         if(typeof errorIn.errorObject === 'string'){
             console.log('It says: ' + errorIn.errorObject);
             console.log('and: ' + errorIn.message);
         } else {
             console.log('It says: ' + errorIn.message);
         }
-        
+
         console.log('The Whole Enchilada (object that caused this mess):');
         console.dir(errorIn.createdBy);
 
@@ -667,6 +695,10 @@ var action = function(){
         // throw errorIn;
     });
 
+    document.addEventListener("DOMContentLoaded", function(){
+        action.emit('dom:ready');
+    });
+
     //return the tweaked function
     return action;
-}(this);
+}(this);

readme.md

@@ -1,20 +1,23 @@
 #Action!
+`Action!` is a front end sub/pub based framework for event based development. No more passing around dependencies, no more worrying about timing. Events free you to build apps that function they way the real world does: cause and effect.
+
+Need data? Ask for it. Need to do something with that data? Listen for when it is sent back to you and do it. Need to watch for the user to do something? Listen for it and react accordingly. `Action!` embraces the asynchronicity that is the world around us to create better front end experiences and code.
+
 
 ##Road Map
 So there are a variety of things that need to be completed for Action! to be ready for primetime. Some of them are basic (getting statemachine working), others are more complex (build tooling for troubleshooting event stacks). I am going to keep them here and make this a living document.
 
 ###TODOs before RC
+0. make the destroy function silence all events registered by the object it is called on
 0. dependency resolution integration with state machines
 0. Figure out the testing side of event driven FED in Action
 0. Revise the destroy function to make it really do what it needs to
 0. Figure out how views really work... (https://github.com/twitter/hogan.js)
-0. Consider web components
 
 ###TODOs generally
 0. create a prod branch and a debug branch (prod probably doesn't need the extra weight of the call stack and emitterid stuff)?
 0. update documentation
 0. example app
-0. simplify model set function?
 0. make the error output even prettier! https://developers.google.com/chrome-developer-tools/docs/console-api#consoleerrorobject_object
 
 ###Done
@@ -25,10 +28,11 @@ So there are a variety of things that need to be completed for Action! to be rea
 0. Clone/ Deep Copy in the set functions
 0. Build out the save function for models
 0. ajax resolution/integration for models
-
+0. Consider web components (considered... and moved on for now)
+0. simplify model set function?
 
 #### Release Names
-We'll use these guys as release names: http://en.wikipedia.org/wiki/List_of_action_film_actors
+We'll use these folks as release names: http://en.wikipedia.org/wiki/List_of_action_film_actors
 
 in order from top left - down the column then on to the next column. If we run out we'll add more names to the list :-)
 
@@ -41,5 +45,5 @@ in order from top left - down the column then on to the next column. If we run o
 
 ###Dependencies
 There are a few dependencies for Action to be a fully useful framework. They are (with the reasons for them):
-0. localForage (If you want to use the local cache. It will automatically cache all of your ajax requests in local storage and pull from them all subsequent times they are requested)
-0. Handlebars (a templating library)
+0. localForage (If you want to use the local cache. It will automatically cache all of your ajax GET requests in local storage and pull from them all subsequent times they are requested)
+0. Handlebars, or compatible (a templating library)