changed jsdoc documentation in jquery.karma.js so that it no longer shows jquery-anonymous in front of a bunch of classes

author: Bryan Berry <bryan@olenepal.org> 2009-10-14 06:39:11 (GMT)
committer: Bryan Berry <bryan@olenepal.org> 2009-10-14 06:39:11 (GMT)
commit: adfc3c62ac50c1fbb52811999377a2e32309d690 (patch)
tree: b6fde34d67772ddb1bf8664e3bcec9c1e2c03929
parent: 602eca1669b29ba7d5cdb6e4ecff370a9368c1ac (diff)
7 files changed, 798 insertions, 36 deletions
diff --git a/chakra/knavbar.html b/chakra/knavbar.html
new file mode 100644
index 0000000..8855a22
--- /dev/null
+++ b/chakra/knavbar.html
@@ -0,0 +1,12 @@
+<nav id="knavbar" class="name">
+		<a id="knavbarHome" href="">
+		<img  src="assets/images/chakra_logo.png" alt="Home" title="Home" class="topNav floatLeft"/>
+		</a>
+		<a id="knavbarHelp" href="">
+		<img  src="assets/images/help.png" alt="Help" title="Help" class="topNav floatRight"/>
+		</a>
+		<a id="knavbarAbout" href="">
+		<img id="knavbarAbout" src="assets/images/karma_logo.png" alt="Karma icon" title="About Karma"
+		     class="topNav floatRight"/>
+		</a>
+</nav>
+\ No newline at end of file
diff --git a/chakra/knavbar.html.~2~ b/chakra/knavbar.html.~2~
new file mode 100644
index 0000000..517254e
--- /dev/null
+++ b/chakra/knavbar.html.~2~
@@ -0,0 +1,12 @@
+<nav id="knavbar" class="name">
+		<a id="knavbarHome" href="" class="url@href">
+		<img  src="assets/images/chakra_logo.png" alt="Home" title="Home" class="topNav floatLeft"/>
+		</a>
+		<a id="knavbarHelp" href="">
+		<img  src="assets/images/help.png" alt="Help" title="Help" class="topNav floatRight"/>
+		</a>
+		<a id="knavbarAbout" href="">
+		<img id="knavbarAbout" src="assets/images/karma_logo.png" alt="Karma icon" title="About Karma"
+		     class="topNav floatRight"/>
+		</a>
+</nav>
+\ No newline at end of file
diff --git a/index.html b/index.html
index 0e163b2..46ebb45 100755
--- a/index.html
+++ b/index.html
@@ -1,24 +1,17 @@
-<!doctype html>
+<!DOCTYPE html>
 <html>
 <head>
 <title>Chakra (Alpha)</title>
 <meta name="keywords" content="karma javascript html5 sugar sugarlabs gsoc ole nepal"/>
 <meta charset="UTF-8"/>
-
+<link type="image/ico" rel="icon" href="assets/default/images/favicon.ico" /> 
 <link rel="stylesheet" href="css/chakra.css" type="text/css"/>
 <script src="js/jquery-1.3.2.min.js"></script>
-
-<link type="image/ico" rel="icon" href="assets/default/images/favicon.ico" /> 
+<script src="js/knavbar.js"></script>
 </head>
 
 <body>
 <section id="navigation">
-	<nav id="knavbar">
-		<img src="assets/images/chakra_logo.png" alt="Home" title="Home" class="topNav floatLeft"/>
-		<img src="assets/images/help.png" alt="Help" title="Help" class="topNav floatRight"/>
-		<img src="assets/images/karma_logo.png" alt="Karma icon" title="About Karma" class="topNav floatRight"/>
-	</nav>
-
 
 </section>
 
diff --git a/js/jquery.karma.js b/js/jquery.karma.js
index c30753d..90e7811 100755
--- a/js/jquery.karma.js
+++ b/js/jquery.karma.js
@@ -38,7 +38,6 @@
  
 /**
  * See <a href="http://jquery.com">jQuery</a>.
- * @class
  * @name jQuery
  * @exports $ as jQuery
 */
@@ -93,6 +92,7 @@ var clone = function( obj ){
 Karma
 @name Karma
 @class Represents a Karma (master) object.
+@namespace 
 @param {String | Object } options Constructor arguments 
 @param {String | Object } [options.container] Target DIV-class that will contain
 	any canvas element created using Karma functions
@@ -151,7 +151,7 @@ var Karma = function( options ) {
 			}
 		}
 		return { "lang": lang };
-	}
+	};
 	/**
 	Creates a new Gettext object and returns a shortcut function to localise 
 	defined strings.<br>We use karma.Gettext.js it's a modification of 
@@ -204,7 +204,7 @@ var Karma = function( options ) {
 		//dirty hack to support {lang}_AudioFile
 		var prefix = lang+"_";
 		that.paths[ "sounds" ].localized+=prefix;
-	}
+	};
 	/**
 	It will attempt to load a language file, the posible languages are defined 
 	on language.alternatives.
@@ -259,7 +259,7 @@ var Karma = function( options ) {
 			}
 		});
 		return loaded;
-	}
+	};
 	//PRIVATE STUFF end
 	// default options 
 	var defaultOptions ={
@@ -319,7 +319,7 @@ var Karma = function( options ) {
 		"paths": this.paths
 	}
 	this.surfaces = {};
-}
+};
 
 /**
 @memberOf Karma 
@@ -353,7 +353,8 @@ Karma.prototype.geometry = {
 	distance : function ( p0, p1 ) {
 		return   Math.sqrt( Karma.prototype.geometry.distance2( p0, p1 ) ); 
 	}
-}
+
+};
 /**
 @memberOf Karma
 @namespace Graphics functions.
@@ -398,7 +399,7 @@ $.extend( Karma.prototype, Karma.prototype.graphics);
 Karma.prototype.init = function( toLoad ) {
 	this.pendingToLoad = toLoad;
 	return this; //chaining :)
-}
+};
 
 /**
 Main function. Any Karma function call should be inside the callback function.
@@ -416,7 +417,7 @@ Karma.prototype.main = function ( cb ) {
 		
 		var statusUpdate = function ( current, error, total) {
 			statusDiv.html(current + "/" + total + (error > 0 ? " [ "+error+" ]":''));
-		}
+		};
 		
 		var that = this;
 		var categories = ["images", "sounds", "videos" ];
@@ -456,7 +457,7 @@ Karma.prototype.main = function ( cb ) {
 					$(this).remove();});
 				if ( cb ) cb();
 			}
-		}
+		};
 		
 		for ( var i=0; i < categories.length; i++ ) {
 			var category = categories[ i ];
@@ -532,7 +533,7 @@ Karma.prototype.surface = function ( options ) {
 	options.paths = this.paths;
 	this.surfaces[ options.name ] = new KSurface( options ); 
 	return this.surface[ options.name ];
-}
+};
 
 /**
 Mouse
@@ -548,10 +549,10 @@ mouse.getRelativeCanvasPosition = function ( ev ) {
 	xy.x = ev.layerX;
     xy.y = ev.layerY;
 	return xy;
-}
+};
 
 //Events stuff
-var master ={}
+var master ={};
 master.buttons =[];
 var handleEvents = function( ev ) {
 	var xy = mouse.getRelativeCanvasPosition( ev  );
@@ -633,6 +634,7 @@ There are 2 ways to create a new KSurface:
 		You must provide at least the 'name' and 'container' parameters.
 	</li>
 </ol>
+@name KSurface
 @class KSurface class
 @param {object} options Constructor options.
 @param {string} [options.name]  The desired name for the surface. The value must
@@ -645,7 +647,7 @@ There are 2 ways to create a new KSurface:
 @param {number} [height=100] The height of the canvas.
 @param {number} [fps=24] The frames per second for any refresh operation.
 @param {boolean} [visible=true] 'true' if the content is visible (will be drawn).
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KSurface = Class(
 	{
@@ -680,7 +682,7 @@ var KSurface = Class(
 				height: 100,
 				fps: 24,
 				visible: true
-			}
+			};
 			$.extend( this, defaultOptions, options);
 			
 			if ( !this.canvas ) {
@@ -733,8 +735,8 @@ var KSurface = Class(
 						throw ("wtf?!: impossible to chain " + name + "!");
 					}
 					return that;
-				}
-			}
+				};
+			};
 			for (var i=0; i<toChain.length; i++){
 				chainMaker(  toChain[ i ] );
 			}
@@ -795,10 +797,11 @@ var KSurface = Class(
 
 /**
 Karma basic Object 
+@name KObject
 @class The basic Karma object
 @param {Object} [options] Options 
 @param {String} [options.localized = true] The object will be localized
-@memberOf_ Karma 
+@memberOf Karma
 **/
 var KObject = Class(
 	{
@@ -813,6 +816,7 @@ var KObject = Class(
 );
 /**
 Graphics basic Object
+@name KGraphic
 @class General methods for any Graphic object
 @param {object} [options] Options 
 @param {number} [options.x = 0] The 'x' position of the object
@@ -822,8 +826,8 @@ Graphics basic Object
 @param {number} [options.height = 0] The 'height' of the object
 @param {boolean} [options.visible = true] Defines if the object will be visible 
 	when drawing
+@memberOf Karma
 @augments KObject
-@memberOf_ Karma 
 **/
 var KGraphic = Class(
 	KObject,
@@ -858,9 +862,10 @@ var KGraphic = Class(
 );
 /**
 An object that collects multiple KGraphic objects. Supports multiple objects.
+@name KGroup
 @class An object that collects multiple KGraphic objects 
 @augments KGraphic
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KGroup = Class(
 	KGraphic,
@@ -888,7 +893,7 @@ var KGroup = Class(
 			//FIXME
 		},
 		/**
-		@memberOf_ KGroup
+		@memberOf KGroup
 		Draws all the elements in childNodes. The elements are drawn according
 		to its 'z' (z-index) value.
 		@see KGroup#appendChild
@@ -915,13 +920,14 @@ var KGroup = Class(
 
 /**
 Graphics basic Media object.
+@name KMedia
 @class General methods for any Graphic object
 @param {String} file  The name of the file that must be loaded
 @param {String} type 'image', 'sound' or 'video'
 @param {Object} [options] Options that will be passed to the media element
 	constructor  
 @augments KObject
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KMedia = Class(
 	KObject,
@@ -962,12 +968,13 @@ var KMedia = Class(
 
 /**
 Image object
+@name KImage
 @class General methods for any Image object
 @param {Object} options Constructor arguments.
 @param {Object} options.file The image file that will be loaded.
 @augments KGraphic
 @augments KMedia
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KImage = Class(
 	KGraphic,
@@ -1009,11 +1016,12 @@ var KImage = Class(
 
 /**
 Sound object
+@name KSound
 @class General methods for any Sound object
 @param {Object} options Constructor arguments.
 @param {Object} options.file The image file that will be loaded.
 @augments KMedia
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KSound = Class(
 	/**@lends_ KMedia*/
@@ -1047,6 +1055,7 @@ var KSound = Class(
 
 /**
 Shape object
+@name KShape
 @class General methods for any Shape object
 @param {object} options Constructor arguments.
 @param {boolean} [options.fill=true] 'true' if the Shape will be filled when 
@@ -1055,7 +1064,7 @@ Shape object
 @param {color|string} [options.fillStyle="#000"] The fill style of the shape.
 @param {color|string} [options.strokeStyle="#000"] The stroke style of the shape.
 @augments KMedia
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KShape = Class(
 	/**@lends_ KGraphic*/
@@ -1071,7 +1080,7 @@ var KShape = Class(
 				fillStyle: '#000',
 				strokeStyle: '#000',
 				openPath : false
-			}
+			};
 			$.extend( this, defaultOptions, options);
 		},
 		draw : function ( ctx ) {
@@ -1091,6 +1100,7 @@ var KShape = Class(
 );
 /**
 Rectangle object
+@name KRectangle
 @class General methods for a rectangle object
 @param {object} options Constructor arguments.
 @param {number} options.x The 'x' position.
@@ -1098,7 +1108,7 @@ Rectangle object
 @param {number} options.w The width of the rectangle. 
 @param {number} options.h The height of the rectangle.
 @augments KShape
-@memberOf_ Karma 
+@memberOf Karma 
 **/
 var KRectangle = Class(
 	KShape,
diff --git a/js/knavbar.js b/js/knavbar.js
new file mode 100644
index 0000000..c7fd93b
--- /dev/null
+++ b/js/knavbar.js
@@ -0,0 +1,15 @@
+//This code loads in html for knavbar into a <section>
+//tag with the id="navigation"
+$(document).ready(function(){    
+    
+    //updates the links in knavbar
+    //specific to the context
+    var modify = function(){
+	document.write('foo');
+	$('#knavbarHome').attr('href', 'foo');
+	
+    };
+
+    var foo = $('#navigation').load('chakra/kfoo.html #knavbar', modify);
+    var x = 0;
+});
+\ No newline at end of file
diff --git a/js/knavbar.js.~2~ b/js/knavbar.js.~2~
new file mode 100644
index 0000000..96c31f2
--- /dev/null
+++ b/js/knavbar.js.~2~
@@ -0,0 +1,10 @@
+//This code loads in html for knavbar into a <section>
+//tag with the id="navigation"
+$(document).ready(function(){
+    $('#navigation').load('chakra/knavbar.html #knavbar');
+    
+    //set chakra to foo
+    
+
+
+});
+\ No newline at end of file
diff --git a/js/pure2.js b/js/pure2.js
new file mode 100644
index 0000000..1e0958f
--- /dev/null
+++ b/js/pure2.js
@@ -0,0 +1,710 @@
+/* * * * * * * * * * * * * * * * * * * * * * * * * *
+
+	PURE Unobtrusive Rendering Engine for HTML
+
+	Licensed under the MIT licenses.
+	More information at: http://www.opensource.org
+
+	Copyright (c) 2009 Michael Cvilic - BeeBole.com
+
+	Thanks to Rog Peppe for the functional JS jump
+	revision: 2.18
+
+* * * * * * * * * * * * * * * * * * * * * * * * * */
+
+var $p, pure = $p = function(){
+	var sel = arguments[0], 
+		ctxt = false;
+
+	if(typeof sel === 'string'){
+		ctxt = arguments[1] || false;
+	}
+	return $p.core(sel, ctxt);
+};
+
+$p.core = function(sel, ctxt, plugins){
+	//get an instance of the plugins
+	var plugins = getPlugins(),
+		templates = [];
+
+	//search for the template node(s)
+	if(typeof sel === 'string'){
+		templates = plugins.find(ctxt || document, sel);
+	}else if(typeof sel === 'object'){
+		templates = [sel];
+	}else{
+		error('No templates found. Review your selector');
+	}
+	
+	for(var i = 0, ii = templates.length; i < ii; i++){
+		plugins[i] = templates[i];
+	}
+	plugins.length = ii;
+
+	// set the signature string that will be replaced at render time
+	var Sig = '_s' + Math.floor( Math.random() * 1000000 ) + '_',
+		// another signature to prepend to attributes and avoid checks: style, height, on[events]...
+		attPfx = '_a' + Math.floor( Math.random() * 1000000 ) + '_',
+		// rx to parse selectors, e.g. "+tr.foo[class]"
+		selRx = /^(\+)?([^\@\+]+)?\@?([^\+]+)?(\+)?$/,
+		// set automatically attributes for some tags
+		autoAttr = {
+			IMG:'src',
+			INPUT:'value'
+		};
+	
+	return plugins;
+
+
+	/* * * * * * * * * * * * * * * * * * * * * * * * * *
+		core functions
+	 * * * * * * * * * * * * * * * * * * * * * * * * * */
+
+
+	// error utility
+	function error(e){
+		alert(e);
+		if(typeof console !== 'undefined'){
+			console.log(e);
+			debugger;
+		}
+		throw('pure error: ' + e);
+	}
+	
+	//return a new instance of plugins
+	function getPlugins(){
+		var plugins = $p.plugins,
+			f = function(){};
+		f.prototype = plugins;
+
+		// do not overwrite functions if external definition
+		f.prototype.compile    = plugins.compile || compile;
+		f.prototype.render     = plugins.render || render;
+		f.prototype.autoRender = plugins.autoRender || autoRender;
+		f.prototype.find       = plugins.find || find;
+		
+		// give the compiler and the error handling to the plugin context
+		f.prototype._compiler  = compiler;
+		f.prototype._error     = error;
+ 
+		return new f();
+	}
+	
+	// returns the outer HTML of a node
+	function outerHTML(node){
+		// if IE take the internal method otherwise build one
+		return node.outerHTML || (
+			function(n){
+        		var div = document.createElement('div'), h;
+	        	div.appendChild( n.cloneNode(true) );
+				h = div.innerHTML;
+				div = null;
+				return h;
+			})(node);
+	}
+
+	// check if the argument is an array
+	function isArray(o){
+		return Object.prototype.toString.call( o ) === "[object Array]";
+	}
+	
+	// returns the string generator function
+	function wrapquote(qfn, f){
+		return function(ctxt){
+			return qfn('' + f(ctxt));
+		};
+	}
+
+	// convert a JSON HTML structure to a dom node and returns the leaf
+	function domify(ns, pa){
+		pa = pa || document.createDocumentFragment();
+		var nn, leaf;
+		for(var n in ns){
+			nn = document.createElement(n);
+			pa.appendChild(nn);
+			if(typeof ns[n] === 'object'){
+				leaf = domify(ns[n], nn);
+			}else{
+				leaf = document.createElement(ns[n]);
+				nn.appendChild(leaf);
+			}
+		}
+		return leaf;
+	};
+	
+		// default find using querySelector when available on the browser
+	function find(n, sel){
+		if(typeof n === 'string'){
+			sel = n;
+			n = false;
+		}
+		if(typeof document.querySelectorAll !== 'undefined'){
+			return (n||document).querySelectorAll( sel );
+		}else{
+			error('You can test PURE standalone with: iPhone, FF3.5+, Safari4+ and IE8+\n\nTo run PURE on your browser, you need a JS library/framework with a CSS selector engine');
+		}
+	}
+	
+	// create a function that concatenates constant string
+	// sections (given in parts) and the results of called
+	// functions to fill in the gaps between parts (fns).
+	// fns[n] fills in the gap between parts[n-1] and parts[n];
+	// fns[0] is unused.
+	// this is the inner template evaluation loop.
+	function concatenator(parts, fns){
+		return function(ctxt){
+			var strs = [ parts[ 0 ] ],
+				n = parts.length,
+				fnVal, pVal, attLine, pos;
+
+			for(var i = 1; i < n; i++){
+				fnVal = fns[i]( ctxt );
+				pVal = parts[i];
+				
+				// if the value is empty and attribute, remove it
+				if(fnVal === ''){
+					attLine = strs[ strs.length - 1 ];
+					if( ( pos = attLine.search( /[\w]+=\"?$/ ) ) > -1){
+						strs[ strs.length - 1 ] = attLine.substring( 0, pos );
+						pVal = pVal.substr( 1 );
+					}
+				}
+				
+				strs[ strs.length ] = fnVal;
+				strs[ strs.length ] = pVal;
+			}
+			return strs.join('');
+		};
+	}
+
+	// parse and check the loop directive
+	function parseloopspec(p){
+		var m = p.match( /^(\w+)\s*<-\s*(\S+)?$/ );
+		if(m === null){
+			error('bad loop spec: "' + p + '"');
+		}
+		if(m[1] === 'item'){
+			error('"item<-..." is a reserved word for the current running iteration.\n\nPlease choose another name for your loop.');
+		}
+		if( !m[2] ){ //undefined or space(IE) 
+			m[2] = function(ctxt){return ctxt.data;};
+		}
+		return {name: m[1], sel: m[2]};
+	}
+
+	// parse a data selector and return a function that
+	// can traverse the data accordingly, given a context.
+	function dataselectfn(sel){
+		if(typeof(sel) === 'function'){
+			return sel;
+		}
+		//check for a valid js variable name with hyphen(for properties only) and $
+		var m = sel.match(/^[a-zA-Z$_][\w$]*(\.[\w$-]*[^\.])*$/);
+		if(m === null){
+			var found = false, s = sel, parts = [], pfns = [], i = 0, retStr;
+			// check if literal
+			if(/\'|\"/.test( s.charAt(0) )){
+				if(/\'|\"/.test( s.charAt(s.length-1) )){
+					retStr = s.substring(1, s.length-1);
+					return function(){ return retStr; };
+				}
+			}else{
+				// check if literal + #{var}
+				while((m = s.match(/#\{([^{}]+)\}/)) !== null){
+					found = true;
+					parts[i++] = s.slice(0, m.index);
+					pfns[i] = dataselectfn(m[1]);
+					s = s.slice(m.index + m[0].length, s.length);
+				}
+			}
+			if(!found){
+				error('bad data selector syntax: ' + sel);
+			}
+			parts[i] = s;
+			return concatenator(parts, pfns);
+		}
+		m = sel.split('.');
+		return function(ctxt){
+			var data = ctxt.data;
+			if(!data){
+				return '';
+			}
+			var	v = ctxt[m[0]],
+				i = 0;
+			if(v){
+				data = v.item;
+				i += 1;
+			}
+			var n = m.length;
+			for(; i < n; i++){
+				if(!data){break;}
+				data = data[m[i]];
+			}
+			return (!data && data !== 0) ? '':data;
+		};
+	}
+
+	// wrap in an object the target node/attr and their properties
+	function gettarget(dom, sel, isloop){
+		var osel, prepend, selector, attr, append, target = [];
+		if( typeof sel === 'string' ){
+			osel = sel;
+			var m = sel.match(selRx);
+			if( !m ){
+				error( 'bad selector syntax: ' + sel );
+			}
+			
+			prepend = m[1];
+			selector = m[2];
+			attr = m[3];
+			append = m[4];
+			
+			if(selector === '.' || ( !selector && attr ) ){
+				target[0] = dom;
+			}else{
+				target = plugins.find(dom, selector);
+			}
+			if(!target || target.length === 0){
+				return {attr: null, nodes: target, set: null, sel: osel};
+			}
+		}else{
+			// autoRender node
+			prepend = sel.prepend;
+			attr = sel.attr;
+			append = sel.append;
+			target = [dom];
+		}
+		
+		if( prepend || append ){
+			if( prepend && append ){
+				error('append/prepend cannot take place at the same time');
+			}else if( isloop ){
+				error('no append/prepend/replace modifiers allowed for loop target');
+			}else if( append && isloop ){
+				error('cannot append with loop (sel: ' + osel + ')');
+			}
+		}
+		var setstr, getstr, quotefn, isStyle, isClass, an;
+		if(attr){
+			isStyle = (/^style$/i).test(attr);
+			isClass = (/^class$/i).test(attr);
+			attName = isClass ? 'className' : attr;
+			setstr = function(node, s){
+				node.setAttribute( attPfx + attr, s );
+				if(attName in node && !isStyle){ 
+					node[ attName ] = '' ;
+				}
+				if(node.nodeType === 1){ 
+					node.removeAttribute(  attr );
+				}
+			};
+			if( isStyle ){
+				getstr = function(node){ return node.style.cssText;};
+			}else{
+				getstr = function(node){ return node.getAttribute(attr);};
+			}
+			if( isStyle || isClass ){//IE no quotes special care
+				quotefn = function(s){ return s.replace(/\"/g, '&quot;');};
+			}else{
+				quotefn = function(s){ return s.replace(/\"/g, '&quot;').replace(/\s/g, '&nbsp;');};
+			}
+		}else{
+			if(isloop){
+				setstr = function(node, s){
+					// we can have a null parent node
+					// if we get overlapping targets.
+					var pn = node.parentNode;
+					if(pn){
+						//replace node with s
+						var t = document.createTextNode(s);
+						node.parentNode.insertBefore(t, node.nextSibling);
+						node.parentNode.removeChild(node);
+					}
+				};
+			}else{
+				getstr = function(node){ return node.innerHTML; };
+				setstr = function(node, s){ node.innerHTML = s; };
+			}
+			quotefn = function(s){ return s; };
+		}
+		var setfn;
+		if(prepend){
+			setfn = function(node, s){ setstr( node, s + getstr( node ) );};
+		}else if(append){
+			setfn = function(node, s){ setstr( node, getstr( node ) + s );};
+		}else{
+			setfn = function(node, s){ setstr( node, s );};
+		}
+		return {attr: attr, nodes: target, set: setfn, sel: osel, quotefn: quotefn};
+	}
+
+	function setsig(target, n){
+		var sig = Sig + n + ':';
+		for(var i = 0; i < target.nodes.length; i++){
+			// could check for overlapping targets here.
+			target.set( target.nodes[i], sig );
+		}
+	}
+
+	// read de loop data, and pass it to the inner rendering function
+	function loopfn(name, dselect, inner){
+		return function(ctxt){
+			var a = dselect(ctxt),
+				old = ctxt[name],
+				temp = { items : a },
+				strs = [],
+				buildArg = function(idx){
+					ctxt.items = a;
+					ctxt.pos = temp.pos = idx;
+					ctxt.item = temp.item = a[ idx ];
+					strs.push( inner( ctxt ) );
+				};
+			ctxt[name] = temp;
+			if( isArray(a) ){
+				//loop on array
+				for(var i = 0, ii = a.length || 0; i < ii; i++){  
+					buildArg(i); 
+				}
+			}else{
+				//loop on collections
+				for(var prop in a){
+					a.hasOwnProperty( prop ) && buildArg(prop); 
+				}
+			}
+			typeof old !== 'undefined' ? ctxt[name] = old : delete ctxt[name];
+			return strs.join('');
+		};
+	}
+	// generate the template for a loop node
+	function loopgen(dom, sel, loop, fns){
+		var already = false;
+		var p;
+		for(var i in loop){
+			if(loop.hasOwnProperty(i)){
+				if(already){
+					error('cannot have more than one loop on a target');
+				}
+				p = i;
+				already = true;
+			}
+		}
+		if(!p){
+			error('no loop spec');
+		}
+		var dsel = loop[p];
+		// if it's a simple data selector then we default to contents, not replacement.
+		if(typeof(dsel) === 'string' || typeof(dsel) === 'function'){
+			loop = {};
+			loop[p] = {root: dsel};
+			return loopgen(dom, sel, loop, fns);
+		}
+		var spec = parseloopspec(p),
+			itersel = dataselectfn(spec.sel),
+			target = gettarget(dom, sel, true),
+			nodes = target.nodes;
+			
+		for(i = 0; i < nodes.length; i++){
+			// could check for overlapping loop targets here by checking that
+			// root is still ancestor of node.
+			var node = nodes[i],
+				inner = compiler(node, dsel);
+			fns[fns.length] = wrapquote(target.quotefn, loopfn(spec.name, itersel, inner));
+			target.nodes = [node];		// N.B. side effect on target.
+			setsig(target, fns.length - 1);
+		}
+	}
+	
+	function getAutoNodes(n, data){
+		var ns = n.getElementsByTagName('*'),
+			an = [],
+			openLoops = {a:[],l:{}},
+			cspec,
+			isNodeValue,
+			i, ii, j, jj, ni, cs, cj;
+		//for each node found in the template
+		for(i = -1, ii = ns.length; i < ii; i++){
+			ni = i > -1 ?ns[i]:n;
+			if(ni.nodeType === 1 && ni.className !== ''){
+				//when a className is found
+				cs = ni.className.split(' ');
+				// for each className 
+				for(j = 0, jj=cs.length;j<jj;j++){
+					cj = cs[j];
+					// check if it is related to a context property
+					cspec = checkClass(cj, ni.tagName);
+					// if so, store the node, plus the type of data
+					if(cspec !== false){
+						isNodeValue = (/nodevalue/i).test(cspec.attr);
+						if(cspec.sel.indexOf('@') > -1 || isNodeValue){
+							ni.className = ni.className.replace('@'+cspec.attr, '');
+							if(isNodeValue){
+								cspec.attr = false;
+							} 
+						}
+						an.push({n:ni, cspec:cspec});
+					}
+				}
+			}
+		}
+		return an;
+		
+		function checkClass(c, tagName){
+			// read the class
+			var ca = c.match(selRx),
+				attr = ca[3] || autoAttr[tagName],
+				cspec = {prepend:!!ca[1], prop:ca[2], attr:attr, append:!!ca[4], sel:c},
+				val = isArray(data) ? data[0][cspec.prop] : data[cspec.prop],
+				i, ii, loopi;
+			// if first level of data is found
+			if(typeof val === 'undefined'){
+				// check in existing open loops
+				for(i = openLoops.a.length-1; i >= 0; i--){
+					loopi = openLoops.a[i];
+					val = loopi.l[0][cspec.prop];
+					if(typeof val !== 'undefined'){
+						cspec.prop = loopi.p + '.' + cspec.prop;
+						if(openLoops.l[cspec.prop] === true){
+							val = val[0];
+						}
+						break;
+					}
+				}
+			}
+			// nothing found return
+			if(typeof val === 'undefined'){
+				return false;
+			}
+			// set the data type and details
+			if(isArray(val)){
+				openLoops.a.push( {l:val, p:cspec.prop} );
+				openLoops.l[cspec.prop] = true;
+				cspec.t = 'loop';
+			}else{
+				cspec.t = 'str';
+			}
+			return cspec;
+		}
+	}
+
+	// returns a function that, given a context argument,
+	// will render the template defined by dom and directive.
+	function compiler(dom, directive, data, ans){
+		var fns = [];
+		// autoRendering nodes parsing -> auto-nodes
+		ans = ans || data && getAutoNodes(dom, data);
+		if(data){
+			var j, jj, cspec, n, target, nodes, itersel, node, inner;
+			// for each auto-nodes
+			while(ans.length > 0){
+				cspec = ans[0].cspec;
+				n = ans[0].n;
+				ans.splice(0, 1);
+				if(cspec.t === 'str'){
+					// if the target is a value
+					target = gettarget(n, cspec, false);
+					setsig(target, fns.length);
+					fns[fns.length] = wrapquote(target.quotefn, dataselectfn(cspec.prop));
+				}else{
+					// if the target is a loop
+					itersel = dataselectfn(cspec.sel);
+					target = gettarget(n, cspec, true);
+					nodes = target.nodes;
+					for(j = 0, jj = nodes.length; j < jj; j++){
+						node = nodes[j];
+						inner = compiler(node, false, data, ans);
+						fns[fns.length] = wrapquote(target.quotefn, loopfn(cspec.sel, itersel, inner));
+						target.nodes = [node];
+						setsig(target, fns.length - 1);
+					}
+				}
+			}
+		}
+		// read directives
+		var target, dsel;
+		for(var sel in directive){
+			if(directive.hasOwnProperty(sel)){
+				dsel = directive[sel];
+				if(typeof(dsel) === 'function' || typeof(dsel) === 'string'){
+					// set the value for the node/attr
+					target = gettarget(dom, sel, false);
+					setsig(target, fns.length);
+					fns[fns.length] = wrapquote(target.quotefn, dataselectfn(dsel));
+				}else{
+					// loop on node
+					loopgen(dom, sel, dsel, fns);
+				}
+			}
+		}
+        // convert node to a string 
+        var h = outerHTML(dom), pfns = [];
+		// IE adds an unremovable "selected" attribute
+		// hard replace while waiting for a better solution
+		if (dom.tagName === 'OPTION' && (new RegExp(attPfx + 'selected', 'i')).test(h)) {
+			h = h.replace(/\sselected\s/, ' ');
+		}
+        // remove attribute prefix
+        h = h.split(attPfx).join('');
+
+		// slice the html string at "Sig"
+		var parts = h.split( Sig ), p;
+		// for each slice add the return string of 
+		for(var i = 1; i < parts.length; i++){
+			p = parts[i];
+			// part is of the form "fn-number:..." as placed there by setsig.
+			pfns[i] = fns[ parseInt(p, 10) ];
+			parts[i] = p.substring( p.indexOf(':') + 1 );
+		}
+		return concatenator(parts, pfns);
+	}
+	// compile the template with directive
+	// if a context is passed, the autoRendering is triggered automatically
+	// return a function waiting the data as argument
+	function compile(directive, ctxt, template){
+		var rfn = compiler( ( template || this[0] ).cloneNode(true), directive, ctxt);
+		return function(data, context){
+			context = context || data;
+			return rfn({data: data, context:context});
+		};
+	}
+	//compile with the directive as argument
+	// run the template function on the context argument
+	// return an HTML string 
+	// should replace the template and return this
+	function render(ctxt, directive){
+		var fn = typeof directive === 'function' ? directive : plugins.compile( directive, false, this[0] );
+		for(var i = 0, ii = this.length; i < ii; i++){
+			this[i] = replaceWith( this[i], fn( ctxt, false ));
+		}
+		context = null;
+		return this;
+	}
+
+	// compile the template with autoRender
+	// run the template function on the context argument
+	// return an HTML string 
+	function autoRender(ctxt, directive){
+		var fn = plugins.compile( directive, ctxt, this[0] );
+		for(var i = 0, ii = this.length; i < ii; i++){
+			this[i] = replaceWith( this[i], fn( ctxt, false));
+		}
+		context = null;
+		return this;
+	}
+	
+	function replaceWith(elm, html){
+		var div = document.createElement('DIV'),
+			tagName = elm.tagName.toLowerCase(),
+			ne, pa;
+		if((/td|tr|th/).test(tagName)){
+			var parents = {	tr:{table:'tbody'}, td:{table:{tbody:'tr'}}, th:{table:{thead:'tr'}} };
+			pa = domify( parents[ tagName ] );
+		}else if( ( /tbody|thead|tfoot/ ).test( tagName )){
+			pa = document.createElement('table');
+		}else{
+			pa = document.createElement('div');
+		}
+
+		var ep = elm.parentNode;
+		// avoid IE mem leak
+		ep.insertBefore(pa, elm);
+		ep.removeChild(elm);
+		pa.innerHTML = html;
+		ne = pa.firstChild;
+		ep.insertBefore(ne, pa);
+		ep.removeChild(pa);
+		elm = ne;
+
+		pa = ne = ep = null;
+		return elm;
+	}
+};
+
+$p.plugins = {};
+
+$p.libs = {
+	dojo:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				return dojo.query(sel, n);
+			};
+		}
+	},
+	domassistant:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				return $(n).cssSelect(sel);
+			};
+		}
+		DOMAssistant.attach({ 
+			publicMethods : [ 'compile', 'render', 'autoRender'],
+			compile:function(directive, ctxt){ return $p(this).compile(directive, ctxt); },
+			render:function(ctxt, directive){ return $( $p(this).render(ctxt, directive) )[0]; },
+			autoRender:function(ctxt, directive){ return $( $p(this).autoRender(ctxt, directive) )[0]; }
+		});
+	},
+	jquery:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				return $(n).find(sel);
+			};
+		}
+		jQuery.fn.extend({
+			compile:function(directive, ctxt){ return $p(this[0]).compile(directive, ctxt); },
+			render:function(ctxt, directive){ return jQuery( $p( this[0] ).render( ctxt, directive ) ); },
+			autoRender:function(ctxt, directive){ return jQuery( $p( this[0] ).autoRender( ctxt, directive ) ); }
+		});
+	},
+	mootools:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				return $(n).getElements(sel);
+			};
+		}
+		Element.implement({
+			compile:function(directive, ctxt){ return $p(this).compile(directive, ctxt); },
+			render:function(ctxt, directive){ return $p(this).render(ctxt, directive); },
+			autoRender:function(ctxt, directive){ return $p(this).autoRender(ctxt, directive); }
+		});
+	},
+	prototype:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				n = n === document ? n.body : n;
+				return typeof n === 'string' ? $$(n) : $(n).select(sel);
+			};
+		}
+		Element.addMethods({
+			compile:function(element, directive, ctxt){ return $p(element).compile(directive, ctxt); }, 
+			render:function(element, ctxt, directive){ return $p(element).render(ctxt, directive); }, 
+			autoRender:function(element, ctxt, directive){ return $p(element).autoRender(ctxt, directive); }
+		});
+	},
+	sizzle:function(){
+		if(typeof document.querySelector === 'undefined'){
+			$p.plugins.find = function(n, sel){
+				return Sizzle(sel, n);
+			};
+		}
+	},
+	sly:function(){
+		if(typeof document.querySelector === 'undefined'){  
+			$p.plugins.find = function(n, sel){
+				return Sly(sel, n);
+			};
+		}
+	}
+};
+
+// get lib specifics if available
+(function(){
+	var libkey = 
+		typeof dojo         !== 'undefined' && 'dojo' || 
+		typeof DOMAssistant !== 'undefined' && 'domassistant' ||
+		typeof jQuery       !== 'undefined' && 'jquery' || 
+		typeof MooTools     !== 'undefined' && 'mootools' ||
+		typeof Prototype    !== 'undefined' && 'prototype' || 
+		typeof Sizzle       !== 'undefined' && 'sizzle' ||
+		typeof Sly          !== 'undefined' && 'sly';
+		
+	libkey && $p.libs[libkey]();
+})();
+\ No newline at end of file
author	Bryan Berry <bryan@olenepal.org>	2009-10-14 06:39:11 (GMT)
committer	Bryan Berry <bryan@olenepal.org>	2009-10-14 06:39:11 (GMT)
commit	adfc3c62ac50c1fbb52811999377a2e32309d690 (patch)
tree	b6fde34d67772ddb1bf8664e3bcec9c1e2c03929
parent	602eca1669b29ba7d5cdb6e4ecff370a9368c1ac (diff)