ninjs-framework 0.1.0

data/lib/ninjs-framework/core/.existence.pdoc.yaml

@@ -0,0 +1,12 @@
+---
+id: "is_defined"
+type: class method
+line_number: 5
+description: |
+
+
+signatures:
+ -
+  signature: ".is_defined(suspect)"
+  return_value: "Any"
+file: /Volumes/Storage/Development/ninjs/repository/ninjs/core/existence.js

data/lib/ninjs-framework/core/application.js

@@ -0,0 +1,17 @@
+NinjsApplication = function() {};
+
+NinjsApplication.prototype.add_module = function(name) {
+	if (is_undefined(name)) {
+		throw new SyntaxError("NinjsApplication.add_module(name): name is undefined");
+	}
+
+	if (is_defined(this[name])) {
+		throw new SyntaxError("NinjsApplication.add_module(name): '" + name + "' already declared");
+	}
+
+	if (this.name === name) {
+		throw new SyntaxError("NinjsApplication.add_module(name): a module cannot have the same name as the application");
+	}
+
+	return this[name] = new NinjsModule(name);
+};

data/lib/ninjs-framework/core/dom.js

@@ -0,0 +1,164 @@
+var DomReady = window.DomReady = {},
+    userAgent = navigator.userAgent.toLowerCase(),
+    browser = {
+      version: (userAgent.match( /.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/ ) || [])[1],
+      safari: /webkit/.test(userAgent),
+      opera: /opera/.test(userAgent),
+      msie: (/msie/.test(userAgent)) && (!/opera/.test( userAgent )),
+      mozilla: (/mozilla/.test(userAgent)) && (!/(compatible|webkit)/.test(userAgent))
+    },
+    readyBound = false,
+    isReady = false,
+    readyList = [];
+
+
+function domReady() {
+  // Make sure that the DOM is not already loaded
+  if(!isReady) {
+    // Remember that the DOM is ready
+    isReady = true;
+
+    if(readyList) {
+      var length = readyList.length;
+      for(var fn = 0; fn < length; fn++) {
+        readyList[fn].call(window, []);
+      }
+
+      readyList = [];
+    }
+  }
+};
+
+// From Simon Willison. A safe way to fire onload w/o screwing up everyone else.
+function addLoadEvent(func) {
+  var oldonload = window.onload;
+  if (typeof window.onload != 'function') {
+    window.onload = func;
+  }
+  else {
+    window.onload = function() {
+      if (oldonload) {
+        oldonload();
+      }
+      func();
+    }
+  }
+};
+
+// does the heavy work of working through the browsers idiosyncracies (let's call them that) to hook onload.
+function bindReady() {
+  if(readyBound) {
+    return;
+  }
+
+  readyBound = true;
+
+  // Mozilla, Opera (see further below for it) and webkit nightlies currently support this event
+  if (document.addEventListener && !browser.opera) {
+    // Use the handy event callback
+    document.addEventListener("DOMContentLoaded", domReady, false);
+  }
+
+  // If IE is used and is not in a frame
+  // Continually check to see if the document is ready
+  if (browser.msie && window == top) (function() {
+    if (isReady) return;
+    try {
+      // If IE is used, use the trick by Diego Perini
+      // http://javascript.nwbox.com/IEContentLoaded/
+      document.documentElement.doScroll("left");
+    }
+    catch(error) {
+      setTimeout(arguments.callee, 0);
+      return;
+    }
+    // and execute any waiting functions
+    domReady();
+  })();
+
+  if(browser.opera) {
+    document.addEventListener( "DOMContentLoaded", function () {
+      if (isReady) return;
+      for (var i = 0; i < document.styleSheets.length; i++)
+      if (document.styleSheets[i].disabled) {
+        setTimeout( arguments.callee, 0 );
+        return;
+      }
+      // and execute any waiting functions
+      domReady();
+    }, false);
+  }
+
+  if(browser.safari) {
+    var numStyles;
+    (function(){
+      if (isReady) return;
+
+      if (document.readyState != "loaded" && document.readyState != "complete") {
+        setTimeout( arguments.callee, 0 );
+        return;
+      }
+
+      if (numStyles === undefined) {
+        var links = document.getElementsByTagName("link");
+        for (var i=0; i < links.length; i++) {
+          if(links[i].getAttribute('rel') == 'stylesheet') {
+            numStyles++;
+          }
+        }
+
+        var styles = document.getElementsByTagName("style");
+        numStyles += styles.length;
+      }
+
+      if (document.styleSheets.length != numStyles) {
+        setTimeout( arguments.callee, 0 );
+        return;
+      }
+
+      // and execute any waiting functions
+      domReady();
+    })();
+  }
+
+  // A fallback to window.onload, that will always work
+  addLoadEvent(domReady);
+};
+
+// This is the public function that people can use to hook up ready.
+DomReady.ready = function(fn, args) {
+  // Attach the listeners
+  bindReady();
+
+  // If the DOM is already ready
+  if (isReady) {
+    // Execute the function immediately
+    fn.call(window, []);
+  }
+  else {
+    // Add the function to the wait list
+    readyList.push( function() { return fn.call(window, []); } );
+  }
+};
+
+NinjsDOM = function() {
+	this.cached_selectors = {};
+};
+
+// This is the public function that people can use to hook up ready.
+NinjsDOM.prototype.ready = function(fn, args) {
+	// Attach the listeners
+	bindReady();
+
+	// If the DOM is already ready
+	if (isReady) {
+		// Execute the function immediately
+		fn.call(window, args || []);
+	}
+	else {
+		// Add the function to the wait list
+		readyList.push( function() { return fn.call(window, args || []); } );
+	}
+};
+
+bindReady();

data/lib/ninjs-framework/core/existence.js

@@ -0,0 +1,60 @@
+is_defined = function(suspect) {
+	return ((suspect === undefined) || (suspect === null)) ? false : true;
+};
+
+is_undefined = function(suspect) {
+	return (suspect === undefined) ? true : false;
+};
+
+is_typeof = function(type, suspect) {
+	if (is_undefined(type)) {
+		throw new SyntaxError("is_typeof(Type, suspect): type is undefined");
+	}
+	if (is_undefined(suspect)) {
+		throw new SyntaxError("is_typeof(Type, suspect): suspect is undefined");
+	}
+
+	return (suspect.constructor == type) ? true : false;
+};
+
+is_numeric = function(suspect) {
+	if(is_typeof(Number, suspect)) {
+		return true;
+	}
+	else {
+		var pattern = /^-?\d+(?:\.\d*)?(?:e[+\-]?\d+)?$/i;
+		return pattern.test(suspect);
+	}
+};
+
+is_string = function(suspect) {
+	return is_typeof(String, suspect);
+};
+
+is_array = function(suspect) {
+	return is_typeof(Array, suspect);
+};
+
+is_number = function(suspect) {
+	return is_typeof(Number, suspect);
+};
+
+is_date = function(suspect) {
+	return is_typeof(Date, suspect);
+};
+
+is_bool = function(suspect) {
+	return is_typeof(Boolean, suspect);
+};
+
+is_regex = function(suspect) {
+	return is_typeof(RegExp, suspect);
+};
+
+is_empty = function(suspect) {
+	return suspect.length === 0;
+};
+
+is_not_empty = function(suspect) {
+	return suspect.length >= 1;
+};

data/lib/ninjs-framework/core/extend.js

@@ -0,0 +1,14 @@
+unless = function(expression, callback, fallback) {
+	if (is_undefined(callback)) {
+		throw new SyntaxError("unless(expression, callback[, fallback]): callback is undefined");
+	}
+
+	if (!!!expression) {
+		callback.call(this);
+	}
+	else {
+		if (is_defined(fallback)) {
+			fallback.call(this);
+		}
+	}
+};

data/lib/ninjs-framework/core/module.js

@@ -0,0 +1,66 @@
+NinjsModule = function(name) {
+	this.dom = new NinjsDOM(this);
+	this.data = {};
+	this.name = name;
+};
+
+NinjsModule.prototype.actions = function() {};
+
+NinjsModule.prototype.run = function() {
+	var mod = this;
+	this.dom.ready(function() {
+		mod.execute();
+	});
+};
+
+NinjsModule.prototype.execute = function() {
+	this.actions();
+};
+
+NinjsModule.prototype.elements = function(elements) {
+	if (is_undefined(elements)) {
+		if (is_typeof(Object, elements)) {
+			throw new SyntaxError("NinjsModule.elements(elements): elements is undefined");
+		}
+		else if (is_string(elements)) {
+			throw new SyntaxError("NinjsModule.elements(name): name is undefined");
+		}
+	}
+
+	if (is_string(elements)) {
+		var name = elements;
+		return this.dom.cached_selectors[name];
+	}
+	else {
+		var dom = this.dom;
+		dom.ready(function() {
+			for(var key in elements) {
+				if (elements.hasOwnProperty(key)) {
+					dom.cached_selectors[key] = elements[key];
+				}
+			}
+		});
+	}
+};
+
+NinjsModule.prototype.set_data = function(key, value) {
+	if (is_undefined(key)) {
+		throw new SyntaxError('NinjsModule.set_data(key, value): key is undefined');
+	}
+
+	if (is_typeof(String, key) && is_undefined(value)) {
+		throw new SyntaxError('NinjsModule.set_data(key, value): value is undefined');
+	}
+
+	if (is_typeof(String, key)) {
+		this.data[key] = value;
+	}
+  else if (is_typeof(Object, key)) {
+		var data = key;
+		for(var property in data) {
+			this.data[property] = data[property];
+		}
+	}
+
+	return this;
+};

data/lib/ninjs-framework/core/nin.js

@@ -0,0 +1,5 @@
+//= require "existence"
+//= require "extend"
+//= require "dom"
+//= require "module"
+//= require "application"

data/lib/ninjs-framework/extensions/jquery.elements.js

@@ -0,0 +1,60 @@
+(function($) { 
+	NinjsModule.prototype.elements = function(elements, force) {
+		var self = this;
+
+		unless(is_defined(force), function() {
+			force = false;
+		});
+
+		if (is_string(elements)) {
+			var key = elements;
+			if (is_undefined(self.dom[key])) {
+				throw new SyntaxError("NinjsModule.elements('" + key + "'): " + self.name + ".dom." + key + " is undefined");
+			}
+
+			if (is_string(self.dom[key])) {
+				var selection = $(self.dom[key]);
+
+				unless(selection.length === 0, function() {
+					return self.dom[key] = selection;
+				}, function() {
+					return self.dom[key];
+				});
+			}
+			else {
+				if (self.dom[key].length === 0 || force) {
+
+					var return_obj = undefined;
+
+					if (is_string(force)) {
+						var selector = self.dom[key].selector;
+						self.dom[key] = $(force).find(selector);
+						self.dom[key].selector = selector;
+
+						return_obj = self.dom[key];
+					}
+
+					var selection = $(self.dom[key].selector);
+				
+					unless(selection.length === 0, function() {
+						return_obj = selection;
+					});
+
+					return return_obj;
+				}
+				else {
+					return self.dom[key];
+				}
+			}
+		}
+		else if (is_typeof(Object, elements)) {
+			self.call_on_ready(function() {
+				for(var key in elements) {
+					if (elements.hasOwnProperty(key)) {
+						self.dom[key] = elements[key];
+					}
+				}
+			});
+		}
+	};
+})(jQuery);

data/lib/ninjs-framework/templates/application.js.erb

@@ -0,0 +1,3 @@
+//-- This file was automatically generated by Ninjs @ <%= Time.now.to_s %> DO NOT EDIT THIS FILE --//\n"
+<%= ninjs_lib %>
+var <%= @config[:name] %> = new NinjsApplication(); 

data/lib/ninjs-framework/templates/autoload.js.erb

@@ -0,0 +1,3 @@
+/*---------- Ninjs autoload <%= auto_file %> ----------*/
+<%= "//= require #{auto_file}" if is_repo %>
+<%= "//= require \"#{auto_file}\"" unless is_repo %>

data/lib/ninjs-framework/templates/core.js.erb

@@ -0,0 +1,3 @@
+/*---------- Ninjs core ../lib/nin.js ----------*/
+//= require "../lib/nin.js"
+var <%= @config[:name] %> = new NinjsApplication();

data/lib/ninjs-framework/templates/dependency.js.erb

@@ -0,0 +1,3 @@
+/*---------- Ninjs dependency <%= dependency %> ----------*/
+<%= "//= require #{dependency}" if is_repo %>
+<%= "//= require \"#{dependency}\"" unless is_repo %>

data/lib/ninjs-framework/templates/jasmine.yml.erb

@@ -0,0 +1,75 @@
+# src_files
+#
+# Return an array of filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# src_files:
+#   - lib/source1.js
+#   - lib/source2.js
+#   - dist/**/*.js
+#
+src_files:
+    - lib/core/*.js
+    - lib/extensions/*.js
+    - lib/utilities/*.js
+
+# stylesheets
+#
+# Return an array of stylesheet filepaths relative to src_dir to include before jasmine specs.
+# Default: []
+#
+# EXAMPLE:
+#
+# stylesheets:
+#   - css/style.css
+#   - stylesheets/*.css
+#
+stylesheets:
+
+# helpers
+#
+# Return an array of filepaths relative to spec_dir to include before jasmine specs.
+# Default: ["helpers/**/*.js"]
+#
+# EXAMPLE:
+#
+# helpers:
+#   - helpers/**/*.js
+#
+helpers:
+
+# spec_files
+#
+#  Return an array of filepaths relative to spec_dir to include.
+# Default: ["**/*[sS]pec.js"]
+#
+# EXAMPLE:
+#
+# spec_files:
+#   - **/*[sS]pec.js
+#
+spec_files:
+
+# src_dir
+#
+# Source directory path. Your src_files must be returned relative to this path. Will use root if left blank.
+# Default: project root
+#
+# EXAMPLE:
+#
+# src_dir: public
+#
+src_dir:
+
+# spec_dir
+#
+# Spec directory path. Your spec_files must be returned relative to this path.
+# Default: spec/javascripts
+#
+# EXAMPLE:
+#
+# spec_dir: spec/javascripts
+#
+spec_dir: