New build scripts

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@5282 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/web/scripts/ajax/dojo/src/uuid/LightweightGenerator.js

@@ -0,0 +1,73 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.LightweightGenerator");
+
+/*
+ * summary:
+ *   The LightweightGenerator is intended to be small and fast,
+ *   but not necessarily good.
+ * 
+ * description:
+ *   Small: The LightweightGenerator has a small footprint. 
+ *   Once comments are stripped, it's only about 25 lines of 
+ *   code, and it doesn't dojo.require() any other packages.
+ *
+ *   Fast: The LightweightGenerator can generate lots of new 
+ *   UUIDs fairly quickly (at least, more quickly than the other 
+ *   dojo UUID generators).
+ *
+ *   Not necessarily good: We use Math.random() as our source
+ *   of randomness, which may or may not provide much randomness. 
+ */
+ 
+dojo.uuid.LightweightGenerator = new function() {
+	var HEX_RADIX = 16;
+
+	function _generateRandomEightCharacterHexString() {
+		// Make random32bitNumber be a randomly generated floating point number
+		// between 0 and (4,294,967,296 - 1), inclusive.
+		var random32bitNumber = Math.floor( (Math.random() % 1) * Math.pow(2, 32) );
+		var eightCharacterHexString = random32bitNumber.toString(HEX_RADIX);
+		while (eightCharacterHexString.length < 8) {
+			eightCharacterHexString = "0" + eightCharacterHexString;
+		}
+		return eightCharacterHexString; // for example: "3B12F1DF"
+	}
+
+	this.generate = function(/* constructor? */ returnType) {
+		// summary: 
+		//   This function generates random UUIDs, meaning "version 4" UUIDs.
+		// description: 
+		//   A typical generated value would be something like this:
+		//   "3b12f1df-5232-4804-897e-917bf397618a"
+		// returnType: The type of object to return. Usually String or dojo.uuid.Uuid
+
+		// examples: 
+		//   var string = dojo.uuid.LightweightGenerator.generate();
+		//   var string = dojo.uuid.LightweightGenerator.generate(String);
+		//   var uuid   = dojo.uuid.LightweightGenerator.generate(dojo.uuid.Uuid);
+		var hyphen = "-";
+		var versionCodeForRandomlyGeneratedUuids = "4"; // 8 == binary2hex("0100")
+		var variantCodeForDCEUuids = "8"; // 8 == binary2hex("1000")
+		var a = _generateRandomEightCharacterHexString();
+		var b = _generateRandomEightCharacterHexString();
+		b = b.substring(0, 4) + hyphen + versionCodeForRandomlyGeneratedUuids + b.substring(5, 8);
+		var c = _generateRandomEightCharacterHexString();
+		c = variantCodeForDCEUuids + c.substring(1, 4) + hyphen + c.substring(4, 8);
+		var d = _generateRandomEightCharacterHexString();
+		var returnValue = a + hyphen + b + hyphen + c + d;
+		returnValue = returnValue.toLowerCase();
+		if (returnType && (returnType != String)) {
+			returnValue = new returnType(returnValue);
+		}
+		return returnValue;
+	};
+}();

source/web/scripts/ajax/dojo/src/uuid/NameBasedGenerator.js

@@ -0,0 +1,38 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.NameBasedGenerator");
+
+dojo.uuid.NameBasedGenerator = new function() {
+	this.generate = function(/* constructor? */ returnType) {
+		// summary: 
+		//   This function generates name-based UUIDs, meaning "version 3" 
+		//   and "version 5" UUIDs.
+		// returnType: The type of object to return. Usually String or dojo.uuid.Uuid
+
+		// examples: 
+		//   var string = dojo.uuid.NameBasedGenerator.generate();
+		//   var string = dojo.uuid.NameBasedGenerator.generate(String);
+		//   var uuid   = dojo.uuid.NameBasedGenerator.generate(dojo.uuid.Uuid);
+
+		dojo.unimplemented('dojo.uuid.NameBasedGenerator.generate');
+		
+		// FIXME:
+		// For an algorithm to generate name-based UUIDs, 
+		// see sections 4.3 of RFC 4122:
+		//  http://www.ietf.org/rfc/rfc4122.txt
+		
+		var returnValue = "00000000-0000-0000-0000-000000000000"; // FIXME
+		if (returnType && (returnType != String)) {
+			returnValue = new returnType(returnValue);
+		}
+		return returnValue; // object
+	};
+}();

source/web/scripts/ajax/dojo/src/uuid/NilGenerator.js

@@ -0,0 +1,32 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.NilGenerator");
+
+dojo.uuid.NilGenerator = new function() {
+	this.generate = function(/* constructor? */ returnType) {
+		// summary: 
+		//   This function returns the Nil UUID: "00000000-0000-0000-0000-000000000000".
+		// description: 
+		//   The Nil UUID is described in section 4.1.7 of
+		//   RFC 4122: http://www.ietf.org/rfc/rfc4122.txt
+		// returnType: The type of object to return. Usually String or dojo.uuid.Uuid
+
+		// examples: 
+		//   var string = dojo.uuid.NilGenerator.generate();
+		//   var string = dojo.uuid.NilGenerator.generate(String);
+		//   var uuid   = dojo.uuid.NilGenerator.generate(dojo.uuid.Uuid);
+		var returnValue = "00000000-0000-0000-0000-000000000000";
+		if (returnType && (returnType != String)) {
+			returnValue = new returnType(returnValue);
+		}
+		return returnValue; // object
+	};
+}();

source/web/scripts/ajax/dojo/src/uuid/RandomGenerator.js

@@ -0,0 +1,39 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.RandomGenerator");
+
+dojo.uuid.RandomGenerator = new function() {
+	this.generate = function(/* constructor? */ returnType) {
+		// summary: 
+		//   This function generates random UUIDs, meaning "version 4" UUIDs.
+		// description: 
+		//   A typical generated value would be something like this:
+		//   "3b12f1df-5232-4804-897e-917bf397618a"
+		// returnType: The type of object to return. Usually String or dojo.uuid.Uuid
+
+		// examples: 
+		//   var string = dojo.uuid.RandomGenerator.generate();
+		//   var string = dojo.uuid.RandomGenerator.generate(String);
+		//   var uuid   = dojo.uuid.RandomGenerator.generate(dojo.uuid.Uuid);
+
+		dojo.unimplemented('dojo.uuid.RandomGenerator.generate');
+		// FIXME:
+		// For an algorithm to generate a random UUID, see
+		// sections 4.4 and 4.5 of RFC 4122:
+		//  http://www.ietf.org/rfc/rfc4122.txt
+		
+		var returnValue = "00000000-0000-0000-0000-000000000000"; // FIXME
+		if (returnType && (returnType != String)) {
+			returnValue = new returnType(returnValue);
+		}
+		return returnValue; // object
+	};
+}();

source/web/scripts/ajax/dojo/src/uuid/TimeBasedGenerator.js

@@ -0,0 +1,355 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.TimeBasedGenerator");
+dojo.require("dojo.lang.common");
+dojo.require("dojo.lang.type");
+dojo.require("dojo.lang.assert");
+
+dojo.uuid.TimeBasedGenerator = new function() {
+
+	// --------------------------------------------------
+	// Public constants:
+	// Number of hours between October 15, 1582 and January 1, 1970:
+	this.GREGORIAN_CHANGE_OFFSET_IN_HOURS = 3394248;
+	// Number of seconds between October 15, 1582 and January 1, 1970:
+	//   this.GREGORIAN_CHANGE_OFFSET_IN_SECONDS = 12219292800;	
+	
+	// --------------------------------------------------
+	// Private variables:
+	var _uuidPseudoNodeString = null;
+	var _uuidClockSeqString = null;
+	var _dateValueOfPreviousUuid = null;
+	var _nextIntraMillisecondIncrement = 0;
+	var _cachedMillisecondsBetween1582and1970 = null;
+	var _cachedHundredNanosecondIntervalsPerMillisecond = null;
+	var _uniformNode = null;
+	
+	// --------------------------------------------------
+	// Private constants:
+	var HEX_RADIX = 16;
+
+	function _carry(/* array */ arrayA) {
+		// summary: 
+		//   Given an array which holds a 64-bit number broken into 4 16-bit 
+		//   elements, this method carries any excess bits (greater than 16-bits) 
+		//   from each array element into the next.
+		// arrayA: An array with 4 elements, each of which is a 16-bit number.
+		arrayA[2] += arrayA[3] >>> 16;
+		arrayA[3] &= 0xFFFF;
+		arrayA[1] += arrayA[2] >>> 16;
+		arrayA[2] &= 0xFFFF;
+		arrayA[0] += arrayA[1] >>> 16;
+		arrayA[1] &= 0xFFFF;
+		dojo.lang.assert((arrayA[0] >>> 16) === 0);
+	}
+
+	function _get64bitArrayFromFloat(/* float */ x) {
+		// summary: 
+		//   Given a floating point number, this method returns an array which 
+		//   holds a 64-bit number broken into 4 16-bit elements.
+		var result = new Array(0, 0, 0, 0);
+		result[3] = x % 0x10000;
+		x -= result[3];
+		x /= 0x10000;
+		result[2] = x % 0x10000;
+		x -= result[2];
+		x /= 0x10000;
+		result[1] = x % 0x10000;
+		x -= result[1];
+		x /= 0x10000;
+		result[0] = x;
+		return result; // Array with 4 elements, each of which is a 16-bit number.
+	}
+
+	function _addTwo64bitArrays(/* array */ arrayA, /* array */ arrayB) {
+		// summary: 
+		//   Takes two arrays, each of which holds a 64-bit number broken into 4
+		//   16-bit elements, and returns a new array that holds a 64-bit number
+		//   that is the sum of the two original numbers.
+		// arrayA: An array with 4 elements, each of which is a 16-bit number.
+		// arrayB: An array with 4 elements, each of which is a 16-bit number.
+		dojo.lang.assertType(arrayA, Array);
+		dojo.lang.assertType(arrayB, Array);
+		dojo.lang.assert(arrayA.length == 4);
+		dojo.lang.assert(arrayB.length == 4);
+	
+		var result = new Array(0, 0, 0, 0);
+		result[3] = arrayA[3] + arrayB[3];
+		result[2] = arrayA[2] + arrayB[2];
+		result[1] = arrayA[1] + arrayB[1];
+		result[0] = arrayA[0] + arrayB[0];
+		_carry(result);
+		return result; // Array with 4 elements, each of which is a 16-bit number.
+	}
+
+	function _multiplyTwo64bitArrays(/* array */ arrayA, /* array */ arrayB) {
+		// summary: 
+		//   Takes two arrays, each of which holds a 64-bit number broken into 4
+		//   16-bit elements, and returns a new array that holds a 64-bit number
+		//   that is the product of the two original numbers.
+		// arrayA: An array with 4 elements, each of which is a 16-bit number.
+		// arrayB: An array with 4 elements, each of which is a 16-bit number.
+		dojo.lang.assertType(arrayA, Array);
+		dojo.lang.assertType(arrayB, Array);
+		dojo.lang.assert(arrayA.length == 4);
+		dojo.lang.assert(arrayB.length == 4);
+	
+		var overflow = false;
+		if (arrayA[0] * arrayB[0] !== 0) { overflow = true; }
+		if (arrayA[0] * arrayB[1] !== 0) { overflow = true; }
+		if (arrayA[0] * arrayB[2] !== 0) { overflow = true; }
+		if (arrayA[1] * arrayB[0] !== 0) { overflow = true; }
+		if (arrayA[1] * arrayB[1] !== 0) { overflow = true; }
+		if (arrayA[2] * arrayB[0] !== 0) { overflow = true; }
+		dojo.lang.assert(!overflow);
+	
+		var result = new Array(0, 0, 0, 0);
+		result[0] += arrayA[0] * arrayB[3];
+		_carry(result);
+		result[0] += arrayA[1] * arrayB[2];
+		_carry(result);
+		result[0] += arrayA[2] * arrayB[1];
+		_carry(result);
+		result[0] += arrayA[3] * arrayB[0];
+		_carry(result);
+		result[1] += arrayA[1] * arrayB[3];
+		_carry(result);
+		result[1] += arrayA[2] * arrayB[2];
+		_carry(result);
+		result[1] += arrayA[3] * arrayB[1];
+		_carry(result);
+		result[2] += arrayA[2] * arrayB[3];
+		_carry(result);
+		result[2] += arrayA[3] * arrayB[2];
+		_carry(result);
+		result[3] += arrayA[3] * arrayB[3];
+		_carry(result);
+		return result; // Array with 4 elements, each of which is a 16-bit number.
+	}
+
+	function _padWithLeadingZeros(/* string */ string, /* int */ desiredLength) {
+		// summary: 
+		//   Pads a string with leading zeros and returns the result.
+		// string: A string to add padding to.
+		// desiredLength: The number of characters the return string should have.
+
+		// examples: 
+		//   result = _padWithLeadingZeros("abc", 6);
+		//   dojo.lang.assert(result == "000abc");
+		while (string.length < desiredLength) {
+			string = "0" + string;
+		}
+		return string; // string
+	}
+
+	function _generateRandomEightCharacterHexString() {
+		// summary: 
+		//   Returns a randomly generated 8-character string of hex digits.
+
+		// FIXME: This probably isn't a very high quality random number.
+	
+		// Make random32bitNumber be a randomly generated floating point number
+		// between 0 and (4,294,967,296 - 1), inclusive.
+		var random32bitNumber = Math.floor( (Math.random() % 1) * Math.pow(2, 32) );
+	
+		var eightCharacterString = random32bitNumber.toString(HEX_RADIX);
+		while (eightCharacterString.length < 8) {
+			eightCharacterString = "0" + eightCharacterString;
+		}
+		return eightCharacterString; // String (an 8-character hex string)
+	}
+
+	function _generateUuidString(/* string? */ node) {
+		// summary: 
+		//   Generates a time-based UUID, meaning a version 1 UUID.  
+		// description: 
+		//   JavaScript code running in a browser doesn't have access to the 
+		//   IEEE 802.3 address of the computer, so if a node value isn't 
+		//   supplied, we generate a random pseudonode value instead.
+		// node: An optional 12-character string to use as the node in the new UUID.
+		dojo.lang.assertType(node, String, {optional: true});
+		if (node) {
+			dojo.lang.assert(node.length == 12);
+		} else {
+			if (_uniformNode) {
+				node = _uniformNode;
+			} else {
+				if (!_uuidPseudoNodeString) {
+					var pseudoNodeIndicatorBit = 0x8000;
+					var random15bitNumber = Math.floor( (Math.random() % 1) * Math.pow(2, 15) );
+					var leftmost4HexCharacters = (pseudoNodeIndicatorBit | random15bitNumber).toString(HEX_RADIX);
+					_uuidPseudoNodeString = leftmost4HexCharacters + _generateRandomEightCharacterHexString();
+				}
+				node = _uuidPseudoNodeString;
+			}
+		}
+		if (!_uuidClockSeqString) {
+			var variantCodeForDCEUuids = 0x8000; // 10--------------, i.e. uses only first two of 16 bits.
+			var random14bitNumber = Math.floor( (Math.random() % 1) * Math.pow(2, 14) );
+			_uuidClockSeqString = (variantCodeForDCEUuids | random14bitNumber).toString(HEX_RADIX);
+		}
+	
+		// Maybe we should think about trying to make the code more readable to
+		// newcomers by creating a class called "WholeNumber" that encapsulates
+		// the methods and data structures for working with these arrays that
+		// hold 4 16-bit numbers?  And then these variables below have names
+		// like "wholeSecondsPerHour" rather than "arraySecondsPerHour"?
+		var now = new Date();
+		var millisecondsSince1970 = now.valueOf(); // milliseconds since midnight 01 January, 1970 UTC.
+		var nowArray = _get64bitArrayFromFloat(millisecondsSince1970);
+		if (!_cachedMillisecondsBetween1582and1970) {
+			var arraySecondsPerHour = _get64bitArrayFromFloat(60 * 60);
+			var arrayHoursBetween1582and1970 = _get64bitArrayFromFloat(dojo.uuid.TimeBasedGenerator.GREGORIAN_CHANGE_OFFSET_IN_HOURS);
+			var arraySecondsBetween1582and1970 = _multiplyTwo64bitArrays(arrayHoursBetween1582and1970, arraySecondsPerHour);
+			var arrayMillisecondsPerSecond = _get64bitArrayFromFloat(1000);
+			_cachedMillisecondsBetween1582and1970 = _multiplyTwo64bitArrays(arraySecondsBetween1582and1970, arrayMillisecondsPerSecond);
+			_cachedHundredNanosecondIntervalsPerMillisecond = _get64bitArrayFromFloat(10000);
+		}
+		var arrayMillisecondsSince1970 = nowArray;
+		var arrayMillisecondsSince1582 = _addTwo64bitArrays(_cachedMillisecondsBetween1582and1970, arrayMillisecondsSince1970);
+		var arrayHundredNanosecondIntervalsSince1582 = _multiplyTwo64bitArrays(arrayMillisecondsSince1582, _cachedHundredNanosecondIntervalsPerMillisecond);
+	
+		if (now.valueOf() == _dateValueOfPreviousUuid) {
+			arrayHundredNanosecondIntervalsSince1582[3] += _nextIntraMillisecondIncrement;
+			_carry(arrayHundredNanosecondIntervalsSince1582);
+			_nextIntraMillisecondIncrement += 1;
+			if (_nextIntraMillisecondIncrement == 10000) {
+				// If we've gotten to here, it means we've already generated 10,000
+				// UUIDs in this single millisecond, which is the most that the UUID
+				// timestamp field allows for.  So now we'll just sit here and wait
+				// for a fraction of a millisecond, so as to ensure that the next
+				// time this method is called there will be a different millisecond
+				// value in the timestamp field.
+				while (now.valueOf() == _dateValueOfPreviousUuid) {
+					now = new Date();
+				}
+			}
+		} else {
+			_dateValueOfPreviousUuid = now.valueOf();
+			_nextIntraMillisecondIncrement = 1;
+		}
+	
+		var hexTimeLowLeftHalf  = arrayHundredNanosecondIntervalsSince1582[2].toString(HEX_RADIX);
+		var hexTimeLowRightHalf = arrayHundredNanosecondIntervalsSince1582[3].toString(HEX_RADIX);
+		var hexTimeLow = _padWithLeadingZeros(hexTimeLowLeftHalf, 4) + _padWithLeadingZeros(hexTimeLowRightHalf, 4);
+		var hexTimeMid = arrayHundredNanosecondIntervalsSince1582[1].toString(HEX_RADIX);
+		hexTimeMid = _padWithLeadingZeros(hexTimeMid, 4);
+		var hexTimeHigh = arrayHundredNanosecondIntervalsSince1582[0].toString(HEX_RADIX);
+		hexTimeHigh = _padWithLeadingZeros(hexTimeHigh, 3);
+		var hyphen = "-";
+		var versionCodeForTimeBasedUuids = "1"; // binary2hex("0001")
+		var resultUuid = hexTimeLow + hyphen + hexTimeMid + hyphen +
+					versionCodeForTimeBasedUuids + hexTimeHigh + hyphen +
+					_uuidClockSeqString + hyphen + node;
+		resultUuid = resultUuid.toLowerCase();
+		return resultUuid; // String (a 36 character string, which will look something like "b4308fb0-86cd-11da-a72b-0800200c9a66")
+	}
+
+	this.setNode = function(/* string? */ node) {
+		// summary: 
+		//   Sets the 'node' value that will be included in generated UUIDs.
+		// node: A 12-character hex string representing a pseudoNode or hardwareNode.
+		dojo.lang.assert((node === null) || (node.length == 12));
+		_uniformNode = node;
+	};
+
+	this.getNode = function() {
+		// summary: 
+		//   Returns the 'node' value that will be included in generated UUIDs.
+		return _uniformNode; // String (a 12-character hex string representing a pseudoNode or hardwareNode)
+	};
+
+	this.generate = function(/* misc? */ input) {
+		// summary: 
+		//   This function generates time-based UUIDs, meaning "version 1" UUIDs. 
+		// description: 
+		// For more info, see
+		//   http://www.webdav.org/specs/draft-leach-uuids-guids-01.txt
+		//   http://www.infonuovo.com/dma/csdocs/sketch/instidid.htm
+		//   http://kruithof.xs4all.nl/uuid/uuidgen
+		//   http://www.opengroup.org/onlinepubs/009629399/apdxa.htm#tagcjh_20
+		//   http://jakarta.apache.org/commons/sandbox/id/apidocs/org/apache/commons/id/uuid/clock/Clock.html
+
+		// examples: 
+		//   var generate = dojo.uuid.TimeBasedGenerator.generate;
+		//   var uuid;   // an instance of dojo.uuid.Uuid
+		//   var string; // a simple string literal
+		//   string = generate();
+		//   string = generate(String);
+		//   uuid   = generate(dojo.uuid.Uuid);
+		//   string = generate("017bf397618a");
+		//   string = generate({node: "017bf397618a"});         // hardwareNode
+		//   string = generate({node: "f17bf397618a"});         // pseudoNode
+		//   string = generate({hardwareNode: "017bf397618a"});
+		//   string = generate({pseudoNode:   "f17bf397618a"});
+		//   string = generate({node: "017bf397618a", returnType: String});
+		//   uuid   = generate({node: "017bf397618a", returnType: dojo.uuid.Uuid});
+		//   dojo.uuid.TimeBasedGenerator.setNode("017bf397618a");
+		//   string = generate(); // the generated UUID has node == "017bf397618a"
+		//   uuid   = generate(dojo.uuid.Uuid); // the generated UUID has node == "017bf397618a"
+		var nodeString = null;
+		var returnType = null;
+		
+		if (input) {
+			if (dojo.lang.isObject(input) && !dojo.lang.isBuiltIn(input)) {
+				// input: object {node: string, hardwareNode: string, pseudoNode: string}
+				// node: A 12-character hex string representing a pseudoNode or hardwareNode.
+				// hardwareNode: A 12-character hex string containing an IEEE 802.3 network node identificator.
+				// pseudoNode: A 12-character hex string representing a pseudoNode.
+				var namedParameters = input;
+				dojo.lang.assertValidKeywords(namedParameters, ["node", "hardwareNode", "pseudoNode", "returnType"]);
+				var node = namedParameters["node"];
+				var hardwareNode = namedParameters["hardwareNode"];
+				var pseudoNode = namedParameters["pseudoNode"];
+				nodeString = (node || pseudoNode || hardwareNode);
+				if (nodeString) {
+					var firstCharacter = nodeString.charAt(0);
+					var firstDigit = parseInt(firstCharacter, HEX_RADIX);
+					if (hardwareNode) {
+						dojo.lang.assert((firstDigit >= 0x0) && (firstDigit <= 0x7));
+					}
+					if (pseudoNode) {
+						dojo.lang.assert((firstDigit >= 0x8) && (firstDigit <= 0xF));
+					}
+				}
+				returnType = namedParameters["returnType"];
+				dojo.lang.assertType(returnType, Function, {optional: true});
+			} else {
+				if (dojo.lang.isString(input)) {
+					// input: string A 12-character hex string representing a pseudoNode or hardwareNode.
+					nodeString = input;
+					returnType = null;
+				} else {
+					if (dojo.lang.isFunction(input)) {
+						// input: constructor The type of object to return. Usually String or dojo.uuid.Uuid
+						nodeString = null;
+						returnType = input;
+					}
+				}
+			}
+			if (nodeString) {
+				dojo.lang.assert(nodeString.length == 12);
+				var integer = parseInt(nodeString, HEX_RADIX);
+				dojo.lang.assert(isFinite(integer));
+			}
+			dojo.lang.assertType(returnType, Function, {optional: true});
+		}
+		
+		var uuidString = _generateUuidString(nodeString);
+		var returnValue;
+		if (returnType && (returnType != String)) {
+			returnValue = new returnType(uuidString);
+		} else {
+			returnValue = uuidString;
+		}
+		return returnValue; // object
+	};
+}();

source/web/scripts/ajax/dojo/src/uuid/Uuid.js

@@ -0,0 +1,379 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.provide("dojo.uuid.Uuid");
+dojo.require("dojo.lang.common");
+dojo.require("dojo.lang.assert");
+
+dojo.uuid.Uuid = function(/* string || generator */ input) {
+	// summary: 
+	//   This is the constructor for the Uuid class.  The Uuid class offers 
+	//   methods for inspecting existing UUIDs.
+	
+	// examples:
+	//   var uuid;
+	//   uuid = new dojo.uuid.Uuid("3b12f1df-5232-4804-897e-917bf397618a");
+	//   uuid = new dojo.uuid.Uuid(); // "00000000-0000-0000-0000-000000000000"
+	//   uuid = new dojo.uuid.Uuid(dojo.uuid.RandomGenerator);
+	//   uuid = new dojo.uuid.Uuid(dojo.uuid.TimeBasedGenerator);
+	//   dojo.uuid.Uuid.setGenerator(dojo.uuid.RandomGenerator);
+	//   uuid = new dojo.uuid.Uuid();
+	//   dojo.lang.assert(!uuid.isEqual(dojo.uuid.Uuid.NIL_UUID));
+	this._uuidString = dojo.uuid.Uuid.NIL_UUID;
+	if (input) {
+		if (dojo.lang.isString(input)) {
+			// input: string? A 36-character string that conforms to the UUID spec.
+			this._uuidString = input.toLowerCase();
+			dojo.lang.assert(this.isValid());
+		} else {
+			if (dojo.lang.isObject(input) && input.generate) {
+				// input: generator A UUID generator, such as dojo.uuid.TimeBasedGenerator.
+				var generator = input;
+				this._uuidString = generator.generate();
+				dojo.lang.assert(this.isValid());
+			} else {
+				// we got passed something other than a string
+				dojo.lang.assert(false, "The dojo.uuid.Uuid() constructor must be initializated with a UUID string.");
+			}
+		}
+	} else {
+		var ourGenerator = dojo.uuid.Uuid.getGenerator();
+		if (ourGenerator) {
+			this._uuidString = ourGenerator.generate();
+			dojo.lang.assert(this.isValid());
+		}
+	}
+};
+
+// -------------------------------------------------------------------
+// Public constants
+// -------------------------------------------------------------------
+dojo.uuid.Uuid.NIL_UUID = "00000000-0000-0000-0000-000000000000";
+dojo.uuid.Uuid.Version = {
+	UNKNOWN: 0,
+	TIME_BASED: 1,
+	DCE_SECURITY: 2,
+	NAME_BASED_MD5: 3,
+	RANDOM: 4,
+	NAME_BASED_SHA1: 5 };
+dojo.uuid.Uuid.Variant = {
+	NCS: "0",
+	DCE: "10",
+	MICROSOFT: "110",
+	UNKNOWN: "111" };
+dojo.uuid.Uuid.HEX_RADIX = 16;
+
+dojo.uuid.Uuid.compare = function(/* dojo.uuid.Uuid */ uuidOne, /* dojo.uuid.Uuid */ uuidTwo) {
+	// summary: 
+	//   Given two UUIDs to compare, this method returns 0, 1, or -1.
+	// description:
+	//   This method is designed to be used by sorting routines, like the
+	//   JavaScript built-in Array sort() method. This implementation is 
+	//   intended to match the sample implementation in IETF RFC 4122:
+	//   http://www.ietf.org/rfc/rfc4122.txt
+	// uuidOne: Any object that has toString() method that returns a 36-character string that conforms to the UUID spec.
+	// uuidTwo: Any object that has toString() method that returns a 36-character string that conforms to the UUID spec.
+
+	// examples:
+	//   var uuid;
+	//   var generator = dojo.uuid.TimeBasedGenerator;
+	//   var a = new dojo.uuid.Uuid(generator);
+	//   var b = new dojo.uuid.Uuid(generator);
+	//   var c = new dojo.uuid.Uuid(generator);
+	//   var array = new Array(a, b, c);
+	//   array.sort(dojo.uuid.Uuid.compare);
+	var uuidStringOne = uuidOne.toString();
+	var uuidStringTwo = uuidTwo.toString();
+	if (uuidStringOne > uuidStringTwo) return 1;   // integer
+	if (uuidStringOne < uuidStringTwo) return -1;  // integer
+	return 0; // integer (either 0, 1, or -1)
+};
+
+dojo.uuid.Uuid.setGenerator = function(/* generator? */ generator) {
+	// summary: 
+	//   Sets the default generator, which will be used by the 
+	//   "new dojo.uuid.Uuid()" constructor if no parameters
+	//   are passed in.
+	// generator: A UUID generator, such as dojo.uuid.TimeBasedGenerator.
+	dojo.lang.assert(!generator || (dojo.lang.isObject(generator) && generator.generate));
+	dojo.uuid.Uuid._ourGenerator = generator;
+};
+
+dojo.uuid.Uuid.getGenerator = function() {
+	// summary: 
+	//   Returns the default generator.  See setGenerator().
+	return dojo.uuid.Uuid._ourGenerator; // generator (A UUID generator, such as dojo.uuid.TimeBasedGenerator).
+};
+
+dojo.uuid.Uuid.prototype.toString = function(/* string? */format) {
+	// summary: 
+	//   By default this method returns a standard 36-character string representing 
+	//   the UUID, such as "3b12f1df-5232-4804-897e-917bf397618a".  You can also
+	//   pass in an optional format specifier to request the output in any of
+	//   a half dozen slight variations.
+	// format: One of these strings: '{}', '()', '""', "''", 'urn', '!-'
+
+	// examples:
+	//   var uuid = new dojo.uuid.Uuid(dojo.uuid.TimeBasedGenerator);
+	//   var s;
+	//   s = uuid.toString();       //  eb529fec-6498-11d7-b236-000629ba5445
+	//   s = uuid.toString('{}');   // {eb529fec-6498-11d7-b236-000629ba5445}
+	//   s = uuid.toString('()');   // (eb529fec-6498-11d7-b236-000629ba5445)
+	//   s = uuid.toString('""');   // "eb529fec-6498-11d7-b236-000629ba5445"
+	//   s = uuid.toString("''");   // 'eb529fec-6498-11d7-b236-000629ba5445'
+	//   s = uuid.toString('!-');   //  eb529fec649811d7b236000629ba5445
+	//   s = uuid.toString('urn');  //  urn:uuid:eb529fec-6498-11d7-b236-000629ba5445
+	if (format) {
+		switch (format) {
+			case '{}':
+				return '{' + this._uuidString + '}';
+				break;
+			case '()':
+				return '(' + this._uuidString + ')';
+				break;
+			case '""':
+				return '"' + this._uuidString + '"';
+				break;
+			case "''":
+				return "'" + this._uuidString + "'";
+				break;
+			case 'urn':
+				return 'urn:uuid:' + this._uuidString;
+				break;
+			case '!-':
+				return this._uuidString.split('-').join('');
+				break;
+			default:
+				// we got passed something other than what we expected
+				dojo.lang.assert(false, "The toString() method of dojo.uuid.Uuid was passed a bogus format.");
+		}
+	} else {
+		return this._uuidString; // string
+	}
+};
+
+dojo.uuid.Uuid.prototype.compare = function(/* dojo.uuid.Uuid */ otherUuid) {
+	// summary: 
+	//   Compares this UUID to another UUID, and returns 0, 1, or -1.
+	// description:
+	//   This implementation is intended to match the sample implementation
+	//   in IETF RFC 4122: http://www.ietf.org/rfc/rfc4122.txt
+	// otherUuid: Any object that has toString() method that returns a 36-character string that conforms to the UUID spec.
+	return dojo.uuid.Uuid.compare(this, otherUuid); // integer (either 0, 1, or -1)
+};
+
+dojo.uuid.Uuid.prototype.isEqual = function(/* dojo.uuid.Uuid */ otherUuid) {
+	// summary: 
+	//   Returns true if this UUID is equal to the otherUuid, or false otherwise.
+	// otherUuid: Any object that has toString() method that returns a 36-character string that conforms to the UUID spec.
+	return (this.compare(otherUuid) == 0); // boolean
+};
+
+dojo.uuid.Uuid.prototype.isValid = function() {
+	// summary: 
+	//   Returns true if the UUID was initialized with a valid value.
+	try {
+		dojo.lang.assertType(this._uuidString, String);
+		dojo.lang.assert(this._uuidString.length == 36);
+		dojo.lang.assert(this._uuidString == this._uuidString.toLowerCase());
+		var arrayOfParts = this._uuidString.split("-");
+		dojo.lang.assert(arrayOfParts.length == 5);
+		dojo.lang.assert(arrayOfParts[0].length == 8);
+		dojo.lang.assert(arrayOfParts[1].length == 4);
+		dojo.lang.assert(arrayOfParts[2].length == 4);
+		dojo.lang.assert(arrayOfParts[3].length == 4);
+		dojo.lang.assert(arrayOfParts[4].length == 12);
+		for (var i in arrayOfParts) {
+			var part = arrayOfParts[i];
+			var integer = parseInt(part, dojo.uuid.Uuid.HEX_RADIX);
+			dojo.lang.assert(isFinite(integer));
+		}
+		return true; // boolean
+	} catch (e) {
+		return false; // boolean
+	}
+};
+
+dojo.uuid.Uuid.prototype.getVariant = function() {
+	// summary: 
+	//   Returns a variant code that indicates what type of UUID this is.
+	//   Returns one of the enumerated dojo.uuid.Uuid.Variant values.
+
+	// example: 
+	//   var uuid = new dojo.uuid.Uuid("3b12f1df-5232-4804-897e-917bf397618a");
+	//   var variant = uuid.getVariant();
+	//   dojo.lang.assert(variant == dojo.uuid.Uuid.Variant.DCE);
+	// example: 
+	// "3b12f1df-5232-4804-897e-917bf397618a"
+	//                     ^
+	//                     |
+	//         (variant "10__" == DCE)
+	var variantCharacter = this._uuidString.charAt(19);
+	var variantNumber = parseInt(variantCharacter, dojo.uuid.Uuid.HEX_RADIX);
+	dojo.lang.assert((variantNumber >= 0) && (variantNumber <= 16));
+
+	if (!dojo.uuid.Uuid._ourVariantLookupTable) {
+		var Variant = dojo.uuid.Uuid.Variant;
+		var lookupTable = [];
+
+		lookupTable[0x0] = Variant.NCS;       // 0000
+		lookupTable[0x1] = Variant.NCS;       // 0001
+		lookupTable[0x2] = Variant.NCS;       // 0010
+		lookupTable[0x3] = Variant.NCS;       // 0011
+
+		lookupTable[0x4] = Variant.NCS;       // 0100
+		lookupTable[0x5] = Variant.NCS;       // 0101
+		lookupTable[0x6] = Variant.NCS;       // 0110
+		lookupTable[0x7] = Variant.NCS;       // 0111
+
+		lookupTable[0x8] = Variant.DCE;       // 1000
+		lookupTable[0x9] = Variant.DCE;       // 1001
+		lookupTable[0xA] = Variant.DCE;       // 1010
+		lookupTable[0xB] = Variant.DCE;       // 1011
+
+		lookupTable[0xC] = Variant.MICROSOFT; // 1100
+		lookupTable[0xD] = Variant.MICROSOFT; // 1101
+		lookupTable[0xE] = Variant.UNKNOWN;   // 1110
+		lookupTable[0xF] = Variant.UNKNOWN;   // 1111
+		
+		dojo.uuid.Uuid._ourVariantLookupTable = lookupTable;
+	}
+
+	return dojo.uuid.Uuid._ourVariantLookupTable[variantNumber]; // dojo.uuid.Uuid.Variant
+};
+
+dojo.uuid.Uuid.prototype.getVersion = function() {
+	// summary: 
+	//   Returns a version number that indicates what type of UUID this is.
+	//   Returns one of the enumerated dojo.uuid.Uuid.Version values.
+
+	// example: 
+	//   var uuid = new dojo.uuid.Uuid("b4308fb0-86cd-11da-a72b-0800200c9a66");
+	//   var version = uuid.getVersion();
+	//   dojo.lang.assert(version == dojo.uuid.Uuid.Version.TIME_BASED);
+	// exceptions: 
+	//   Throws an Error if this is not a DCE Variant UUID.
+	if (!this._versionNumber) {
+		var errorMessage = "Called getVersion() on a dojo.uuid.Uuid that was not a DCE Variant UUID.";
+		dojo.lang.assert(this.getVariant() == dojo.uuid.Uuid.Variant.DCE, errorMessage);
+	
+		// "b4308fb0-86cd-11da-a72b-0800200c9a66"
+		//                ^
+		//                |
+		//       (version 1 == TIME_BASED)
+		var versionCharacter = this._uuidString.charAt(14);
+		this._versionNumber = parseInt(versionCharacter, dojo.uuid.Uuid.HEX_RADIX);
+	}
+	return this._versionNumber; // dojo.uuid.Uuid.Version
+};
+
+dojo.uuid.Uuid.prototype.getNode = function() {
+	// summary: 
+	//   If this is a version 1 UUID (a time-based UUID), getNode() returns a 
+	//   12-character string with the "node" or "pseudonode" portion of the UUID, 
+	//   which is the rightmost 12 characters.  
+
+	// exceptions: 
+	//   Throws an Error if this is not a version 1 UUID.
+	if (!this._nodeString) {
+		var errorMessage = "Called getNode() on a dojo.uuid.Uuid that was not a TIME_BASED UUID.";
+		dojo.lang.assert(this.getVersion() == dojo.uuid.Uuid.Version.TIME_BASED, errorMessage);
+
+		var arrayOfStrings = this._uuidString.split('-');
+		this._nodeString = arrayOfStrings[4];
+	}
+	return this._nodeString; // String (a 12-character string, which will look something like "917bf397618a")
+};
+
+dojo.uuid.Uuid.prototype.getTimestamp = function(/* misc. */ returnType) {
+	// summary: 
+	//   If this is a version 1 UUID (a time-based UUID), this method returns
+	//   the timestamp value encoded in the UUID.  The caller can ask for the
+	//   timestamp to be returned either as a JavaScript Date object or as a 
+	//   15-character string of hex digits.
+	// returnType: Any of these five values: "string", String, "hex", "date", Date
+
+	// returns: 
+	//   Returns the timestamp value as a JavaScript Date object or a 15-character string of hex digits.
+	// examples: 
+	//   var uuid = new dojo.uuid.Uuid("b4308fb0-86cd-11da-a72b-0800200c9a66");
+	//   var date, string, hexString;
+	//   date   = uuid.getTimestamp();         // returns a JavaScript Date
+	//   date   = uuid.getTimestamp(Date);     // 
+	//   string = uuid.getTimestamp(String);   // "Mon, 16 Jan 2006 20:21:41 GMT"
+	//   hexString = uuid.getTimestamp("hex"); // "1da86cdb4308fb0"
+	// exceptions: 
+	//   Throws an Error if this is not a version 1 UUID.
+	var errorMessage = "Called getTimestamp() on a dojo.uuid.Uuid that was not a TIME_BASED UUID.";
+	dojo.lang.assert(this.getVersion() == dojo.uuid.Uuid.Version.TIME_BASED, errorMessage);
+	
+	if (!returnType) {returnType = null};
+	switch (returnType) {
+		case "string":
+		case String:
+			return this.getTimestamp(Date).toUTCString(); // String (e.g. "Mon, 16 Jan 2006 20:21:41 GMT")
+			break;
+		case "hex":
+			// Return a 15-character string of hex digits containing the 
+			// timestamp for this UUID, with the high-order bits first.
+			if (!this._timestampAsHexString) {
+				var arrayOfStrings = this._uuidString.split('-');
+				var hexTimeLow = arrayOfStrings[0];
+				var hexTimeMid = arrayOfStrings[1];
+				var hexTimeHigh = arrayOfStrings[2];
+			
+				// Chop off the leading "1" character, which is the UUID 
+				// version number for time-based UUIDs.
+				hexTimeHigh = hexTimeHigh.slice(1);
+			
+				this._timestampAsHexString = hexTimeHigh + hexTimeMid + hexTimeLow;
+				dojo.lang.assert(this._timestampAsHexString.length == 15);
+			}
+			return this._timestampAsHexString; // String (e.g. "1da86cdb4308fb0")
+			break;
+		case null: // no returnType was specified, so default to Date
+		case "date":
+		case Date:
+			// Return a JavaScript Date object. 
+			if (!this._timestampAsDate) {
+				var GREGORIAN_CHANGE_OFFSET_IN_HOURS = 3394248;
+			
+				var arrayOfParts = this._uuidString.split('-');
+				var timeLow = parseInt(arrayOfParts[0], dojo.uuid.Uuid.HEX_RADIX);
+				var timeMid = parseInt(arrayOfParts[1], dojo.uuid.Uuid.HEX_RADIX);
+				var timeHigh = parseInt(arrayOfParts[2], dojo.uuid.Uuid.HEX_RADIX);
+				var hundredNanosecondIntervalsSince1582 = timeHigh & 0x0FFF;
+				hundredNanosecondIntervalsSince1582 <<= 16;
+				hundredNanosecondIntervalsSince1582 += timeMid;
+				// What we really want to do next is shift left 32 bits, but the 
+				// result will be too big to fit in an int, so we'll multiply by 2^32,
+				// and the result will be a floating point approximation.
+				hundredNanosecondIntervalsSince1582 *= 0x100000000;
+				hundredNanosecondIntervalsSince1582 += timeLow;
+				var millisecondsSince1582 = hundredNanosecondIntervalsSince1582 / 10000;
+			
+				// Again, this will be a floating point approximation.
+				// We can make things exact later if we need to.
+				var secondsPerHour = 60 * 60;
+				var hoursBetween1582and1970 = GREGORIAN_CHANGE_OFFSET_IN_HOURS;
+				var secondsBetween1582and1970 = hoursBetween1582and1970 * secondsPerHour;
+				var millisecondsBetween1582and1970 = secondsBetween1582and1970 * 1000;
+				var millisecondsSince1970 = millisecondsSince1582 - millisecondsBetween1582and1970;
+			
+				this._timestampAsDate = new Date(millisecondsSince1970);
+			}
+			return this._timestampAsDate; // Date
+			break;
+		default:
+			// we got passed something other than a valid returnType
+			dojo.lang.assert(false, "The getTimestamp() method dojo.uuid.Uuid was passed a bogus returnType: " + returnType);
+			break;
+	}
+};

source/web/scripts/ajax/dojo/src/uuid/__package__.js

@@ -0,0 +1,22 @@
+/*
+	Copyright (c) 2004-2006, The Dojo Foundation
+	All Rights Reserved.
+
+	Licensed under the Academic Free License version 2.1 or above OR the
+	modified BSD license. For more information on Dojo licensing, see:
+
+		http://dojotoolkit.org/community/licensing.shtml
+*/
+
+dojo.kwCompoundRequire({
+	common: [
+		"dojo.uuid.Uuid",
+		"dojo.uuid.LightweightGenerator",
+		"dojo.uuid.RandomGenerator",
+		"dojo.uuid.TimeBasedGenerator",
+		"dojo.uuid.NameBasedGenerator",
+		"dojo.uuid.NilGenerator"
+	]
+});
+dojo.provide("dojo.uuid.*");
+