You are viewing a plain text version of this content. The canonical link for it is here.
Posted to xap-commits@incubator.apache.org by mt...@apache.org on 2007/03/14 20:37:27 UTC

svn commit: r518313 [24/43] - in /incubator/xap/trunk/codebase/src/dojo: ./ src/ src/animation/ src/cal/ src/charting/ src/charting/svg/ src/charting/vml/ src/collections/ src/crypto/ src/data/ src/data/core/ src/data/old/ src/data/old/format/ src/data...

Added: incubator/xap/trunk/codebase/src/dojo/src/selection/Selection.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/selection/Selection.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/selection/Selection.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/selection/Selection.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,472 @@
+/*
+	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.selection.Selection");
+dojo.require("dojo.lang.array");
+dojo.require("dojo.lang.func");
+dojo.require("dojo.lang.common");
+dojo.require("dojo.math");
+
+dojo.declare("dojo.selection.Selection", null,
+	{
+		initializer: function(items, isCollection){
+			this.items = [];
+			this.selection = [];
+			this._pivotItems = [];
+			this.clearItems();
+
+			if(items) {
+				if(isCollection) {
+					this.setItemsCollection(items);
+				} else {
+					this.setItems(items);
+				}
+			}
+		},
+
+		// Array: items to select from, order matters for growable selections
+		items: null,
+
+		// Array: items selected, aren't stored in order (see sorted())
+		selection: null, 
+		lastSelected: null, // last item selected
+
+		// Boolean: if true, grow selection will start from 0th item when nothing is selected
+		allowImplicit: true, 
+
+		// Integer: number of *selected* items
+		length: 0, 
+
+		// Boolean:
+		//		if true, the selection is treated as an in-order and can grow
+		//		by ranges, not just by single item
+		isGrowable: true,
+
+		_pivotItems: null, // stack of pivot items
+		_pivotItem: null, // item we grow selections from, top of stack
+
+		// event handlers
+		onSelect: function(item){
+			// summary: slot to be connect()'d to
+		},
+		onDeselect: function(item){
+			// summary: slot to be connect()'d to
+		},
+		onSelectChange: function(item, selected){
+			// summary: slot to be connect()'d to
+		},
+
+		_find: function(item, inSelection) {
+			if(inSelection) {
+				return dojo.lang.find(this.selection, item);
+			} else {
+				return dojo.lang.find(this.items, item);
+			}
+		},
+
+		isSelectable: function(/*Object*/item){
+			// summary:
+			//		user-customizable and should be over-ridden, will filter
+			//		items through this
+			return true; // boolean
+		},
+
+		setItems: function(/* ... */){
+			// summary:
+			//		adds all passed arguments to the items array, removing any
+			//		previously selected items.
+			this.clearItems();
+			this.addItems.call(this, arguments);
+		},
+
+ 
+		setItemsCollection: function(/*Object*/collection){
+			// summary:
+			//		like setItems, but use in case you have an active
+			//		collection array-like object (i.e. getElementsByTagName
+			//		collection) that manages its own order and item list
+			this.items = collection;
+		},
+
+		addItems: function(/* ... */){
+			// summary:
+			//		adds all passed arguments to the items array
+			var args = dojo.lang.unnest(arguments);
+			for(var i = 0; i < args.length; i++){
+				this.items.push(args[i]);
+			}
+		},
+
+		addItemsAt: function(/*Object*/item, /*Object*/before /* ... */){
+			// summary:
+			//		add items to the array after the the passed "before" item.
+			if(this.items.length == 0){ // work for empy case
+				return this.addItems(dojo.lang.toArray(arguments, 2));
+			}
+
+			if(!this.isItem(item)){
+				item = this.items[item];
+			}
+			if(!item){ throw new Error("addItemsAt: item doesn't exist"); }
+			var idx = this._find(item);
+			if(idx > 0 && before){ idx--; }
+			for(var i = 2; i < arguments.length; i++){
+				if(!this.isItem(arguments[i])){
+					this.items.splice(idx++, 0, arguments[i]);
+				}
+			}
+		},
+
+		removeItem: function(/*Object*/item){
+			// summary: remove item
+			var idx = this._find(item);
+			if(idx > -1) {
+				this.items.splice(idx, 1);
+			}
+			// remove from selection
+			// FIXME: do we call deselect? I don't think so because this isn't how
+			// you usually want to deselect an item. For example, if you deleted an
+			// item, you don't really want to deselect it -- you want it gone. -DS
+			idx = this._find(item, true);
+			if(idx > -1) {
+				this.selection.splice(idx, 1);
+			}
+		},
+
+		clearItems: function(){
+			// summary: remove and uselect all items
+			this.items = [];
+			this.deselectAll();
+		},
+
+		isItem: function(/*Object*/item){
+			// summary: do we already "know" about the passed item?
+			return this._find(item) > -1; // boolean
+		},
+
+		isSelected: function(/*Object*/item){
+			// summary:
+			//		do we know about the item and is it selected by this
+			//		selection?
+			return this._find(item, true) > -1; // boolean
+		},
+
+		/**
+		 * allows you to filter item in or out of the selection
+		 * depending on the current selection and action to be taken
+		**/
+		selectFilter: function(item, selection, add, grow) {
+			return true;
+		},
+
+		update: function(/*Object*/item, /*Boolean*/add, /*Boolean*/grow, noToggle) {
+			// summary: manages selections, most selecting should be done here
+			// item: item which may be added/grown to/only selected/deselected
+			// add: behaves like ctrl in windows selection world
+			// grow: behaves like shift
+			// noToggle: if true, don't toggle selection on item
+			if(!this.isItem(item)){ return false; } // boolean
+
+			if(this.isGrowable && grow){
+				if( (!this.isSelected(item)) && 
+					this.selectFilter(item, this.selection, false, true) ){
+					this.grow(item);
+					this.lastSelected = item;
+				}
+			}else if(add){
+				if(this.selectFilter(item, this.selection, true, false)){
+					if(noToggle){
+						if(this.select(item)){
+							this.lastSelected = item;
+						}
+					}else if(this.toggleSelected(item)){
+						this.lastSelected = item;
+					}
+				}
+			}else{
+				this.deselectAll();
+				this.select(item);
+			}
+
+			this.length = this.selection.length;
+			return true; // Boolean
+		},
+
+		grow: function(/*Object*/toItem, /*Object*/fromItem){
+			// summary:
+			//		Grow a selection. Any items in (fromItem, lastSelected]
+			//		that aren't part of (fromItem, toItem] will be deselected
+			// toItem: which item to grow selection to
+			// fromItem: which item to start the growth from (it won't be selected)
+			if(!this.isGrowable){ return; }
+
+			if(arguments.length == 1){
+				fromItem = this._pivotItem;
+				if(!fromItem && this.allowImplicit){
+					fromItem = this.items[0];
+				}
+			}
+			if(!toItem || !fromItem){ return false; }
+
+			var fromIdx = this._find(fromItem);
+
+			// get items to deselect (fromItem, lastSelected]
+			var toDeselect = {};
+			var lastIdx = -1;
+			if(this.lastSelected){
+				lastIdx = this._find(this.lastSelected);
+				var step = fromIdx < lastIdx ? -1 : 1;
+				var range = dojo.math.range(lastIdx, fromIdx, step);
+				for(var i = 0; i < range.length; i++){
+					toDeselect[range[i]] = true;
+				}
+			}
+
+			// add selection (fromItem, toItem]
+			var toIdx = this._find(toItem);
+			var step = fromIdx < toIdx ? -1 : 1;
+			var shrink = lastIdx >= 0 && step == 1 ? lastIdx < toIdx : lastIdx > toIdx;
+			var range = dojo.math.range(toIdx, fromIdx, step);
+			if(range.length){
+				for(var i = range.length-1; i >= 0; i--){
+					var item = this.items[range[i]];
+					if(this.selectFilter(item, this.selection, false, true)){
+						if(this.select(item, true) || shrink){
+							this.lastSelected = item;
+						}
+						if(range[i] in toDeselect){
+							delete toDeselect[range[i]];
+						}
+					}
+				}
+			}else{
+				this.lastSelected = fromItem;
+			}
+
+			// now deselect...
+			for(var i in toDeselect){
+				if(this.items[i] == this.lastSelected){
+					//dojo.debug("oops!");
+				}
+				this.deselect(this.items[i]);
+			}
+
+			// make sure everything is all kosher after selections+deselections
+			this._updatePivot();
+		},
+
+		growUp: function(){
+			// summary: Grow selection upwards one item from lastSelected
+			if(!this.isGrowable){ return; }
+
+			var idx = this._find(this.lastSelected) - 1;
+			while(idx >= 0){
+				if(this.selectFilter(this.items[idx], this.selection, false, true)){
+					this.grow(this.items[idx]);
+					break;
+				}
+				idx--;
+			}
+		},
+
+		growDown: function(){
+			// summary: Grow selection downwards one item from lastSelected
+			if(!this.isGrowable){ return; }
+
+			var idx = this._find(this.lastSelected);
+			if(idx < 0 && this.allowImplicit){
+				this.select(this.items[0]);
+				idx = 0;
+			}
+			idx++;
+			while(idx > 0 && idx < this.items.length){
+				if(this.selectFilter(this.items[idx], this.selection, false, true)){
+					this.grow(this.items[idx]);
+					break;
+				}
+				idx++;
+			}
+		},
+
+		toggleSelected: function(/*Object*/item, /*Boolean*/noPivot){
+			// summary:
+			//		like it says on the tin. If noPivot is true, no selection
+			//		pivot is added (or removed) from the selection. Returns 1
+			//		if the item is selected, -1 if it is deselected, and 0 if
+			//		the item is not under management.
+			if(this.isItem(item)){
+				if(this.select(item, noPivot)){ return 1; }
+				if(this.deselect(item)){ return -1; }
+			}
+			return 0;
+		},
+
+		select: function(/*Object*/item, /*Boolean*/noPivot){
+			// summary:
+			//		like it says on the tin. If noPivot is true, no selection
+			//		pivot is added  from the selection.
+			if(this.isItem(item) && !this.isSelected(item)
+				&& this.isSelectable(item)){
+				this.selection.push(item);
+				this.lastSelected = item;
+				this.onSelect(item);
+				this.onSelectChange(item, true);
+				if(!noPivot){
+					this._addPivot(item);
+				}
+				this.length = this.selection.length;
+				return true;
+			}
+			return false;
+		},
+
+		deselect: function(item){
+			// summary: deselects the item if it's selected.
+			var idx = this._find(item, true);
+			if(idx > -1){
+				this.selection.splice(idx, 1);
+				this.onDeselect(item);
+				this.onSelectChange(item, false);
+				if(item == this.lastSelected){
+					this.lastSelected = null;
+				}
+				this._removePivot(item);
+				this.length = this.selection.length;
+				return true;
+			}
+			return false;
+		},
+
+		selectAll: function(){
+			// summary: selects all known items
+			for(var i = 0; i < this.items.length; i++){
+				this.select(this.items[i]);
+			}
+		},
+
+		deselectAll: function(){
+			// summary: deselects all currently selected items
+			while(this.selection && this.selection.length){
+				this.deselect(this.selection[0]);
+			}
+		},
+
+		selectNext: function(){
+			// summary:
+			//		clobbers the existing selection (if any) and selects the
+			//		next item "below" the previous "bottom" selection. Returns
+			//		whether or not selection was successful.
+			var idx = this._find(this.lastSelected);
+			while(idx > -1 && ++idx < this.items.length){
+				if(this.isSelectable(this.items[idx])){
+					this.deselectAll();
+					this.select(this.items[idx]);
+					return true;
+				}
+			}
+			return false;
+		},
+
+		selectPrevious: function(){
+			// summary:
+			//		clobbers the existing selection (if any) and selects the
+			//		item "above" the previous "top" selection. Returns whether
+			//		or not selection was successful.
+			var idx = this._find(this.lastSelected);
+			while(idx-- > 0){
+				if(this.isSelectable(this.items[idx])){
+					this.deselectAll();
+					this.select(this.items[idx]);
+					return true;
+				}
+			}
+			return false;
+		},
+
+		selectFirst: function(){
+			// summary:
+			//		select first selectable item. Returns whether or not an
+			//		item was selected.
+			this.deselectAll();
+			var idx = 0;
+			while(this.items[idx] && !this.select(this.items[idx])){
+				idx++;
+			}
+			return this.items[idx] ? true : false;
+		},
+
+		selectLast: function(){
+			// summary: select last selectable item
+			this.deselectAll();
+			var idx = this.items.length-1;
+			while(this.items[idx] && !this.select(this.items[idx])) {
+				idx--;
+			}
+			return this.items[idx] ? true : false;
+		},
+
+		_addPivot: function(item, andClear){
+			this._pivotItem = item;
+			if(andClear){
+				this._pivotItems = [item];
+			}else{
+				this._pivotItems.push(item);
+			}
+		},
+
+		_removePivot: function(item){
+			var i = dojo.lang.find(this._pivotItems, item);
+			if(i > -1){
+				this._pivotItems.splice(i, 1);
+				this._pivotItem = this._pivotItems[this._pivotItems.length-1];
+			}
+
+			this._updatePivot();
+		},
+
+		_updatePivot: function(){
+			if(this._pivotItems.length == 0){
+				if(this.lastSelected){
+					this._addPivot(this.lastSelected);
+				}
+			}
+		},
+
+		sorted: function(){
+			// summary: returns an array of items in sort order
+			return dojo.lang.toArray(this.selection).sort(
+				dojo.lang.hitch(this, function(a, b){
+					var A = this._find(a), B = this._find(b);
+					if(A > B){
+						return 1;
+					}else if(A < B){
+						return -1;
+					}else{
+						return 0;
+					}
+				})
+			);
+		},
+
+		updateSelected: function(){
+			// summary: 
+			//		remove any items from the selection that are no longer in
+			//		this.items
+			for(var i = 0; i < this.selection.length; i++) {
+				if(this._find(this.selection[i]) < 0) {
+					var removed = this.selection.splice(i, 1);
+
+					this._removePivot(removed[0]);
+				}
+			}
+			this.length = this.selection.length;
+		}
+	}
+);

Added: incubator/xap/trunk/codebase/src/dojo/src/storage.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/storage.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/storage.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/storage.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,394 @@
+/*
+	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.storage");
+
+dojo.require("dojo.lang.*");
+dojo.require("dojo.event.*");
+
+
+dojo.storage = new function(){
+	// summary: A singleton for working with Dojo Storage.
+	// description:
+	//	dojo.storage exposes the current available storage
+	//	provider on this platform. It gives you methods such
+	//	as dojo.storage.put(), dojo.storage.get(), etc.
+	//  
+	//  	For more details on Dojo Storage, see the primary
+	//	documentation page at
+	//	http://manual.dojotoolkit.org/storage.html
+	//
+	//	Note for storage provider developers who are creating
+	//	subclasses-
+	//	This is the base class for all storage providers
+	//	Specific kinds of Storage Providers should subclass this
+	//	and implement these methods. You should avoid initialization
+	//	storage provider subclass's constructor; instead, perform 
+	//	initialization in your initialize() method. 	
+}
+
+dojo.declare("dojo.storage", null, {
+	// SUCCESS: String
+	//	Flag that indicates a put() call to a 
+	//	storage provider was succesful.
+	SUCCESS: "success",
+	
+	// FAILED: String
+	//	Flag that indicates a put() call to 
+	//	a storage provider failed.
+	FAILED: "failed",
+	
+	// PENDING: String
+	//	Flag that indicates a put() call to a 
+	//	storage provider is pending user approval.
+	PENDING: "pending",
+	
+	// SIZE_NOT_AVAILABLE: String
+	//	Returned by getMaximumSize() if this storage provider can not determine
+	//	the maximum amount of data it can support. 
+	SIZE_NOT_AVAILABLE: "Size not available",
+	
+	// SIZE_NO_LIMIT: String
+	//	Returned by getMaximumSize() if this storage provider has no theoretical
+	//	limit on the amount of data it can store. 
+	SIZE_NO_LIMIT: "No size limit",
+
+	// namespace: String
+	//	The namespace for all storage operations. This is useful if several
+	//	applications want access to the storage system from the same domain but
+		//want different storage silos. 
+	namespace: "default",
+	
+	// onHideSettingsUI: Function
+	//	If a function is assigned to this property, then when the settings
+	//	provider's UI is closed this function is called. Useful, for example,
+	//	if the user has just cleared out all storage for this provider using
+	//	the settings UI, and you want to update your UI.
+	onHideSettingsUI: null,
+
+	initialize: function(){
+		// summary: 
+		//		Allows this storage provider to initialize itself. This is
+		//		called after the page has finished loading, so you can not do
+		//		document.writes(). Storage Provider subclasses should initialize
+		//		themselves inside of here rather than in their function
+		//		constructor.
+		dojo.unimplemented("dojo.storage.initialize");
+	},
+	
+	isAvailable: function(){ /*Boolean*/
+		// summary: 
+		//		Returns whether this storage provider is available on this
+		//		platform. 
+		dojo.unimplemented("dojo.storage.isAvailable");
+	},
+
+	put: function(	/*string*/ key,
+					/*object*/ value, 
+					/*function*/ resultsHandler){
+		// summary:
+		//		Puts a key and value into this storage system.
+		// description:
+		//		Example-
+		//			var resultsHandler = function(status, key, message){
+		//			  alert("status="+status+", key="+key+", message="+message);
+		//			};
+		//			dojo.storage.put("test", "hello world", resultsHandler);
+		// key:
+		//		A string key to use when retrieving this value in the future.
+		// value:
+		//		A value to store; this can be any JavaScript type.
+		// resultsHandler:
+		//		A callback function that will receive three arguments. The
+		//		first argument is one of three values: dojo.storage.SUCCESS,
+		//		dojo.storage.FAILED, or dojo.storage.PENDING; these values
+		//		determine how the put request went. In some storage systems
+		//		users can deny a storage request, resulting in a
+		//		dojo.storage.FAILED, while in other storage systems a storage
+		//		request must wait for user approval, resulting in a
+		//		dojo.storage.PENDING status until the request is either
+		//		approved or denied, resulting in another call back with
+		//		dojo.storage.SUCCESS. 
+		//		The second argument in the call back is the key name that was being stored.
+		//		The third argument in the call back is an optional message that
+		//		details possible error messages that might have occurred during
+		//		the storage process.
+		
+		dojo.unimplemented("dojo.storage.put");
+	},
+
+	get: function(/*string*/ key){ /*Object*/
+		// summary:
+		//		Gets the value with the given key. Returns null if this key is
+		//		not in the storage system.
+		// key:
+		//		A string key to get the value of.
+		// return: Returns any JavaScript object type; null if the key is not present
+		dojo.unimplemented("dojo.storage.get");
+	},
+
+	hasKey: function(/*string*/ key){ /*Boolean*/
+		// summary: Determines whether the storage has the given key. 
+		return (this.get(key) != null);
+	},
+
+	getKeys: function(){ /*Array*/
+		// summary: Enumerates all of the available keys in this storage system.
+		// return: Array of available keys
+		dojo.unimplemented("dojo.storage.getKeys");
+	},
+	
+	clear: function(){
+		// summary: 
+		//		Completely clears this storage system of all of it's values and
+		//		keys. 
+		dojo.unimplemented("dojo.storage.clear");
+	},
+  
+	remove: function(key){
+		// summary: Removes the given key from this storage system.
+		dojo.unimplemented("dojo.storage.remove");
+	},
+
+	isPermanent: function(){ /*Boolean*/
+		// summary:
+		//		Returns whether this storage provider's values are persisted
+		//		when this platform is shutdown. 
+		dojo.unimplemented("dojo.storage.isPermanent");
+	},
+
+	getMaximumSize: function(){ /* mixed */
+		// summary: The maximum storage allowed by this provider
+		// returns: 
+		//	Returns the maximum storage size 
+	    //	supported by this provider, in 
+	    //	thousands of bytes (i.e., if it 
+	    //	returns 60 then this means that 60K 
+	    //	of storage is supported).
+	    //
+	    //	If this provider can not determine 
+	    //	it's maximum size, then 
+	    //	dojo.storage.SIZE_NOT_AVAILABLE is 
+	    //	returned; if there is no theoretical
+	    //	limit on the amount of storage 
+	    //	this provider can return, then
+	    //	dojo.storage.SIZE_NO_LIMIT is 
+	    //	returned
+		dojo.unimplemented("dojo.storage.getMaximumSize");
+	},
+
+	hasSettingsUI: function(){ /*Boolean*/
+		// summary: Determines whether this provider has a settings UI.
+		return false;
+	},
+
+	showSettingsUI: function(){
+		// summary: If this provider has a settings UI, determined
+		// by calling hasSettingsUI(), it is shown. 
+		dojo.unimplemented("dojo.storage.showSettingsUI");
+	},
+
+	hideSettingsUI: function(){
+		// summary: If this provider has a settings UI, hides it.
+		dojo.unimplemented("dojo.storage.hideSettingsUI");
+	},
+	
+	getType: function(){ /*String*/
+		// summary:
+		//		The provider name as a string, such as
+		//		"dojo.storage.FlashStorageProvider". 
+		dojo.unimplemented("dojo.storage.getType");
+	},
+	
+	isValidKey: function(/*string*/ keyName){ /*Boolean*/
+		// summary:
+		//		Subclasses can call this to ensure that the key given is valid
+		//		in a consistent way across different storage providers. We use
+		//		the lowest common denominator for key values allowed: only
+		//		letters, numbers, and underscores are allowed. No spaces. 
+		if((keyName == null)||(typeof keyName == "undefined")){
+			return false;
+		}
+			
+		return /^[0-9A-Za-z_]*$/.test(keyName);
+	}
+});
+
+
+
+
+dojo.storage.manager = new function(){
+	// summary: A singleton class in charge of the Dojo Storage system
+	// description:
+	//		Initializes the storage systems and figures out the best available 
+	//		storage options on this platform.	
+	
+	// currentProvider: Object
+	//	The storage provider that was automagically chosen to do storage
+	//	on this platform, such as dojo.storage.browser.FlashStorageProvider.
+	this.currentProvider = null;
+	
+	// available: Boolean
+	//	Whether storage of some kind is available
+	this.available = false;
+	
+	this._initialized = false;
+	this._providers = [];
+	
+	// namespace: String
+	//	An optional namespace value that can be used by a single application
+	//	to partition storage into seperate units - not well supported yet.
+	this.namespace = "default";
+	
+	this.initialize = function(){
+		// summary: 
+		//		Initializes the storage system and autodetects the best storage
+		//		provider we can provide on this platform
+		this.autodetect();
+	};
+	
+	this.register = function(/*string*/ name, /*Object*/ instance) {
+		// summary:
+		//		Registers the existence of a new storage provider; used by
+		//		subclasses to inform the manager of their existence. The
+		//		storage manager will select storage providers based on 
+		//		their ordering, so the order in which you call this method
+		//		matters. 
+		// name:
+		//		The full class name of this provider, such as
+		//		"dojo.storage.browser.FlashStorageProvider".
+		// instance:
+		//		An instance of this provider, which we will use to call
+		//		isAvailable() on. 
+		this._providers[this._providers.length] = instance;
+		this._providers[name] = instance;
+	};
+	
+	this.setProvider = function(storageClass){
+		// summary:
+		//		Instructs the storageManager to use the given storage class for
+		//		all storage requests.
+		// description:
+		//		Example-
+		//			dojo.storage.setProvider(
+		//				dojo.storage.browser.IEStorageProvider)
+	
+	};
+	
+	this.autodetect = function(){
+		// summary:
+		//		Autodetects the best possible persistent storage provider
+		//		available on this platform. 
+		if(this._initialized == true){ // already finished
+			return;
+		}
+			
+		// go through each provider, seeing if it can be used
+		var providerToUse = null;
+		for(var i = 0; i < this._providers.length; i++){
+			providerToUse = this._providers[i];
+			// a flag to force the storage manager to use a particular 
+			// storage provider type, such as 
+			// djConfig = {forceStorageProvider: "dojo.storage.browser.WhatWGStorageProvider"};
+			if(dojo.lang.isUndefined(djConfig["forceStorageProvider"]) == false
+				&& providerToUse.getType() == djConfig["forceStorageProvider"]){
+				// still call isAvailable for this provider, since this helps some
+				// providers internally figure out if they are available
+				providerToUse.isAvailable();
+				break;
+			}else if(dojo.lang.isUndefined(djConfig["forceStorageProvider"]) == true
+						&& providerToUse.isAvailable()){
+				break;
+			}
+		}	
+		
+		if(providerToUse == null){ // no provider available
+			this._initialized = true;
+			this.available = false;
+			this.currentProvider = null;
+			dojo.raise("No storage provider found for this platform");
+		}
+			
+		// create this provider and copy over it's properties
+		this.currentProvider = providerToUse;
+	  	for(var i in providerToUse){
+	  		dojo.storage[i] = providerToUse[i];
+		}
+		dojo.storage.manager = this;
+		
+		// have the provider initialize itself
+		dojo.storage.initialize();
+		
+		this._initialized = true;
+		this.available = true;
+	};
+	
+	this.isAvailable = function(){ /*Boolean*/
+		// summary: Returns whether any storage options are available.
+		return this.available;
+	};
+	
+	this.isInitialized = function(){ /*Boolean*/
+	 	// summary:
+		//		Returns whether the storage system is initialized and ready to
+		//		be used. 
+
+		// FIXME: This should REALLY not be in here, but it fixes a tricky
+		// Flash timing bug
+		if(this.currentProvider.getType() == "dojo.storage.browser.FlashStorageProvider"
+			&& dojo.flash.ready == false){
+			return false;
+		}else{
+			return this._initialized;
+		}
+	};
+
+	this.supportsProvider = function(/*string*/ storageClass){ /* Boolean */
+		// summary: Determines if this platform supports the given storage provider.
+		// description:
+		//		Example-
+		//			dojo.storage.manager.supportsProvider(
+		//				"dojo.storage.browser.InternetExplorerStorageProvider");
+
+		// construct this class dynamically
+		try{
+			// dynamically call the given providers class level isAvailable()
+			// method
+			var provider = eval("new " + storageClass + "()");
+			var results = provider.isAvailable();
+			if(results == null || typeof results == "undefined")
+				return false;
+			return results;
+		}catch (exception){
+			return false;
+		}
+	};
+
+	this.getProvider = function(){ /* Object */
+		// summary: Gets the current provider
+		return this.currentProvider;
+	};
+	
+	this.loaded = function(){
+		// summary:
+		//		The storage provider should call this method when it is loaded
+		//		and ready to be used. Clients who will use the provider will
+		//		connect to this method to know when they can use the storage
+		//		system.
+		// description:
+		//		Example-
+		//			if(dojo.storage.manager.isInitialized() == false){ 
+		//				dojo.event.connect(dojo.storage.manager, "loaded", TestStorage, 
+	    //				TestStorage.initialize);
+		//			}else{
+		//				dojo.event.connect(dojo, "loaded", TestStorage, TestStorage.initialize);
+		//			}
+	};
+};

Added: incubator/xap/trunk/codebase/src/dojo/src/storage/Storage.as
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/storage/Storage.as?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/storage/Storage.as (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/storage/Storage.as Wed Mar 14 13:36:44 2007
@@ -0,0 +1,146 @@
+/*
+	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
+*/
+
+import DojoExternalInterface;
+
+class Storage {
+	public static var SUCCESS = "success";
+	public static var FAILED = "failed";
+	public static var PENDING = "pending";
+	
+	public var so;
+	
+	public function Storage(){
+		//getURL("javascript:dojo.debug('FLASH:Storage constructor')");
+		DojoExternalInterface.initialize();
+		DojoExternalInterface.addCallback("put", this, put);
+		DojoExternalInterface.addCallback("get", this, get);
+		DojoExternalInterface.addCallback("showSettings", this, showSettings);
+		DojoExternalInterface.addCallback("clear", this, clear);
+		DojoExternalInterface.addCallback("getKeys", this, getKeys);
+		DojoExternalInterface.addCallback("remove", this, remove);
+		DojoExternalInterface.loaded();
+		
+		// preload the System Settings finished button movie for offline
+		// access so it is in the cache
+		_root.createEmptyMovieClip("_settingsBackground", 1);
+		// getURL("javascript:alert('"+DojoExternalInterface.dojoPath+"');");
+		_root._settingsBackground.loadMovie(DojoExternalInterface.dojoPath + "storage_dialog.swf");
+	}
+
+	public function put(keyName, keyValue, namespace){
+		// Get the SharedObject for these values and save it
+		so = SharedObject.getLocal(namespace);
+		
+		// prepare a storage status handler
+		var self = this;
+		so.onStatus = function(infoObject:Object){
+			//getURL("javascript:dojo.debug('FLASH: onStatus, infoObject="+infoObject.code+"')");
+			
+			// delete the data value if the request was denied
+			if (infoObject.code == "SharedObject.Flush.Failed"){
+				delete self.so.data[keyName];
+			}
+			
+			var statusResults;
+			if(infoObject.code == "SharedObject.Flush.Failed"){
+				statusResults = Storage.FAILED;
+			}else if(infoObject.code == "SharedObject.Flush.Pending"){
+				statusResults = Storage.PENDING;
+			}else if(infoObject.code == "SharedObject.Flush.Success"){
+				statusResults = Storage.SUCCESS;
+			}
+			//getURL("javascript:dojo.debug('FLASH: onStatus, statusResults="+statusResults+"')");
+			
+			// give the status results to JavaScript
+			DojoExternalInterface.call("dojo.storage._onStatus", null, statusResults, 
+																 keyName);
+		}
+		
+		// save the key and value
+		so.data[keyName] = keyValue;
+		var flushResults = so.flush();
+		
+		// return results of this command to JavaScript
+		var statusResults;
+		if(flushResults == true){
+			statusResults = Storage.SUCCESS;
+		}else if(flushResults == "pending"){
+			statusResults = Storage.PENDING;
+		}else{
+			statusResults = Storage.FAILED;
+		}
+		
+		DojoExternalInterface.call("dojo.storage._onStatus", null, statusResults, 
+															 keyName);
+	}
+
+	public function get(keyName, namespace){
+		// Get the SharedObject for these values and save it
+		so = SharedObject.getLocal(namespace);
+		var results = so.data[keyName];
+		
+		return results;
+	}
+	
+	public function showSettings(){
+		// Show the configuration options for the Flash player, opened to the
+		// section for local storage controls (pane 1)
+		System.showSettings(1);
+		
+		// there is no way we can intercept when the Close button is pressed, allowing us
+		// to hide the Flash dialog. Instead, we need to load a movie in the
+		// background that we can show a close button on.
+		_root.createEmptyMovieClip("_settingsBackground", 1);
+		_root._settingsBackground.loadMovie(DojoExternalInterface.dojoPath + "storage_dialog.swf");
+	}
+	
+	public function clear(namespace){
+		so = SharedObject.getLocal(namespace);
+		so.clear();
+		so.flush();
+	}
+	
+	public function getKeys(namespace){
+		// Returns a list of the available keys in this namespace
+		
+		// get the storage object
+		so = SharedObject.getLocal(namespace);
+		
+		// get all of the keys
+		var results = new Array();
+		for(var i in so.data)
+			results.push(i);	
+		
+		// join the keys together in a comma seperated string
+		results = results.join(",");
+		
+		return results;
+	}
+	
+	public function remove(keyName, namespace){
+		// Removes a key
+
+		// get the storage object
+		so = SharedObject.getLocal(namespace);
+		
+		// delete this value
+		delete so.data[keyName];
+		
+		// save the changes
+		so.flush();
+	}
+
+	static function main(mc){
+		//getURL("javascript:dojo.debug('FLASH: storage loaded')");
+		_root.app = new Storage(); 
+	}
+}
+

Added: incubator/xap/trunk/codebase/src/dojo/src/storage/__package__.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/storage/__package__.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/storage/__package__.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/storage/__package__.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,16 @@
+/*
+	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.storage"],
+	browser: ["dojo.storage.browser"]
+});
+dojo.provide("dojo.storage.*");
+

Added: incubator/xap/trunk/codebase/src/dojo/src/storage/browser.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/storage/browser.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/storage/browser.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/storage/browser.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,363 @@
+/*
+	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.storage.browser");
+
+dojo.require("dojo.storage");
+dojo.require("dojo.flash");
+dojo.require("dojo.json");
+dojo.require("dojo.uri.*");
+
+
+
+dojo.storage.browser.WhatWGStorageProvider = function(){
+	// summary:
+	//		Storage provider that uses WHAT Working Group features in Firefox 2 
+	//		to achieve permanent storage.
+	// description: 
+	//		The WHAT WG storage API is documented at 
+	//		http://www.whatwg.org/specs/web-apps/current-work/#scs-client-side
+	//
+	//		You can disable this storage provider with the following djConfig
+	//		variable:
+	//		var djConfig = { disableWhatWGStorage: true };
+	//		
+	//		Authors of this storage provider-	
+	//			JB Boisseau, jb.boisseau@eutech-ssii.com
+	//			Brad Neuberg, bkn3@columbia.edu 
+}
+
+dojo.inherits(dojo.storage.browser.WhatWGStorageProvider, dojo.storage);
+
+// instance methods and properties
+dojo.lang.extend(dojo.storage.browser.WhatWGStorageProvider, {
+	namespace: "default",
+	initialized: false,
+	
+	_domain: null,
+	_available: null,
+	_statusHandler: null,
+	
+	initialize: function(){
+		if(djConfig["disableWhatWGStorage"] == true){
+			return;
+		}
+		
+		// get current domain
+		this._domain = location.hostname;
+		
+		// indicate that this storage provider is now loaded
+		this.initialized = true;
+		dojo.storage.manager.loaded();	
+	},
+	
+	isAvailable: function(){
+		try{
+			var myStorage = globalStorage[location.hostname];
+		}catch(e){
+			this._available = false;
+			return this._available;
+		}
+		
+		this._available = true;	
+		return this._available;
+	},
+
+	put: function(key, value, resultsHandler){
+		if(this.isValidKey(key) == false){
+			dojo.raise("Invalid key given: " + key);
+		}			
+		
+		this._statusHandler = resultsHandler;
+		
+		// serialize the value;
+		// handle strings differently so they have better performance
+		if(dojo.lang.isString(value)){
+			value = "string:" + value;
+		}else{
+			value = dojo.json.serialize(value);
+		}
+		
+		// register for successful storage events
+		window.addEventListener("storage", function(evt){
+			// indicate we succeeded
+			resultsHandler.call(null, dojo.storage.SUCCESS, key);
+		}, false);
+		
+		// try to store the value	
+		try{
+			var myStorage = globalStorage[this._domain];
+			myStorage.setItem(key,value);
+		}catch(e){
+			// indicate we failed
+			this._statusHandler.call(null, dojo.storage.FAILED, 
+									key, e.toString());
+		}
+	},
+
+	get: function(key){
+		if(this.isValidKey(key) == false){
+			dojo.raise("Invalid key given: " + key);
+		}
+		
+		var myStorage = globalStorage[this._domain];
+		
+		var results = myStorage.getItem(key);
+
+		if(results == null){
+			return null;
+		}
+	
+		results = results.value;
+		
+		// destringify the content back into a 
+		// real JavaScript object;
+		// handle strings differently so they have better performance
+		if(!dojo.lang.isUndefined(results) && results != null 
+			 && /^string:/.test(results)){
+			results = results.substring("string:".length);
+		}else{
+			results = dojo.json.evalJson(results);
+		}
+		
+		return results;
+	},
+
+	getKeys: function(){
+		var myStorage = globalStorage[this._domain];
+		var keysArray = new Array();
+		for(i=0; i<myStorage.length;i++){
+			keysArray[i] = myStorage.key(i);
+		}
+		
+		return keysArray;
+	},
+
+	clear: function(){
+		var myStorage = globalStorage[this._domain];
+		var keys = new Array();
+		for(var i = 0; i < myStorage.length; i++){
+			keys[keys.length] = myStorage.key(i);
+		}
+		
+		for(var i = 0; i < keys.length; i++){
+			myStorage.removeItem(keys[i]);
+		}
+	},
+	
+	remove: function(key){
+		var myStorage = globalStorage[this._domain];
+		myStorage.removeItem(key);
+	},
+	
+	isPermanent: function(){
+		return true;
+	},
+
+	getMaximumSize: function(){
+		return dojo.storage.SIZE_NO_LIMIT;
+	},
+
+	hasSettingsUI: function(){
+		return false;
+	},
+	
+	showSettingsUI: function(){
+		dojo.raise(this.getType() + " does not support a storage settings user-interface");
+	},
+	
+	hideSettingsUI: function(){
+		dojo.raise(this.getType() + " does not support a storage settings user-interface");
+	},
+	
+	getType: function(){
+		return "dojo.storage.browser.WhatWGStorageProvider";
+	}
+});
+
+
+
+
+dojo.storage.browser.FlashStorageProvider = function(){
+	// summary: Storage provider that uses features in Flash to achieve permanent storage
+	// description:
+	//		Authors of this storage provider-
+	//			Brad Neuberg, bkn3@columbia.edu	
+}
+
+dojo.inherits(dojo.storage.browser.FlashStorageProvider, dojo.storage);
+
+// instance methods and properties
+dojo.lang.extend(dojo.storage.browser.FlashStorageProvider, {
+	namespace: "default",
+	initialized: false,
+	_available: null,
+	_statusHandler: null,
+	
+	initialize: function(){
+		if(djConfig["disableFlashStorage"] == true){
+			return;
+		}
+		
+		// initialize our Flash
+		var loadedListener = function(){
+			dojo.storage._flashLoaded();
+		}
+		dojo.flash.addLoadedListener(loadedListener);
+		var swfloc6 = dojo.uri.dojoUri("Storage_version6.swf").toString();
+		var swfloc8 = dojo.uri.dojoUri("Storage_version8.swf").toString();
+		dojo.flash.setSwf({flash6: swfloc6, flash8: swfloc8, visible: false});
+	},
+	
+	isAvailable: function(){
+		if(djConfig["disableFlashStorage"] == true){
+			this._available = false;
+		}else{
+			this._available = true;
+		}
+		
+		return this._available;
+	},
+
+	put: function(key, value, resultsHandler){
+		if(this.isValidKey(key) == false){
+			dojo.raise("Invalid key given: " + key);
+		}
+			
+		this._statusHandler = resultsHandler;
+		
+		// serialize the value;
+		// handle strings differently so they have better performance
+		if(dojo.lang.isString(value)){
+			value = "string:" + value;
+		}else{
+			value = dojo.json.serialize(value);
+		}
+		
+		dojo.flash.comm.put(key, value, this.namespace);
+	},
+
+	get: function(key){
+		if(this.isValidKey(key) == false){
+			dojo.raise("Invalid key given: " + key);
+		}
+		
+		var results = dojo.flash.comm.get(key, this.namespace);
+
+		if(results == ""){
+			return null;
+		}
+    
+		// destringify the content back into a 
+		// real JavaScript object;
+		// handle strings differently so they have better performance
+		if(!dojo.lang.isUndefined(results) && results != null 
+			 && /^string:/.test(results)){
+			results = results.substring("string:".length);
+		}else{
+			results = dojo.json.evalJson(results);
+		}
+    
+		return results;
+	},
+
+	getKeys: function(){
+		var results = dojo.flash.comm.getKeys(this.namespace);
+		
+		if(results == ""){
+			return [];
+		}
+
+		// the results are returned comma seperated; split them
+		return results.split(",");
+	},
+
+	clear: function(){
+		dojo.flash.comm.clear(this.namespace);
+	},
+	
+	remove: function(key){
+		// summary: 
+		//		Note- This one method is not implemented on the
+		// 		FlashStorageProvider yet
+		
+		dojo.unimplemented("dojo.storage.browser.FlashStorageProvider.remove");
+	},
+	
+	isPermanent: function(){
+		return true;
+	},
+
+	getMaximumSize: function(){
+		return dojo.storage.SIZE_NO_LIMIT;
+	},
+
+	hasSettingsUI: function(){
+		return true;
+	},
+
+	showSettingsUI: function(){
+		dojo.flash.comm.showSettings();
+		dojo.flash.obj.setVisible(true);
+		dojo.flash.obj.center();
+	},
+
+	hideSettingsUI: function(){
+		// hide the dialog
+		dojo.flash.obj.setVisible(false);
+		
+		// call anyone who wants to know the dialog is
+		// now hidden
+		if(dojo.storage.onHideSettingsUI != null &&
+			!dojo.lang.isUndefined(dojo.storage.onHideSettingsUI)){
+			dojo.storage.onHideSettingsUI.call(null);	
+		}
+	},
+	
+	getType: function(){
+		return "dojo.storage.browser.FlashStorageProvider";
+	},
+	
+	/** Called when the Flash is finished loading. */
+	_flashLoaded: function(){
+		this._initialized = true;
+
+		// indicate that this storage provider is now loaded
+		dojo.storage.manager.loaded();
+	},
+	
+	//	Called if the storage system needs to tell us about the status
+	//	of a put() request. 
+	_onStatus: function(statusResult, key){
+		var ds = dojo.storage;
+		var dfo = dojo.flash.obj;
+		
+		if(statusResult == ds.PENDING){
+			dfo.center();
+			dfo.setVisible(true);
+		}else{
+			dfo.setVisible(false);
+		}
+		
+		if((!dj_undef("_statusHandler", ds))&&(ds._statusHandler != null)){
+			ds._statusHandler.call(null, statusResult, key);		
+		}
+	}
+});
+
+// register the existence of our storage providers
+dojo.storage.manager.register("dojo.storage.browser.WhatWGStorageProvider",
+								new dojo.storage.browser.WhatWGStorageProvider());
+dojo.storage.manager.register("dojo.storage.browser.FlashStorageProvider",
+								new dojo.storage.browser.FlashStorageProvider());
+
+// now that we are loaded and registered tell the storage manager to initialize
+// itself
+dojo.storage.manager.initialize();

Added: incubator/xap/trunk/codebase/src/dojo/src/storage/storage_dialog.fla
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/storage/storage_dialog.fla?view=auto&rev=518313
==============================================================================
Binary file - no diff available.

Propchange: incubator/xap/trunk/codebase/src/dojo/src/storage/storage_dialog.fla
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: incubator/xap/trunk/codebase/src/dojo/src/string.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/string.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/string.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/string.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,12 @@
+/*
+	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.string");
+dojo.require("dojo.string.common");

Added: incubator/xap/trunk/codebase/src/dojo/src/string/Builder.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/string/Builder.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/string/Builder.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/string/Builder.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,128 @@
+/*
+	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.string.Builder");
+dojo.require("dojo.string");
+dojo.require("dojo.lang.common");
+
+// NOTE: testing shows that direct "+=" concatenation is *much* faster on
+// Spidermoneky and Rhino, while arr.push()/arr.join() style concatenation is
+// significantly quicker on IE (Jscript/wsh/etc.).
+
+dojo.string.Builder = function(/* string? */str){
+	//	summary
+	this.arrConcat = (dojo.render.html.capable && dojo.render.html["ie"]);
+
+	var a = [];
+	var b = "";
+	var length = this.length = b.length;
+
+	if(this.arrConcat){
+		if(b.length > 0){
+			a.push(b);
+		}
+		b = "";
+	}
+
+	this.toString = this.valueOf = function(){ 
+		//	summary
+		//	Concatenate internal buffer and return as a string
+		return (this.arrConcat) ? a.join("") : b;	//	string
+	};
+
+	this.append = function(){
+		//	summary
+		//	Append all arguments to the end of the internal buffer
+		for(var x=0; x<arguments.length; x++){
+			var s = arguments[x];
+			if(dojo.lang.isArrayLike(s)){
+				this.append.apply(this, s);
+			} else {
+				if(this.arrConcat){
+					a.push(s);
+				}else{
+					b+=s;
+				}
+				length += s.length;
+				this.length = length;
+			}
+		}
+		return this;	//	dojo.string.Builder
+	};
+
+	this.clear = function(){
+		//	summary
+		//	Clear the internal buffer.
+		a = [];
+		b = "";
+		length = this.length = 0;
+		return this;	//	dojo.string.Builder
+	};
+
+	this.remove = function(/* integer */f, /* integer */l){
+		//	summary
+		//	Remove a section of string from the internal buffer.
+		var s = ""; 
+		if(this.arrConcat){
+			b = a.join(""); 
+		}
+		a=[];
+		if(f>0){
+			s = b.substring(0, (f-1));
+		}
+		b = s + b.substring(f + l); 
+		length = this.length = b.length; 
+		if(this.arrConcat){
+			a.push(b);
+			b="";
+		}
+		return this;	//	dojo.string.Builder
+	};
+
+	this.replace = function(/* string */o, /* string */n){
+		//	summary
+		//	replace phrase *o* with phrase *n*.
+		if(this.arrConcat){
+			b = a.join(""); 
+		}
+		a = []; 
+		b = b.replace(o,n); 
+		length = this.length = b.length; 
+		if(this.arrConcat){
+			a.push(b);
+			b="";
+		}
+		return this;	//	dojo.string.Builder
+	};
+
+	this.insert = function(/* integer */idx, /* string */s){
+		//	summary
+		//	Insert string s at index idx.
+		if(this.arrConcat){
+			b = a.join(""); 
+		}
+		a=[];
+		if(idx == 0){
+			b = s + b;
+		}else{
+			var t = b.split("");
+			t.splice(idx,0,s);
+			b = t.join("")
+		}
+		length = this.length = b.length; 
+		if(this.arrConcat){
+			a.push(b); 
+			b="";
+		}
+		return this;	//	dojo.string.Builder
+	};
+
+	this.append.apply(this, arguments);
+};

Added: incubator/xap/trunk/codebase/src/dojo/src/string/__package__.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/string/__package__.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/string/__package__.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/string/__package__.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,19 @@
+/*
+	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.string",
+		"dojo.string.common",
+		"dojo.string.extras",
+		"dojo.string.Builder"
+	]
+});
+dojo.provide("dojo.string.*");

Added: incubator/xap/trunk/codebase/src/dojo/src/string/common.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/string/common.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/string/common.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/string/common.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,78 @@
+/*
+	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.string.common");
+
+dojo.string.trim = function(/* string */str, /* integer? */wh){
+	//	summary
+	//	Trim whitespace from str.  If wh > 0, trim from start, if wh < 0, trim from end, else both
+	if(!str.replace){ return str; }
+	if(!str.length){ return str; }
+	var re = (wh > 0) ? (/^\s+/) : (wh < 0) ? (/\s+$/) : (/^\s+|\s+$/g);
+	return str.replace(re, "");	//	string
+}
+
+dojo.string.trimStart = function(/* string */str) {
+	//	summary
+	//	Trim whitespace at the beginning of 'str'
+	return dojo.string.trim(str, 1);	//	string
+}
+
+dojo.string.trimEnd = function(/* string */str) {
+	//	summary
+	//	Trim whitespace at the end of 'str'
+	return dojo.string.trim(str, -1);
+}
+
+dojo.string.repeat = function(/* string */str, /* integer */count, /* string? */separator) {
+	//	summary
+	//	Return 'str' repeated 'count' times, optionally placing 'separator' between each rep
+	var out = "";
+	for(var i = 0; i < count; i++) {
+		out += str;
+		if(separator && i < count - 1) {
+			out += separator;
+		}
+	}
+	return out;	//	string
+}
+
+dojo.string.pad = function(/* string */str, /* integer */len/*=2*/, /* string */ c/*='0'*/, /* integer */dir/*=1*/) {
+	//	summary
+	//	Pad 'str' to guarantee that it is at least 'len' length with the character 'c' at either the 
+	//	start (dir=1) or end (dir=-1) of the string
+	var out = String(str);
+	if(!c) {
+		c = '0';
+	}
+	if(!dir) {
+		dir = 1;
+	}
+	while(out.length < len) {
+		if(dir > 0) {
+			out = c + out;
+		} else {
+			out += c;
+		}
+	}
+	return out;	//	string
+}
+
+dojo.string.padLeft = function(/* string */str, /* integer */len, /* string */c) {
+	//	summary
+	//	same as dojo.string.pad(str, len, c, 1)
+	return dojo.string.pad(str, len, c, 1);	//	string
+}
+
+dojo.string.padRight = function(/* string */str, /* integer */len, /* string */c) {
+	//	summary
+	//	same as dojo.string.pad(str, len, c, -1)
+	return dojo.string.pad(str, len, c, -1);	//	string
+}

Added: incubator/xap/trunk/codebase/src/dojo/src/string/extras.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/string/extras.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/string/extras.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/string/extras.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,261 @@
+/*
+	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.string.extras");
+
+dojo.require("dojo.string.common");
+dojo.require("dojo.lang.common");
+dojo.require("dojo.lang.array");
+
+//TODO: should we use ${} substitution syntax instead, like widgets do?
+dojo.string.substituteParams = function(/*string*/template, /* object - optional or ... */hash){
+// summary:
+//	Performs parameterized substitutions on a string. Throws an exception if any parameter is unmatched.
+//
+// description:
+//	For example,
+//		dojo.string.substituteParams("File '%{0}' is not found in directory '%{1}'.","foo.html","/temp");
+//	returns
+//		"File 'foo.html' is not found in directory '/temp'."
+//
+// template: the original string template with %{values} to be replaced
+// hash: name/value pairs (type object) to provide substitutions.  Alternatively, substitutions may be
+//	included as arguments 1..n to this function, corresponding to template parameters 0..n-1
+
+	var map = (typeof hash == 'object') ? hash : dojo.lang.toArray(arguments, 1);
+
+	return template.replace(/\%\{(\w+)\}/g, function(match, key){
+		if(typeof(map[key]) != "undefined" && map[key] != null){
+			return map[key];
+		}
+		dojo.raise("Substitution not found: " + key);
+	}); // string
+};
+
+dojo.string.capitalize = function(/*string*/str){
+// summary:
+//	Uppercases the first letter of each word
+
+	if(!dojo.lang.isString(str)){ return ""; }
+	if(arguments.length == 0){ str = this; }
+
+	var words = str.split(' ');
+	for(var i=0; i<words.length; i++){
+		words[i] = words[i].charAt(0).toUpperCase() + words[i].substring(1);
+	}
+	return words.join(" "); // string
+}
+
+dojo.string.isBlank = function(/*string*/str){
+// summary:
+//	Return true if the entire string is whitespace characters
+
+	if(!dojo.lang.isString(str)){ return true; }
+	return (dojo.string.trim(str).length == 0); // boolean
+}
+
+//FIXME: not sure exactly what encodeAscii is trying to do, or if it's working right
+dojo.string.encodeAscii = function(/*string*/str){
+	if(!dojo.lang.isString(str)){ return str; } // unknown
+	var ret = "";
+	var value = escape(str);
+	var match, re = /%u([0-9A-F]{4})/i;
+	while((match = value.match(re))){
+		var num = Number("0x"+match[1]);
+		var newVal = escape("&#" + num + ";");
+		ret += value.substring(0, match.index) + newVal;
+		value = value.substring(match.index+match[0].length);
+	}
+	ret += value.replace(/\+/g, "%2B");
+	return ret; // string
+}
+
+dojo.string.escape = function(/*string*/type, /*string*/str){
+// summary:
+//	Adds escape sequences for special characters according to the convention of 'type'
+//
+// type: one of xml|html|xhtml|sql|regexp|regex|javascript|jscript|js|ascii
+// str: the string to be escaped
+
+	var args = dojo.lang.toArray(arguments, 1);
+	switch(type.toLowerCase()){
+		case "xml":
+		case "html":
+		case "xhtml":
+			return dojo.string.escapeXml.apply(this, args); // string
+		case "sql":
+			return dojo.string.escapeSql.apply(this, args); // string
+		case "regexp":
+		case "regex":
+			return dojo.string.escapeRegExp.apply(this, args); // string
+		case "javascript":
+		case "jscript":
+		case "js":
+			return dojo.string.escapeJavaScript.apply(this, args); // string
+		case "ascii":
+			// so it's encode, but it seems useful
+			return dojo.string.encodeAscii.apply(this, args); // string
+		default:
+			return str; // string
+	}
+}
+
+dojo.string.escapeXml = function(/*string*/str, /*boolean*/noSingleQuotes){
+//summary:
+//	Adds escape sequences for special characters in XML: &<>"'
+//  Optionally skips escapes for single quotes
+
+	str = str.replace(/&/gm, "&amp;").replace(/</gm, "&lt;")
+		.replace(/>/gm, "&gt;").replace(/"/gm, "&quot;");
+	if(!noSingleQuotes){ str = str.replace(/'/gm, "&#39;"); }
+	return str; // string
+}
+
+dojo.string.escapeSql = function(/*string*/str){
+//summary:
+//	Adds escape sequences for single quotes in SQL expressions
+
+	return str.replace(/'/gm, "''"); //string
+}
+
+dojo.string.escapeRegExp = function(/*string*/str){
+//summary:
+//	Adds escape sequences for special characters in regular expressions
+
+	return str.replace(/\\/gm, "\\\\").replace(/([\f\b\n\t\r[\^$|?*+(){}])/gm, "\\$1"); // string
+}
+
+//FIXME: should this one also escape backslash?
+dojo.string.escapeJavaScript = function(/*string*/str){
+//summary:
+//	Adds escape sequences for single and double quotes as well
+//	as non-visible characters in JavaScript string literal expressions
+
+	return str.replace(/(["'\f\b\n\t\r])/gm, "\\$1"); // string
+}
+
+//FIXME: looks a lot like escapeJavaScript, just adds quotes? deprecate one?
+dojo.string.escapeString = function(/*string*/str){
+//summary:
+//	Adds escape sequences for non-visual characters, double quote and backslash
+//	and surrounds with double quotes to form a valid string literal.
+	return ('"' + str.replace(/(["\\])/g, '\\$1') + '"'
+		).replace(/[\f]/g, "\\f"
+		).replace(/[\b]/g, "\\b"
+		).replace(/[\n]/g, "\\n"
+		).replace(/[\t]/g, "\\t"
+		).replace(/[\r]/g, "\\r"); // string
+}
+
+// TODO: make an HTML version
+dojo.string.summary = function(/*string*/str, /*number*/len){
+// summary:
+//	Truncates 'str' after 'len' characters and appends periods as necessary so that it ends with "..."
+
+	if(!len || str.length <= len){
+		return str; // string
+	}
+
+	return str.substring(0, len).replace(/\.+$/, "") + "..."; // string
+}
+
+dojo.string.endsWith = function(/*string*/str, /*string*/end, /*boolean*/ignoreCase){
+// summary:
+//	Returns true if 'str' ends with 'end'
+
+	if(ignoreCase){
+		str = str.toLowerCase();
+		end = end.toLowerCase();
+	}
+	if((str.length - end.length) < 0){
+		return false; // boolean
+	}
+	return str.lastIndexOf(end) == str.length - end.length; // boolean
+}
+
+dojo.string.endsWithAny = function(/*string*/str /* , ... */){
+// summary:
+//	Returns true if 'str' ends with any of the arguments[2 -> n]
+
+	for(var i = 1; i < arguments.length; i++) {
+		if(dojo.string.endsWith(str, arguments[i])) {
+			return true; // boolean
+		}
+	}
+	return false; // boolean
+}
+
+dojo.string.startsWith = function(/*string*/str, /*string*/start, /*boolean*/ignoreCase){
+// summary:
+//	Returns true if 'str' starts with 'start'
+
+	if(ignoreCase) {
+		str = str.toLowerCase();
+		start = start.toLowerCase();
+	}
+	return str.indexOf(start) == 0; // boolean
+}
+
+dojo.string.startsWithAny = function(/*string*/str /* , ... */){
+// summary:
+//	Returns true if 'str' starts with any of the arguments[2 -> n]
+
+	for(var i = 1; i < arguments.length; i++) {
+		if(dojo.string.startsWith(str, arguments[i])) {
+			return true; // boolean
+		}
+	}
+	return false; // boolean
+}
+
+dojo.string.has = function(/*string*/str /* , ... */) {
+// summary:
+//	Returns true if 'str' contains any of the arguments 2 -> n
+
+	for(var i = 1; i < arguments.length; i++) {
+		if(str.indexOf(arguments[i]) > -1){
+			return true; // boolean
+		}
+	}
+	return false; // boolean
+}
+
+dojo.string.normalizeNewlines = function(/*string*/text, /*string? (\n or \r)*/newlineChar){
+// summary:
+//	Changes occurences of CR and LF in text to CRLF, or if newlineChar is provided as '\n' or '\r',
+//	substitutes newlineChar for occurrences of CR/LF and CRLF
+
+	if (newlineChar == "\n"){
+		text = text.replace(/\r\n/g, "\n");
+		text = text.replace(/\r/g, "\n");
+	} else if (newlineChar == "\r"){
+		text = text.replace(/\r\n/g, "\r");
+		text = text.replace(/\n/g, "\r");
+	}else{
+		text = text.replace(/([^\r])\n/g, "$1\r\n").replace(/\r([^\n])/g, "\r\n$1");
+	}
+	return text; // string
+}
+
+dojo.string.splitEscaped = function(/*string*/str, /*string of length=1*/charac){
+// summary:
+//	Splits 'str' into an array separated by 'charac', but skips characters escaped with a backslash
+
+	var components = [];
+	for (var i = 0, prevcomma = 0; i < str.length; i++){
+		if (str.charAt(i) == '\\'){ i++; continue; }
+		if (str.charAt(i) == charac){
+			components.push(str.substring(prevcomma, i));
+			prevcomma = i + 1;
+		}
+	}
+	components.push(str.substr(prevcomma));
+	return components; // array
+}

Added: incubator/xap/trunk/codebase/src/dojo/src/style.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/style.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/style.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/style.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,17 @@
+/*
+	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.style");
+dojo.require("dojo.lang.common");
+dojo.kwCompoundRequire({
+	browser: ["dojo.html.style"]
+});
+dojo.deprecated("dojo.style", "replaced by dojo.html.style", "0.5");
+dojo.lang.mixin(dojo.style, dojo.html);

Added: incubator/xap/trunk/codebase/src/dojo/src/svg.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/svg.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/svg.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/svg.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,320 @@
+/*
+	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.svg");
+dojo.require("dojo.lang.common");
+dojo.require("dojo.dom");
+
+dojo.mixin(dojo.svg, dojo.dom);
+
+dojo.svg.graphics=dojo.svg.g=new function(/* DOMDocument */ d){
+	//	summary
+	//	Singleton to encapsulate SVG rendering functions.
+	this.suspend=function(){
+		//	summary
+		//	Suspend the rendering engine
+		try { d.documentElement.suspendRedraw(0); } catch(e){ }
+	};
+	this.resume=function(){
+		//	summary
+		//	Resume the rendering engine
+		try { d.documentElement.unsuspendRedraw(0); } catch(e){ }
+	};
+	this.force=function(){
+		//	summary
+		//	Force the render engine to redraw
+		try { d.documentElement.forceRedraw(); } catch(e){ }
+	};
+}(document);
+
+dojo.svg.animations=dojo.svg.anim=new function(/* DOMDocument */ d){
+	//	summary
+	//	Singleton to encapsulate SVG animation functionality.
+	this.arePaused=function(){
+		//	summary
+		//	check to see if all animations are paused
+		try {
+			return d.documentElement.animationsPaused();	//	bool
+		} catch(e){
+			return false;	//	bool
+		}
+	} ;
+	this.pause=function(){
+		//	summary
+		//	pause all animations
+		try { d.documentElement.pauseAnimations(); } catch(e){ }
+	};
+	this.resume=function(){
+		//	summary
+		//	resume all animations
+		try { d.documentElement.unpauseAnimations(); } catch(e){ }
+	};
+}(document);
+
+//	fixme: these functions should be mixed in from dojo.style, but dojo.style is HTML-centric and needs to change.
+dojo.svg.toCamelCase=function(/* string */ selector){
+	//	summary
+	//	converts a CSS-style selector to a camelCased one
+	var arr=selector.split('-'), cc=arr[0];
+	for(var i=1; i < arr.length; i++) {
+		cc += arr[i].charAt(0).toUpperCase() + arr[i].substring(1);
+	}
+	return cc;	// string
+};
+dojo.svg.toSelectorCase=function(/* string */ selector) {
+	//	summary
+	//	converts a camelCased selector to a CSS style one
+	return selector.replace(/([A-Z])/g, "-$1" ).toLowerCase();	//	string
+};
+dojo.svg.getStyle=function(/* SVGElement */ node, /* string */ cssSelector){
+	//	summary
+	//	get the computed style of selector for node.
+	return document.defaultView.getComputedStyle(node, cssSelector);	//	object
+};
+dojo.svg.getNumericStyle=function(/* SVGElement */ node, /* string */ cssSelector){
+	//	summary
+	//	return the numeric version of the computed style of selector on node.
+	return parseFloat(dojo.svg.getStyle(node, cssSelector));
+};
+
+//	fixme: there are different ways of doing the following, need to take into account
+dojo.svg.getOpacity=function(/* SVGElement */node){
+	//	summary
+	//	Return the opacity of the passed element
+	return Math.min(1.0, dojo.svg.getNumericStyle(node, "fill-opacity"));	//	float
+};
+dojo.svg.setOpacity=function(/* SVGElement */ node, /* float */ opacity){
+	//	summary
+	//	set the opacity of node using attributes.
+	node.setAttributeNS(this.xmlns.svg, "fill-opacity", opacity);
+	node.setAttributeNS(this.xmlns.svg, "stroke-opacity", opacity);
+};
+dojo.svg.clearOpacity=function(/* SVGElement */ node){
+	//	summary
+	//	Set any attributes setting opacity to opaque (1.0)
+	node.setAttributeNS(this.xmlns.svg, "fill-opacity", "1.0");
+	node.setAttributeNS(this.xmlns.svg, "stroke-opacity", "1.0");
+};
+
+/**
+ *	Coordinates and dimensions.
+ */
+
+// TODO ////////////////////////////////////////////////////////// TODO
+dojo.svg.getCoords=function(/* SVGElement */ node){
+	//	summary
+	//	Returns the x/y coordinates of the passed node, if available.
+	if (node.getBBox) {
+		var box=node.getBBox();
+		return { x: box.x, y: box.y };	//	object
+	}
+	return null;	//	object
+};
+dojo.svg.setCoords=function(/* SVGElement */node, /* object */coords){
+	//	summary
+	//	Set the x/y coordinates of the passed node
+	var p=dojo.svg.getCoords();
+	if (!p) return;
+	var dx=p.x - coords.x;
+	var dy=p.y - coords.y;
+	dojo.svg.translate(node, dx, dy);
+};
+dojo.svg.getDimensions=function(/* SVGElement */node){
+	//	summary
+	//	Get the height and width of the passed node.
+	if (node.getBBox){
+		var box=node.getBBox();
+		return { width: box.width, height : box.height };	//	object
+	}
+	return null;	//	object
+};
+dojo.svg.setDimensions=function(/* SVGElement */node, /* object */dim){
+	//	summary
+	//	Set the dimensions of the passed element if possible.
+	//	will only support shape-based and container elements; path-based elements are ignored.
+	if (node.width){
+		node.width.baseVal.value=dim.width;
+		node.height.baseVal.value=dim.height;
+	}
+	else if (node.r){
+		node.r.baseVal.value=Math.min(dim.width, dim.height)/2;
+	}
+	else if (node.rx){
+		node.rx.baseVal.value=dim.width/2;
+		node.ry.baseVal.value=dim.height/2;
+	}
+};
+
+/**
+ *	Transformations.
+ */
+dojo.svg.translate=function(/* SVGElement */node, /* int */dx, /* int */dy){
+	//	summary
+	//	Translates the passed node by dx and dy
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		t.setTranslate(dx, dy);
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.scale=function(/* SVGElement */node, /* float */scaleX, /* float? */scaleY){
+	//	summary
+	//	Scales the passed element by factor scaleX and scaleY.  If scaleY not passed, scaleX is used.
+	if (!scaleY) var scaleY=scaleX;
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		t.setScale(scaleX, scaleY);
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.rotate=function(/* SVGElement */node, /* float */ang, /* int? */cx, /* int? */cy){
+	//	summary
+	//	rotate the passed node by ang, with optional cx/cy as the rotation point.
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		if (cx == null) t.setMatrix(t.matrix.rotate(ang));
+		else t.setRotate(ang, cx, cy);
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.skew=function(/* SVGElement */node, /* float */ang, /* string? */axis){
+	//	summary
+	//	skew the passed node by ang over axis.
+	var dir=axis || "x";
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		if (dir != "x") t.setSkewY(ang);
+		else t.setSkewX(ang);
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.flip=function(/* SVGElement */node, /* string? */axis){
+	//	summary
+	//	flip the passed element over axis
+	var dir=axis || "x";
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		t.setMatrix((dir != "x") ? t.matrix.flipY() : t.matrix.flipX());
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.invert=function(/* SVGElement */node){
+	//	summary
+	//	transform the passed node by the inverse of the current matrix
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var t=node.ownerSVGElement.createSVGTransform();
+		t.setMatrix(t.matrix.inverse());
+		node.transform.baseVal.appendItem(t);
+	}
+};
+dojo.svg.applyMatrix=function(
+	/* SVGElement */node, 
+	/* int || SVGMatrix */a, 
+	/* int? */b, 
+	/* int? */c, 
+	/* int? */d, 
+	/* int? */e, 
+	/* int? */f
+){
+	//	summary
+	//	apply the passed matrix to node.  If params b - f are passed, a matrix will be created.
+	if (node.transform && node.ownerSVGElement && node.ownerSVGElement.createSVGTransform){
+		var m;
+		if (b){
+			var m=node.ownerSVGElement.createSVGMatrix();
+			m.a=a;
+			m.b=b;
+			m.c=c;
+			m.d=d;
+			m.e=e;
+			m.f=f;
+		} else m=a;
+		var t=node.ownerSVGElement.createSVGTransform();
+		t.setMatrix(m);
+		node.transform.baseVal.appendItem(t);
+	}
+};
+
+/**
+ *	Grouping and z-index operations.
+ */
+dojo.svg.group=function(/* Nodelist || array */nodes){
+	//	summary
+	//	expect an array of nodes, attaches the group to the parent of the first node.
+	var p=nodes.item(0).parentNode;
+	var g=document.createElementNS(this.xmlns.svg, "g");
+	for (var i=0; i < nodes.length; i++) g.appendChild(nodes.item(i));
+	p.appendChild(g);
+	return g;
+};
+dojo.svg.ungroup=function(/* SVGGElement */g){
+	//	summary
+	//	puts the children of the group on the same level as group was.
+	var p=g.parentNode;
+	while (g.childNodes.length > 0) p.appendChild(g.childNodes.item(0));
+	p.removeChild(g);
+};
+//	if the node is part of a group, return the group, else return null.
+dojo.svg.getGroup=function(/* SVGElement */node){
+	//	summary
+	//	if the node is part of a group, return the group, else return null.
+	var a=this.getAncestors(node);
+	for (var i=0; i < a.length; i++){
+		if (a[i].nodeType == this.ELEMENT_NODE && a[i].nodeName.toLowerCase() == "g")
+			return a[i];
+	}
+	return null;
+};
+dojo.svg.bringToFront=function(/* SVGElement */node){
+	//	summary
+	//	move the passed node the to top of the group (i.e. last child)
+	var n=this.getGroup(node) || node;
+	n.ownerSVGElement.appendChild(n);
+};
+dojo.svg.sendToBack=function(/* SVGElement */node){
+	//	summary
+	//	move the passed node to the bottom of the group (i.e. first child)
+	var n=this.getGroup(node) || node;
+	n.ownerSVGElement.insertBefore(n, n.ownerSVGElement.firstChild);
+};
+
+//	TODO: possibly push node up a level in the DOM if it's at the beginning or end of the childNodes list.
+dojo.svg.bringForward=function(/* SVGElement */node){
+	//	summary
+	//	move the passed node up one in the child node chain
+	var n=this.getGroup(node) || node;
+	if (this.getLastChildElement(n.parentNode) != n){
+		this.insertAfter(n, this.getNextSiblingElement(n), true);
+	}
+};
+dojo.svg.sendBackward=function(/* SVGElement */node){
+	//	summary
+	//	move the passed node down one in the child node chain
+	var n=this.getGroup(node) || node;
+	if (this.getFirstChildElement(n.parentNode) != n){
+		this.insertBefore(n, this.getPreviousSiblingElement(n), true);
+	}
+};
+// END TODO ////////////////////////////////////////////////////// TODO
+
+dojo.svg.createNodesFromText=function(/* string */ txt, /* bool? */ wrap){
+	//	summary
+	//	Create a list of nodes from text
+	var docFrag=(new DOMParser()).parseFromString(txt, "text/xml").normalize();
+	if(wrap){ 
+		return [docFrag.firstChild.cloneNode(true)];	//	array
+	}
+	var nodes=[];
+	for(var x=0; x<docFrag.childNodes.length; x++){
+		nodes.push(docFrag.childNodes.item(x).cloneNode(true));
+	}
+	return nodes;	// array
+}
+// vim:ts=4:noet:tw=0:

Added: incubator/xap/trunk/codebase/src/dojo/src/text/__package__.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/text/__package__.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/text/__package__.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/text/__package__.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,18 @@
+/*
+	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.text.String",
+		"dojo.text.Builder"
+	]
+});
+
+dojo.deprecated("dojo.text", "textDirectory moved to cal, text.String and text.Builder havne't been here for awhile", "0.5");

Added: incubator/xap/trunk/codebase/src/dojo/src/text/textDirectory.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/text/textDirectory.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/text/textDirectory.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/text/textDirectory.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,12 @@
+/*
+	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.require("dojo.cal.textDirectory");
+dojo.deprecate("dojo.text.textDirectory", "use dojo.cal.textDirectory", "0.5");

Added: incubator/xap/trunk/codebase/src/dojo/src/undo/Manager.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/undo/Manager.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/undo/Manager.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/undo/Manager.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,254 @@
+/*
+	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.undo.Manager");
+dojo.require("dojo.lang.common");
+
+dojo.undo.Manager = function(/*dojo.undo.Manager Object */parent) {
+	//summary: Constructor for a dojo.undo.Manager object.
+	this.clear();
+	this._parent = parent;
+};
+dojo.extend(dojo.undo.Manager, {
+	_parent: null,
+	_undoStack: null,
+	_redoStack: null,
+	_currentManager: null,
+
+	canUndo: false,
+	canRedo: false,
+
+	isUndoing: false,
+	isRedoing: false,
+
+	onUndo: function(/*Object*/manager, /*Object*/item) {
+		//summary: An event that fires when undo is called.
+		//It allows you to hook in and update your code (UI?) as necessary.
+
+		//manager: Object: the dojo.undo.Manager instance.
+		//item: Object: The object stored by the undo stack. It has the following properties:
+		//		undo: Function: the undo function for this item in the stack.
+		//		redo: Function: the redo function for this item in the stack. May be null.
+		//		description: String: description of this item. May be null.
+	},
+	onRedo: function(/*Object*/manager, /*Object*/item) {
+		//summary: An event that fires when redo is called.
+		//It allows you to hook in and update your code (UI?) as necessary.
+
+		//manager: Object: the dojo.undo.Manager instance.
+		//item: Object: The object stored by the redo stack. It has the following properties:
+		//		undo: Function: the undo function for this item in the stack.
+		//		redo: Function: the redo function for this item in the stack. May be null.
+		//		description: String: description of this item. May be null.
+	},
+
+	onUndoAny: function(/*Object*/manager, /*Object*/item) {
+		//summary: An event that fires when *any* undo action is done, 
+		//which means you'll have one for every item
+		//in a transaction. This is usually only useful for debugging.
+		//See notes for onUndo for info on the function parameters.
+	},
+	
+	onRedoAny: function(/*Object*/manager, /*Object*/item) {
+		//summary: An event that fires when *any* redo action is done, 
+		//which means you'll have one for every item
+		//in a transaction. This is usually only useful for debugging.
+		//See notes for onRedo for info on the function parameters.
+	},
+
+	_updateStatus: function() {
+		//summary: Private method used to set some internal state.
+		this.canUndo = this._undoStack.length > 0;
+		this.canRedo = this._redoStack.length > 0;
+	},
+
+	clear: function() {
+		//summary: Clears this instance of dojo.undo.Manager.
+		this._undoStack = [];
+		this._redoStack = [];
+		this._currentManager = this;
+
+		this.isUndoing = false;
+		this.isRedoing = false;
+
+		this._updateStatus();
+	},
+
+	undo: function() {
+		//summary: Call this method to go one place back in the undo
+		//stack. Returns true if the manager successfully completed
+		//the undo step.
+		if(!this.canUndo) { return false; /*boolean*/}
+
+		this.endAllTransactions();
+
+		this.isUndoing = true;
+		var top = this._undoStack.pop();
+		if(top instanceof dojo.undo.Manager){
+			top.undoAll();
+		}else{
+			top.undo();
+		}
+		if(top.redo){
+			this._redoStack.push(top);
+		}
+		this.isUndoing = false;
+
+		this._updateStatus();
+		this.onUndo(this, top);
+		if(!(top instanceof dojo.undo.Manager)) {
+			this.getTop().onUndoAny(this, top);
+		}
+		return true; //boolean
+	},
+
+	redo: function() {
+		//summary: Call this method to go one place forward in the redo
+		//stack. Returns true if the manager successfully completed
+		//the redo step.
+		if(!this.canRedo){ return false; /*boolean*/}
+
+		this.isRedoing = true;
+		var top = this._redoStack.pop();
+		if(top instanceof dojo.undo.Manager) {
+			top.redoAll();
+		}else{
+			top.redo();
+		}
+		this._undoStack.push(top);
+		this.isRedoing = false;
+
+		this._updateStatus();
+		this.onRedo(this, top);
+		if(!(top instanceof dojo.undo.Manager)){
+			this.getTop().onRedoAny(this, top);
+		}
+		return true; //boolean
+	},
+
+	undoAll: function() {
+		//summary: Call undo as many times as it takes to get all the
+		//way through the undo stack.
+		while(this._undoStack.length > 0) {
+			this.undo();
+		}
+	},
+
+	redoAll: function() {
+		//summary: Call redo as many times as it takes to get all the
+		//way through the redo stack.
+		while(this._redoStack.length > 0) {
+			this.redo();
+		}
+	},
+
+	push: function(/*Function*/undo, /*Function?*/redo, /*String?*/description) {
+		//summary: add something to the undo manager.
+		if(!undo) { return; }
+
+		if(this._currentManager == this) {
+			this._undoStack.push({
+				undo: undo,
+				redo: redo,
+				description: description
+			});
+		} else {
+			this._currentManager.push.apply(this._currentManager, arguments);
+		}
+		// adding a new undo-able item clears out the redo stack
+		this._redoStack = [];
+		this._updateStatus();
+	},
+
+	concat: function(/*Object*/manager) {
+		//summary: Adds all undo and redo stack items to another dojo.undo.Manager
+		//instance.
+		if ( !manager ) { return; }
+
+		if (this._currentManager == this ) {
+			for(var x=0; x < manager._undoStack.length; x++) {
+				this._undoStack.push(manager._undoStack[x]);
+			}
+			// adding a new undo-able item clears out the redo stack
+			if (manager._undoStack.length > 0) {
+				this._redoStack = [];
+			}
+			this._updateStatus();
+		} else {
+			this._currentManager.concat.apply(this._currentManager, arguments);
+		}
+	},
+
+	beginTransaction: function(/*String?*/description) {
+		//summary: All undo/redo items added via
+		//push() after this call is made but before endTransaction() is called are
+		//treated as one item in the undo and redo stacks. When undo() or redo() is
+		//called then undo/redo is called on all of the items in the transaction.
+		//Transactions can be nested.
+		if(this._currentManager == this) {
+			var mgr = new dojo.undo.Manager(this);
+			mgr.description = description ? description : "";
+			this._undoStack.push(mgr);
+			this._currentManager = mgr;
+			return mgr;
+		} else {
+			//for nested transactions need to make sure the top level _currentManager is set
+			this._currentManager = this._currentManager.beginTransaction.apply(this._currentManager, arguments);
+		}
+	},
+
+	endTransaction: function(flatten /* optional */) {
+		//summary: Ends a transaction started by beginTransaction(). See beginTransaction()
+		//for details.
+		
+		//flatten: boolean: If true, adds the current transaction to the parent's
+		//undo stack.
+	
+		if(this._currentManager == this) {
+			if(this._parent) {
+				this._parent._currentManager = this._parent;
+				// don't leave empty transactions hangin' around
+				if(this._undoStack.length == 0 || flatten) {
+					var idx = dojo.lang.find(this._parent._undoStack, this);
+					if (idx >= 0) {
+						this._parent._undoStack.splice(idx, 1);
+						//add the current transaction to parents undo stack
+						if (flatten) {
+							for(var x=0; x < this._undoStack.length; x++){
+								this._parent._undoStack.splice(idx++, 0, this._undoStack[x]);
+							}
+							this._updateStatus();
+						}
+					}
+				}
+				return this._parent;
+			}
+		} else {
+			//for nested transactions need to make sure the top level _currentManager is set
+			this._currentManager = this._currentManager.endTransaction.apply(this._currentManager, arguments);
+		}
+	},
+
+	endAllTransactions: function() {
+		//summary: Ends all nested transactions.
+		while(this._currentManager != this) {
+			this.endTransaction();
+		}
+	},
+
+	getTop: function() {
+		//summary: Finds the top parent of an undo manager.
+		if(this._parent) {
+			return this._parent.getTop();
+		} else {
+			return this;
+		}
+	}
+});

Added: incubator/xap/trunk/codebase/src/dojo/src/undo/__package__.js
URL: http://svn.apache.org/viewvc/incubator/xap/trunk/codebase/src/dojo/src/undo/__package__.js?view=auto&rev=518313
==============================================================================
--- incubator/xap/trunk/codebase/src/dojo/src/undo/__package__.js (added)
+++ incubator/xap/trunk/codebase/src/dojo/src/undo/__package__.js Wed Mar 14 13:36:44 2007
@@ -0,0 +1,12 @@
+/*
+	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.require("dojo.undo.Manager");
+dojo.provide("dojo.undo.*");