Utils = {
	
	// remove all of the children from a DOM object
	removeChildren : function( obj )
	{
		for( var kk = obj.childNodes.length; --kk >= 0 ; )
		{
			obj.removeChild( obj.childNodes[kk] );
		}
	},
	
	// copy all options (typically from a dropdown) into an array
	copyOptionsToArray : function( obj )
	{
		var optArray = new Array(1);
		var idx = 0;
		
		for(idx=0;idx<obj.length;idx++)
		{
			optArray[idx] = obj[idx];
		}
		
		return optArray;		
	},
	
	// text is a value is numeric
	isNumeric : function( value )
	{
		return ( parseInt( value ) == value );
	},

	inArray : function( needle, haystack, strictComparison )
	{
		var inHaystack = false;
		for( var i = 0, count = haystack.length; i < count; ++i )
		{
			if( strictComparison === true )
			{
  				if( needle === haystack[i] )
				{
					inHaystack = true;
					break;
				}
			}
			else
			{
  				if( needle == haystack[i] )
				{
					inHaystack = true;
					break;
				}
			}
		}
		return inHaystack;
	},
	
	// remove an option from a select dropdown
	removeOptionFromSelect : function( selectName, removeValue )
	{
		var selectObject = $(selectName);
		var allOptions = Utils.copyOptionsToArray( selectObject );
		
		Utils.removeChildren( selectObject );
		
		$A(allOptions).each( function( option ) {
			if( option.value != removeValue )
			{
				selectObject.appendChild( option );
			}
		} );
	},

	// evaluate a JSON object - a key function
	evalJSON : function( text )
	{
		try
		{
			return eval('(' + text + ')');
		} catch (e) {}
	},
	
	// check all input boxes of a certain class
	checkAll : function( checkboxClass )
	{
		var boxes = document.getElementsByClassName( checkboxClass );
		if( boxes == undefined )
		{
			return;
		}
		
		try
		{
			$A(boxes).each( function( option ) {
				option.checked = true;
			} );		
		} catch (e) {}
	},
	
	uncheckAll : function( checkboxClass )
	{
		var boxes = document.getElementsByClassName( checkboxClass );
		if( boxes == undefined )
		{
			return;
		}
		
		try
		{
			$A(boxes).each( function( option ) {
				option.checked = false;
			} );		
		} catch (e) {}
	},
	
	// convenience function for stopping events, cross-browser
	stopEvent : function( event )
	{
		event.cancelBubble = true;
		event.returnValue = false;
		if (event.stopPropagation) {
			event.stopPropagation();		
		}
	},

	openAndOffsetWindow : function( url, windowName, w, h, voffset, windowOptions ) 
	{
		var chasm = screen.availWidth;
		var mount = screen.availHeight;
	
		if( ! windowOptions || windowOptions == undefined )
		{
			windowOptions =  "scrollbars=auto, resizable=yes";
		}
		
		voffset = Math.min( voffset, mount - h - 10 );
	
		return window.open(url, windowName, 'width=' + w + ',height=' + h + ',left=' + ((chasm - w - 10) * 0.5) + ',top=' + voffset + ', ' + windowOptions);
	},

	// target any external links to a blank window (necessary because target attribute within content is illegal in xhtml-strict)
 	targetExternalLinks : function() 
 	{
		if( ! document.getElementsByTagName ) return;
		
		var anchors = document.getElementsByTagName("a");
		// var relAnchors = document.getElementsBySelector('a[rel="external"]');
		for(var i = 0; i < anchors.length; i++)
		{
			var anchor = anchors[i];
			if( anchor.getAttribute("href") && anchor.getAttribute("rel") == "external" )
			{
				anchor.target = "_blank";
			}
		}
	},
	
	// sort the children of a node according to their textual content
	sortSelectedNodes : function( container )
	{
    var children = [];
    for(var x = container.firstChild; x != null; x = x.nextSibling)
    {
    	if (x.nodeType == 1 /* Node.ELEMENT_NODE */) 
    	{ 
    		children.push(x);
    	}
    }

    children.sort( function( n, m ) { 
    	var s = Utils.innerText( n ); // .firstChild.nextSibling.data;
    	s = s.trim();
    	var t = Utils.innerText( m ); // .nextSibling.firstChild.data;
    	t = t.trim();
    	if( s < t ) return -1;
    	else if( s > t ) return 1;
    	else return 0;
    } );
    
    // Note that as we insert existing nodes, they are automatically removed from their current position
    for(var i = 0; i < children.length; i++) 
    {
    	container.appendChild(children[i]);
    }
	},
	
	// find the text content within a node of node tree
	innerText : function(node) 
	{ 
    // is this a text or CDATA node? 
    if (node.nodeType == 3 || node.nodeType == 4) 
    { 
        return node.data; 
    } 
    
    var i; 
    var returnValue = []; 
    for (i = 0; i < node.childNodes.length; i++) 
    { 
        returnValue.push(this.innerText(node.childNodes[i])); 
    } 
    return returnValue.join(' '); 
	}, 	
	
	Timer : {
		timers : new Object(),

		// return current timestamp - dates are ignored
		getTimestamp : function()
		{
			var currentTimestamp = new Date();
			return currentTimestamp.getTime();		
		},
		
		startTimer : function( timerName )
		{
			this.timers[timerName] = new Object();
			this.timers[timerName]['startTime'] = this.getTimestamp();
			this.timers[timerName]['lapTime'] = this.timers[timerName]['startTime'];
			this.timers[timerName]['times'] = new Object();
		},
		
		lapTime : function( timerName, lapName )
		{		
			if( this.timers[timerName] == undefined )
			{
				this.startTimer(timerName);
			}
			var timestamp = this.getTimestamp();
			this.timers[timerName]['times'] [lapName] = ( timestamp - this.timers[timerName]['lapTime'] ) / 1000;
			this.timers[timerName]['lapTime'] = timestamp;
		},	
	
		getTimes : function( timerName )
		{
			return this.timers[timerName]['times'] ;
		},
		
		reportTimings : function( timerName )
		{
			var times = this.getTimes( timerName );		
			var buffer = "";
			var counter = 0;
			for( lap in times )
			{
				buffer += "\n" + ( ++counter ) + ". " + lap + ": " + times[lap] + "s";
			}
			Logger.debug( "Lap times for '" + timerName + "': " + buffer );
		}
	}
}
	
// Add a function to the String class to trip leading and trailing white-space
String.prototype.trim = function() 
{
	return this.replace(/^\s*|\s*$/g, "");
}

// Watch for all links on the page and force external links to open in a new window.
Event.observe( window, 'load', Utils.targetExternalLinks, false );