Subversion Repositories Applications.papyrus

Rev

Rev 1318 | Blame | Compare with Previous | Last modification | View Log | RSS feed

/*
        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
*/

if(typeof dojo == "undefined"){

// TODOC: HOW TO DOC THE BELOW?
// @global: djConfig
// summary:
//              Application code can set the global 'djConfig' prior to loading
//              the library to override certain global settings for how dojo works.
// description:  The variables that can be set are as follows:
//                      - isDebug: false
//                      - allowQueryConfig: false
//                      - baseScriptUri: ""
//                      - baseRelativePath: ""
//                      - libraryScriptUri: ""
//                      - iePreventClobber: false
//                      - ieClobberMinimal: true
//                      - locale: undefined
//                      - extraLocale: undefined
//                      - preventBackButtonFix: true
//                      - searchIds: []
//                      - parseWidgets: true
// TODOC: HOW TO DOC THESE VARIABLES?
// TODOC: IS THIS A COMPLETE LIST?
// note:
//              'djConfig' does not exist under 'dojo.*' so that it can be set before the
//              'dojo' variable exists.
// note:
//              Setting any of these variables *after* the library has loaded does nothing at all.
// TODOC: is this still true?  Release notes for 0.3 indicated they could be set after load.
//


//TODOC:  HOW TO DOC THIS?
// @global: dj_global
// summary:
//              an alias for the top-level global object in the host environment
//              (e.g., the window object in a browser).
// description:
//              Refer to 'dj_global' rather than referring to window to ensure your
//              code runs correctly in contexts other than web browsers (eg: Rhino on a server).
var dj_global = this;

//TODOC:  HOW TO DOC THIS?
// @global: dj_currentContext
// summary:
//              Private global context object. Where 'dj_global' always refers to the boot-time
//    global context, 'dj_currentContext' can be modified for temporary context shifting.
//    dojo.global() returns dj_currentContext.
// description:
//              Refer to dojo.global() rather than referring to dj_global to ensure your
//              code runs correctly in managed contexts.
var dj_currentContext = this;


// ****************************************************************
// global public utils
// TODOC: DO WE WANT TO NOTE THAT THESE ARE GLOBAL PUBLIC UTILS?
// ****************************************************************

function dj_undef(/*String*/ name, /*Object?*/ object){
        //summary: Returns true if 'name' is defined on 'object' (or globally if 'object' is null).
        //description: Note that 'defined' and 'exists' are not the same concept.
        return (typeof (object || dj_currentContext)[name] == "undefined");     // Boolean
}

// make sure djConfig is defined
if(dj_undef("djConfig", this)){
        var djConfig = {};
}

//TODOC:  HOW TO DOC THIS?
// dojo is the root variable of (almost all) our public symbols -- make sure it is defined.
if(dj_undef("dojo", this)){
        var dojo = {};
}

dojo.global = function(){
        // summary:
        //              return the current global context object
        //              (e.g., the window object in a browser).
        // description:
        //              Refer to 'dojo.global()' rather than referring to window to ensure your
        //              code runs correctly in contexts other than web browsers (eg: Rhino on a server).
        return dj_currentContext;
}

// Override locale setting, if specified
dojo.locale  = djConfig.locale;

//TODOC:  HOW TO DOC THIS?
dojo.version = {
        // summary: version number of this instance of dojo.
        major: 0, minor: 4, patch: 3, flag: "",
        revision: Number("$Rev: 8617 $".match(/[0-9]+/)[0]),
        toString: function(){
                with(dojo.version){
                        return major + "." + minor + "." + patch + flag + " (" + revision + ")";        // String
                }
        }
}

dojo.evalProp = function(/*String*/ name, /*Object*/ object, /*Boolean?*/ create){
        // summary: Returns 'object[name]'.  If not defined and 'create' is true, will return a new Object.
        // description:
        //              Returns null if 'object[name]' is not defined and 'create' is not true.
        //              Note: 'defined' and 'exists' are not the same concept.
        if((!object)||(!name)) return undefined; // undefined
        if(!dj_undef(name, object)) return object[name]; // mixed
        return (create ? (object[name]={}) : undefined);        // mixed
}

dojo.parseObjPath = function(/*String*/ path, /*Object?*/ context, /*Boolean?*/ create){
        // summary: Parse string path to an object, and return corresponding object reference and property name.
        // description:
        //              Returns an object with two properties, 'obj' and 'prop'.
        //              'obj[prop]' is the reference indicated by 'path'.
        // path: Path to an object, in the form "A.B.C".
        // context: Object to use as root of path.  Defaults to 'dojo.global()'.
        // create: If true, Objects will be created at any point along the 'path' that is undefined.
        var object = (context || dojo.global());
        var names = path.split('.');
        var prop = names.pop();
        for (var i=0,l=names.length;i<l && object;i++){
                object = dojo.evalProp(names[i], object, create);
        }
        return {obj: object, prop: prop};       // Object: {obj: Object, prop: String}
}

dojo.evalObjPath = function(/*String*/ path, /*Boolean?*/ create){
        // summary: Return the value of object at 'path' in the global scope, without using 'eval()'.
        // path: Path to an object, in the form "A.B.C".
        // create: If true, Objects will be created at any point along the 'path' that is undefined.
        if(typeof path != "string"){
                return dojo.global();
        }
        // fast path for no periods
        if(path.indexOf('.') == -1){
                return dojo.evalProp(path, dojo.global(), create);              // mixed
        }

        //MOW: old 'with' syntax was confusing and would throw an error if parseObjPath returned null.
        var ref = dojo.parseObjPath(path, dojo.global(), create);
        if(ref){
                return dojo.evalProp(ref.prop, ref.obj, create);        // mixed
        }
        return null;
}

dojo.errorToString = function(/*Error*/ exception){
        // summary: Return an exception's 'message', 'description' or text.

        // TODO: overriding Error.prototype.toString won't accomplish this?
        //              ... since natively generated Error objects do not always reflect such things?
        if(!dj_undef("message", exception)){
                return exception.message;               // String
        }else if(!dj_undef("description", exception)){
                return exception.description;   // String
        }else{
                return exception;                               // Error
        }
}

dojo.raise = function(/*String*/ message, /*Error?*/ exception){
        // summary: Common point for raising exceptions in Dojo to enable logging.
        //      Throws an error message with text of 'exception' if provided, or
        //      rethrows exception object.

        if(exception){
                message = message + ": "+dojo.errorToString(exception);
        }else{
                message = dojo.errorToString(message);
        }

        // print the message to the user if hostenv.println is defined
        try { if(djConfig.isDebug){ dojo.hostenv.println("FATAL exception raised: "+message); } } catch (e) {}

        throw exception || Error(message);
}

//Stub functions so things don't break.
//TODOC:  HOW TO DOC THESE?
dojo.debug = function(){};
dojo.debugShallow = function(obj){};
dojo.profile = { start: function(){}, end: function(){}, stop: function(){}, dump: function(){} };

function dj_eval(/*String*/ scriptFragment){
        // summary: Perform an evaluation in the global scope.  Use this rather than calling 'eval()' directly.
        // description: Placed in a separate function to minimize size of trapped evaluation context.
        // note:
        //       - JSC eval() takes an optional second argument which can be 'unsafe'.
        //       - Mozilla/SpiderMonkey eval() takes an optional second argument which is the
        //       scope object for new symbols.
        return dj_global.eval ? dj_global.eval(scriptFragment) : eval(scriptFragment);  // mixed
}

dojo.unimplemented = function(/*String*/ funcname, /*String?*/ extra){
        // summary: Throw an exception because some function is not implemented.
        // extra: Text to append to the exception message.
        var message = "'" + funcname + "' not implemented";
        if (extra != null) { message += " " + extra; }
        dojo.raise(message);
}

dojo.deprecated = function(/*String*/ behaviour, /*String?*/ extra, /*String?*/ removal){
        // summary: Log a debug message to indicate that a behavior has been deprecated.
        // extra: Text to append to the message.
        // removal: Text to indicate when in the future the behavior will be removed.
        var message = "DEPRECATED: " + behaviour;
        if(extra){ message += " " + extra; }
        if(removal){ message += " -- will be removed in version: " + removal; }
        dojo.debug(message);
}

dojo.render = (function(){
        //TODOC: HOW TO DOC THIS?
        // summary: Details rendering support, OS and browser of the current environment.
        // TODOC: is this something many folks will interact with?  If so, we should doc the structure created...
        function vscaffold(prefs, names){
                var tmp = {
                        capable: false,
                        support: {
                                builtin: false,
                                plugin: false
                        },
                        prefixes: prefs
                };
                for(var i=0; i<names.length; i++){
                        tmp[names[i]] = false;
                }
                return tmp;
        }

        return {
                name: "",
                ver: dojo.version,
                os: { win: false, linux: false, osx: false },
                html: vscaffold(["html"], ["ie", "opera", "khtml", "safari", "moz"]),
                svg: vscaffold(["svg"], ["corel", "adobe", "batik"]),
                vml: vscaffold(["vml"], ["ie"]),
                swf: vscaffold(["Swf", "Flash", "Mm"], ["mm"]),
                swt: vscaffold(["Swt"], ["ibm"])
        };
})();

// ****************************************************************
// dojo.hostenv methods that must be defined in hostenv_*.js
// ****************************************************************

/**
 * The interface definining the interaction with the EcmaScript host environment.
*/

/*
 * None of these methods should ever be called directly by library users.
 * Instead public methods such as loadModule should be called instead.
 */
dojo.hostenv = (function(){
        // TODOC:  HOW TO DOC THIS?
        // summary: Provides encapsulation of behavior that changes across different 'host environments'
        //                      (different browsers, server via Rhino, etc).
        // description: None of these methods should ever be called directly by library users.
        //                              Use public methods such as 'loadModule' instead.

        // default configuration options
        var config = {
                isDebug: false,
                allowQueryConfig: false,
                baseScriptUri: "",
                baseRelativePath: "",
                libraryScriptUri: "",
                iePreventClobber: false,
                ieClobberMinimal: true,
                preventBackButtonFix: true,
                delayMozLoadingFix: false,
                searchIds: [],
                parseWidgets: true
        };

        if (typeof djConfig == "undefined") { djConfig = config; }
        else {
                for (var option in config) {
                        if (typeof djConfig[option] == "undefined") {
                                djConfig[option] = config[option];
                        }
                }
        }

        return {
                name_: '(unset)',
                version_: '(unset)',


                getName: function(){
                        // sumary: Return the name of the host environment.
                        return this.name_;      // String
                },


                getVersion: function(){
                        // summary: Return the version of the hostenv.
                        return this.version_; // String
                },

                getText: function(/*String*/ uri){
                        // summary:     Read the plain/text contents at the specified 'uri'.
                        // description:
                        //                      If 'getText()' is not implemented, then it is necessary to override
                        //                      'loadUri()' with an implementation that doesn't rely on it.

                        dojo.unimplemented('getText', "uri=" + uri);
                }
        };
})();


dojo.hostenv.getBaseScriptUri = function(){
        // summary: Return the base script uri that other scripts are found relative to.
        // TODOC: HUH?  This comment means nothing to me.  What other scripts? Is this the path to other dojo libraries?
        //              MAYBE:  Return the base uri to scripts in the dojo library.      ???
        // return: Empty string or a path ending in '/'.
        if(djConfig.baseScriptUri.length){
                return djConfig.baseScriptUri;
        }

        // MOW: Why not:
        //                      uri = djConfig.libraryScriptUri || djConfig.baseRelativePath
        //              ??? Why 'new String(...)'
        var uri = new String(djConfig.libraryScriptUri||djConfig.baseRelativePath);
        if (!uri) { dojo.raise("Nothing returned by getLibraryScriptUri(): " + uri); }

        // MOW: uri seems to not be actually used.  Seems to be hard-coding to djConfig.baseRelativePath... ???
        var lastslash = uri.lastIndexOf('/');           // MOW ???
        djConfig.baseScriptUri = djConfig.baseRelativePath;
        return djConfig.baseScriptUri;  // String
}

/*
 * loader.js - A bootstrap module.  Runs before the hostenv_*.js file. Contains all of the package loading methods.
 */

//A semi-colon is at the start of the line because after doing a build, this function definition
//get compressed onto the same line as the last line in bootstrap1.js. That list line is just a
//curly bracket, and the browser complains about that syntax. The semicolon fixes it. Putting it
//here instead of at the end of bootstrap1.js, since it is more of an issue for this file, (using
//the closure), and bootstrap1.js could change in the future.
;(function(){
        //Additional properties for dojo.hostenv
        var _addHostEnv = {
                pkgFileName: "__package__",
        
                // for recursion protection
                loading_modules_: {},
                loaded_modules_: {},
                addedToLoadingCount: [],
                removedFromLoadingCount: [],
        
                inFlightCount: 0,
        
                // FIXME: it should be possible to pull module prefixes in from djConfig
                modulePrefixes_: {
                        dojo: {name: "dojo", value: "src"}
                },

                setModulePrefix: function(/*String*/module, /*String*/prefix){
                        // summary: establishes module/prefix pair
                        this.modulePrefixes_[module] = {name: module, value: prefix};
                },

                moduleHasPrefix: function(/*String*/module){
                        // summary: checks to see if module has been established
                        var mp = this.modulePrefixes_;
                        return Boolean(mp[module] && mp[module].value); // Boolean
                },

                getModulePrefix: function(/*String*/module){
                        // summary: gets the prefix associated with module
                        if(this.moduleHasPrefix(module)){
                                return this.modulePrefixes_[module].value; // String
                        }
                        return module; // String
                },

                getTextStack: [],
                loadUriStack: [],
                loadedUris: [],
        
                //WARNING: This variable is referenced by packages outside of bootstrap: FloatingPane.js and undo/browser.js
                post_load_: false,
                
                //Egad! Lots of test files push on this directly instead of using dojo.addOnLoad.
                modulesLoadedListeners: [],
                unloadListeners: [],
                loadNotifying: false
        };
        
        //Add all of these properties to dojo.hostenv
        for(var param in _addHostEnv){
                dojo.hostenv[param] = _addHostEnv[param];
        }
})();

dojo.hostenv.loadPath = function(/*String*/relpath, /*String?*/module, /*Function?*/cb){
// summary:
//      Load a Javascript module given a relative path
//
// description:
//      Loads and interprets the script located at relpath, which is relative to the
//      script root directory.  If the script is found but its interpretation causes
//      a runtime exception, that exception is not caught by us, so the caller will
//      see it.  We return a true value if and only if the script is found.
//
//      For now, we do not have an implementation of a true search path.  We
//      consider only the single base script uri, as returned by getBaseScriptUri().
//
// relpath: A relative path to a script (no leading '/', and typically
//      ending in '.js').
// module: A module whose existance to check for after loading a path.
//      Can be used to determine success or failure of the load.
// cb: a callback function to pass the result of evaluating the script

        var uri;
        if(relpath.charAt(0) == '/' || relpath.match(/^\w+:/)){
                // dojo.raise("relpath '" + relpath + "'; must be relative");
                uri = relpath;
        }else{
                uri = this.getBaseScriptUri() + relpath;
        }
        if(djConfig.cacheBust && dojo.render.html.capable){
                uri += "?" + String(djConfig.cacheBust).replace(/\W+/g,"");
        }
        try{
                return !module ? this.loadUri(uri, cb) : this.loadUriAndCheck(uri, module, cb); // Boolean
        }catch(e){
                dojo.debug(e);
                return false; // Boolean
        }
}

dojo.hostenv.loadUri = function(/*String (URL)*/uri, /*Function?*/cb){
// summary:
//      Loads JavaScript from a URI
//
// description:
//      Reads the contents of the URI, and evaluates the contents.  This is used to load modules as well
//      as resource bundles.  Returns true if it succeeded. Returns false if the URI reading failed.
//      Throws if the evaluation throws.
//
// uri: a uri which points at the script to be loaded
// cb: a callback function to process the result of evaluating the script as an expression, typically
//      used by the resource bundle loader to load JSON-style resources

        if(this.loadedUris[uri]){
                return true; // Boolean
        }
        var contents = this.getText(uri, null, true);
        if(!contents){ return false; } // Boolean
        this.loadedUris[uri] = true;
        if(cb){ contents = '('+contents+')'; }
        var value = dj_eval(contents);
        if(cb){ cb(value); }
        return true; // Boolean
}

// FIXME: probably need to add logging to this method
dojo.hostenv.loadUriAndCheck = function(/*String (URL)*/uri, /*String*/moduleName, /*Function?*/cb){
        // summary: calls loadUri then findModule and returns true if both succeed
        var ok = true;
        try{
                ok = this.loadUri(uri, cb);
        }catch(e){
                dojo.debug("failed loading ", uri, " with error: ", e);
        }
        return Boolean(ok && this.findModule(moduleName, false)); // Boolean
}

dojo.loaded = function(){ }
dojo.unloaded = function(){ }

dojo.hostenv.loaded = function(){
        this.loadNotifying = true;
        this.post_load_ = true;
        var mll = this.modulesLoadedListeners;
        for(var x=0; x<mll.length; x++){
                mll[x]();
        }

        //Clear listeners so new ones can be added
        //For other xdomain package loads after the initial load.
        this.modulesLoadedListeners = [];
        this.loadNotifying = false;

        dojo.loaded();
}

dojo.hostenv.unloaded = function(){
        var mll = this.unloadListeners;
        while(mll.length){
                (mll.pop())();
        }
        dojo.unloaded();
}

dojo.addOnLoad = function(/*Object?*/obj, /*String|Function*/functionName) {
// summary:
//      Registers a function to be triggered after the DOM has finished loading 
//      and widgets declared in markup have been instantiated.  Images and CSS files
//      may or may not have finished downloading when the specified function is called.
//      (Note that widgets' CSS and HTML code is guaranteed to be downloaded before said
//      widgets are instantiated.)
//
// usage:
//      dojo.addOnLoad(functionPointer)
//      dojo.addOnLoad(object, "functionName")

        var dh = dojo.hostenv;
        if(arguments.length == 1) {
                dh.modulesLoadedListeners.push(obj);
        } else if(arguments.length > 1) {
                dh.modulesLoadedListeners.push(function() {
                        obj[functionName]();
                });
        }

        //Added for xdomain loading. dojo.addOnLoad is used to
        //indicate callbacks after doing some dojo.require() statements.
        //In the xdomain case, if all the requires are loaded (after initial
        //page load), then immediately call any listeners.
        if(dh.post_load_ && dh.inFlightCount == 0 && !dh.loadNotifying){
                dh.callLoaded();
        }
}

dojo.addOnUnload = function(/*Object?*/obj, /*String|Function?*/functionName){
// summary: registers a function to be triggered when the page unloads
//
// usage:
//      dojo.addOnLoad(functionPointer)
//      dojo.addOnLoad(object, "functionName")
        var dh = dojo.hostenv;
        if(arguments.length == 1){
                dh.unloadListeners.push(obj);
        } else if(arguments.length > 1) {
                dh.unloadListeners.push(function() {
                        obj[functionName]();
                });
        }
}

dojo.hostenv.modulesLoaded = function(){
        if(this.post_load_){ return; }
        if(this.loadUriStack.length==0 && this.getTextStack.length==0){
                if(this.inFlightCount > 0){ 
                        dojo.debug("files still in flight!");
                        return;
                }
                dojo.hostenv.callLoaded();
        }
}

dojo.hostenv.callLoaded = function(){
        //The "object" check is for IE, and the other opera check fixes an issue
        //in Opera where it could not find the body element in some widget test cases.
        //For 0.9, maybe route all browsers through the setTimeout (need protection
        //still for non-browser environments though). This might also help the issue with
        //FF 2.0 and freezing issues where we try to do sync xhr while background css images
        //are being loaded (trac #2572)? Consider for 0.9.
        if(typeof setTimeout == "object" || (djConfig["useXDomain"] && dojo.render.html.opera)){
                setTimeout("dojo.hostenv.loaded();", 0);
        }else{
                dojo.hostenv.loaded();
        }
}

dojo.hostenv.getModuleSymbols = function(/*String*/modulename){
// summary:
//      Converts a module name in dotted JS notation to an array representing the path in the source tree
        var syms = modulename.split(".");
        for(var i = syms.length; i>0; i--){
                var parentModule = syms.slice(0, i).join(".");
                if((i==1) && !this.moduleHasPrefix(parentModule)){              
                        // Support default module directory (sibling of dojo) for top-level modules 
                        syms[0] = "../" + syms[0];
                }else{
                        var parentModulePath = this.getModulePrefix(parentModule);
                        if(parentModulePath != parentModule){
                                syms.splice(0, i, parentModulePath);
                                break;
                        }
                }
        }
        return syms; // Array
}

dojo.hostenv._global_omit_module_check = false;
dojo.hostenv.loadModule = function(/*String*/moduleName, /*Boolean?*/exactOnly, /*Boolean?*/omitModuleCheck){
// summary:
//      loads a Javascript module from the appropriate URI
//
// description:
//      loadModule("A.B") first checks to see if symbol A.B is defined. 
//      If it is, it is simply returned (nothing to do).
//      
//      If it is not defined, it will look for "A/B.js" in the script root directory,
//      followed by "A.js".
//      
//      It throws if it cannot find a file to load, or if the symbol A.B is not
//      defined after loading.
//      
//      It returns the object A.B.
//      
//      This does nothing about importing symbols into the current package.
//      It is presumed that the caller will take care of that. For example, to import
//      all symbols:
//      
//         with (dojo.hostenv.loadModule("A.B")) {
//            ...
//         }
//      
//      And to import just the leaf symbol:
//      
//         var B = dojo.hostenv.loadModule("A.B");
//         ...
//      
//      dj_load is an alias for dojo.hostenv.loadModule

        if(!moduleName){ return; }
        omitModuleCheck = this._global_omit_module_check || omitModuleCheck;
        var module = this.findModule(moduleName, false);
        if(module){
                return module;
        }

        // protect against infinite recursion from mutual dependencies
        if(dj_undef(moduleName, this.loading_modules_)){
                this.addedToLoadingCount.push(moduleName);
        }
        this.loading_modules_[moduleName] = 1;

        // convert periods to slashes
        var relpath = moduleName.replace(/\./g, '/') + '.js';

        var nsyms = moduleName.split(".");
        
        // this line allowed loading of a module manifest as if it were a namespace
        // it's an interesting idea, but shouldn't be combined with 'namespaces' proper
        // and leads to unwanted dependencies
        // the effect can be achieved in other (albeit less-flexible) ways now, so I am
        // removing this pending further design work
        // perhaps we can explicitly define this idea of a 'module manifest', and subclass
        // 'namespace manifest' from that
        //dojo.getNamespace(nsyms[0]);

        var syms = this.getModuleSymbols(moduleName);
        var startedRelative = ((syms[0].charAt(0) != '/') && !syms[0].match(/^\w+:/));
        var last = syms[syms.length - 1];
        var ok;
        // figure out if we're looking for a full package, if so, we want to do
        // things slightly diffrently
        if(last=="*"){
                moduleName = nsyms.slice(0, -1).join('.');
                while(syms.length){
                        syms.pop();
                        syms.push(this.pkgFileName);
                        relpath = syms.join("/") + '.js';
                        if(startedRelative && relpath.charAt(0)=="/"){
                                relpath = relpath.slice(1);
                        }
                        ok = this.loadPath(relpath, !omitModuleCheck ? moduleName : null);
                        if(ok){ break; }
                        syms.pop();
                }
        }else{
                relpath = syms.join("/") + '.js';
                moduleName = nsyms.join('.');
                var modArg = !omitModuleCheck ? moduleName : null;
                ok = this.loadPath(relpath, modArg);
                if(!ok && !exactOnly){
                        syms.pop();
                        while(syms.length){
                                relpath = syms.join('/') + '.js';
                                ok = this.loadPath(relpath, modArg);
                                if(ok){ break; }
                                syms.pop();
                                relpath = syms.join('/') + '/'+this.pkgFileName+'.js';
                                if(startedRelative && relpath.charAt(0)=="/"){
                                        relpath = relpath.slice(1);
                                }
                                ok = this.loadPath(relpath, modArg);
                                if(ok){ break; }
                        }
                }

                if(!ok && !omitModuleCheck){
                        dojo.raise("Could not load '" + moduleName + "'; last tried '" + relpath + "'");
                }
        }

        // check that the symbol was defined
        //Don't bother if we're doing xdomain (asynchronous) loading.
        if(!omitModuleCheck && !this["isXDomain"]){
                // pass in false so we can give better error
                module = this.findModule(moduleName, false);
                if(!module){
                        dojo.raise("symbol '" + moduleName + "' is not defined after loading '" + relpath + "'"); 
                }
        }

        return module;
}

dojo.hostenv.startPackage = function(/*String*/packageName){
// summary:
//      Creates a JavaScript package
//
// description:
//      startPackage("A.B") follows the path, and at each level creates a new empty
//      object or uses what already exists. It returns the result.
//
// packageName: the package to be created as a String in dot notation

        //Make sure we have a string.
        var fullPkgName = String(packageName);
        var strippedPkgName = fullPkgName;

        var syms = packageName.split(/\./);
        if(syms[syms.length-1]=="*"){
                syms.pop();
                strippedPkgName = syms.join(".");
        }
        var evaledPkg = dojo.evalObjPath(strippedPkgName, true);
        this.loaded_modules_[fullPkgName] = evaledPkg;
        this.loaded_modules_[strippedPkgName] = evaledPkg;
        
        return evaledPkg; // Object
}

dojo.hostenv.findModule = function(/*String*/moduleName, /*Boolean?*/mustExist){
// summary:
//      Returns the Object representing the module, if it exists, otherwise null.
//
// moduleName A fully qualified module including package name, like 'A.B'.
// mustExist Optional, default false. throw instead of returning null
//      if the module does not currently exist.

        var lmn = String(moduleName);

        if(this.loaded_modules_[lmn]){
                return this.loaded_modules_[lmn]; // Object
        }

        if(mustExist){
                dojo.raise("no loaded module named '" + moduleName + "'");
        }
        return null; // null
}

//Start of old bootstrap2:

dojo.kwCompoundRequire = function(/*Object containing Arrays*/modMap){
// description:
//      This method taks a "map" of arrays which one can use to optionally load dojo
//      modules. The map is indexed by the possible dojo.hostenv.name_ values, with
//      two additional values: "default" and "common". The items in the "default"
//      array will be loaded if none of the other items have been choosen based on
//      the hostenv.name_ item. The items in the "common" array will _always_ be
//      loaded, regardless of which list is chosen.  Here's how it's normally
//      called:
//      
//      dojo.kwCompoundRequire({
//              browser: [
//                      ["foo.bar.baz", true, true], // an example that passes multiple args to loadModule()
//                      "foo.sample.*",
//                      "foo.test,
//              ],
//              default: [ "foo.sample.*" ],
//              common: [ "really.important.module.*" ]
//      });

        var common = modMap["common"]||[];
        var result = modMap[dojo.hostenv.name_] ? common.concat(modMap[dojo.hostenv.name_]||[]) : common.concat(modMap["default"]||[]);

        for(var x=0; x<result.length; x++){
                var curr = result[x];
                if(curr.constructor == Array){
                        dojo.hostenv.loadModule.apply(dojo.hostenv, curr);
                }else{
                        dojo.hostenv.loadModule(curr);
                }
        }
}

dojo.require = function(/*String*/ resourceName){
        // summary
        //      Ensure that the given resource (ie, javascript
        //      source file) has been loaded.
        // description
        //      dojo.require() is similar to C's #include command or java's "import" command.
        //      You call dojo.require() to pull in the resources (ie, javascript source files)
        //      that define the functions you are using. 
        //
        //      Note that in the case of a build, many resources have already been included
        //      into dojo.js (ie, many of the javascript source files have been compressed and
        //      concatened into dojo.js), so many dojo.require() calls will simply return
        //      without downloading anything.
        dojo.hostenv.loadModule.apply(dojo.hostenv, arguments);
}

dojo.requireIf = function(/*Boolean*/ condition, /*String*/ resourceName){
        // summary
        //      If the condition is true then call dojo.require() for the specified resource
        var arg0 = arguments[0];
        if((arg0 === true)||(arg0=="common")||(arg0 && dojo.render[arg0].capable)){
                var args = [];
                for (var i = 1; i < arguments.length; i++) { args.push(arguments[i]); }
                dojo.require.apply(dojo, args);
        }
}

dojo.requireAfterIf = dojo.requireIf;

dojo.provide = function(/*String*/ resourceName){
        // summary
        //      Each javascript source file must have (exactly) one dojo.provide()
        //      call at the top of the file, corresponding to the file name.
        //      For example, dojo/src/foo.js must have dojo.provide("dojo.foo"); at the top of the file.
        //
        // description
        //      Each javascript source file is called a resource.  When a resource
        //      is loaded by the browser, dojo.provide() registers that it has
        //      been loaded.
        //      
        //      For backwards compatibility reasons, in addition to registering the resource,
        //      dojo.provide() also ensures that the javascript object for the module exists.  For
        //      example, dojo.provide("dojo.html.common"), in addition to registering that common.js
        //      is a resource for the dojo.html module, will ensure that the dojo.html javascript object
        //      exists, so that calls like dojo.html.foo = function(){ ... } don't fail.
        //
        //      In the case of a build (or in the future, a rollup), where multiple javascript source
        //      files are combined into one bigger file (similar to a .lib or .jar file), that file
        //      will contain multiple dojo.provide() calls, to note that it includes
        //      multiple resources.
        return dojo.hostenv.startPackage.apply(dojo.hostenv, arguments);
}

dojo.registerModulePath = function(/*String*/module, /*String*/prefix){
        // summary: maps a module name to a path
        // description: An unregistered module is given the default path of ../<module>,
        //      relative to Dojo root. For example, module acme is mapped to ../acme.
        //      If you want to use a different module name, use dojo.registerModulePath. 
        return dojo.hostenv.setModulePrefix(module, prefix);
}

if(djConfig["modulePaths"]){
        for(var param in djConfig["modulePaths"]){
                dojo.registerModulePath(param, djConfig["modulePaths"][param]);
        }
}

dojo.setModulePrefix = function(/*String*/module, /*String*/prefix){
        // summary: maps a module name to a path
        dojo.deprecated('dojo.setModulePrefix("' + module + '", "' + prefix + '")', "replaced by dojo.registerModulePath", "0.5");
        return dojo.registerModulePath(module, prefix);
}

dojo.exists = function(/*Object*/obj, /*String*/name){
        // summary: determine if an object supports a given method
        // description: useful for longer api chains where you have to test each object in the chain
        var p = name.split(".");
        for(var i = 0; i < p.length; i++){
                if(!obj[p[i]]){ return false; } // Boolean
                obj = obj[p[i]];
        }
        return true; // Boolean
}

// Localization routines

dojo.hostenv.normalizeLocale = function(/*String?*/locale){
//      summary:
//              Returns canonical form of locale, as used by Dojo.  All variants are case-insensitive and are separated by '-'
//              as specified in RFC 3066. If no locale is specified, the user agent's default is returned.

        var result = locale ? locale.toLowerCase() : dojo.locale;
        if(result == "root"){
                result = "ROOT";
        }
        return result;// String
};

dojo.hostenv.searchLocalePath = function(/*String*/locale, /*Boolean*/down, /*Function*/searchFunc){
//      summary:
//              A helper method to assist in searching for locale-based resources.  Will iterate through
//              the variants of a particular locale, either up or down, executing a callback function.
//              For example, "en-us" and true will try "en-us" followed by "en" and finally "ROOT".

        locale = dojo.hostenv.normalizeLocale(locale);

        var elements = locale.split('-');
        var searchlist = [];
        for(var i = elements.length; i > 0; i--){
                searchlist.push(elements.slice(0, i).join('-'));
        }
        searchlist.push(false);
        if(down){searchlist.reverse();}

        for(var j = searchlist.length - 1; j >= 0; j--){
                var loc = searchlist[j] || "ROOT";
                var stop = searchFunc(loc);
                if(stop){ break; }
        }
}

//These two functions are placed outside of preloadLocalizations
//So that the xd loading can use/override them.
dojo.hostenv.localesGenerated /***BUILD:localesGenerated***/; // value will be inserted here at build time, if necessary

dojo.hostenv.registerNlsPrefix = function(){
// summary:
//      Register module "nls" to point where Dojo can find pre-built localization files
        dojo.registerModulePath("nls","nls");   
}

dojo.hostenv.preloadLocalizations = function(){
// summary:
//      Load built, flattened resource bundles, if available for all locales used in the page.
//      Execute only once.  Note that this is a no-op unless there is a build.

        if(dojo.hostenv.localesGenerated){
                dojo.hostenv.registerNlsPrefix();

                function preload(locale){
                        locale = dojo.hostenv.normalizeLocale(locale);
                        dojo.hostenv.searchLocalePath(locale, true, function(loc){
                                for(var i=0; i<dojo.hostenv.localesGenerated.length;i++){
                                        if(dojo.hostenv.localesGenerated[i] == loc){
                                                dojo["require"]("nls.dojo_"+loc);
                                                return true; // Boolean
                                        }
                                }
                                return false; // Boolean
                        });
                }
                preload();
                var extra = djConfig.extraLocale||[];
                for(var i=0; i<extra.length; i++){
                        preload(extra[i]);
                }
        }
        dojo.hostenv.preloadLocalizations = function(){};
}

dojo.requireLocalization = function(/*String*/moduleName, /*String*/bundleName, /*String?*/locale, /*String?*/availableFlatLocales){
// summary:
//      Declares translated resources and loads them if necessary, in the same style as dojo.require.
//      Contents of the resource bundle are typically strings, but may be any name/value pair,
//      represented in JSON format.  See also dojo.i18n.getLocalization.
//
// moduleName: name of the package containing the "nls" directory in which the bundle is found
// bundleName: bundle name, i.e. the filename without the '.js' suffix
// locale: the locale to load (optional)  By default, the browser's user locale as defined by dojo.locale
// availableFlatLocales: A comma-separated list of the available, flattened locales for this bundle.
// This argument should only be set by the build process.
//
// description:
//      Load translated resource bundles provided underneath the "nls" directory within a package.
//      Translated resources may be located in different packages throughout the source tree.  For example,
//      a particular widget may define one or more resource bundles, structured in a program as follows,
//      where moduleName is mycode.mywidget and bundleNames available include bundleone and bundletwo:
//      ...
//      mycode/
//       mywidget/
//        nls/
//         bundleone.js (the fallback translation, English in this example)
//         bundletwo.js (also a fallback translation)
//         de/
//          bundleone.js
//          bundletwo.js
//         de-at/
//          bundleone.js
//         en/
//          (empty; use the fallback translation)
//         en-us/
//          bundleone.js
//         en-gb/
//          bundleone.js
//         es/
//          bundleone.js
//          bundletwo.js
//        ...etc
//      ...
//      Each directory is named for a locale as specified by RFC 3066, (http://www.ietf.org/rfc/rfc3066.txt),
//      normalized in lowercase.  Note that the two bundles in the example do not define all the same variants.
//      For a given locale, bundles will be loaded for that locale and all more general locales above it, including
//      a fallback at the root directory.  For example, a declaration for the "de-at" locale will first
//      load nls/de-at/bundleone.js, then nls/de/bundleone.js and finally nls/bundleone.js.  The data will
//      be flattened into a single Object so that lookups will follow this cascading pattern.  An optional build
//      step can preload the bundles to avoid data redundancy and the multiple network hits normally required to
//      load these resources.

        dojo.hostenv.preloadLocalizations();
        var targetLocale = dojo.hostenv.normalizeLocale(locale);
        var bundlePackage = [moduleName, "nls", bundleName].join(".");
//NOTE: When loading these resources, the packaging does not match what is on disk.  This is an
// implementation detail, as this is just a private data structure to hold the loaded resources.
// e.g. tests/hello/nls/en-us/salutations.js is loaded as the object tests.hello.nls.salutations.en_us={...}
// The structure on disk is intended to be most convenient for developers and translators, but in memory
// it is more logical and efficient to store in a different order.  Locales cannot use dashes, since the
// resulting path will not evaluate as valid JS, so we translate them to underscores.
        
        //Find the best-match locale to load if we have available flat locales.
        var bestLocale = "";
        if(availableFlatLocales){
                var flatLocales = availableFlatLocales.split(",");
                for(var i = 0; i < flatLocales.length; i++){
                        //Locale must match from start of string.
                        if(targetLocale.indexOf(flatLocales[i]) == 0){
                                if(flatLocales[i].length > bestLocale.length){
                                        bestLocale = flatLocales[i];
                                }
                        }
                }
                if(!bestLocale){
                        bestLocale = "ROOT";
                }               
        }

        //See if the desired locale is already loaded.
        var tempLocale = availableFlatLocales ? bestLocale : targetLocale;
        var bundle = dojo.hostenv.findModule(bundlePackage);
        var localizedBundle = null;
        if(bundle){
                if(djConfig.localizationComplete && bundle._built){return;}
                var jsLoc = tempLocale.replace('-', '_');
                var translationPackage = bundlePackage+"."+jsLoc;
                localizedBundle = dojo.hostenv.findModule(translationPackage);
        }

        if(!localizedBundle){
                bundle = dojo.hostenv.startPackage(bundlePackage);
                var syms = dojo.hostenv.getModuleSymbols(moduleName);
                var modpath = syms.concat("nls").join("/");
                var parent;

                dojo.hostenv.searchLocalePath(tempLocale, availableFlatLocales, function(loc){
                        var jsLoc = loc.replace('-', '_');
                        var translationPackage = bundlePackage + "." + jsLoc;
                        var loaded = false;
                        if(!dojo.hostenv.findModule(translationPackage)){
                                // Mark loaded whether it's found or not, so that further load attempts will not be made
                                dojo.hostenv.startPackage(translationPackage);
                                var module = [modpath];
                                if(loc != "ROOT"){module.push(loc);}
                                module.push(bundleName);
                                var filespec = module.join("/") + '.js';
                                loaded = dojo.hostenv.loadPath(filespec, null, function(hash){
                                        // Use singleton with prototype to point to parent bundle, then mix-in result from loadPath
                                        var clazz = function(){};
                                        clazz.prototype = parent;
                                        bundle[jsLoc] = new clazz();
                                        for(var j in hash){ bundle[jsLoc][j] = hash[j]; }
                                });
                        }else{
                                loaded = true;
                        }
                        if(loaded && bundle[jsLoc]){
                                parent = bundle[jsLoc];
                        }else{
                                bundle[jsLoc] = parent;
                        }
                        
                        if(availableFlatLocales){
                                //Stop the locale path searching if we know the availableFlatLocales, since
                                //the first call to this function will load the only bundle that is needed.
                                return true;
                        }
                });
        }

        //Save the best locale bundle as the target locale bundle when we know the
        //the available bundles.
        if(availableFlatLocales && targetLocale != bestLocale){
                bundle[targetLocale.replace('-', '_')] = bundle[bestLocale.replace('-', '_')];
        }
};

(function(){
        // If other locales are used, dojo.requireLocalization should load them as well, by default.
        // Override dojo.requireLocalization to do load the default bundle, then iterate through the
        // extraLocale list and load those translations as well, unless a particular locale was requested.

        var extra = djConfig.extraLocale;
        if(extra){
                if(!extra instanceof Array){
                        extra = [extra];
                }

                var req = dojo.requireLocalization;
                dojo.requireLocalization = function(m, b, locale, availableFlatLocales){
                        req(m,b,locale, availableFlatLocales);
                        if(locale){return;}
                        for(var i=0; i<extra.length; i++){
                                req(m,b,extra[i], availableFlatLocales);
                        }
                };
        }
})();

};

if(typeof window != 'undefined'){

        // attempt to figure out the path to dojo if it isn't set in the config
        (function(){
                // before we get any further with the config options, try to pick them out
                // of the URL. Most of this code is from NW
                if(djConfig.allowQueryConfig){
                        var baseUrl = document.location.toString(); // FIXME: use location.query instead?
                        var params = baseUrl.split("?", 2);
                        if(params.length > 1){
                                var paramStr = params[1];
                                var pairs = paramStr.split("&");
                                for(var x in pairs){
                                        var sp = pairs[x].split("=");
                                        // FIXME: is this eval dangerous?
                                        if((sp[0].length > 9)&&(sp[0].substr(0, 9) == "djConfig.")){
                                                var opt = sp[0].substr(9);
                                                try{
                                                        djConfig[opt]=eval(sp[1]);
                                                }catch(e){
                                                        djConfig[opt]=sp[1];
                                                }
                                        }
                                }
                        }
                }

                if(
                        ((djConfig["baseScriptUri"] == "")||(djConfig["baseRelativePath"] == "")) && 
                        (document && document.getElementsByTagName)
                ){
                        var scripts = document.getElementsByTagName("script");
                        var rePkg = /(__package__|dojo|bootstrap1)\.js([\?\.]|$)/i;
                        for(var i = 0; i < scripts.length; i++) {
                                var src = scripts[i].getAttribute("src");
                                if(!src) { continue; }
                                var m = src.match(rePkg);
                                if(m) {
                                        var root = src.substring(0, m.index);
                                        if(src.indexOf("bootstrap1") > -1) { root += "../"; }
                                        if(!this["djConfig"]) { djConfig = {}; }
                                        if(djConfig["baseScriptUri"] == "") { djConfig["baseScriptUri"] = root; }
                                        if(djConfig["baseRelativePath"] == "") { djConfig["baseRelativePath"] = root; }
                                        break;
                                }
                        }
                }

                // fill in the rendering support information in dojo.render.*
                var dr = dojo.render;
                var drh = dojo.render.html;
                var drs = dojo.render.svg;
                var dua = (drh.UA = navigator.userAgent);
                var dav = (drh.AV = navigator.appVersion);
                var t = true;
                var f = false;
                drh.capable = t;
                drh.support.builtin = t;

                dr.ver = parseFloat(drh.AV);
                dr.os.mac = dav.indexOf("Macintosh") >= 0;
                dr.os.win = dav.indexOf("Windows") >= 0;
                // could also be Solaris or something, but it's the same browser
                dr.os.linux = dav.indexOf("X11") >= 0;

                drh.opera = dua.indexOf("Opera") >= 0;
                drh.khtml = (dav.indexOf("Konqueror") >= 0)||(dav.indexOf("Safari") >= 0);
                drh.safari = dav.indexOf("Safari") >= 0;
                var geckoPos = dua.indexOf("Gecko");
                drh.mozilla = drh.moz = (geckoPos >= 0)&&(!drh.khtml);
                if (drh.mozilla) {
                        // gecko version is YYYYMMDD
                        drh.geckoVersion = dua.substring(geckoPos + 6, geckoPos + 14);
                }
                drh.ie = (document.all)&&(!drh.opera);
                drh.ie50 = drh.ie && dav.indexOf("MSIE 5.0")>=0;
                drh.ie55 = drh.ie && dav.indexOf("MSIE 5.5")>=0;
                drh.ie60 = drh.ie && dav.indexOf("MSIE 6.0")>=0;
                drh.ie70 = drh.ie && dav.indexOf("MSIE 7.0")>=0;

                var cm = document["compatMode"];
                drh.quirks = (cm == "BackCompat")||(cm == "QuirksMode")||drh.ie55||drh.ie50;

                // TODO: is the HTML LANG attribute relevant?
                dojo.locale = dojo.locale || (drh.ie ? navigator.userLanguage : navigator.language).toLowerCase();

                dr.vml.capable=drh.ie;
                drs.capable = f;
                drs.support.plugin = f;
                drs.support.builtin = f;
                var tdoc = window["document"];
                var tdi = tdoc["implementation"];

                if((tdi)&&(tdi["hasFeature"])&&(tdi.hasFeature("org.w3c.dom.svg", "1.0"))){
                        drs.capable = t;
                        drs.support.builtin = t;
                        drs.support.plugin = f;
                }
                // webkits after 420 support SVG natively. The test string is "AppleWebKit/420+"
                if(drh.safari){
                        var tmp = dua.split("AppleWebKit/")[1];
                        var ver = parseFloat(tmp.split(" ")[0]);
                        if(ver >= 420){
                                drs.capable = t;
                                drs.support.builtin = t;
                                drs.support.plugin = f;
                        }
                }else{
                }
        })();

        dojo.hostenv.startPackage("dojo.hostenv");

        dojo.render.name = dojo.hostenv.name_ = 'browser';
        dojo.hostenv.searchIds = [];

        // These are in order of decreasing likelihood; this will change in time.
        dojo.hostenv._XMLHTTP_PROGIDS = ['Msxml2.XMLHTTP', 'Microsoft.XMLHTTP', 'Msxml2.XMLHTTP.4.0'];

        dojo.hostenv.getXmlhttpObject = function(){
                // summary: does the work of portably generating a new XMLHTTPRequest object.
                var http = null;
                var last_e = null;
                try{ http = new XMLHttpRequest(); }catch(e){}
                if(!http){
                        for(var i=0; i<3; ++i){
                                var progid = dojo.hostenv._XMLHTTP_PROGIDS[i];
                                try{
                                        http = new ActiveXObject(progid);
                                }catch(e){
                                        last_e = e;
                                }

                                if(http){
                                        dojo.hostenv._XMLHTTP_PROGIDS = [progid];  // so faster next time
                                        break;
                                }
                        }

                        /*if(http && !http.toString) {
                                http.toString = function() { "[object XMLHttpRequest]"; }
                        }*/
                }

                if(!http){
                        return dojo.raise("XMLHTTP not available", last_e);
                }

                return http; // XMLHTTPRequest instance
        }

        dojo.hostenv._blockAsync = false;
        dojo.hostenv.getText = function(uri, async_cb, fail_ok){
                // summary: Read the contents of the specified uri and return those contents.
                // uri:
                //              A relative or absolute uri. If absolute, it still must be in
                //              the same "domain" as we are.
                // async_cb:
                //              If not specified, load synchronously. If specified, load
                //              asynchronously, and use async_cb as the progress handler which
                //              takes the xmlhttp object as its argument. If async_cb, this
                //              function returns null.
                // fail_ok:
                //              Default false. If fail_ok and !async_cb and loading fails,
                //              return null instead of throwing.

                // need to block async callbacks from snatching this thread as the result
                // of an async callback might call another sync XHR, this hangs khtml forever
                // hostenv._blockAsync must also be checked in BrowserIO's watchInFlight()
                // NOTE: must be declared before scope switches ie. this.getXmlhttpObject()
                if(!async_cb){ this._blockAsync = true; }

                var http = this.getXmlhttpObject();

                function isDocumentOk(http){
                        var stat = http["status"];
                        // allow a 304 use cache, needed in konq (is this compliant with the http spec?)
                        return Boolean((!stat)||((200 <= stat)&&(300 > stat))||(stat==304));
                }

                if(async_cb){
                        var _this = this, timer = null, gbl = dojo.global();
                        var xhr = dojo.evalObjPath("dojo.io.XMLHTTPTransport");
                        http.onreadystatechange = function(){
                                if(timer){ gbl.clearTimeout(timer); timer = null; }
                                if(_this._blockAsync || (xhr && xhr._blockAsync)){
                                        timer = gbl.setTimeout(function () { http.onreadystatechange.apply(this); }, 10);
                                }else{
                                        if(4==http.readyState){
                                                if(isDocumentOk(http)){
                                                        // dojo.debug("LOADED URI: "+uri);
                                                        async_cb(http.responseText);
                                                }
                                        }
                                }
                        }
                }

                http.open('GET', uri, async_cb ? true : false);
                try{
                        http.send(null);
                        if(async_cb){
                                return null;
                        }
                        if(!isDocumentOk(http)){
                                var err = Error("Unable to load "+uri+" status:"+ http.status);
                                err.status = http.status;
                                err.responseText = http.responseText;
                                throw err;
                        }
                }catch(e){
                        this._blockAsync = false;
                        if((fail_ok)&&(!async_cb)){
                                return null;
                        }else{
                                throw e;
                        }
                }

                this._blockAsync = false;
                return http.responseText; // String
        }

        dojo.hostenv.defaultDebugContainerId = 'dojoDebug';
        dojo.hostenv._println_buffer = [];
        dojo.hostenv._println_safe = false;
        dojo.hostenv.println = function(/*String*/line){
                // summary:
                //              prints the provided line to whatever logging container is
                //              available. If the page isn't loaded yet, the line may be added
                //              to a buffer for printing later.
                if(!dojo.hostenv._println_safe){
                        dojo.hostenv._println_buffer.push(line);
                }else{
                        try {
                                var console = document.getElementById(djConfig.debugContainerId ?
                                        djConfig.debugContainerId : dojo.hostenv.defaultDebugContainerId);
                                if(!console) { console = dojo.body(); }

                                var div = document.createElement("div");
                                div.appendChild(document.createTextNode(line));
                                console.appendChild(div);
                        } catch (e) {
                                try{
                                        // safari needs the output wrapped in an element for some reason
                                        document.write("<div>" + line + "</div>");
                                }catch(e2){
                                        window.status = line;
                                }
                        }
                }
        }

        dojo.addOnLoad(function(){
                dojo.hostenv._println_safe = true;
                while(dojo.hostenv._println_buffer.length > 0){
                        dojo.hostenv.println(dojo.hostenv._println_buffer.shift());
                }
        });

        function dj_addNodeEvtHdlr(/*DomNode*/node, /*String*/evtName, /*Function*/fp){
                // summary:
                //              non-destructively adds the specified function to the node's
                //              evtName handler.
                // node: the DomNode to add the handler to
                // evtName: should be in the form "click" for "onclick" handlers
                var oldHandler = node["on"+evtName] || function(){};
                node["on"+evtName] = function(){
                        fp.apply(node, arguments);
                        oldHandler.apply(node, arguments);
                }
                return true;
        }

        dojo.hostenv._djInitFired = false;
        //      BEGIN DOMContentLoaded, from Dean Edwards (http://dean.edwards.name/weblog/2006/06/again/)
        function dj_load_init(e){
                dojo.hostenv._djInitFired = true;
                // allow multiple calls, only first one will take effect
                // A bug in khtml calls events callbacks for document for event which isnt supported
                // for example a created contextmenu event calls DOMContentLoaded, workaround
                var type = (e && e.type) ? e.type.toLowerCase() : "load";
                if(arguments.callee.initialized || (type!="domcontentloaded" && type!="load")){ return; }
                arguments.callee.initialized = true;
                if(typeof(_timer) != 'undefined'){
                        clearInterval(_timer);
                        delete _timer;
                }

                var initFunc = function(){
                        //perform initialization
                        if(dojo.render.html.ie){
                                dojo.hostenv.makeWidgets();
                        }
                };

                if(dojo.hostenv.inFlightCount == 0){
                        initFunc();
                        dojo.hostenv.modulesLoaded();
                }else{
                        //This else case should be xdomain loading.
                        //Make sure this is the first thing in the load listener array.
                        //Part of the dojo.addOnLoad guarantee is that when the listeners are notified,
                        //It means the DOM (or page) has loaded and that widgets have been parsed.
                        dojo.hostenv.modulesLoadedListeners.unshift(initFunc);
                }
        }

        //      START DOMContentLoaded
        // Mozilla and Opera 9 expose the event we could use
        if(document.addEventListener){
                // NOTE: 
                //              due to a threading issue in Firefox 2.0, we can't enable
                //              DOMContentLoaded on that platform. For more information, see:
                //              http://trac.dojotoolkit.org/ticket/1704
                if(dojo.render.html.opera || (dojo.render.html.moz && (djConfig["enableMozDomContentLoaded"] === true))){
                        document.addEventListener("DOMContentLoaded", dj_load_init, null);
                }

                //      mainly for Opera 8.5, won't be fired if DOMContentLoaded fired already.
                //  also used for Mozilla because of trac #1640
                window.addEventListener("load", dj_load_init, null);
        }

        //      for Internet Explorer. readyState will not be achieved on init call, but dojo doesn't need it
        //      however, we'll include it because we don't know if there are other functions added that might.
        //      Note that this has changed because the build process strips all comments--including conditional
        //              ones.
        if(dojo.render.html.ie && dojo.render.os.win){
                document.attachEvent("onreadystatechange", function(e){
                        if(document.readyState == "complete"){
                                dj_load_init();
                        }
                });
        }

        if (/(WebKit|khtml)/i.test(navigator.userAgent)) { // sniff
                var _timer = setInterval(function() {
                        if (/loaded|complete/.test(document.readyState)) {
                                dj_load_init(); // call the onload handler
                        }
                }, 10);
        }
        //      END DOMContentLoaded

        // IE WebControl hosted in an application can fire "beforeunload" and "unload"
        // events when control visibility changes, causing Dojo to unload too soon. The
        // following code fixes the problem
        // Reference: http://support.microsoft.com/default.aspx?scid=kb;en-us;199155
        if(dojo.render.html.ie){
                dj_addNodeEvtHdlr(window, "beforeunload", function(){
                        dojo.hostenv._unloading = true;
                        window.setTimeout(function() {
                                dojo.hostenv._unloading = false;
                        }, 0);
                });
        }

        dj_addNodeEvtHdlr(window, "unload", function(){
                dojo.hostenv.unloaded();
                if((!dojo.render.html.ie)||(dojo.render.html.ie && dojo.hostenv._unloading)){
                        dojo.hostenv.unloaded();
                }
        });

        dojo.hostenv.makeWidgets = function(){
                // you can put searchIds in djConfig and dojo.hostenv at the moment
                // we should probably eventually move to one or the other
                var sids = [];
                if(djConfig.searchIds && djConfig.searchIds.length > 0) {
                        sids = sids.concat(djConfig.searchIds);
                }
                if(dojo.hostenv.searchIds && dojo.hostenv.searchIds.length > 0) {
                        sids = sids.concat(dojo.hostenv.searchIds);
                }

                if((djConfig.parseWidgets)||(sids.length > 0)){
                        if(dojo.evalObjPath("dojo.widget.Parse")){
                                // we must do this on a delay to avoid:
                                //      http://www.shaftek.org/blog/archives/000212.html
                                // (IE bug)
                                        var parser = new dojo.xml.Parse();
                                        if(sids.length > 0){
                                                for(var x=0; x<sids.length; x++){
                                                        var tmpNode = document.getElementById(sids[x]);
                                                        if(!tmpNode){ continue; }
                                                        var frag = parser.parseElement(tmpNode, null, true);
                                                        dojo.widget.getParser().createComponents(frag);
                                                }
                                        }else if(djConfig.parseWidgets){
                                                var frag  = parser.parseElement(dojo.body(), null, true);
                                                dojo.widget.getParser().createComponents(frag);
                                        }
                        }
                }
        }

        dojo.addOnLoad(function(){
                if(!dojo.render.html.ie) {
                        dojo.hostenv.makeWidgets();
                }
        });

        try{
                if(dojo.render.html.ie){
                        document.namespaces.add("v","urn:schemas-microsoft-com:vml");
                        document.createStyleSheet().addRule("v\\:*", "behavior:url(#default#VML)");
                }
        }catch(e){ }

        // stub, over-ridden by debugging code. This will at least keep us from
        // breaking when it's not included
        dojo.hostenv.writeIncludes = function(){}

        //TODOC:  HOW TO DOC THIS?
        // @global: dj_currentDocument
        // summary:
        //              Current document object. 'dj_currentDocument' can be modified for temporary context shifting.
        // description:
        //    dojo.doc() returns dojo.currentDocument.
        //              Refer to dojo.doc() rather than referring to 'window.document' to ensure your
        //              code runs correctly in managed contexts.
        if(!dj_undef("document", this)){
                dj_currentDocument = this.document;
        }

        dojo.doc = function(){
                // summary:
                //              return the document object associated with the dojo.global()
                return dj_currentDocument;
        }

        dojo.body = function(){
                // summary:
                //              return the body object associated with dojo.doc()
                // Note: document.body is not defined for a strict xhtml document
                return dojo.doc().body || dojo.doc().getElementsByTagName("body")[0];
        }

        dojo.byId = function(/*String*/id, /*DocumentElement*/doc){
                // summary:
                //              similar to other library's "$" function, takes a string
                //              representing a DOM id or a DomNode and returns the
                //              corresponding DomNode. If a Node is passed, this function is a
                //              no-op. Returns a single DOM node or null, working around
                //              several browser-specific bugs to do so.
                // id: DOM id or DOM Node
                // doc:
                //              optional, defaults to the current value of dj_currentDocument.
                //              Can be used to retreive node references from other documents.
                if((id)&&((typeof id == "string")||(id instanceof String))){
                        if(!doc){ doc = dj_currentDocument; }
                        var ele = doc.getElementById(id);
                        // workaround bug in IE and Opera 8.2 where getElementById returns wrong element
                        if(ele && (ele.id != id) && doc.all){
                                ele = null;
                                // get all matching elements with this id
                                eles = doc.all[id];
                                if(eles){
                                        // if more than 1, choose first with the correct id
                                        if(eles.length){
                                                for(var i=0; i<eles.length; i++){
                                                        if(eles[i].id == id){
                                                                ele = eles[i];
                                                                break;
                                                        }
                                                }
                                        // return 1 and only element
                                        }else{
                                                ele = eles;
                                        }
                                }
                        }
                        return ele; // DomNode
                }
                return id; // DomNode
        }

        dojo.setContext = function(/*Object*/globalObject, /*DocumentElement*/globalDocument){
                // summary:
                //              changes the behavior of many core Dojo functions that deal with
                //              namespace and DOM lookup, changing them to work in a new global
                //              context. The varibles dj_currentContext and dj_currentDocument
                //              are modified as a result of calling this function.
                dj_currentContext = globalObject;
                dj_currentDocument = globalDocument;
        };

        dojo._fireCallback = function(callback, context, cbArguments){
                if((context)&&((typeof callback == "string")||(callback instanceof String))){
                        callback=context[callback];
                }
                return (context ? callback.apply(context, cbArguments || [ ]) : callback());
        }

        dojo.withGlobal = function(/*Object*/globalObject, /*Function*/callback, /*Object?*/thisObject, /*Array?*/cbArguments){
                // summary:
                //              Call callback with globalObject as dojo.global() and globalObject.document
                //              as dojo.doc(). If provided, globalObject will be executed in the context of
                //              object thisObject
                // description:
                //              When callback() returns or throws an error, the dojo.global() and dojo.doc() will
                //              be restored to its previous state.
                var rval;
                var oldGlob = dj_currentContext;
                var oldDoc = dj_currentDocument;
                try{
                        dojo.setContext(globalObject, globalObject.document);
                        rval = dojo._fireCallback(callback, thisObject, cbArguments);
                }finally{
                        dojo.setContext(oldGlob, oldDoc);
                }
                return rval;
        }

        dojo.withDoc = function (/*Object*/documentObject, /*Function*/callback, /*Object?*/thisObject, /*Array?*/cbArguments) {
                // summary:
                //              Call callback with documentObject as dojo.doc(). If provided, callback will be executed
                //              in the context of object thisObject
                // description:
                //              When callback() returns or throws an error, the dojo.doc() will
                //              be restored to its previous state.
                var rval;
                var oldDoc = dj_currentDocument;
                try{
                        dj_currentDocument = documentObject;
                        rval = dojo._fireCallback(callback, thisObject, cbArguments);
                }finally{
                        dj_currentDocument = oldDoc;
                }
                return rval;
        }

} //if (typeof window != 'undefined')

//Load debug code if necessary.
dojo.requireIf((djConfig["isDebug"] || djConfig["debugAtAllCosts"]), "dojo.debug");

//window.widget is for Dashboard detection
//The full conditionals are spelled out to avoid issues during builds.
//Builds may be looking for require/requireIf statements and processing them.
dojo.requireIf(djConfig["debugAtAllCosts"] && !window.widget && !djConfig["useXDomain"], "dojo.browser_debug");
dojo.requireIf(djConfig["debugAtAllCosts"] && !window.widget && djConfig["useXDomain"], "dojo.browser_debug_xd");

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
}

dojo.provide("dojo.string");


dojo.provide("dojo.lang.common");

dojo.lang.inherits = function(/*Function*/subclass, /*Function*/superclass){
        // summary: Set up inheritance between two classes.
        if(!dojo.lang.isFunction(superclass)){ 
                dojo.raise("dojo.inherits: superclass argument ["+superclass+"] must be a function (subclass: ["+subclass+"']");
        }
        subclass.prototype = new superclass();
        subclass.prototype.constructor = subclass;
        subclass.superclass = superclass.prototype;
        // DEPRECATED: super is a reserved word, use 'superclass'
        subclass['super'] = superclass.prototype;
}

dojo.lang._mixin = function(/*Object*/ obj, /*Object*/ props){
        // summary:
        //              Adds all properties and methods of props to obj. This addition is
        //              "prototype extension safe", so that instances of objects will not
        //              pass along prototype defaults.
        var tobj = {};
        for(var x in props){
                // the "tobj" condition avoid copying properties in "props"
                // inherited from Object.prototype.  For example, if obj has a custom
                // toString() method, don't overwrite it with the toString() method
                // that props inherited from Object.protoype
                if((typeof tobj[x] == "undefined") || (tobj[x] != props[x])){
                        obj[x] = props[x];
                }
        }
        // IE doesn't recognize custom toStrings in for..in
        if(dojo.render.html.ie 
                && (typeof(props["toString"]) == "function")
                && (props["toString"] != obj["toString"])
                && (props["toString"] != tobj["toString"]))
        {
                obj.toString = props.toString;
        }
        return obj; // Object
}

dojo.lang.mixin = function(/*Object*/obj, /*Object...*/props){
        // summary:     Adds all properties and methods of props to obj. 
        for(var i=1, l=arguments.length; i<l; i++){
                dojo.lang._mixin(obj, arguments[i]);
        }
        return obj; // Object
}

dojo.lang.extend = function(/*Object*/ constructor, /*Object...*/ props){
        // summary:
        //              Adds all properties and methods of props to constructor's
        //              prototype, making them available to all instances created with
        //              constructor.
        for(var i=1, l=arguments.length; i<l; i++){
                dojo.lang._mixin(constructor.prototype, arguments[i]);
        }
        return constructor; // Object
}

// Promote to dojo module
dojo.inherits = dojo.lang.inherits;
//dojo.lang._mixin = dojo.lang._mixin;
dojo.mixin = dojo.lang.mixin;
dojo.extend = dojo.lang.extend;

dojo.lang.find = function(      /*Array*/               array, 
                                                        /*Object*/              value,
                                                        /*Boolean?*/    identity,
                                                        /*Boolean?*/    findLast){
        // summary:     
        //              Return the index of value in array, returning -1 if not found.
        // array: just what you think
        // value: the value to locate
        // identity: 
        //              If true, matches with identity comparison (===). If false, uses
        //              normal comparison (==).
        // findLast: 
        //              If true, returns index of last instance of value.
        // examples:
        //              find(array, value[, identity [findLast]]) // recommended
        //              find(value, array[, identity [findLast]]) // deprecated
                                                        
        // support both (array, value) and (value, array)
        if(!dojo.lang.isArrayLike(array) && dojo.lang.isArrayLike(value)) {
                dojo.deprecated('dojo.lang.find(value, array)', 'use dojo.lang.find(array, value) instead', "0.5");
                var temp = array;
                array = value;
                value = temp;
        }
        var isString = dojo.lang.isString(array);
        if(isString) { array = array.split(""); }

        if(findLast) {
                var step = -1;
                var i = array.length - 1;
                var end = -1;
        } else {
                var step = 1;
                var i = 0;
                var end = array.length;
        }
        if(identity){
                while(i != end) {
                        if(array[i] === value){ return i; }
                        i += step;
                }
        }else{
                while(i != end) {
                        if(array[i] == value){ return i; }
                        i += step;
                }
        }
        return -1;      // number
}

dojo.lang.indexOf = dojo.lang.find;

dojo.lang.findLast = function(/*Array*/array, /*Object*/value, /*boolean?*/identity){
        // summary:
        //              Return index of last occurance of value in array, returning -1 if
        //              not found. This is a shortcut for dojo.lang.find() with a true
        //              value for its "findLast" parameter.
        // identity:
        //              If true, matches with identity comparison (===). If false, uses
        //              normal comparison (==).
        return dojo.lang.find(array, value, identity, true); // number
}

dojo.lang.lastIndexOf = dojo.lang.findLast;

dojo.lang.inArray = function(array /*Array*/, value /*Object*/){
        // summary:     Return true if value is present in array.
        return dojo.lang.find(array, value) > -1; // boolean
}

/**
 * Partial implmentation of is* functions from
 * http://www.crockford.com/javascript/recommend.html
 * NOTE: some of these may not be the best thing to use in all situations
 * as they aren't part of core JS and therefore can't work in every case.
 * See WARNING messages inline for tips.
 *
 * The following is* functions are fairly "safe"
 */

dojo.lang.isObject = function(/*anything*/ it){
        // summary:     Return true if it is an Object, Array or Function.
        if(typeof it == "undefined"){ return false; }
        return (typeof it == "object" || it === null || dojo.lang.isArray(it) || dojo.lang.isFunction(it)); // Boolean
}

dojo.lang.isArray = function(/*anything*/ it){
        // summary:     Return true if it is an Array.
        return (it && it instanceof Array || typeof it == "array"); // Boolean
}

dojo.lang.isArrayLike = function(/*anything*/ it){
        // summary:     
        //              Return true if it can be used as an array (i.e. is an object with
        //              an integer length property).
        if((!it)||(dojo.lang.isUndefined(it))){ return false; }
        if(dojo.lang.isString(it)){ return false; }
        if(dojo.lang.isFunction(it)){ return false; } // keeps out built-in constructors (Number, String, ...) which have length properties
        if(dojo.lang.isArray(it)){ return true; }
        // form node itself is ArrayLike, but not always iterable. Use form.elements instead.
        if((it.tagName)&&(it.tagName.toLowerCase()=='form')){ return false; }
        if(dojo.lang.isNumber(it.length) && isFinite(it.length)){ return true; }
        return false; // Boolean
}

dojo.lang.isFunction = function(/*anything*/ it){
        // summary:     Return true if it is a Function.
        return (it instanceof Function || typeof it == "function"); // Boolean
};

(function(){
        // webkit treats NodeList as a function, which is bad
        if((dojo.render.html.capable)&&(dojo.render.html["safari"])){
                dojo.lang.isFunction = function(/*anything*/ it){
                        if((typeof(it) == "function") && (it == "[object NodeList]")) { return false; }
                        return (it instanceof Function || typeof it == "function"); // Boolean
                }
        }
})();

dojo.lang.isString = function(/*anything*/ it){
        // summary:     Return true if it is a String.
        return (typeof it == "string" || it instanceof String);
}

dojo.lang.isAlien = function(/*anything*/ it){
        // summary: Return true if it is not a built-in function. False if not.
        if(!it){ return false; }
        return !dojo.lang.isFunction(it) && /\{\s*\[native code\]\s*\}/.test(String(it)); // Boolean
}

dojo.lang.isBoolean = function(/*anything*/ it){
        // summary:     Return true if it is a Boolean.
        return (it instanceof Boolean || typeof it == "boolean"); // Boolean
}

/**
 * The following is***() functions are somewhat "unsafe". Fortunately,
 * there are workarounds the the language provides and are mentioned
 * in the WARNING messages.
 *
 */
dojo.lang.isNumber = function(/*anything*/ it){
        // summary:     Return true if it is a number.
        // description: 
        //              WARNING - In most cases, isNaN(it) is sufficient to determine whether or not
        //              something is a number or can be used as such. For example, a number or string
        //              can be used interchangably when accessing array items (array["1"] is the same as
        //              array[1]) and isNaN will return false for both values ("1" and 1). However,
        //              isNumber("1")  will return false, which is generally not too useful.
        //              Also, isNumber(NaN) returns true, again, this isn't generally useful, but there
        //              are corner cases (like when you want to make sure that two things are really
        //              the same type of thing). That is really where isNumber "shines".
        //
        // Recommendation - Use isNaN(it) when possible
        
        return (it instanceof Number || typeof it == "number"); // Boolean
}

/*
 * FIXME: Should isUndefined go away since it is error prone?
 */
dojo.lang.isUndefined = function(/*anything*/ it){
        // summary: Return true if it is not defined.
        // description: 
        //              WARNING - In some cases, isUndefined will not behave as you
        //              might expect. If you do isUndefined(foo) and there is no earlier
        //              reference to foo, an error will be thrown before isUndefined is
        //              called. It behaves correctly if you scope yor object first, i.e.
        //              isUndefined(foo.bar) where foo is an object and bar isn't a
        //              property of the object.
        //
        // Recommendation - Use typeof foo == "undefined" when possible

        return ((typeof(it) == "undefined")&&(it == undefined)); // Boolean
}

// end Crockford functions

dojo.provide("dojo.lang.extras");



dojo.lang.setTimeout = function(/*Function*/func, /*int*/delay /*, ...*/){
        // summary:
        //              Sets a timeout in milliseconds to execute a function in a given
        //              context with optional arguments.
        // usage:
        //              dojo.lang.setTimeout(Object context, function func, number delay[, arg1[, ...]]);
        //              dojo.lang.setTimeout(function func, number delay[, arg1[, ...]]);

        var context = window, argsStart = 2;
        if(!dojo.lang.isFunction(func)){
                context = func;
                func = delay;
                delay = arguments[2];
                argsStart++;
        }

        if(dojo.lang.isString(func)){
                func = context[func];
        }
        
        var args = [];
        for (var i = argsStart; i < arguments.length; i++){
                args.push(arguments[i]);
        }
        return dojo.global().setTimeout(function(){ func.apply(context, args); }, delay); // int
}

dojo.lang.clearTimeout = function(/*int*/timer){
        // summary: clears timer by number from the execution queue

        // FIXME:
        //              why do we have this function? It's not portable outside of browser
        //              environments and it's a stupid wrapper on something that browsers
        //              provide anyway.
        dojo.global().clearTimeout(timer);
}

dojo.lang.getNameInObj = function(/*Object*/ns, /*unknown*/item){
        // summary: 
        //              looks for a value in the object ns with a value matching item and
        //              returns the property name
        // ns: if null, dj_global is used
        // item: value to return a name for
        if(!ns){ ns = dj_global; }

        for(var x in ns){
                if(ns[x] === item){
                        return new String(x); // String
                }
        }
        return null; // null
}

dojo.lang.shallowCopy = function(/*Object*/obj, /*Boolean?*/deep){
        // summary:
        //              copies object obj one level deep, or full depth if deep is true
        var i, ret;     

        if(obj === null){ /*obj: null*/ return null; } // null
        
        if(dojo.lang.isObject(obj)){
                // obj: Object  
                ret = new obj.constructor();
                for(i in obj){
                        if(dojo.lang.isUndefined(ret[i])){
                                ret[i] = deep ? dojo.lang.shallowCopy(obj[i], deep) : obj[i];
                        }
                }
        }else if(dojo.lang.isArray(obj)){
                // obj: Array
                ret = [];
                for(i=0; i<obj.length; i++){
                        ret[i] = deep ? dojo.lang.shallowCopy(obj[i], deep) : obj[i];
                }
        }else{
                // obj: Object
                ret = obj;
        }

        return ret; // Object
}

dojo.lang.firstValued = function(/* ... */){
        // summary: Return the first argument that isn't undefined

        for(var i = 0; i < arguments.length; i++){
                if(typeof arguments[i] != "undefined"){
                        return arguments[i]; // Object
                }
        }
        return undefined; // undefined
}

dojo.lang.getObjPathValue = function(/*String*/objpath, /*Object?*/context, /*Boolean?*/create){
        // summary:
        //              Gets a value from a reference specified as a string descriptor,
        //              (e.g. "A.B") in the given context.
        // context: if not specified, dj_global is used
        // create: if true, undefined objects in the path are created.
        with(dojo.parseObjPath(objpath, context, create)){
                return dojo.evalProp(prop, obj, create); // Object
        }
}

dojo.lang.setObjPathValue = function(/*String*/objpath, /*anything*/value, /*Object?*/context, /*Boolean?*/create){
        // summary:
        //              Sets a value on a reference specified as a string descriptor.
        //              (e.g. "A.B") in the given context. This is similar to straight
        //              assignment, except that the object structure in question can
        //              optionally be created if it does not exist.
        //      context: if not specified, dj_global is used
        //      create: if true, undefined objects in the path are created.

        // FIXME: why is this function valuable? It should be scheduled for
        // removal on the grounds that dojo.parseObjPath does most of it's work and
        // is more straightforward and has fewer dependencies. Also, the order of
        // arguments is bone-headed. "context" should clearly come after "create".
        // *sigh*
        dojo.deprecated("dojo.lang.setObjPathValue", "use dojo.parseObjPath and the '=' operator", "0.6");

        if(arguments.length < 4){
                create = true;
        }
        with(dojo.parseObjPath(objpath, context, create)){
                if(obj && (create || (prop in obj))){
                        obj[prop] = value;
                }
        }
}

dojo.provide("dojo.io.common");



/******************************************************************************
 *      Notes about dojo.io design:
 *      
 *      The dojo.io.* package has the unenviable task of making a lot of different
 *      types of I/O feel natural, despite a universal lack of good (or even
 *      reasonable!) I/O capability in the host environment. So lets pin this down
 *      a little bit further.
 *
 *      Rhino:
 *              perhaps the best situation anywhere. Access to Java classes allows you
 *              to do anything one might want in terms of I/O, both synchronously and
 *              async. Can open TCP sockets and perform low-latency client/server
 *              interactions. HTTP transport is available through Java HTTP client and
 *              server classes. Wish it were always this easy.
 *
 *      xpcshell:
 *              XPCOM for I/O.
 *
 *      spidermonkey:
 *              S.O.L.
 *
 *      Browsers:
 *              Browsers generally do not provide any useable filesystem access. We are
 *              therefore limited to HTTP for moving information to and from Dojo
 *              instances living in a browser.
 *
 *              XMLHTTP:
 *                      Sync or async, allows reading of arbitrary text files (including
 *                      JS, which can then be eval()'d), writing requires server
 *                      cooperation and is limited to HTTP mechanisms (POST and GET).
 *
 *              <iframe> hacks:
 *                      iframe document hacks allow browsers to communicate asynchronously
 *                      with a server via HTTP POST and GET operations. With significant
 *                      effort and server cooperation, low-latency data transit between
 *                      client and server can be acheived via iframe mechanisms (repubsub).
 *
 *              SVG:
 *                      Adobe's SVG viewer implements helpful primitives for XML-based
 *                      requests, but receipt of arbitrary text data seems unlikely w/o
 *                      <![CDATA[]]> sections.
 *
 *
 *      A discussion between Dylan, Mark, Tom, and Alex helped to lay down a lot
 *      the IO API interface. A transcript of it can be found at:
 *              http://dojotoolkit.org/viewcvs/viewcvs.py/documents/irc/irc_io_api_log.txt?rev=307&view=auto
 *      
 *      Also referenced in the design of the API was the DOM 3 L&S spec:
 *              http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html
 ******************************************************************************/

// a map of the available transport options. Transports should add themselves
// by calling add(name)
dojo.io.transports = [];
dojo.io.hdlrFuncNames = [ "load", "error", "timeout" ]; // we're omitting a progress() event for now

dojo.io.Request = function(/*String*/ url, /*String*/ mimetype, /*String*/ transport, /*String or Boolean*/ changeUrl){
// summary:
//              Constructs a Request object that is used by dojo.io.bind().
// description:
//              dojo.io.bind() will create one of these for you if
//              you call dojo.io.bind() with an plain object containing the bind parameters.
//              This method can either take the arguments specified, or an Object containing all of the parameters that you
//              want to use to create the dojo.io.Request (similar to how dojo.io.bind() is called.
//              The named parameters to this constructor represent the minimum set of parameters need
        if((arguments.length == 1)&&(arguments[0].constructor == Object)){
                this.fromKwArgs(arguments[0]);
        }else{
                this.url = url;
                if(mimetype){ this.mimetype = mimetype; }
                if(transport){ this.transport = transport; }
                if(arguments.length >= 4){ this.changeUrl = changeUrl; }
        }
}

dojo.lang.extend(dojo.io.Request, {

        /** The URL to hit */
        url: "",
        
        /** The mime type used to interrpret the response body */
        mimetype: "text/plain",
        
        /** The HTTP method to use */
        method: "GET",
        
        /** An Object containing key-value pairs to be included with the request */
        content: undefined, // Object
        
        /** The transport medium to use */
        transport: undefined, // String
        
        /** If defined the URL of the page is physically changed */
        changeUrl: undefined, // String
        
        /** A form node to use in the request */
        formNode: undefined, // HTMLFormElement
        
        /** Whether the request should be made synchronously */
        sync: false,
        
        bindSuccess: false,

        /** Cache/look for the request in the cache before attempting to request?
         *  NOTE: this isn't a browser cache, this is internal and would only cache in-page
         */
        useCache: false,

        /** Prevent the browser from caching this by adding a query string argument to the URL */
        preventCache: false,

        jsonFilter: function(value){
                if(     (this.mimetype == "text/json-comment-filtered")||
                        (this.mimetype == "application/json-comment-filtered")
                ){
                        var cStartIdx = value.indexOf("\/*");
                        var cEndIdx = value.lastIndexOf("*\/");
                        if((cStartIdx == -1)||(cEndIdx == -1)){
                                dojo.debug("your JSON wasn't comment filtered!"); // FIXME: throw exception instead?
                                return "";
                        }
                        return value.substring(cStartIdx+2, cEndIdx);
                }
                dojo.debug("please consider using a mimetype of text/json-comment-filtered to avoid potential security issues with JSON endpoints");
                return value;
        },
        
        // events stuff
        load: function(/*String*/type, /*Object*/data, /*Object*/transportImplementation, /*Object*/kwArgs){
                // summary:
                //              Called on successful completion of a bind.
                //              type: String
                //                              A string with value "load"
                //              data: Object
                //                              The object representing the result of the bind. The actual structure
                //                              of the data object will depend on the mimetype that was given to bind
                //                              in the bind arguments.
                //              transportImplementation: Object
                //                              The object that implements a particular transport. Structure is depedent
                //                              on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the
                //                              XMLHttpRequest object from the browser.
                //              kwArgs: Object
                //                              Object that contains the request parameters that were given to the
                //                              bind call. Useful for storing and retrieving state from when bind
                //                              was called.
        },
        error: function(/*String*/type, /*Object*/error, /*Object*/transportImplementation, /*Object*/kwArgs){
                // summary:
                //              Called when there is an error with a bind.
                //              type: String
                //                              A string with value "error"
                //              error: Object
                //                              The error object. Should be a dojo.io.Error object, but not guaranteed.
                //              transportImplementation: Object
                //                              The object that implements a particular transport. Structure is depedent
                //                              on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the
                //                              XMLHttpRequest object from the browser.
                //              kwArgs: Object
                //                              Object that contains the request parameters that were given to the
                //                              bind call. Useful for storing and retrieving state from when bind
                //                              was called.
        },
        timeout: function(/*String*/type, /*Object*/empty, /*Object*/transportImplementation, /*Object*/kwArgs){
                // summary:
                //              Called when there is an error with a bind. Only implemented in certain transports at this time.
                //              type: String
                //                              A string with value "timeout"
                //              empty: Object
                //                              Should be null. Just a spacer argument so that load, error, timeout and handle have the
                //                              same signatures.
                //              transportImplementation: Object
                //                              The object that implements a particular transport. Structure is depedent
                //                              on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the
                //                              XMLHttpRequest object from the browser. May be null for the timeout case for
                //                              some transports.
                //              kwArgs: Object
                //                              Object that contains the request parameters that were given to the
                //                              bind call. Useful for storing and retrieving state from when bind
                //                              was called.
        },
        handle: function(/*String*/type, /*Object*/data, /*Object*/transportImplementation, /*Object*/kwArgs){
                // summary:
                //              The handle method can be defined instead of defining separate load, error and timeout
                //              callbacks.
                //              type: String
                //                              A string with the type of callback: "load", "error", or "timeout".
                //              data: Object
                //                              See the above callbacks for what this parameter could be.
                //              transportImplementation: Object
                //                              The object that implements a particular transport. Structure is depedent
                //                              on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the
                //                              XMLHttpRequest object from the browser.
                //              kwArgs: Object
                //                              Object that contains the request parameters that were given to the
                //                              bind call. Useful for storing and retrieving state from when bind
                //                              was called.     
        },

        //FIXME: change IframeIO.js to use timeouts?
        // The number of seconds to wait until firing a timeout callback.
        // If it is zero, that means, don't do a timeout check.
        timeoutSeconds: 0,
        
        // the abort method needs to be filled in by the transport that accepts the
        // bind() request
        abort: function(){ },
        
        // backButton: function(){ },
        // forwardButton: function(){ },

        fromKwArgs: function(/*Object*/ kwArgs){
                // summary:
                //              Creates a dojo.io.Request from a simple object (kwArgs object).

                // normalize args
                if(kwArgs["url"]){ kwArgs.url = kwArgs.url.toString(); }
                if(kwArgs["formNode"]) { kwArgs.formNode = dojo.byId(kwArgs.formNode); }
                if(!kwArgs["method"] && kwArgs["formNode"] && kwArgs["formNode"].method) {
                        kwArgs.method = kwArgs["formNode"].method;
                }
                
                // backwards compatibility
                if(!kwArgs["handle"] && kwArgs["handler"]){ kwArgs.handle = kwArgs.handler; }
                if(!kwArgs["load"] && kwArgs["loaded"]){ kwArgs.load = kwArgs.loaded; }
                if(!kwArgs["changeUrl"] && kwArgs["changeURL"]) { kwArgs.changeUrl = kwArgs.changeURL; }

                // encoding fun!
                kwArgs.encoding = dojo.lang.firstValued(kwArgs["encoding"], djConfig["bindEncoding"], "");

                kwArgs.sendTransport = dojo.lang.firstValued(kwArgs["sendTransport"], djConfig["ioSendTransport"], false);

                var isFunction = dojo.lang.isFunction;
                for(var x=0; x<dojo.io.hdlrFuncNames.length; x++){
                        var fn = dojo.io.hdlrFuncNames[x];
                        if(kwArgs[fn] && isFunction(kwArgs[fn])){ continue; }
                        if(kwArgs["handle"] && isFunction(kwArgs["handle"])){
                                kwArgs[fn] = kwArgs.handle;
                        }
                        // handler is aliased above, shouldn't need this check
                        /* else if(dojo.lang.isObject(kwArgs.handler)){
                                if(isFunction(kwArgs.handler[fn])){
                                        kwArgs[fn] = kwArgs.handler[fn]||kwArgs.handler["handle"]||function(){};
                                }
                        }*/
                }
                dojo.lang.mixin(this, kwArgs);
        }

});

dojo.io.Error = function(/*String*/ msg, /*String*/ type, /*Number*/num){
        // summary:
        //              Constructs an object representing a bind error.
        this.message = msg;
        this.type =  type || "unknown"; // must be one of "io", "parse", "unknown"
        this.number = num || 0; // per-substrate error number, not normalized
}

dojo.io.transports.addTransport = function(/*String*/name){
        // summary:
        //              Used to register transports that can support bind calls.
        this.push(name);
        // FIXME: do we need to handle things that aren't direct children of the
        // dojo.io module? (say, dojo.io.foo.fooTransport?)
        this[name] = dojo.io[name];
}

// binding interface, the various implementations register their capabilities
// and the bind() method dispatches
dojo.io.bind = function(/*dojo.io.Request or Object*/request){
        // summary:
        //              Binding interface for IO. Loading different IO transports, like
        //              dojo.io.BrowserIO or dojo.io.IframeIO, will register with bind
        //              to handle particular types of bind calls.
        //              request: Object
        //                              Object containing bind arguments. This object is converted to
        //                              a dojo.io.Request object, and that request object is the return
        //                              value for this method.
        if(!(request instanceof dojo.io.Request)){
                try{
                        request = new dojo.io.Request(request);
                }catch(e){ dojo.debug(e); }
        }

        // if the request asks for a particular implementation, use it
        var tsName = "";
        if(request["transport"]){
                tsName = request["transport"];
                if(!this[tsName]){
                        dojo.io.sendBindError(request, "No dojo.io.bind() transport with name '"
                                + request["transport"] + "'.");
                        return request; //dojo.io.Request
                }
                if(!this[tsName].canHandle(request)){
                        dojo.io.sendBindError(request, "dojo.io.bind() transport with name '"
                                + request["transport"] + "' cannot handle this type of request.");
                        return request; //dojo.io.Request
                }
        }else{
                // otherwise we do our best to auto-detect what available transports
                // will handle 
                for(var x=0; x<dojo.io.transports.length; x++){
                        var tmp = dojo.io.transports[x];
                        if((this[tmp])&&(this[tmp].canHandle(request))){
                                tsName = tmp;
                                break;
                        }
                }
                if(tsName == ""){
                        dojo.io.sendBindError(request, "None of the loaded transports for dojo.io.bind()"
                                + " can handle the request.");
                        return request; //dojo.io.Request
                }
        }
        this[tsName].bind(request);
        request.bindSuccess = true;
        return request; //dojo.io.Request
}

dojo.io.sendBindError = function(/* Object */request, /* String */message){
        // summary:
        //              Used internally by dojo.io.bind() to return/raise a bind error.

        //Need to be careful since not all hostenvs support setTimeout.
        if((typeof request.error == "function" || typeof request.handle == "function")
                && (typeof setTimeout == "function" || typeof setTimeout == "object")){
                var errorObject = new dojo.io.Error(message);
                setTimeout(function(){
                        request[(typeof request.error == "function") ? "error" : "handle"]("error", errorObject, null, request);
                }, 50);
        }else{
                dojo.raise(message);
        }
}

dojo.io.queueBind = function(/*dojo.io.Request or Object*/request){
        // summary:
        //              queueBind will use dojo.io.bind() but guarantee that only one bind
        //              call is handled at a time.
        // description:
        //              If queueBind is called while a bind call
        //              is in process, it will queue up the other calls to bind and call them
        //              in order as bind calls complete.
        //              request: Object
        //                      Same sort of request object as used for dojo.io.bind().
        if(!(request instanceof dojo.io.Request)){
                try{
                        request = new dojo.io.Request(request);
                }catch(e){ dojo.debug(e); }
        }

        // make sure we get called if/when we get a response
        var oldLoad = request.load;
        request.load = function(){
                dojo.io._queueBindInFlight = false;
                var ret = oldLoad.apply(this, arguments);
                dojo.io._dispatchNextQueueBind();
                return ret;
        }

        var oldErr = request.error;
        request.error = function(){
                dojo.io._queueBindInFlight = false;
                var ret = oldErr.apply(this, arguments);
                dojo.io._dispatchNextQueueBind();
                return ret;
        }

        dojo.io._bindQueue.push(request);
        dojo.io._dispatchNextQueueBind();
        return request; //dojo.io.Request
}

dojo.io._dispatchNextQueueBind = function(){
        // summary:
        //      Private method used by dojo.io.queueBind().
        if(!dojo.io._queueBindInFlight){
                dojo.io._queueBindInFlight = true;
                if(dojo.io._bindQueue.length > 0){
                        dojo.io.bind(dojo.io._bindQueue.shift());
                }else{
                        dojo.io._queueBindInFlight = false;
                }
        }
}
dojo.io._bindQueue = [];
dojo.io._queueBindInFlight = false;

dojo.io.argsFromMap = function(/*Object*/map, /*String?*/encoding, /*String?*/last){
        // summary:
        //              Converts name/values pairs in the map object to an URL-encoded string
        //              with format of name1=value1&name2=value2...
        //              map: Object
        //                      Object that has the contains the names and values.
        //              encoding: String?
        //                      String to specify how to encode the name and value. If the encoding string
        //                      contains "utf" (case-insensitive), then encodeURIComponent is used. Otherwise
        //                      dojo.string.encodeAscii is used.
        //              last: String?
        //                      The last parameter in the list. Helps with final string formatting?
        var enc = /utf/i.test(encoding||"") ? encodeURIComponent : dojo.string.encodeAscii;
        var mapped = [];
        var control = new Object();
        for(var name in map){
                var domap = function(elt){
                        var val = enc(name)+"="+enc(elt);
                        mapped[(last == name) ? "push" : "unshift"](val);
                }
                if(!control[name]){
                        var value = map[name];
                        // FIXME: should be isArrayLike?
                        if (dojo.lang.isArray(value)){
                                dojo.lang.forEach(value, domap);
                        }else{
                                domap(value);
                        }
                }
        }
        return mapped.join("&"); //String
}

dojo.io.setIFrameSrc = function(/*DOMNode*/ iframe, /*String*/ src, /*Boolean*/ replace){
        //summary:
        //              Sets the URL that is loaded in an IFrame. The replace parameter indicates whether
        //              location.replace() should be used when changing the location of the iframe.
        try{
                var r = dojo.render.html;
                // dojo.debug(iframe);
                if(!replace){
                        if(r.safari){
                                iframe.location = src;
                        }else{
                                frames[iframe.name].location = src;
                        }
                }else{
                        // Fun with DOM 0 incompatibilities!
                        var idoc;
                        if(r.ie){
                                idoc = iframe.contentWindow.document;
                        }else if(r.safari){
                                idoc = iframe.document;
                        }else{ //  if(r.moz){
                                idoc = iframe.contentWindow;
                        }

                        //For Safari (at least 2.0.3) and Opera, if the iframe
                        //has just been created but it doesn't have content
                        //yet, then iframe.document may be null. In that case,
                        //use iframe.location and return.
                        if(!idoc){
                                iframe.location = src;
                                return;
                        }else{
                                idoc.location.replace(src);
                        }
                }
        }catch(e){ 
                dojo.debug(e); 
                dojo.debug("setIFrameSrc: "+e); 
        }
}

/*
dojo.io.sampleTranport = new function(){
        this.canHandle = function(kwArgs){
                // canHandle just tells dojo.io.bind() if this is a good transport to
                // use for the particular type of request.
                if(     
                        (
                                (kwArgs["mimetype"] == "text/plain") ||
                                (kwArgs["mimetype"] == "text/html") ||
                                (kwArgs["mimetype"] == "text/javascript")
                        )&&(
                                (kwArgs["method"] == "get") ||
                                ( (kwArgs["method"] == "post") && (!kwArgs["formNode"]) )
                        )
                ){
                        return true;
                }

                return false;
        }

        this.bind = function(kwArgs){
                var hdlrObj = {};

                // set up a handler object
                for(var x=0; x<dojo.io.hdlrFuncNames.length; x++){
                        var fn = dojo.io.hdlrFuncNames[x];
                        if(typeof kwArgs.handler == "object"){
                                if(typeof kwArgs.handler[fn] == "function"){
                                        hdlrObj[fn] = kwArgs.handler[fn]||kwArgs.handler["handle"];
                                }
                        }else if(typeof kwArgs[fn] == "function"){
                                hdlrObj[fn] = kwArgs[fn];
                        }else{
                                hdlrObj[fn] = kwArgs["handle"]||function(){};
                        }
                }

                // build a handler function that calls back to the handler obj
                var hdlrFunc = function(evt){
                        if(evt.type == "onload"){
                                hdlrObj.load("load", evt.data, evt);
                        }else if(evt.type == "onerr"){
                                var errObj = new dojo.io.Error("sampleTransport Error: "+evt.msg);
                                hdlrObj.error("error", errObj);
                        }
                }

                // the sample transport would attach the hdlrFunc() when sending the
                // request down the pipe at this point
                var tgtURL = kwArgs.url+"?"+dojo.io.argsFromMap(kwArgs.content);
                // sampleTransport.sendRequest(tgtURL, hdlrFunc);
        }

        dojo.io.transports.addTransport("sampleTranport");
}
*/

dojo.provide("dojo.lang.array");



// FIXME: Is this worthless since you can do: if(name in obj)
// is this the right place for this?

dojo.lang.mixin(dojo.lang, {
        has: function(/*Object*/obj, /*String*/name){
                // summary: is there a property with the passed name in obj?
                try{
                        return typeof obj[name] != "undefined"; // Boolean
                }catch(e){ return false; } // Boolean
        },

        isEmpty: function(/*Object*/obj){
                // summary:
                //              can be used to determine if the passed object is "empty". In
                //              the case of array-like objects, the length, property is
                //              examined, but for other types of objects iteration is used to
                //              examine the iterable "surface area" to determine if any
                //              non-prototypal properties have been assigned. This iteration is
                //              prototype-extension safe.
                if(dojo.lang.isObject(obj)){
                        var tmp = {};
                        var count = 0;
                        for(var x in obj){
                                if(obj[x] && (!tmp[x])){
                                        count++;
                                        break;
                                } 
                        }
                        return count == 0; // boolean
                }else if(dojo.lang.isArrayLike(obj) || dojo.lang.isString(obj)){
                        return obj.length == 0; // boolean
                }
        },

        map: function(/*Array*/arr, /*Object|Function*/obj, /*Function?*/unary_func){
                // summary:
                //              returns a new array constituded from the return values of
                //              passing each element of arr into unary_func. The obj parameter
                //              may be passed to enable the passed function to be called in
                //              that scope. In environments that support JavaScript 1.6, this
                //              function is a passthrough to the built-in map() function
                //              provided by Array instances. For details on this, see:
                //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:map
                // examples:
                //              dojo.lang.map([1, 2, 3, 4], function(item){ return item+1 });
                //              // returns [2, 3, 4, 5]
                var isString = dojo.lang.isString(arr);
                if(isString){
                        // arr: String
                        arr = arr.split("");
                }
                if(dojo.lang.isFunction(obj)&&(!unary_func)){
                        unary_func = obj;
                        obj = dj_global;
                }else if(dojo.lang.isFunction(obj) && unary_func){
                        // ff 1.5 compat
                        var tmpObj = obj;
                        obj = unary_func;
                        unary_func = tmpObj;
                }
                if(Array.map){
                        var outArr = Array.map(arr, unary_func, obj);
                }else{
                        var outArr = [];
                        for(var i=0;i<arr.length;++i){
                                outArr.push(unary_func.call(obj, arr[i]));
                        }
                }
                if(isString) {
                        return outArr.join(""); // String
                } else {
                        return outArr; // Array
                }
        },

        reduce: function(/*Array*/arr, initialValue, /*Object|Function*/obj, /*Function*/binary_func){
                // summary:
                //              similar to Python's builtin reduce() function. The result of
                //              the previous computation is passed as the first argument to
                //              binary_func along with the next value from arr. The result of
                //              this call is used along with the subsequent value from arr, and
                //              this continues until arr is exhausted. The return value is the
                //              last result. The "obj" and "initialValue" parameters may be
                //              safely omitted and the order of obj and binary_func may be
                //              reversed. The default order of the obj and binary_func argument
                //              will probably be reversed in a future release, and this call
                //              order is supported today.
                // examples:
                //              dojo.lang.reduce([1, 2, 3, 4], function(last, next){ return last+next});
                //              returns 10
                var reducedValue = initialValue;
                if(arguments.length == 2){
                        binary_func = initialValue;
                        reducedValue = arr[0];
                        arr = arr.slice(1);
                }else if(arguments.length == 3){
                        if(dojo.lang.isFunction(obj)){
                                binary_func = obj;
                                obj = null;
                        }
                }else{
                        // un-fsck the default order
                        // FIXME:
                        //              could be wrong for some strange function object cases. Not
                        //              sure how to test for them.
                        if(dojo.lang.isFunction(obj)){
                                var tmp = binary_func;
                                binary_func = obj;
                                obj = tmp;
                        }
                }

                var ob = obj || dj_global;
                dojo.lang.map(arr, 
                        function(val){
                                reducedValue = binary_func.call(ob, reducedValue, val);
                        }
                );
                return reducedValue;
        },

        forEach: function(/*Array*/anArray, /*Function*/callback, /*Object?*/thisObject){
                // summary:
                //              for every item in anArray, call callback with that item as its
                //              only parameter. Return values are ignored. This funciton
                //              corresponds (and wraps) the JavaScript 1.6 forEach method. For
                //              more details, see:
                //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:forEach
                if(dojo.lang.isString(anArray)){
                        // anArray: String
                        anArray = anArray.split(""); 
                }
                if(Array.forEach){
                        Array.forEach(anArray, callback, thisObject);
                }else{
                        // FIXME: there are several ways of handilng thisObject. Is dj_global always the default context?
                        if(!thisObject){
                                thisObject=dj_global;
                        }
                        for(var i=0,l=anArray.length; i<l; i++){ 
                                callback.call(thisObject, anArray[i], i, anArray);
                        }
                }
        },

        _everyOrSome: function(/*Boolean*/every, /*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                if(dojo.lang.isString(arr)){ 
                        //arr: String
                        arr = arr.split(""); 
                }
                if(Array.every){
                        return Array[ every ? "every" : "some" ](arr, callback, thisObject);
                }else{
                        if(!thisObject){
                                thisObject = dj_global;
                        }
                        for(var i=0,l=arr.length; i<l; i++){
                                var result = callback.call(thisObject, arr[i], i, arr);
                                if(every && !result){
                                        return false; // Boolean
                                }else if((!every)&&(result)){
                                        return true; // Boolean
                                }
                        }
                        return Boolean(every); // Boolean
                }
        },

        every: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                // summary:
                //              determines whether or not every item in the array satisfies the
                //              condition implemented by callback. thisObject may be used to
                //              scope the call to callback. The function signature is derived
                //              from the JavaScript 1.6 Array.every() function. More
                //              information on this can be found here:
                //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:every
                // examples:
                //              dojo.lang.every([1, 2, 3, 4], function(item){ return item>1; });
                //              // returns false
                //              dojo.lang.every([1, 2, 3, 4], function(item){ return item>0; });
                //              // returns true 
                return this._everyOrSome(true, arr, callback, thisObject); // Boolean
        },

        some: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                // summary:
                //              determines whether or not any item in the array satisfies the
                //              condition implemented by callback. thisObject may be used to
                //              scope the call to callback. The function signature is derived
                //              from the JavaScript 1.6 Array.some() function. More
                //              information on this can be found here:
                //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:some
                // examples:
                //              dojo.lang.some([1, 2, 3, 4], function(item){ return item>1; });
                //              // returns true
                //              dojo.lang.some([1, 2, 3, 4], function(item){ return item<1; });
                //              // returns false
                return this._everyOrSome(false, arr, callback, thisObject); // Boolean
        },

        filter: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                // summary:
                //              returns a new Array with those items from arr that match the
                //              condition implemented by callback.thisObject may be used to
                //              scope the call to callback. The function signature is derived
                //              from the JavaScript 1.6 Array.filter() function, although
                //              special accomidation is made in our implementation for strings.
                //              More information on the JS 1.6 API can be found here:
                //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:filter
                // examples:
                //              dojo.lang.some([1, 2, 3, 4], function(item){ return item>1; });
                //              // returns [2, 3, 4]
                var isString = dojo.lang.isString(arr);
                if(isString){ /*arr: String*/arr = arr.split(""); }
                var outArr;
                if(Array.filter){
                        outArr = Array.filter(arr, callback, thisObject);
                }else{
                        if(!thisObject){
                                if(arguments.length >= 3){ dojo.raise("thisObject doesn't exist!"); }
                                thisObject = dj_global;
                        }

                        outArr = [];
                        for(var i = 0; i < arr.length; i++){
                                if(callback.call(thisObject, arr[i], i, arr)){
                                        outArr.push(arr[i]);
                                }
                        }
                }
                if(isString){
                        return outArr.join(""); // String
                } else {
                        return outArr; // Array
                }
        },

        unnest: function(/* ... */){
                // summary:
                //              Creates a 1-D array out of all the arguments passed,
                //              unravelling any array-like objects in the process
                // usage:
                //              unnest(1, 2, 3) ==> [1, 2, 3]
                //              unnest(1, [2, [3], [[[4]]]]) ==> [1, 2, 3, 4]

                var out = [];
                for(var i = 0; i < arguments.length; i++){
                        if(dojo.lang.isArrayLike(arguments[i])){
                                var add = dojo.lang.unnest.apply(this, arguments[i]);
                                out = out.concat(add);
                        }else{
                                out.push(arguments[i]);
                        }
                }
                return out; // Array
        },

        toArray: function(/*Object*/arrayLike, /*Number*/startOffset){
                // summary:
                //              Converts an array-like object (i.e. arguments, DOMCollection)
                //              to an array. Returns a new Array object.
                var array = [];
                for(var i = startOffset||0; i < arrayLike.length; i++){
                        array.push(arrayLike[i]);
                }
                return array; // Array
        }
});

dojo.provide("dojo.lang.func");


dojo.lang.hitch = function(/*Object*/thisObject, /*Function|String*/method /*, ...*/){
        // summary: 
        //              Returns a function that will only ever execute in the a given scope
        //              (thisObject). This allows for easy use of object member functions
        //              in callbacks and other places in which the "this" keyword may
        //              otherwise not reference the expected scope. Any number of default
        //              positional arguments may be passed as parameters beyond "method".
        //              Each of these values will be used to "placehold" (similar to curry)
        //              for the hitched function. Note that the order of arguments may be
        //              reversed in a future version.
        // thisObject: the scope to run the method in
        // method:
        //              a function to be "bound" to thisObject or the name of the method in
        //              thisObject to be used as the basis for the binding
        // usage:
        //              dojo.lang.hitch(foo, "bar")(); // runs foo.bar() in the scope of foo
        //              dojo.lang.hitch(foo, myFunction); // returns a function that runs myFunction in the scope of foo

        var args = [];
        for(var x=2; x<arguments.length; x++){
                args.push(arguments[x]);
        }
        var fcn = (dojo.lang.isString(method) ? thisObject[method] : method) || function(){};
        return function(){
                var ta = args.concat([]); // make a copy
                for(var x=0; x<arguments.length; x++){
                        ta.push(arguments[x]);
                }
                return fcn.apply(thisObject, ta); // Function
                // return fcn.apply(thisObject, arguments); // Function
        };
}

dojo.lang.anonCtr = 0;
dojo.lang.anon = {};

dojo.lang.nameAnonFunc = function(/*Function*/anonFuncPtr, /*Object*/thisObj, /*Boolean*/searchForNames){
        // summary:
        //              Creates a reference to anonFuncPtr in thisObj with a completely
        //              unique name. The new name is returned as a String.  If
        //              searchForNames is true, an effort will be made to locate an
        //              existing reference to anonFuncPtr in thisObj, and if one is found,
        //              the existing name will be returned instead. The default is for
        //              searchForNames to be false.
        var nso = (thisObj|| dojo.lang.anon);
        if( (searchForNames) ||
                ((dj_global["djConfig"])&&(djConfig["slowAnonFuncLookups"] == true)) ){
                for(var x in nso){
                        try{
                                if(nso[x] === anonFuncPtr){
                                        return x;
                                }
                        }catch(e){} // window.external fails in IE embedded in Eclipse (Eclipse bug #151165)
                }
        }
        var ret = "__"+dojo.lang.anonCtr++;
        while(typeof nso[ret] != "undefined"){
                ret = "__"+dojo.lang.anonCtr++;
        }
        nso[ret] = anonFuncPtr;
        return ret; // String
}

dojo.lang.forward = function(funcName){
        // summary:
        //              Returns a function that forwards a method call to
        //              this.funcName(...).  Unlike dojo.lang.hitch(), the "this" scope is
        //              not fixed on a single object. Ported from MochiKit.
        return function(){
                return this[funcName].apply(this, arguments);
        }; // Function
}

dojo.lang.curry = function(thisObj, func /* args ... */){
        // summary:
        //              similar to the curry() method found in many functional programming
        //              environments, this function returns an "argument accumulator"
        //              function, bound to a particular scope, and "primed" with a variable
        //              number of arguments. The curry method is unique in that it returns
        //              a function that may return other "partial" function which can be
        //              called repeatedly. New functions are returned until the arity of
        //              the original function is reached, at which point the underlying
        //              function (func) is called in the scope thisObj with all of the
        //              accumulated arguments (plus any extras) in positional order.
        // examples:
        //              assuming a function defined like this:
        //                      var foo = {
        //                              bar: function(arg1, arg2, arg3){
        //                                      dojo.debug.apply(dojo, arguments);
        //                              }
        //                      };
        //              
        //              dojo.lang.curry() can be used most simply in this way:
        //              
        //                      tmp = dojo.lang.curry(foo, foo.bar, "arg one", "thinger");
        //                      tmp("blah", "this is superfluous");
        //                      // debugs: "arg one thinger blah this is superfluous"
        //                      tmp("blah");
        //                      // debugs: "arg one thinger blah"
        //                      tmp();
        //                      // returns a function exactly like tmp that expects one argument
        //
        //              other intermittent functions could be created until the 3
        //              positional arguments are filled:
        //
        //                      tmp = dojo.lang.curry(foo, foo.bar, "arg one");
        //                      tmp2 = tmp("arg two");
        //                      tmp2("blah blah");
        //                      // debugs: "arg one arg two blah blah"
        //                      tmp2("oy");
        //                      // debugs: "arg one arg two oy"
        //
        //              curry() can also be used to call the function if enough arguments
        //              are passed in the initial invocation:
        //
        //                      dojo.lang.curry(foo, foo.bar, "one", "two", "three", "four");
        //                      // debugs: "one two three four"
        //                      dojo.lang.curry(foo, foo.bar, "one", "two", "three");
        //                      // debugs: "one two three"


        // FIXME: the order of func and thisObj should be changed!!!
        var outerArgs = [];
        thisObj = thisObj||dj_global;
        if(dojo.lang.isString(func)){
                func = thisObj[func];
        }
        for(var x=2; x<arguments.length; x++){
                outerArgs.push(arguments[x]);
        }
        // since the event system replaces the original function with a new
        // join-point runner with an arity of 0, we check to see if it's left us
        // any clues about the original arity in lieu of the function's actual
        // length property
        var ecount = (func["__preJoinArity"]||func.length) - outerArgs.length;
        // borrowed from svend tofte
        function gather(nextArgs, innerArgs, expected){
                var texpected = expected;
                var totalArgs = innerArgs.slice(0); // copy
                for(var x=0; x<nextArgs.length; x++){
                        totalArgs.push(nextArgs[x]);
                }
                // check the list of provided nextArgs to see if it, plus the
                // number of innerArgs already supplied, meets the total
                // expected.
                expected = expected-nextArgs.length;
                if(expected<=0){
                        var res = func.apply(thisObj, totalArgs);
                        expected = texpected;
                        return res;
                }else{
                        return function(){
                                return gather(arguments,// check to see if we've been run
                                                                                // with enough args
                                                        totalArgs,      // a copy
                                                        expected);      // how many more do we need to run?;
                        };
                }
        }
        return gather([], outerArgs, ecount);
}

dojo.lang.curryArguments = function(/*Object*/thisObj, /*Function*/func, /*Array*/args, /*Integer, optional*/offset){
        // summary:
        //              similar to dojo.lang.curry(), except that a list of arguments to
        //              start the curry with may be provided as an array instead of as
        //              positional arguments. An offset may be specified from the 0 index
        //              to skip some elements in args.
        var targs = [];
        var x = offset||0;
        for(x=offset; x<args.length; x++){
                targs.push(args[x]); // ensure that it's an arr
        }
        return dojo.lang.curry.apply(dojo.lang, [thisObj, func].concat(targs));
}

dojo.lang.tryThese = function(/*...*/){
        // summary:
        //              executes each function argument in turn, returning the return value
        //              from the first one which does not throw an exception in execution.
        //              Any number of functions may be passed.
        for(var x=0; x<arguments.length; x++){
                try{
                        if(typeof arguments[x] == "function"){
                                var ret = (arguments[x]());
                                if(ret){
                                        return ret;
                                }
                        }
                }catch(e){
                        dojo.debug(e);
                }
        }
}

dojo.lang.delayThese = function(/*Array*/farr, /*Function, optional*/cb, /*Integer*/delay, /*Function, optional*/onend){
        // summary:
        //              executes a series of functions contained in farr, but spaces out
        //              calls to each function by the millisecond delay provided. If cb is
        //              provided, it will be called directly after each item in farr is
        //              called and if onend is passed, it will be called when all items
        //              have completed executing.

        /**
         * alternate: (array funcArray, function callback, function onend)
         * alternate: (array funcArray, function callback)
         * alternate: (array funcArray)
         */
        if(!farr.length){ 
                if(typeof onend == "function"){
                        onend();
                }
                return;
        }
        if((typeof delay == "undefined")&&(typeof cb == "number")){
                delay = cb;
                cb = function(){};
        }else if(!cb){
                cb = function(){};
                if(!delay){ delay = 0; }
        }
        setTimeout(function(){
                (farr.shift())();
                cb();
                dojo.lang.delayThese(farr, cb, delay, onend);
        }, delay);
}

dojo.provide("dojo.string.extras");





//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
}

dojo.provide("dojo.dom");

dojo.dom.ELEMENT_NODE                  = 1;
dojo.dom.ATTRIBUTE_NODE                = 2;
dojo.dom.TEXT_NODE                     = 3;
dojo.dom.CDATA_SECTION_NODE            = 4;
dojo.dom.ENTITY_REFERENCE_NODE         = 5;
dojo.dom.ENTITY_NODE                   = 6;
dojo.dom.PROCESSING_INSTRUCTION_NODE   = 7;
dojo.dom.COMMENT_NODE                  = 8;
dojo.dom.DOCUMENT_NODE                 = 9;
dojo.dom.DOCUMENT_TYPE_NODE            = 10;
dojo.dom.DOCUMENT_FRAGMENT_NODE        = 11;
dojo.dom.NOTATION_NODE                 = 12;
        
dojo.dom.dojoml = "http://www.dojotoolkit.org/2004/dojoml";

/**
 *      comprehensive list of XML namespaces
**/
dojo.dom.xmlns = {
        //      summary
        //      aliases for various common XML namespaces
        svg : "http://www.w3.org/2000/svg",
        smil : "http://www.w3.org/2001/SMIL20/",
        mml : "http://www.w3.org/1998/Math/MathML",
        cml : "http://www.xml-cml.org",
        xlink : "http://www.w3.org/1999/xlink",
        xhtml : "http://www.w3.org/1999/xhtml",
        xul : "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul",
        xbl : "http://www.mozilla.org/xbl",
        fo : "http://www.w3.org/1999/XSL/Format",
        xsl : "http://www.w3.org/1999/XSL/Transform",
        xslt : "http://www.w3.org/1999/XSL/Transform",
        xi : "http://www.w3.org/2001/XInclude",
        xforms : "http://www.w3.org/2002/01/xforms",
        saxon : "http://icl.com/saxon",
        xalan : "http://xml.apache.org/xslt",
        xsd : "http://www.w3.org/2001/XMLSchema",
        dt: "http://www.w3.org/2001/XMLSchema-datatypes",
        xsi : "http://www.w3.org/2001/XMLSchema-instance",
        rdf : "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        rdfs : "http://www.w3.org/2000/01/rdf-schema#",
        dc : "http://purl.org/dc/elements/1.1/",
        dcq: "http://purl.org/dc/qualifiers/1.0",
        "soap-env" : "http://schemas.xmlsoap.org/soap/envelope/",
        wsdl : "http://schemas.xmlsoap.org/wsdl/",
        AdobeExtensions : "http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/"
};

dojo.dom.isNode = function(/* object */wh){
        //      summary:
        //              checks to see if wh is actually a node.
        if(typeof Element == "function") {
                try {
                        return wh instanceof Element;   //      boolean
                } catch(e) {}
        } else {
                // best-guess
                return wh && !isNaN(wh.nodeType);       //      boolean
        }
}

dojo.dom.getUniqueId = function(){
        //      summary:
        //              returns a unique string for use with any DOM element
        var _document = dojo.doc();
        do {
                var id = "dj_unique_" + (++arguments.callee._idIncrement);
        }while(_document.getElementById(id));
        return id;      //      string
}
dojo.dom.getUniqueId._idIncrement = 0;

dojo.dom.firstElement = dojo.dom.getFirstChildElement = function(/* Element */parentNode, /* string? */tagName){
        //      summary:
        //              returns the first child element matching tagName
        var node = parentNode.firstChild;
        while(node && node.nodeType != dojo.dom.ELEMENT_NODE){
                node = node.nextSibling;
        }
        if(tagName && node && node.tagName && node.tagName.toLowerCase() != tagName.toLowerCase()) {
                node = dojo.dom.nextElement(node, tagName);
        }
        return node;    //      Element
}

dojo.dom.lastElement = dojo.dom.getLastChildElement = function(/* Element */parentNode, /* string? */tagName){
        //      summary:
        //              returns the last child element matching tagName
        var node = parentNode.lastChild;
        while(node && node.nodeType != dojo.dom.ELEMENT_NODE) {
                node = node.previousSibling;
        }
        if(tagName && node && node.tagName && node.tagName.toLowerCase() != tagName.toLowerCase()) {
                node = dojo.dom.prevElement(node, tagName);
        }
        return node;    //      Element
}

dojo.dom.nextElement = dojo.dom.getNextSiblingElement = function(/* Node */node, /* string? */tagName){
        //      summary:
        //              returns the next sibling element matching tagName
        if(!node) { return null; }
        do {
                node = node.nextSibling;
        } while(node && node.nodeType != dojo.dom.ELEMENT_NODE);

        if(node && tagName && tagName.toLowerCase() != node.tagName.toLowerCase()) {
                return dojo.dom.nextElement(node, tagName);
        }
        return node;    //      Element
}

dojo.dom.prevElement = dojo.dom.getPreviousSiblingElement = function(/* Node */node, /* string? */tagName){
        //      summary:
        //              returns the previous sibling element matching tagName
        if(!node) { return null; }
        if(tagName) { tagName = tagName.toLowerCase(); }
        do {
                node = node.previousSibling;
        } while(node && node.nodeType != dojo.dom.ELEMENT_NODE);

        if(node && tagName && tagName.toLowerCase() != node.tagName.toLowerCase()) {
                return dojo.dom.prevElement(node, tagName);
        }
        return node;    //      Element
}

// TODO: hmph
/*this.forEachChildTag = function(node, unaryFunc) {
        var child = this.getFirstChildTag(node);
        while(child) {
                if(unaryFunc(child) == "break") { break; }
                child = this.getNextSiblingTag(child);
        }
}*/

dojo.dom.moveChildren = function(/*Element*/srcNode, /*Element*/destNode, /*boolean?*/trim){
        //      summary:
        //              Moves children from srcNode to destNode and returns the count of
        //              children moved; will trim off text nodes if trim == true
        var count = 0;
        if(trim) {
                while(srcNode.hasChildNodes() &&
                        srcNode.firstChild.nodeType == dojo.dom.TEXT_NODE) {
                        srcNode.removeChild(srcNode.firstChild);
                }
                while(srcNode.hasChildNodes() &&
                        srcNode.lastChild.nodeType == dojo.dom.TEXT_NODE) {
                        srcNode.removeChild(srcNode.lastChild);
                }
        }
        while(srcNode.hasChildNodes()){
                destNode.appendChild(srcNode.firstChild);
                count++;
        }
        return count;   //      number
}

dojo.dom.copyChildren = function(/*Element*/srcNode, /*Element*/destNode, /*boolean?*/trim){
        //      summary:
        //              Copies children from srcNde to destNode and returns the count of
        //              children copied; will trim off text nodes if trim == true
        var clonedNode = srcNode.cloneNode(true);
        return this.moveChildren(clonedNode, destNode, trim);   //      number
}

dojo.dom.replaceChildren = function(/*Element*/node, /*Node*/newChild){
        //      summary:
        //              Removes all children of node and appends newChild. All the existing
        //              children will be destroyed.
        // FIXME: what if newChild is an array-like object?
        var nodes = [];
        if(dojo.render.html.ie){
                for(var i=0;i<node.childNodes.length;i++){
                        nodes.push(node.childNodes[i]);
                }
        }
        dojo.dom.removeChildren(node);
        node.appendChild(newChild);
        for(var i=0;i<nodes.length;i++){
                dojo.dom.destroyNode(nodes[i]);
        }
}

dojo.dom.removeChildren = function(/*Element*/node){
        //      summary:
        //              removes all children from node and returns the count of children removed.
        //              The children nodes are not destroyed. Be sure to call destroyNode on them
        //              after they are not used anymore.
        var count = node.childNodes.length;
        while(node.hasChildNodes()){ dojo.dom.removeNode(node.firstChild); }
        return count; // int
}

dojo.dom.replaceNode = function(/*Element*/node, /*Element*/newNode){
        //      summary:
        //              replaces node with newNode and returns a reference to the removed node.
        //              To prevent IE memory leak, call destroyNode on the returned node when
        //              it is no longer needed.
        return node.parentNode.replaceChild(newNode, node); // Node
}

dojo.dom.destroyNode = function(/*Node*/node){
        // summary:
        //              destroy a node (it can not be used any more). For IE, this is the
        //              right function to call to prevent memory leaks. While for other
        //              browsers, this is identical to dojo.dom.removeNode
        if(node.parentNode){
                node = dojo.dom.removeNode(node);
        }
        if(node.nodeType != 3){ // ingore TEXT_NODE
                if(dojo.evalObjPath("dojo.event.browser.clean", false)){
                        dojo.event.browser.clean(node);
                }
                if(dojo.render.html.ie){
                        node.outerHTML=''; //prevent ugly IE mem leak associated with Node.removeChild (ticket #1727)
                }
        }
}

dojo.dom.removeNode = function(/*Node*/node){
        // summary:
        //              if node has a parent, removes node from parent and returns a
        //              reference to the removed child.
        //              To prevent IE memory leak, call destroyNode on the returned node when
        //              it is no longer needed.
        //      node:
        //              the node to remove from its parent.

        if(node && node.parentNode){
                // return a ref to the removed child
                return node.parentNode.removeChild(node); //Node
        }
}

dojo.dom.getAncestors = function(/*Node*/node, /*function?*/filterFunction, /*boolean?*/returnFirstHit){
        //      summary:
        //              returns all ancestors matching optional filterFunction; will return
        //              only the first if returnFirstHit
        var ancestors = [];
        var isFunction = (filterFunction && (filterFunction instanceof Function || typeof filterFunction == "function"));
        while(node){
                if(!isFunction || filterFunction(node)){
                        ancestors.push(node);
                }
                if(returnFirstHit && ancestors.length > 0){ 
                        return ancestors[0];    //      Node
                }
                
                node = node.parentNode;
        }
        if(returnFirstHit){ return null; }
        return ancestors;       //      array
}

dojo.dom.getAncestorsByTag = function(/*Node*/node, /*String*/tag, /*boolean?*/returnFirstHit){
        //      summary:
        //              returns all ancestors matching tag (as tagName), will only return
        //              first one if returnFirstHit
        tag = tag.toLowerCase();
        return dojo.dom.getAncestors(node, function(el){
                return ((el.tagName)&&(el.tagName.toLowerCase() == tag));
        }, returnFirstHit);     //      Node || array
}

dojo.dom.getFirstAncestorByTag = function(/*Node*/node, /*string*/tag){
        //      summary:
        //              Returns first ancestor of node with tag tagName
        return dojo.dom.getAncestorsByTag(node, tag, true);     //      Node
}

dojo.dom.isDescendantOf = function(/* Node */node, /* Node */ancestor, /* boolean? */guaranteeDescendant){
        //      summary
        //      Returns boolean if node is a descendant of ancestor
        // guaranteeDescendant allows us to be a "true" isDescendantOf function
        if(guaranteeDescendant && node) { node = node.parentNode; }
        while(node) {
                if(node == ancestor){ 
                        return true;    //      boolean
                }
                node = node.parentNode;
        }
        return false;   //      boolean
}

dojo.dom.innerXML = function(/*Node*/node){
        //      summary:
        //              Implementation of MS's innerXML function.
        if(node.innerXML){
                return node.innerXML;   //      string
        }else if (node.xml){
                return node.xml;                //      string
        }else if(typeof XMLSerializer != "undefined"){
                return (new XMLSerializer()).serializeToString(node);   //      string
        }
}

dojo.dom.createDocument = function(){
        //      summary:
        //              cross-browser implementation of creating an XML document object.
        var doc = null;
        var _document = dojo.doc();

        if(!dj_undef("ActiveXObject")){
                var prefixes = [ "MSXML2", "Microsoft", "MSXML", "MSXML3" ];
                for(var i = 0; i<prefixes.length; i++){
                        try{
                                doc = new ActiveXObject(prefixes[i]+".XMLDOM");
                        }catch(e){ /* squelch */ };

                        if(doc){ break; }
                }
        }else if((_document.implementation)&&
                (_document.implementation.createDocument)){
                doc = _document.implementation.createDocument("", "", null);
        }
        
        return doc;     //      DOMDocument
}

dojo.dom.createDocumentFromText = function(/*string*/str, /*string?*/mimetype){
        //      summary:
        //              attempts to create a Document object based on optional mime-type,
        //              using str as the contents of the document
        if(!mimetype){ mimetype = "text/xml"; }
        if(!dj_undef("DOMParser")){
                var parser = new DOMParser();
                return parser.parseFromString(str, mimetype);   //      DOMDocument
        }else if(!dj_undef("ActiveXObject")){
                var domDoc = dojo.dom.createDocument();
                if(domDoc){
                        domDoc.async = false;
                        domDoc.loadXML(str);
                        return domDoc;  //      DOMDocument
                }else{
                        dojo.debug("toXml didn't work?");
                }
        /*
        }else if((dojo.render.html.capable)&&(dojo.render.html.safari)){
                // FIXME: this doesn't appear to work!
                // from: http://web-graphics.com/mtarchive/001606.php
                // var xml = '<?xml version="1.0"?>'+str;
                var mtype = "text/xml";
                var xml = '<?xml version="1.0"?>'+str;
                var url = "data:"+mtype+";charset=utf-8,"+encodeURIComponent(xml);
                var req = new XMLHttpRequest();
                req.open("GET", url, false);
                req.overrideMimeType(mtype);
                req.send(null);
                return req.responseXML;
        */
        }else{
                var _document = dojo.doc();
                if(_document.createElement){
                        // FIXME: this may change all tags to uppercase!
                        var tmp = _document.createElement("xml");
                        tmp.innerHTML = str;
                        if(_document.implementation && _document.implementation.createDocument){
                                var xmlDoc = _document.implementation.createDocument("foo", "", null);
                                for(var i = 0; i < tmp.childNodes.length; i++) {
                                        xmlDoc.importNode(tmp.childNodes.item(i), true);
                                }
                                return xmlDoc;  //      DOMDocument
                        }
                        // FIXME: probably not a good idea to have to return an HTML fragment
                        // FIXME: the tmp.doc.firstChild is as tested from IE, so it may not
                        // work that way across the board
                        return ((tmp.document)&&
                                (tmp.document.firstChild ?  tmp.document.firstChild : tmp));    //      DOMDocument
                }
        }
        return null;
}

dojo.dom.prependChild = function(/*Element*/node, /*Element*/parent){
        //      summary:
        //              prepends node to parent's children nodes
        if(parent.firstChild) {
                parent.insertBefore(node, parent.firstChild);
        } else {
                parent.appendChild(node);
        }
        return true;    //      boolean
}

dojo.dom.insertBefore = function(/*Node*/node, /*Node*/ref, /*boolean?*/force){
        //      summary:
        //              Try to insert node before ref
        if(     (force != true)&&
                (node === ref || node.nextSibling === ref)){ return false; }
        var parent = ref.parentNode;
        parent.insertBefore(node, ref);
        return true;    //      boolean
}

dojo.dom.insertAfter = function(/*Node*/node, /*Node*/ref, /*boolean?*/force){
        //      summary:
        //              Try to insert node after ref
        var pn = ref.parentNode;
        if(ref == pn.lastChild){
                if((force != true)&&(node === ref)){
                        return false;   //      boolean
                }
                pn.appendChild(node);
        }else{
                return this.insertBefore(node, ref.nextSibling, force); //      boolean
        }
        return true;    //      boolean
}

dojo.dom.insertAtPosition = function(/*Node*/node, /*Node*/ref, /*string*/position){
        //      summary:
        //              attempt to insert node in relation to ref based on position
        if((!node)||(!ref)||(!position)){ 
                return false;   //      boolean 
        }
        switch(position.toLowerCase()){
                case "before":
                        return dojo.dom.insertBefore(node, ref);        //      boolean
                case "after":
                        return dojo.dom.insertAfter(node, ref);         //      boolean
                case "first":
                        if(ref.firstChild){
                                return dojo.dom.insertBefore(node, ref.firstChild);     //      boolean
                        }else{
                                ref.appendChild(node);
                                return true;    //      boolean
                        }
                        break;
                default: // aka: last
                        ref.appendChild(node);
                        return true;    //      boolean
        }
}

dojo.dom.insertAtIndex = function(/*Node*/node, /*Element*/containingNode, /*number*/insertionIndex){
        //      summary:
        //              insert node into child nodes nodelist of containingNode at
        //              insertionIndex. insertionIndex should be between 0 and 
        //              the number of the childNodes in containingNode. insertionIndex
        //              specifys after how many childNodes in containingNode the node
        //              shall be inserted. If 0 is given, node will be appended to 
        //              containingNode.
        var siblingNodes = containingNode.childNodes;

        // if there aren't any kids yet, just add it to the beginning

        if (!siblingNodes.length || siblingNodes.length == insertionIndex){
                containingNode.appendChild(node);
                return true;    //      boolean
        }

        if(insertionIndex == 0){
                return dojo.dom.prependChild(node, containingNode);     //      boolean
        }
        // otherwise we need to walk the childNodes
        // and find our spot

        return dojo.dom.insertAfter(node, siblingNodes[insertionIndex-1]);      //      boolean
}
        
dojo.dom.textContent = function(/*Node*/node, /*string*/text){
        //      summary:
        //              implementation of the DOM Level 3 attribute; scan node for text
        if (arguments.length>1) {
                var _document = dojo.doc();
                dojo.dom.replaceChildren(node, _document.createTextNode(text));
                return text;    //      string
        } else {
                if(node.textContent != undefined){ //FF 1.5
                        return node.textContent;        //      string
                }
                var _result = "";
                if (node == null) { return _result; }
                for (var i = 0; i < node.childNodes.length; i++) {
                        switch (node.childNodes[i].nodeType) {
                                case 1: // ELEMENT_NODE
                                case 5: // ENTITY_REFERENCE_NODE
                                        _result += dojo.dom.textContent(node.childNodes[i]);
                                        break;
                                case 3: // TEXT_NODE
                                case 2: // ATTRIBUTE_NODE
                                case 4: // CDATA_SECTION_NODE
                                        _result += node.childNodes[i].nodeValue;
                                        break;
                                default:
                                        break;
                        }
                }
                return _result; //      string
        }
}

dojo.dom.hasParent = function(/*Node*/node){
        //      summary:
        //              returns whether or not node is a child of another node.
        return Boolean(node && node.parentNode && dojo.dom.isNode(node.parentNode));    //      boolean
}

/**
 * Examples:
 *
 * myFooNode = <foo />
 * isTag(myFooNode, "foo"); // returns "foo"
 * isTag(myFooNode, "bar"); // returns ""
 * isTag(myFooNode, "FOO"); // returns ""
 * isTag(myFooNode, "hey", "foo", "bar"); // returns "foo"
**/
dojo.dom.isTag = function(/* Node */node /* ... */){
        //      summary:
        //              determines if node has any of the provided tag names and returns
        //              the tag name that matches, empty string otherwise.
        if(node && node.tagName) {
                for(var i=1; i<arguments.length; i++){
                        if(node.tagName==String(arguments[i])){
                                return String(arguments[i]);    //      string
                        }
                }
        }
        return "";      //      string
}

dojo.dom.setAttributeNS = function(     /*Element*/elem, /*string*/namespaceURI, 
                                                                        /*string*/attrName, /*string*/attrValue){
        //      summary:
        //              implementation of DOM2 setAttributeNS that works cross browser.
        if(elem == null || ((elem == undefined)&&(typeof elem == "undefined"))){
                dojo.raise("No element given to dojo.dom.setAttributeNS");
        }
        
        if(!((elem.setAttributeNS == undefined)&&(typeof elem.setAttributeNS == "undefined"))){ // w3c
                elem.setAttributeNS(namespaceURI, attrName, attrValue);
        }else{ // IE
                // get a root XML document
                var ownerDoc = elem.ownerDocument;
                var attribute = ownerDoc.createNode(
                        2, // node type
                        attrName,
                        namespaceURI
                );
                
                // set value
                attribute.nodeValue = attrValue;
                
                // attach to element
                elem.setAttributeNode(attribute);
        }
}

dojo.provide("dojo.undo.browser");


try{
        if((!djConfig["preventBackButtonFix"])&&(!dojo.hostenv.post_load_)){
                document.write("<iframe style='border: 0px; width: 1px; height: 1px; position: absolute; bottom: 0px; right: 0px; visibility: visible;' name='djhistory' id='djhistory' src='" + (djConfig["dojoIframeHistoryUrl"] || dojo.hostenv.getBaseScriptUri()+'iframe_history.html') + "'></iframe>");
        }
}catch(e){/* squelch */}

if(dojo.render.html.opera){
        dojo.debug("Opera is not supported with dojo.undo.browser, so back/forward detection will not work.");
}

dojo.undo.browser = {
        initialHref: (!dj_undef("window")) ? window.location.href : "",
        initialHash: (!dj_undef("window")) ? window.location.hash : "",

        moveForward: false,
        historyStack: [],
        forwardStack: [],
        historyIframe: null,
        bookmarkAnchor: null,
        locationTimer: null,

        /**
         * 
         */
        setInitialState: function(/*Object*/args){
                //summary: Sets the state object and back callback for the very first page that is loaded.
                //description: It is recommended that you call this method as part of an event listener that is registered via
                //dojo.addOnLoad().
                //args: Object
                //              See the addToHistory() function for the list of valid args properties.
                this.initialState = this._createState(this.initialHref, args, this.initialHash);
        },

        //FIXME: Would like to support arbitrary back/forward jumps. Have to rework iframeLoaded among other things.
        //FIXME: is there a slight race condition in moz using change URL with the timer check and when
        //       the hash gets set? I think I have seen a back/forward call in quick succession, but not consistent.
        addToHistory: function(args){
                //summary: adds a state object (args) to the history list. You must set
                //djConfig.preventBackButtonFix = false to use dojo.undo.browser.

                //args: Object
                //              args can have the following properties:
                //              To support getting back button notifications, the object argument should implement a
                //              function called either "back", "backButton", or "handle". The string "back" will be
                //              passed as the first and only argument to this callback.
                //              - To support getting forward button notifications, the object argument should implement a
                //              function called either "forward", "forwardButton", or "handle". The string "forward" will be
                //              passed as the first and only argument to this callback.
                //              - If you want the browser location string to change, define "changeUrl" on the object. If the
                //              value of "changeUrl" is true, then a unique number will be appended to the URL as a fragment
                //              identifier (http://some.domain.com/path#uniquenumber). If it is any other value that does
                //              not evaluate to false, that value will be used as the fragment identifier. For example,
                //              if changeUrl: 'page1', then the URL will look like: http://some.domain.com/path#page1
                //              Full example:
                //              dojo.undo.browser.addToHistory({
                //                back: function() { alert('back pressed'); },
                //                forward: function() { alert('forward pressed'); },
                //                changeUrl: true
                //              });
                //
                //      BROWSER NOTES:
                //  Safari 1.2: 
                //      back button "works" fine, however it's not possible to actually
                //      DETECT that you've moved backwards by inspecting window.location.
                //      Unless there is some other means of locating.
                //      FIXME: perhaps we can poll on history.length?
                //      Safari 2.0.3+ (and probably 1.3.2+):
                //      works fine, except when changeUrl is used. When changeUrl is used,
                //      Safari jumps all the way back to whatever page was shown before
                //      the page that uses dojo.undo.browser support.
                //      IE 5.5 SP2:
                //      back button behavior is macro. It does not move back to the
                //      previous hash value, but to the last full page load. This suggests
                //      that the iframe is the correct way to capture the back button in
                //      these cases.
                //      Don't test this page using local disk for MSIE. MSIE will not create 
                //      a history list for iframe_history.html if served from a file: URL. 
                //      The XML served back from the XHR tests will also not be properly 
                //      created if served from local disk. Serve the test pages from a web 
                //      server to test in that browser.
                //      IE 6.0:
                //      same behavior as IE 5.5 SP2
                //      Firefox 1.0+:
                //      the back button will return us to the previous hash on the same
                //      page, thereby not requiring an iframe hack, although we do then
                //      need to run a timer to detect inter-page movement.

                //If addToHistory is called, then that means we prune the
                //forward stack -- the user went back, then wanted to
                //start a new forward path.
                this.forwardStack = []; 

                var hash = null;
                var url = null;
                if(!this.historyIframe){
                        if(djConfig["useXDomain"] && !djConfig["dojoIframeHistoryUrl"]){
                                dojo.debug("dojo.undo.browser: When using cross-domain Dojo builds,"
                                        + " please save iframe_history.html to your domain and set djConfig.dojoIframeHistoryUrl"
                                        + " to the path on your domain to iframe_history.html");
                        }
                        this.historyIframe = window.frames["djhistory"];
                }
                if(!this.bookmarkAnchor){
                        this.bookmarkAnchor = document.createElement("a");
                        dojo.body().appendChild(this.bookmarkAnchor);
                        this.bookmarkAnchor.style.display = "none";
                }
                if(args["changeUrl"]){
                        hash = "#"+ ((args["changeUrl"]!==true) ? args["changeUrl"] : (new Date()).getTime());
                        
                        //If the current hash matches the new one, just replace the history object with
                        //this new one. It doesn't make sense to track different state objects for the same
                        //logical URL. This matches the browser behavior of only putting in one history
                        //item no matter how many times you click on the same #hash link, at least in Firefox
                        //and Safari, and there is no reliable way in those browsers to know if a #hash link
                        //has been clicked on multiple times. So making this the standard behavior in all browsers
                        //so that dojo.undo.browser's behavior is the same in all browsers.
                        if(this.historyStack.length == 0 && this.initialState.urlHash == hash){
                                this.initialState = this._createState(url, args, hash);
                                return;
                        }else if(this.historyStack.length > 0 && this.historyStack[this.historyStack.length - 1].urlHash == hash){
                                this.historyStack[this.historyStack.length - 1] = this._createState(url, args, hash);
                                return;
                        }

                        this.changingUrl = true;
                        setTimeout("window.location.href = '"+hash+"'; dojo.undo.browser.changingUrl = false;", 1);
                        this.bookmarkAnchor.href = hash;
                        
                        if(dojo.render.html.ie){
                                url = this._loadIframeHistory();

                                var oldCB = args["back"]||args["backButton"]||args["handle"];

                                //The function takes handleName as a parameter, in case the
                                //callback we are overriding was "handle". In that case,
                                //we will need to pass the handle name to handle.
                                var tcb = function(handleName){
                                        if(window.location.hash != ""){
                                                setTimeout("window.location.href = '"+hash+"';", 1);
                                        }
                                        //Use apply to set "this" to args, and to try to avoid memory leaks.
                                        oldCB.apply(this, [handleName]);
                                }
                
                                //Set interceptor function in the right place.
                                if(args["back"]){
                                        args.back = tcb;
                                }else if(args["backButton"]){
                                        args.backButton = tcb;
                                }else if(args["handle"]){
                                        args.handle = tcb;
                                }
                
                                var oldFW = args["forward"]||args["forwardButton"]||args["handle"];
                
                                //The function takes handleName as a parameter, in case the
                                //callback we are overriding was "handle". In that case,
                                //we will need to pass the handle name to handle.
                                var tfw = function(handleName){
                                        if(window.location.hash != ""){
                                                window.location.href = hash;
                                        }
                                        if(oldFW){ // we might not actually have one
                                                //Use apply to set "this" to args, and to try to avoid memory leaks.
                                                oldFW.apply(this, [handleName]);
                                        }
                                }

                                //Set interceptor function in the right place.
                                if(args["forward"]){
                                        args.forward = tfw;
                                }else if(args["forwardButton"]){
                                        args.forwardButton = tfw;
                                }else if(args["handle"]){
                                        args.handle = tfw;
                                }

                        }else if(dojo.render.html.moz){
                                // start the timer
                                if(!this.locationTimer){
                                        this.locationTimer = setInterval("dojo.undo.browser.checkLocation();", 200);
                                }
                        }
                }else{
                        url = this._loadIframeHistory();
                }

                this.historyStack.push(this._createState(url, args, hash));
        },

        checkLocation: function(){
                //summary: private method. Do not call this directly.
                if (!this.changingUrl){
                        var hsl = this.historyStack.length;

                        if((window.location.hash == this.initialHash||window.location.href == this.initialHref)&&(hsl == 1)){
                                // FIXME: could this ever be a forward button?
                                // we can't clear it because we still need to check for forwards. Ugg.
                                // clearInterval(this.locationTimer);
                                this.handleBackButton();
                                return;
                        }
                        
                        // first check to see if we could have gone forward. We always halt on
                        // a no-hash item.
                        if(this.forwardStack.length > 0){
                                if(this.forwardStack[this.forwardStack.length-1].urlHash == window.location.hash){
                                        this.handleForwardButton();
                                        return;
                                }
                        }
        
                        // ok, that didn't work, try someplace back in the history stack
                        if((hsl >= 2)&&(this.historyStack[hsl-2])){
                                if(this.historyStack[hsl-2].urlHash==window.location.hash){
                                        this.handleBackButton();
                                        return;
                                }
                        }
                }
        },

        iframeLoaded: function(evt, ifrLoc){
                //summary: private method. Do not call this directly.
                if(!dojo.render.html.opera){
                        var query = this._getUrlQuery(ifrLoc.href);
                        if(query == null){ 
                                // alert("iframeLoaded");
                                // we hit the end of the history, so we should go back
                                if(this.historyStack.length == 1){
                                        this.handleBackButton();
                                }
                                return;
                        }
                        if(this.moveForward){
                                // we were expecting it, so it's not either a forward or backward movement
                                this.moveForward = false;
                                return;
                        }
        
                        //Check the back stack first, since it is more likely.
                        //Note that only one step back or forward is supported.
                        if(this.historyStack.length >= 2 && query == this._getUrlQuery(this.historyStack[this.historyStack.length-2].url)){
                                this.handleBackButton();
                        }
                        else if(this.forwardStack.length > 0 && query == this._getUrlQuery(this.forwardStack[this.forwardStack.length-1].url)){
                                this.handleForwardButton();
                        }
                }
        },

        handleBackButton: function(){
                //summary: private method. Do not call this directly.

                //The "current" page is always at the top of the history stack.
                var current = this.historyStack.pop();
                if(!current){ return; }
                var last = this.historyStack[this.historyStack.length-1];
                if(!last && this.historyStack.length == 0){
                        last = this.initialState;
                }
                if (last){
                        if(last.kwArgs["back"]){
                                last.kwArgs["back"]();
                        }else if(last.kwArgs["backButton"]){
                                last.kwArgs["backButton"]();
                        }else if(last.kwArgs["handle"]){
                                last.kwArgs.handle("back");
                        }
                }
                this.forwardStack.push(current);
        },

        handleForwardButton: function(){
                //summary: private method. Do not call this directly.

                var last = this.forwardStack.pop();
                if(!last){ return; }
                if(last.kwArgs["forward"]){
                        last.kwArgs.forward();
                }else if(last.kwArgs["forwardButton"]){
                        last.kwArgs.forwardButton();
                }else if(last.kwArgs["handle"]){
                        last.kwArgs.handle("forward");
                }
                this.historyStack.push(last);
        },

        _createState: function(url, args, hash){
                //summary: private method. Do not call this directly.

                return {"url": url, "kwArgs": args, "urlHash": hash};   //Object
        },

        _getUrlQuery: function(url){
                //summary: private method. Do not call this directly.
                var segments = url.split("?");
                if (segments.length < 2){
                        return null; //null
                }
                else{
                        return segments[1]; //String
                }
        },
        
        _loadIframeHistory: function(){
                //summary: private method. Do not call this directly.
                var url = (djConfig["dojoIframeHistoryUrl"] || dojo.hostenv.getBaseScriptUri()+'iframe_history.html')
                        + "?" + (new Date()).getTime();
                this.moveForward = true;
                dojo.io.setIFrameSrc(this.historyIframe, url, false);   
                return url; //String
        }
}

dojo.provide("dojo.io.BrowserIO");








if(!dj_undef("window")) {

dojo.io.checkChildrenForFile = function(/*DOMNode*/node){
        //summary: Checks any child nodes of node for an input type="file" element.
        var hasFile = false;
        var inputs = node.getElementsByTagName("input");
        dojo.lang.forEach(inputs, function(input){
                if(hasFile){ return; }
                if(input.getAttribute("type")=="file"){
                        hasFile = true;
                }
        });
        return hasFile; //boolean
}

dojo.io.formHasFile = function(/*DOMNode*/formNode){
        //summary: Just calls dojo.io.checkChildrenForFile().
        return dojo.io.checkChildrenForFile(formNode); //boolean
}

dojo.io.updateNode = function(/*DOMNode*/node, /*String or Object*/urlOrArgs){
        //summary: Updates a DOMnode with the result of a dojo.io.bind() call.
        //node: DOMNode
        //urlOrArgs: String or Object
        //              Either a String that has an URL, or an object containing dojo.io.bind()
        //              arguments.
        node = dojo.byId(node);
        var args = urlOrArgs;
        if(dojo.lang.isString(urlOrArgs)){
                args = { url: urlOrArgs };
        }
        args.mimetype = "text/html";
        args.load = function(t, d, e){
                while(node.firstChild){
                        dojo.dom.destroyNode(node.firstChild);
                }
                node.innerHTML = d;
        };
        dojo.io.bind(args);
}

dojo.io.formFilter = function(/*DOMNode*/node) {
        //summary: Returns true if the node is an input element that is enabled, has
        //a name, and whose type is one of the following values: ["file", "submit", "image", "reset", "button"]
        var type = (node.type||"").toLowerCase();
        return !node.disabled && node.name
                && !dojo.lang.inArray(["file", "submit", "image", "reset", "button"], type); //boolean
}

// TODO: Move to htmlUtils
dojo.io.encodeForm = function(/*DOMNode*/formNode, /*String?*/encoding, /*Function?*/formFilter){
        //summary: Converts the names and values of form elements into an URL-encoded
        //string (name=value&name=value...).
        //formNode: DOMNode
        //encoding: String?
        //              The encoding to use for the values. Specify a string that starts with
        //              "utf" (for instance, "utf8"), to use encodeURIComponent() as the encoding
        //              function. Otherwise, dojo.string.encodeAscii will be used.
        //formFilter: Function?
        //      A function used to filter out form elements. The element node will be passed
        //      to the formFilter function, and a boolean result is expected (true indicating
        //      indicating that the element should have its name/value included in the output).
        //      If no formFilter is specified, then dojo.io.formFilter() will be used.
        if((!formNode)||(!formNode.tagName)||(!formNode.tagName.toLowerCase() == "form")){
                dojo.raise("Attempted to encode a non-form element.");
        }
        if(!formFilter) { formFilter = dojo.io.formFilter; }
        var enc = /utf/i.test(encoding||"") ? encodeURIComponent : dojo.string.encodeAscii;
        var values = [];

        for(var i = 0; i < formNode.elements.length; i++){
                var elm = formNode.elements[i];
                if(!elm || elm.tagName.toLowerCase() == "fieldset" || !formFilter(elm)) { continue; }
                var name = enc(elm.name);
                var type = elm.type.toLowerCase();

                if(type == "select-multiple"){
                        for(var j = 0; j < elm.options.length; j++){
                                if(elm.options[j].selected) {
                                        values.push(name + "=" + enc(elm.options[j].value));
                                }
                        }
                }else if(dojo.lang.inArray(["radio", "checkbox"], type)){
                        if(elm.checked){
                                values.push(name + "=" + enc(elm.value));
                        }
                }else{
                        values.push(name + "=" + enc(elm.value));
                }
        }

        // now collect input type="image", which doesn't show up in the elements array
        var inputs = formNode.getElementsByTagName("input");
        for(var i = 0; i < inputs.length; i++) {
                var input = inputs[i];
                if(input.type.toLowerCase() == "image" && input.form == formNode
                        && formFilter(input)) {
                        var name = enc(input.name);
                        values.push(name + "=" + enc(input.value));
                        values.push(name + ".x=0");
                        values.push(name + ".y=0");
                }
        }
        return values.join("&") + "&"; //String
}

dojo.io.FormBind = function(/*DOMNode or Object*/args) {
        //summary: constructor for a dojo.io.FormBind object. See the Dojo Book for
        //some information on usage: http://manual.dojotoolkit.org/WikiHome/DojoDotBook/Book23
        //args: DOMNode or Object
        //              args can either be the DOMNode for a form element, or an object containing
        //              dojo.io.bind() arguments, one of which should be formNode with the value of
        //              a form element DOMNode.
        this.bindArgs = {};

        if(args && args.formNode) {
                this.init(args);
        } else if(args) {
                this.init({formNode: args});
        }
}
dojo.lang.extend(dojo.io.FormBind, {
        form: null,

        bindArgs: null,

        clickedButton: null,

        init: function(/*DOMNode or Object*/args) {
                //summary: Internal function called by the dojo.io.FormBind() constructor
                //do not call this method directly.
                var form = dojo.byId(args.formNode);

                if(!form || !form.tagName || form.tagName.toLowerCase() != "form") {
                        throw new Error("FormBind: Couldn't apply, invalid form");
                } else if(this.form == form) {
                        return;
                } else if(this.form) {
                        throw new Error("FormBind: Already applied to a form");
                }

                dojo.lang.mixin(this.bindArgs, args);
                this.form = form;

                this.connect(form, "onsubmit", "submit");

                for(var i = 0; i < form.elements.length; i++) {
                        var node = form.elements[i];
                        if(node && node.type && dojo.lang.inArray(["submit", "button"], node.type.toLowerCase())) {
                                this.connect(node, "onclick", "click");
                        }
                }

                var inputs = form.getElementsByTagName("input");
                for(var i = 0; i < inputs.length; i++) {
                        var input = inputs[i];
                        if(input.type.toLowerCase() == "image" && input.form == form) {
                                this.connect(input, "onclick", "click");
                        }
                }
        },

        onSubmit: function(/*DOMNode*/form) {
                //summary: Function used to verify that the form is OK to submit.
                //Override this function if you want specific form validation done.
                return true; //boolean
        },

        submit: function(/*Event*/e) {
                //summary: internal function that is connected as a listener to the
                //form's onsubmit event.
                e.preventDefault();
                if(this.onSubmit(this.form)) {
                        dojo.io.bind(dojo.lang.mixin(this.bindArgs, {
                                formFilter: dojo.lang.hitch(this, "formFilter")
                        }));
                }
        },

        click: function(/*Event*/e) {
                //summary: internal method that is connected as a listener to the
                //form's elements whose click event can submit a form.
                var node = e.currentTarget;
                if(node.disabled) { return; }
                this.clickedButton = node;
        },

        formFilter: function(/*DOMNode*/node) {
                //summary: internal function used to know which form element values to include
                //              in the dojo.io.bind() request.
                var type = (node.type||"").toLowerCase();
                var accept = false;
                if(node.disabled || !node.name) {
                        accept = false;
                } else if(dojo.lang.inArray(["submit", "button", "image"], type)) {
                        if(!this.clickedButton) { this.clickedButton = node; }
                        accept = node == this.clickedButton;
                } else {
                        accept = !dojo.lang.inArray(["file", "submit", "reset", "button"], type);
                }
                return accept; //boolean
        },

        // in case you don't have dojo.event.* pulled in
        connect: function(/*Object*/srcObj, /*Function*/srcFcn, /*Function*/targetFcn) {
                //summary: internal function used to connect event listeners to form elements
                //that trigger events. Used in case dojo.event is not loaded.
                if(dojo.evalObjPath("dojo.event.connect")) {
                        dojo.event.connect(srcObj, srcFcn, this, targetFcn);
                } else {
                        var fcn = dojo.lang.hitch(this, targetFcn);
                        srcObj[srcFcn] = function(e) {
                                if(!e) { e = window.event; }
                                if(!e.currentTarget) { e.currentTarget = e.srcElement; }
                                if(!e.preventDefault) { e.preventDefault = function() { window.event.returnValue = false; } }
                                fcn(e);
                        }
                }
        }
});

dojo.io.XMLHTTPTransport = new function(){
        //summary: The object that implements the dojo.io.bind transport for XMLHttpRequest.
        var _this = this;

        var _cache = {}; // FIXME: make this public? do we even need to?
        this.useCache = false; // if this is true, we'll cache unless kwArgs.useCache = false
        this.preventCache = false; // if this is true, we'll always force GET requests to cache

        // FIXME: Should this even be a function? or do we just hard code it in the next 2 functions?
        function getCacheKey(url, query, method) {
                return url + "|" + query + "|" + method.toLowerCase();
        }

        function addToCache(url, query, method, http) {
                _cache[getCacheKey(url, query, method)] = http;
        }

        function getFromCache(url, query, method) {
                return _cache[getCacheKey(url, query, method)];
        }

        this.clearCache = function() {
                _cache = {};
        }

        // moved successful load stuff here
        function doLoad(kwArgs, http, url, query, useCache) {
                if(     ((http.status>=200)&&(http.status<300))||       // allow any 2XX response code
                        (http.status==304)||                                            // get it out of the cache
                        (http.status==1223)||                                           // Internet Explorer mangled the status code
                        (location.protocol=="file:" && (http.status==0 || http.status==undefined))||
                        (location.protocol=="chrome:" && (http.status==0 || http.status==undefined))
                ){
                        var ret;
                        if(kwArgs.method.toLowerCase() == "head"){
                                var headers = http.getAllResponseHeaders();
                                ret = {};
                                ret.toString = function(){ return headers; }
                                var values = headers.split(/[\r\n]+/g);
                                for(var i = 0; i < values.length; i++) {
                                        var pair = values[i].match(/^([^:]+)\s*:\s*(.+)$/i);
                                        if(pair) {
                                                ret[pair[1]] = pair[2];
                                        }
                                }
                        }else if(kwArgs.mimetype == "text/javascript"){
                                try{
                                        ret = dj_eval(http.responseText);
                                }catch(e){
                                        dojo.debug(e);
                                        dojo.debug(http.responseText);
                                        ret = null;
                                }
                        }else if(kwArgs.mimetype.substr(0, 9) == "text/json" || kwArgs.mimetype.substr(0, 16) == "application/json"){
                                try{
                                        ret = dj_eval("("+kwArgs.jsonFilter(http.responseText)+")");
                                }catch(e){
                                        dojo.debug(e);
                                        dojo.debug(http.responseText);
                                        ret = false;
                                }
                        }else if((kwArgs.mimetype == "application/xml")||
                                                (kwArgs.mimetype == "text/xml")){
                                ret = http.responseXML;
                                if(!ret || typeof ret == "string" || !http.getResponseHeader("Content-Type")) {
                                        ret = dojo.dom.createDocumentFromText(http.responseText);
                                }
                        }else{
                                ret = http.responseText;
                        }

                        if(useCache){ // only cache successful responses
                                addToCache(url, query, kwArgs.method, http);
                        }
                        kwArgs[(typeof kwArgs.load == "function") ? "load" : "handle"]("load", ret, http, kwArgs);
                }else{
                        var errObj = new dojo.io.Error("XMLHttpTransport Error: "+http.status+" "+http.statusText);
                        kwArgs[(typeof kwArgs.error == "function") ? "error" : "handle"]("error", errObj, http, kwArgs);
                }
        }

        // set headers (note: Content-Type will get overriden if kwArgs.contentType is set)
        function setHeaders(http, kwArgs){
                if(kwArgs["headers"]) {
                        for(var header in kwArgs["headers"]) {
                                if(header.toLowerCase() == "content-type" && !kwArgs["contentType"]) {
                                        kwArgs["contentType"] = kwArgs["headers"][header];
                                } else {
                                        http.setRequestHeader(header, kwArgs["headers"][header]);
                                }
                        }
                }
        }

        this.inFlight = [];
        this.inFlightTimer = null;

        this.startWatchingInFlight = function(){
                //summary: internal method used to trigger a timer to watch all inflight
                //XMLHttpRequests.
                if(!this.inFlightTimer){
                        // setInterval broken in mozilla x86_64 in some circumstances, see
                        // https://bugzilla.mozilla.org/show_bug.cgi?id=344439
                        // using setTimeout instead
                        this.inFlightTimer = setTimeout("dojo.io.XMLHTTPTransport.watchInFlight();", 10);
                }
        }

        this.watchInFlight = function(){
                //summary: internal method that checks each inflight XMLHttpRequest to see
                //if it has completed or if the timeout situation applies.
                var now = null;
                // make sure sync calls stay thread safe, if this callback is called during a sync call
                // and this results in another sync call before the first sync call ends the browser hangs
                if(!dojo.hostenv._blockAsync && !_this._blockAsync){
                        for(var x=this.inFlight.length-1; x>=0; x--){
                                try{
                                        var tif = this.inFlight[x];
                                        if(!tif || tif.http._aborted || !tif.http.readyState){
                                                this.inFlight.splice(x, 1); continue; 
                                        }
                                        if(4==tif.http.readyState){
                                                // remove it so we can clean refs
                                                this.inFlight.splice(x, 1);
                                                doLoad(tif.req, tif.http, tif.url, tif.query, tif.useCache);
                                        }else if (tif.startTime){
                                                //See if this is a timeout case.
                                                if(!now){
                                                        now = (new Date()).getTime();
                                                }
                                                if(tif.startTime + (tif.req.timeoutSeconds * 1000) < now){
                                                        //Stop the request.
                                                        if(typeof tif.http.abort == "function"){
                                                                tif.http.abort();
                                                        }
                
                                                        // remove it so we can clean refs
                                                        this.inFlight.splice(x, 1);
                                                        tif.req[(typeof tif.req.timeout == "function") ? "timeout" : "handle"]("timeout", null, tif.http, tif.req);
                                                }
                                        }
                                }catch(e){
                                        try{
                                                var errObj = new dojo.io.Error("XMLHttpTransport.watchInFlight Error: " + e);
                                                tif.req[(typeof tif.req.error == "function") ? "error" : "handle"]("error", errObj, tif.http, tif.req);
                                        }catch(e2){
                                                dojo.debug("XMLHttpTransport error callback failed: " + e2);
                                        }
                                }
                        }
                }

                clearTimeout(this.inFlightTimer);
                if(this.inFlight.length == 0){
                        this.inFlightTimer = null;
                        return;
                }
                this.inFlightTimer = setTimeout("dojo.io.XMLHTTPTransport.watchInFlight();", 10);
        }

        var hasXmlHttp = dojo.hostenv.getXmlhttpObject() ? true : false;
        this.canHandle = function(/*dojo.io.Request*/kwArgs){
                //summary: Tells dojo.io.bind() if this is a good transport to
                //use for the particular type of request. This type of transport cannot
                //handle forms that have an input type="file" element.

                // FIXME: we need to determine when form values need to be
                // multi-part mime encoded and avoid using this transport for those
                // requests.
                var mlc = kwArgs["mimetype"].toLowerCase()||"";
                return hasXmlHttp
                        && (
                                (
                                        dojo.lang.inArray([
                                                "text/plain", "text/html", "application/xml", 
                                                "text/xml", "text/javascript"
                                                ], mlc
                                        )
                                ) || (
                                        mlc.substr(0, 9) == "text/json" || mlc.substr(0, 16) == "application/json"
                                )
                        )
                        && !( kwArgs["formNode"] && dojo.io.formHasFile(kwArgs["formNode"]) ); //boolean
        }

        this.multipartBoundary = "45309FFF-BD65-4d50-99C9-36986896A96F";        // unique guid as a boundary value for multipart posts

        this.bind = function(/*dojo.io.Request*/kwArgs){
                //summary: function that sends the request to the server.

                //This function will attach an abort() function to the kwArgs dojo.io.Request object,
                //so if you need to abort the request, you can call that method on the request object.
                //The following are acceptable properties in kwArgs (in addition to the
                //normal dojo.io.Request object properties).
                //url: String: URL the server URL to use for the request.
                //method: String: the HTTP method to use (GET, POST, etc...).
                //mimetype: Specifies what format the result data should be given to the load/handle callback. Valid values are:
                //              text/javascript, text/json, application/json, application/xml, text/xml. Any other mimetype will give back a text
                //              string.
                //transport: String: specify "XMLHTTPTransport" to force the use of this XMLHttpRequest transport.
                //headers: Object: The object property names and values will be sent as HTTP request header
                //              names and values.
                //sendTransport: boolean: If true, then dojo.transport=xmlhttp will be added to the request.
                //encoding: String: The type of encoding to use when dealing with the content kwArgs property.
                //content: Object: The content object is converted into a name=value&name=value string, by
                //              using dojo.io.argsFromMap(). The encoding kwArgs property is passed to dojo.io.argsFromMap()
                //              for use in encoding the names and values. The resulting string is added to the request.
                //formNode: DOMNode: a form element node. This should not normally be used. Use new dojo.io.FormBind() instead.
                //              If formNode is used, then the names and values of the form elements will be converted
                //              to a name=value&name=value string and added to the request. The encoding kwArgs property is used
                //              to encode the names and values.
                //postContent: String: Raw name=value&name=value string to be included as part of the request.
                //back or backButton: Function: A function to be called if the back button is pressed. If this kwArgs property
                //              is used, then back button support via dojo.undo.browser will be used. See notes for dojo.undo.browser on usage.
                //              You need to set djConfig.preventBackButtonFix = false to enable back button support.
                //changeUrl: boolean or String: Used as part of back button support. See notes for dojo.undo.browser on usage.
                //user: String: The user name. Used in conjuction with password. Passed to XMLHttpRequest.open().
                //password: String: The user's password. Used in conjuction with user. Passed to XMLHttpRequest.open().
                //file: Object or Array of Objects: an object simulating a file to be uploaded. file objects should have the following properties:
                //              name or fileName: the name of the file
                //              contentType: the MIME content type for the file.
                //              content: the actual content of the file.
                //multipart: boolean: indicates whether this should be a multipart mime request. If kwArgs.file exists, then this
                //              property is set to true automatically.
                //sync: boolean: if true, then a synchronous XMLHttpRequest call is done,
                //              if false (the default), then an asynchronous call is used.
                //preventCache: boolean: If true, then a cache busting parameter is added to the request URL.
                //              default value is false.
                //useCache: boolean: If true, then XMLHttpTransport will keep an internal cache of the server
                //              response and use that response if a similar request is done again.
                //              A similar request is one that has the same URL, query string and HTTP method value.
                //              default is false.
                if(!kwArgs["url"]){
                        // are we performing a history action?
                        if( !kwArgs["formNode"]
                                && (kwArgs["backButton"] || kwArgs["back"] || kwArgs["changeUrl"] || kwArgs["watchForURL"])
                                && (!djConfig.preventBackButtonFix)) {
        dojo.deprecated("Using dojo.io.XMLHTTPTransport.bind() to add to browser history without doing an IO request",
                                        "Use dojo.undo.browser.addToHistory() instead.", "0.4");
                                dojo.undo.browser.addToHistory(kwArgs);
                                return true;
                        }
                }

                // build this first for cache purposes
                var url = kwArgs.url;
                var query = "";
                if(kwArgs["formNode"]){
                        var ta = kwArgs.formNode.getAttribute("action");
                        if((ta)&&(!kwArgs["url"])){ url = ta; }
                        var tp = kwArgs.formNode.getAttribute("method");
                        if((tp)&&(!kwArgs["method"])){ kwArgs.method = tp; }
                        query += dojo.io.encodeForm(kwArgs.formNode, kwArgs.encoding, kwArgs["formFilter"]);
                }

                if(url.indexOf("#") > -1) {
                        dojo.debug("Warning: dojo.io.bind: stripping hash values from url:", url);
                        url = url.split("#")[0];
                }

                if(kwArgs["file"]){
                        // force post for file transfer
                        kwArgs.method = "post";
                }

                if(!kwArgs["method"]){
                        kwArgs.method = "get";
                }

                // guess the multipart value
                if(kwArgs.method.toLowerCase() == "get"){
                        // GET cannot use multipart
                        kwArgs.multipart = false;
                }else{
                        if(kwArgs["file"]){
                                // enforce multipart when sending files
                                kwArgs.multipart = true;
                        }else if(!kwArgs["multipart"]){
                                // default 
                                kwArgs.multipart = false;
                        }
                }

                if(kwArgs["backButton"] || kwArgs["back"] || kwArgs["changeUrl"]){
                        dojo.undo.browser.addToHistory(kwArgs);
                }

                var content = kwArgs["content"] || {};

                if(kwArgs.sendTransport) {
                        content["dojo.transport"] = "xmlhttp";
                }

                do { // break-block
                        if(kwArgs.postContent){
                                query = kwArgs.postContent;
                                break;
                        }

                        if(content) {
                                query += dojo.io.argsFromMap(content, kwArgs.encoding);
                        }
                        
                        if(kwArgs.method.toLowerCase() == "get" || !kwArgs.multipart){
                                break;
                        }

                        var     t = [];
                        if(query.length){
                                var q = query.split("&");
                                for(var i = 0; i < q.length; ++i){
                                        if(q[i].length){
                                                var p = q[i].split("=");
                                                t.push( "--" + this.multipartBoundary,
                                                                "Content-Disposition: form-data; name=\"" + p[0] + "\"", 
                                                                "",
                                                                p[1]);
                                        }
                                }
                        }

                        if(kwArgs.file){
                                if(dojo.lang.isArray(kwArgs.file)){
                                        for(var i = 0; i < kwArgs.file.length; ++i){
                                                var o = kwArgs.file[i];
                                                t.push( "--" + this.multipartBoundary,
                                                                "Content-Disposition: form-data; name=\"" + o.name + "\"; filename=\"" + ("fileName" in o ? o.fileName : o.name) + "\"",
                                                                "Content-Type: " + ("contentType" in o ? o.contentType : "application/octet-stream"),
                                                                "",
                                                                o.content);
                                        }
                                }else{
                                        var o = kwArgs.file;
                                        t.push( "--" + this.multipartBoundary,
                                                        "Content-Disposition: form-data; name=\"" + o.name + "\"; filename=\"" + ("fileName" in o ? o.fileName : o.name) + "\"",
                                                        "Content-Type: " + ("contentType" in o ? o.contentType : "application/octet-stream"),
                                                        "",
                                                        o.content);
                                }
                        }

                        if(t.length){
                                t.push("--"+this.multipartBoundary+"--", "");
                                query = t.join("\r\n");
                        }
                }while(false);

                // kwArgs.Connection = "close";

                var async = kwArgs["sync"] ? false : true;

                var preventCache = kwArgs["preventCache"] ||
                        (this.preventCache == true && kwArgs["preventCache"] != false);
                var useCache = kwArgs["useCache"] == true ||
                        (this.useCache == true && kwArgs["useCache"] != false );

                // preventCache is browser-level (add query string junk), useCache
                // is for the local cache. If we say preventCache, then don't attempt
                // to look in the cache, but if useCache is true, we still want to cache
                // the response
                if(!preventCache && useCache){
                        var cachedHttp = getFromCache(url, query, kwArgs.method);
                        if(cachedHttp){
                                doLoad(kwArgs, cachedHttp, url, query, false);
                                return;
                        }
                }

                // much of this is from getText, but reproduced here because we need
                // more flexibility
                var http = dojo.hostenv.getXmlhttpObject(kwArgs);       
                var received = false;

                // build a handler function that calls back to the handler obj
                if(async){
                        var startTime = 
                        // FIXME: setting up this callback handler leaks on IE!!!
                        this.inFlight.push({
                                "req":          kwArgs,
                                "http":         http,
                                "url":          url,
                                "query":        query,
                                "useCache":     useCache,
                                "startTime": kwArgs.timeoutSeconds ? (new Date()).getTime() : 0
                        });
                        this.startWatchingInFlight();
                }else{
                        // block async callbacks until sync is in, needed in khtml, others?
                        _this._blockAsync = true;
                }

                if(kwArgs.method.toLowerCase() == "post"){
                        // FIXME: need to hack in more flexible Content-Type setting here!
                        if (!kwArgs.user) {
                                http.open("POST", url, async);
                        }else{
        http.open("POST", url, async, kwArgs.user, kwArgs.password);
                        }
                        setHeaders(http, kwArgs);
                        http.setRequestHeader("Content-Type", kwArgs.multipart ? ("multipart/form-data; boundary=" + this.multipartBoundary) : 
                                (kwArgs.contentType || "application/x-www-form-urlencoded"));
                        try{
                                http.send(query);
                        }catch(e){
                                if(typeof http.abort == "function"){
                                        http.abort();
                                }
                                doLoad(kwArgs, {status: 404}, url, query, useCache);
                        }
                }else{
                        var tmpUrl = url;
                        if(query != "") {
                                tmpUrl += (tmpUrl.indexOf("?") > -1 ? "&" : "?") + query;
                        }
                        if(preventCache) {
                                tmpUrl += (dojo.string.endsWithAny(tmpUrl, "?", "&")
                                        ? "" : (tmpUrl.indexOf("?") > -1 ? "&" : "?")) + "dojo.preventCache=" + new Date().valueOf();
                        }
                        if (!kwArgs.user) {
                                http.open(kwArgs.method.toUpperCase(), tmpUrl, async);
                        }else{
                                http.open(kwArgs.method.toUpperCase(), tmpUrl, async, kwArgs.user, kwArgs.password);
                        }
                        setHeaders(http, kwArgs);
                        try {
                                http.send(null);
                        }catch(e)       {
                                if(typeof http.abort == "function"){
                                        http.abort();
                                }
                                doLoad(kwArgs, {status: 404}, url, query, useCache);
                        }
                }

                if( !async ) {
                        doLoad(kwArgs, http, url, query, useCache);
                        _this._blockAsync = false;
                }

                kwArgs.abort = function(){
                        try{// khtml doesent reset readyState on abort, need this workaround
                                http._aborted = true; 
                        }catch(e){/*squelsh*/}
                        return http.abort();
                }

                return;
        }
        dojo.io.transports.addTransport("XMLHTTPTransport");
}

}

dojo.provide("dojo.io.cookie");

dojo.io.cookie.setCookie = function(/*String*/name, /*String*/value, 
                                                                        /*Number?*/days, /*String?*/path, 
                                                                        /*String?*/domain, /*boolean?*/secure){
        //summary: sets a cookie.
        var expires = -1;
        if((typeof days == "number")&&(days >= 0)){
                var d = new Date();
                d.setTime(d.getTime()+(days*24*60*60*1000));
                expires = d.toGMTString();
        }
        value = escape(value);
        document.cookie = name + "=" + value + ";"
                + (expires != -1 ? " expires=" + expires + ";" : "")
                + (path ? "path=" + path : "")
                + (domain ? "; domain=" + domain : "")
                + (secure ? "; secure" : "");
}

dojo.io.cookie.set = dojo.io.cookie.setCookie;

dojo.io.cookie.getCookie = function(/*String*/name){
        //summary: Gets a cookie with the given name.

        // FIXME: Which cookie should we return?
        //        If there are cookies set for different sub domains in the current
        //        scope there could be more than one cookie with the same name.
        //        I think taking the last one in the list takes the one from the
        //        deepest subdomain, which is what we're doing here.
        var idx = document.cookie.lastIndexOf(name+'=');
        if(idx == -1) { return null; }
        var value = document.cookie.substring(idx+name.length+1);
        var end = value.indexOf(';');
        if(end == -1) { end = value.length; }
        value = value.substring(0, end);
        value = unescape(value);
        return value; //String
}

dojo.io.cookie.get = dojo.io.cookie.getCookie;

dojo.io.cookie.deleteCookie = function(/*String*/name){
        //summary: Deletes a cookie with the given name.
        dojo.io.cookie.setCookie(name, "-", 0);
}

dojo.io.cookie.setObjectCookie = function(      /*String*/name, /*Object*/obj, 
                                                                                        /*Number?*/days, /*String?*/path, 
                                                                                        /*String?*/domain, /*boolean?*/secure, 
                                                                                        /*boolean?*/clearCurrent){
        //summary: Takes an object, serializes it to a cookie value, and either
        //sets a cookie with the serialized value.
        //description: If clearCurrent is true, then any current cookie value
        //for this object will be replaced with the the new serialized object value.
        //If clearCurrent is false, then the existing cookie value will be modified
        //with any changes from the new object value.
        //Objects must be simple name/value pairs where the value is either a string
        //or a number. Any other value will be ignored.
        if(arguments.length == 5){ // for backwards compat
                clearCurrent = domain;
                domain = null;
                secure = null;
        }
        var pairs = [], cookie, value = "";
        if(!clearCurrent){
                cookie = dojo.io.cookie.getObjectCookie(name);
        }
        if(days >= 0){
                if(!cookie){ cookie = {}; }
                for(var prop in obj){
                        if(obj[prop] == null){
                                delete cookie[prop];
                        }else if((typeof obj[prop] == "string")||(typeof obj[prop] == "number")){
                                cookie[prop] = obj[prop];
                        }
                }
                prop = null;
                for(var prop in cookie){
                        pairs.push(escape(prop) + "=" + escape(cookie[prop]));
                }
                value = pairs.join("&");
        }
        dojo.io.cookie.setCookie(name, value, days, path, domain, secure);
}

dojo.io.cookie.getObjectCookie = function(/*String*/name){
        //summary: Gets an object value for the given cookie name. The complement of
        //dojo.io.cookie.setObjectCookie().
        var values = null, cookie = dojo.io.cookie.getCookie(name);
        if(cookie){
                values = {};
                var pairs = cookie.split("&");
                for(var i = 0; i < pairs.length; i++){
                        var pair = pairs[i].split("=");
                        var value = pair[1];
                        if( isNaN(value) ){ value = unescape(pair[1]); }
                        values[ unescape(pair[0]) ] = value;
                }
        }
        return values;
}

dojo.io.cookie.isSupported = function(){
        //summary: Tests the browser to see if cookies are enabled.
        if(typeof navigator.cookieEnabled != "boolean"){
                dojo.io.cookie.setCookie("__TestingYourBrowserForCookieSupport__",
                        "CookiesAllowed", 90, null);
                var cookieVal = dojo.io.cookie.getCookie("__TestingYourBrowserForCookieSupport__");
                navigator.cookieEnabled = (cookieVal == "CookiesAllowed");
                if(navigator.cookieEnabled){
                        // FIXME: should we leave this around?
                        this.deleteCookie("__TestingYourBrowserForCookieSupport__");
                }
        }
        return navigator.cookieEnabled; //boolean
}

// need to leave this in for backwards-compat from 0.1 for when it gets pulled in by dojo.io.*
if(!dojo.io.cookies){ dojo.io.cookies = dojo.io.cookie; }

dojo.kwCompoundRequire({
        common: ["dojo.io.common"],
        rhino: ["dojo.io.RhinoIO"],
        browser: ["dojo.io.BrowserIO", "dojo.io.cookie"],
        dashboard: ["dojo.io.BrowserIO", "dojo.io.cookie"]
});
dojo.provide("dojo.io.*");

dojo.provide("dojo.event.common");





// TODO: connection filter functions
//                      these are functions that accept a method invocation (like around
//                      advice) and return a boolean based on it. That value determines
//                      whether or not the connection proceeds. It could "feel" like around
//                      advice for those who know what it is (calling proceed() or not),
//                      but I think presenting it as a "filter" and/or calling it with the
//                      function args and not the MethodInvocation might make it more
//                      palletable to "normal" users than around-advice currently is
// TODO: execution scope mangling
//                      YUI's event facility by default executes listeners in the context
//                      of the source object. This is very odd, but should probably be
//                      supported as an option (both for the source and for the dest). It
//                      can be thought of as a connection-specific hitch().
// TODO: more resiliency for 4+ arguments to connect()

dojo.event = new function(){
        this._canTimeout = dojo.lang.isFunction(dj_global["setTimeout"])||dojo.lang.isAlien(dj_global["setTimeout"]);

        // FIXME: where should we put this method (not here!)?
        function interpolateArgs(args, searchForNames){
                var dl = dojo.lang;
                var ao = {
                        srcObj: dj_global,
                        srcFunc: null,
                        adviceObj: dj_global,
                        adviceFunc: null,
                        aroundObj: null,
                        aroundFunc: null,
                        adviceType: (args.length>2) ? args[0] : "after",
                        precedence: "last",
                        once: false,
                        delay: null,
                        rate: 0,
                        adviceMsg: false,
                        maxCalls: -1
                };

                switch(args.length){
                        case 0: return;
                        case 1: return;
                        case 2:
                                ao.srcFunc = args[0];
                                ao.adviceFunc = args[1];
                                break;
                        case 3:
                                if((dl.isObject(args[0]))&&(dl.isString(args[1]))&&(dl.isString(args[2]))){
                                        ao.adviceType = "after";
                                        ao.srcObj = args[0];
                                        ao.srcFunc = args[1];
                                        ao.adviceFunc = args[2];
                                }else if((dl.isString(args[1]))&&(dl.isString(args[2]))){
                                        ao.srcFunc = args[1];
                                        ao.adviceFunc = args[2];
                                }else if((dl.isObject(args[0]))&&(dl.isString(args[1]))&&(dl.isFunction(args[2]))){
                                        ao.adviceType = "after";
                                        ao.srcObj = args[0];
                                        ao.srcFunc = args[1];
                                        var tmpName  = dl.nameAnonFunc(args[2], ao.adviceObj, searchForNames);
                                        ao.adviceFunc = tmpName;
                                }else if((dl.isFunction(args[0]))&&(dl.isObject(args[1]))&&(dl.isString(args[2]))){
                                        ao.adviceType = "after";
                                        ao.srcObj = dj_global;
                                        var tmpName  = dl.nameAnonFunc(args[0], ao.srcObj, searchForNames);
                                        ao.srcFunc = tmpName;
                                        ao.adviceObj = args[1];
                                        ao.adviceFunc = args[2];
                                }
                                break;
                        case 4:
                                if((dl.isObject(args[0]))&&(dl.isObject(args[2]))){
                                        // we can assume that we've got an old-style "connect" from
                                        // the sigslot school of event attachment. We therefore
                                        // assume after-advice.
                                        ao.adviceType = "after";
                                        ao.srcObj = args[0];
                                        ao.srcFunc = args[1];
                                        ao.adviceObj = args[2];
                                        ao.adviceFunc = args[3];
                                }else if((dl.isString(args[0]))&&(dl.isString(args[1]))&&(dl.isObject(args[2]))){
                                        ao.adviceType = args[0];
                                        ao.srcObj = dj_global;
                                        ao.srcFunc = args[1];
                                        ao.adviceObj = args[2];
                                        ao.adviceFunc = args[3];
                                }else if((dl.isString(args[0]))&&(dl.isFunction(args[1]))&&(dl.isObject(args[2]))){
                                        ao.adviceType = args[0];
                                        ao.srcObj = dj_global;
                                        var tmpName  = dl.nameAnonFunc(args[1], dj_global, searchForNames);
                                        ao.srcFunc = tmpName;
                                        ao.adviceObj = args[2];
                                        ao.adviceFunc = args[3];
                                }else if((dl.isString(args[0]))&&(dl.isObject(args[1]))&&(dl.isString(args[2]))&&(dl.isFunction(args[3]))){
                                        ao.srcObj = args[1];
                                        ao.srcFunc = args[2];
                                        var tmpName  = dl.nameAnonFunc(args[3], dj_global, searchForNames);
                                        ao.adviceObj = dj_global;
                                        ao.adviceFunc = tmpName;
                                }else if(dl.isObject(args[1])){
                                        ao.srcObj = args[1];
                                        ao.srcFunc = args[2];
                                        ao.adviceObj = dj_global;
                                        ao.adviceFunc = args[3];
                                }else if(dl.isObject(args[2])){
                                        ao.srcObj = dj_global;
                                        ao.srcFunc = args[1];
                                        ao.adviceObj = args[2];
                                        ao.adviceFunc = args[3];
                                }else{
                                        ao.srcObj = ao.adviceObj = ao.aroundObj = dj_global;
                                        ao.srcFunc = args[1];
                                        ao.adviceFunc = args[2];
                                        ao.aroundFunc = args[3];
                                }
                                break;
                        case 6:
                                ao.srcObj = args[1];
                                ao.srcFunc = args[2];
                                ao.adviceObj = args[3]
                                ao.adviceFunc = args[4];
                                ao.aroundFunc = args[5];
                                ao.aroundObj = dj_global;
                                break;
                        default:
                                ao.srcObj = args[1];
                                ao.srcFunc = args[2];
                                ao.adviceObj = args[3]
                                ao.adviceFunc = args[4];
                                ao.aroundObj = args[5];
                                ao.aroundFunc = args[6];
                                ao.once = args[7];
                                ao.delay = args[8];
                                ao.rate = args[9];
                                ao.adviceMsg = args[10];
                                ao.maxCalls = (!isNaN(parseInt(args[11]))) ? args[11] : -1;
                                break;
                }

                if(dl.isFunction(ao.aroundFunc)){
                        var tmpName  = dl.nameAnonFunc(ao.aroundFunc, ao.aroundObj, searchForNames);
                        ao.aroundFunc = tmpName;
                }

                if(dl.isFunction(ao.srcFunc)){
                        ao.srcFunc = dl.getNameInObj(ao.srcObj, ao.srcFunc);
                }

                if(dl.isFunction(ao.adviceFunc)){
                        ao.adviceFunc = dl.getNameInObj(ao.adviceObj, ao.adviceFunc);
                }

                if((ao.aroundObj)&&(dl.isFunction(ao.aroundFunc))){
                        ao.aroundFunc = dl.getNameInObj(ao.aroundObj, ao.aroundFunc);
                }

                if(!ao.srcObj){
                        dojo.raise("bad srcObj for srcFunc: "+ao.srcFunc);
                }
                if(!ao.adviceObj){
                        dojo.raise("bad adviceObj for adviceFunc: "+ao.adviceFunc);
                }
                
                if(!ao.adviceFunc){
                        dojo.debug("bad adviceFunc for srcFunc: "+ao.srcFunc);
                        dojo.debugShallow(ao);
                } 
                
                return ao;
        }

        this.connect = function(/*...*/){
                // summary:
                //              dojo.event.connect is the glue that holds most Dojo-based
                //              applications together. Most combinations of arguments are
                //              supported, with the connect() method attempting to disambiguate
                //              the implied types of positional parameters. The following will
                //              all work:
                //                      dojo.event.connect("globalFunctionName1", "globalFunctionName2");
                //                      dojo.event.connect(functionReference1, functionReference2);
                //                      dojo.event.connect("globalFunctionName1", functionReference2);
                //                      dojo.event.connect(functionReference1, "globalFunctionName2");
                //                      dojo.event.connect(scope1, "functionName1", "globalFunctionName2");
                //                      dojo.event.connect("globalFunctionName1", scope2, "functionName2");
                //                      dojo.event.connect(scope1, "functionName1", scope2, "functionName2");
                //                      dojo.event.connect("after", scope1, "functionName1", scope2, "functionName2");
                //                      dojo.event.connect("before", scope1, "functionName1", scope2, "functionName2");
                //                      dojo.event.connect("around",    scope1, "functionName1", 
                //                                                                                      scope2, "functionName2",
                //                                                                                      aroundFunctionReference);
                //                      dojo.event.connect("around",    scope1, "functionName1", 
                //                                                                                      scope2, "functionName2",
                //                                                                                      scope3, "aroundFunctionName");
                //                      dojo.event.connect("before-around",     scope1, "functionName1", 
                //                                                                                                      scope2, "functionName2",
                //                                                                                                      aroundFunctionReference);
                //                      dojo.event.connect("after-around",              scope1, "functionName1", 
                //                                                                                                      scope2, "functionName2",
                //                                                                                                      aroundFunctionReference);
                //                      dojo.event.connect("after-around",              scope1, "functionName1", 
                //                                                                                                      scope2, "functionName2",
                //                                                                                                      scope3, "aroundFunctionName");
                //                      dojo.event.connect("around",    scope1, "functionName1", 
                //                                                                                      scope2, "functionName2",
                //                                                                                      scope3, "aroundFunctionName", true, 30);
                //                      dojo.event.connect("around",    scope1, "functionName1", 
                //                                                                                      scope2, "functionName2",
                //                                                                                      scope3, "aroundFunctionName", null, null, 10);
                // adviceType: 
                //              Optional. String. One of "before", "after", "around",
                //              "before-around", or "after-around". FIXME
                // srcObj:
                //              the scope in which to locate/execute the named srcFunc. Along
                //              with srcFunc, this creates a way to dereference the function to
                //              call. So if the function in question is "foo.bar", the
                //              srcObj/srcFunc pair would be foo and "bar", where "bar" is a
                //              string and foo is an object reference.
                // srcFunc:
                //              the name of the function to connect to. When it is executed,
                //              the listener being registered with this call will be called.
                //              The adviceType defines the call order between the source and
                //              the target functions.
                // adviceObj:
                //              the scope in which to locate/execute the named adviceFunc.
                // adviceFunc:
                //              the name of the function being conected to srcObj.srcFunc
                // aroundObj:
                //              the scope in which to locate/execute the named aroundFunc.
                // aroundFunc:
                //              the name of, or a reference to, the function that will be used
                //              to mediate the advice call. Around advice requires a special
                //              unary function that will be passed a "MethodInvocation" object.
                //              These objects have several important properties, namely:
                //                      - args
                //                              a mutable array of arguments to be passed into the
                //                              wrapped function
                //                      - proceed
                //                              a function that "continues" the invocation. The result
                //                              of this function is the return of the wrapped function.
                //                              You can then manipulate this return before passing it
                //                              back out (or take further action based on it).
                // once:
                //              boolean that determines whether or not this connect() will
                //              create a new connection if an identical connect() has already
                //              been made. Defaults to "false".
                // delay:
                //              an optional delay (in ms), as an integer, for dispatch of a
                //              listener after the source has been fired.
                // rate:
                //              an optional rate throttling parameter (integer, in ms). When
                //              specified, this particular connection will not fire more than
                //              once in the interval specified by the rate
                // adviceMsg:
                //              boolean. Should the listener have all the parameters passed in
                //              as a single argument?

                /*
                                ao.adviceType = args[0];
                                ao.srcObj = args[1];
                                ao.srcFunc = args[2];
                                ao.adviceObj = args[3]
                                ao.adviceFunc = args[4];
                                ao.aroundObj = args[5];
                                ao.aroundFunc = args[6];
                                ao.once = args[7];
                                ao.delay = args[8];
                                ao.rate = args[9];
                                ao.adviceMsg = args[10];
                                ao.maxCalls = args[11];
                */
                if(arguments.length == 1){
                        var ao = arguments[0];
                }else{
                        var ao = interpolateArgs(arguments, true);
                }
                if(dojo.lang.isString(ao.srcFunc) && (ao.srcFunc.toLowerCase() == "onkey") ){
                        if(dojo.render.html.ie){
                                ao.srcFunc = "onkeydown";
                                this.connect(ao);
                        }
                        ao.srcFunc = "onkeypress";
                }

                if(dojo.lang.isArray(ao.srcObj) && ao.srcObj!=""){
                        var tmpAO = {};
                        for(var x in ao){
                                tmpAO[x] = ao[x];
                        }
                        var mjps = [];
                        dojo.lang.forEach(ao.srcObj, function(src){
                                if((dojo.render.html.capable)&&(dojo.lang.isString(src))){
                                        src = dojo.byId(src);
                                        // dojo.debug(src);
                                }
                                tmpAO.srcObj = src;
                                // dojo.debug(tmpAO.srcObj, tmpAO.srcFunc);
                                // dojo.debug(tmpAO.adviceObj, tmpAO.adviceFunc);
                                mjps.push(dojo.event.connect.call(dojo.event, tmpAO));
                        });
                        return mjps;
                }

                // FIXME: just doing a "getForMethod()" seems to be enough to put this into infinite recursion!!
                var mjp = dojo.event.MethodJoinPoint.getForMethod(ao.srcObj, ao.srcFunc);
                if(ao.adviceFunc){
                        var mjp2 = dojo.event.MethodJoinPoint.getForMethod(ao.adviceObj, ao.adviceFunc);
                }

                mjp.kwAddAdvice(ao);

                // advanced users might want to fsck w/ the join point manually
                return mjp; // a MethodJoinPoint object
        }

        this.log = function(/*object or funcName*/ a1, /*funcName*/ a2){
                // summary:
                //              a function that will wrap and log all calls to the specified
                //              a1.a2() function. If only a1 is passed, it'll be used as a
                //              function or function name on the global context. Logging will
                //              be sent to dojo.debug
                // a1:
                //              if a2 is passed, this should be an object. If not, it can be a
                //              function or function name.
                // a2:
                //              a function name
                var kwArgs;
                if((arguments.length == 1)&&(typeof a1 == "object")){
                        kwArgs = a1;
                }else{
                        kwArgs = {
                                srcObj: a1,
                                srcFunc: a2
                        };
                }
                kwArgs.adviceFunc = function(){
                        var argsStr = [];
                        for(var x=0; x<arguments.length; x++){
                                argsStr.push(arguments[x]);
                        }
                        dojo.debug("("+kwArgs.srcObj+")."+kwArgs.srcFunc, ":", argsStr.join(", "));
                };
                this.kwConnect(kwArgs);
        }

        this.connectBefore = function(){
                // summary:
                //              takes the same parameters as dojo.event.connect(), except that
                //              the advice type will always be "before"
                var args = ["before"];
                for(var i = 0; i < arguments.length; i++){ args.push(arguments[i]); }
                return this.connect.apply(this, args); // a MethodJoinPoint object
        }

        this.connectAround = function(){
                // summary:
                //              takes the same parameters as dojo.event.connect(), except that
                //              the advice type will always be "around"
                var args = ["around"];
                for(var i = 0; i < arguments.length; i++){ args.push(arguments[i]); }
                return this.connect.apply(this, args); // a MethodJoinPoint object
        }

        this.connectOnce = function(){
                // summary:
                //              takes the same parameters as dojo.event.connect(), except that
                //              the "once" flag will always be set to "true"
                var ao = interpolateArgs(arguments, true);
                ao.once = true;
                return this.connect(ao); // a MethodJoinPoint object
        }

        this.connectRunOnce = function(){
                // summary:
                //              takes the same parameters as dojo.event.connect(), except that
                //              the "maxCalls" flag will always be set to 1
                var ao = interpolateArgs(arguments, true);
                ao.maxCalls = 1;
                return this.connect(ao); // a MethodJoinPoint object
        }

        this._kwConnectImpl = function(kwArgs, disconnect){
                var fn = (disconnect) ? "disconnect" : "connect";
                if(typeof kwArgs["srcFunc"] == "function"){
                        kwArgs.srcObj = kwArgs["srcObj"]||dj_global;
                        var tmpName  = dojo.lang.nameAnonFunc(kwArgs.srcFunc, kwArgs.srcObj, true);
                        kwArgs.srcFunc = tmpName;
                }
                if(typeof kwArgs["adviceFunc"] == "function"){
                        kwArgs.adviceObj = kwArgs["adviceObj"]||dj_global;
                        var tmpName  = dojo.lang.nameAnonFunc(kwArgs.adviceFunc, kwArgs.adviceObj, true);
                        kwArgs.adviceFunc = tmpName;
                }
                kwArgs.srcObj = kwArgs["srcObj"]||dj_global;
                kwArgs.adviceObj = kwArgs["adviceObj"]||kwArgs["targetObj"]||dj_global;
                kwArgs.adviceFunc = kwArgs["adviceFunc"]||kwArgs["targetFunc"];
                // pass kwargs to avoid unrolling/repacking
                return dojo.event[fn](kwArgs);
        }

        this.kwConnect = function(/*Object*/ kwArgs){
                // summary:
                //              A version of dojo.event.connect() that takes a map of named
                //              parameters instead of the positional parameters that
                //              dojo.event.connect() uses. For many advanced connection types,
                //              this can be a much more readable (and potentially faster)
                //              alternative.
                // kwArgs:
                //              An object that can have the following properties:
                //                      - adviceType
                //                      - srcObj
                //                      - srcFunc
                //                      - adviceObj
                //                      - adviceFunc 
                //                      - aroundObj
                //                      - aroundFunc
                //                      - once
                //                      - delay
                //                      - rate
                //                      - adviceMsg
                //              As with connect, only srcFunc and adviceFunc are generally
                //              required

                return this._kwConnectImpl(kwArgs, false); // a MethodJoinPoint object

        }

        this.disconnect = function(){
                // summary:
                //              Takes the same parameters as dojo.event.connect() but destroys
                //              an existing connection instead of building a new one. For
                //              multiple identical connections, multiple disconnect() calls
                //              will unroll one each time it's called.
                if(arguments.length == 1){
                        var ao = arguments[0];
                }else{
                        var ao = interpolateArgs(arguments, true);
                }
                if(!ao.adviceFunc){ return; } // nothing to disconnect
                if(dojo.lang.isString(ao.srcFunc) && (ao.srcFunc.toLowerCase() == "onkey") ){
                        if(dojo.render.html.ie){
                                ao.srcFunc = "onkeydown";
                                this.disconnect(ao);
                        }
                        ao.srcFunc = "onkeypress";
                }
                if(!ao.srcObj[ao.srcFunc]){ return null; } // prevent un-necessaray joinpoint creation
                var mjp = dojo.event.MethodJoinPoint.getForMethod(ao.srcObj, ao.srcFunc, true);
                mjp.removeAdvice(ao.adviceObj, ao.adviceFunc, ao.adviceType, ao.once); // a MethodJoinPoint object
                return mjp;
        }

        this.kwDisconnect = function(kwArgs){
                // summary:
                //              Takes the same parameters as dojo.event.kwConnect() but
                //              destroys an existing connection instead of building a new one.
                return this._kwConnectImpl(kwArgs, true);
        }
}

// exactly one of these is created whenever a method with a joint point is run,
// if there is at least one 'around' advice.
dojo.event.MethodInvocation = function(/*dojo.event.MethodJoinPoint*/join_point, /*Object*/obj, /*Array*/args){
        // summary:
        //              a class the models the call into a function. This is used under the
        //              covers for all method invocations on both ends of a
        //              connect()-wrapped function dispatch. This allows us to "pickle"
        //              calls, such as in the case of around advice.
        // join_point:
        //              a dojo.event.MethodJoinPoint object that represents a connection
        // obj:
        //              the scope the call will execute in
        // args:
        //              an array of parameters that will get passed to the callee
        this.jp_ = join_point;
        this.object = obj;
        this.args = [];
        // make sure we don't lock into a mutable object which can change under us.
        // It's ok if the individual items change, though.
        for(var x=0; x<args.length; x++){
                this.args[x] = args[x];
        }
        // the index of the 'around' that is currently being executed.
        this.around_index = -1;
}

dojo.event.MethodInvocation.prototype.proceed = function(){
        // summary:
        //              proceed with the method call that's represented by this invocation
        //              object
        this.around_index++;
        if(this.around_index >= this.jp_.around.length){
                return this.jp_.object[this.jp_.methodname].apply(this.jp_.object, this.args);
                // return this.jp_.run_before_after(this.object, this.args);
        }else{
                var ti = this.jp_.around[this.around_index];
                var mobj = ti[0]||dj_global;
                var meth = ti[1];
                return mobj[meth].call(mobj, this);
        }
} 


dojo.event.MethodJoinPoint = function(/*Object*/obj, /*String*/funcName){
        this.object = obj||dj_global;
        this.methodname = funcName;
        this.methodfunc = this.object[funcName];
        this.squelch = false;
        // this.before = [];
        // this.after = [];
        // this.around = [];
}

dojo.event.MethodJoinPoint.getForMethod = function(/*Object*/obj, /*String*/funcName){
        // summary:
        //              "static" class function for returning a MethodJoinPoint from a
        //              scoped function. If one doesn't exist, one is created.
        // obj:
        //              the scope to search for the function in
        // funcName:
        //              the name of the function to return a MethodJoinPoint for
        if(!obj){ obj = dj_global; }
        var ofn = obj[funcName];
        if(!ofn){
                // supply a do-nothing method implementation
                ofn = obj[funcName] = function(){};
                if(!obj[funcName]){
                        // e.g. cannot add to inbuilt objects in IE6
                        dojo.raise("Cannot set do-nothing method on that object "+funcName);
                }
        }else if((typeof ofn != "function")&&(!dojo.lang.isFunction(ofn))&&(!dojo.lang.isAlien(ofn))){
                // FIXME: should we throw an exception here instead?
                return null; 
        }
        // we hide our joinpoint instance in obj[funcName + '$joinpoint']
        var jpname = funcName + "$joinpoint";
        var jpfuncname = funcName + "$joinpoint$method";
        var joinpoint = obj[jpname];
        if(!joinpoint){
                var isNode = false;
                if(dojo.event["browser"]){
                        if( (obj["attachEvent"])||
                                (obj["nodeType"])||
                                (obj["addEventListener"]) ){
                                isNode = true;
                                dojo.event.browser.addClobberNodeAttrs(obj, [jpname, jpfuncname, funcName]);
                        }
                }
                var origArity = ofn.length;
                obj[jpfuncname] = ofn;
                // joinpoint = obj[jpname] = new dojo.event.MethodJoinPoint(obj, funcName);
                joinpoint = obj[jpname] = new dojo.event.MethodJoinPoint(obj, jpfuncname);

                if(!isNode){
                        obj[funcName] = function(){ 
                                // var args = [];
                                // for(var x=0; x<arguments.length; x++){
                                        // args.push(arguments[x]);
                                // }
                                // return joinpoint.run.apply(joinpoint, args); 
                                return joinpoint.run.apply(joinpoint, arguments); 
                        }
                }else{
                        obj[funcName] = function(){ 
                                var args = [];

                                if(!arguments.length){
                                        var evt = null;
                                        try{
                                                if(obj.ownerDocument){
                                                        evt = obj.ownerDocument.parentWindow.event;
                                                }else if(obj.documentElement){
                                                        evt = obj.documentElement.ownerDocument.parentWindow.event;
                                                }else if(obj.event){ //obj is a window
                                                        evt = obj.event;
                                                }else{
                                                        evt = window.event;
                                                }
                                        }catch(e){
                                                evt = window.event;
                                        }

                                        if(evt){
                                                args.push(dojo.event.browser.fixEvent(evt, this));
                                        }
                                }else{
                                        for(var x=0; x<arguments.length; x++){
                                                if((x==0)&&(dojo.event.browser.isEvent(arguments[x]))){
                                                        args.push(dojo.event.browser.fixEvent(arguments[x], this));
                                                }else{
                                                        args.push(arguments[x]);
                                                }
                                        }
                                }
                                // return joinpoint.run.apply(joinpoint, arguments); 
                                return joinpoint.run.apply(joinpoint, args); 
                        }
                }
                obj[funcName].__preJoinArity = origArity;
        }
        return joinpoint; // dojo.event.MethodJoinPoint
}

dojo.lang.extend(dojo.event.MethodJoinPoint, {
        squelch: false,

        unintercept: function(){
                // summary: 
                //              destroy the connection to all listeners that may have been
                //              registered on this joinpoint
                this.object[this.methodname] = this.methodfunc;
                this.before = [];
                this.after = [];
                this.around = [];
        },

        disconnect: dojo.lang.forward("unintercept"),

        run: function(){
                // summary:
                //              execute the connection represented by this join point. The
                //              arguments passed to run() will be passed to the function and
                //              its listeners.
                var obj = this.object||dj_global;
                var args = arguments;

                // optimization. We only compute once the array version of the arguments
                // pseudo-arr in order to prevent building it each time advice is unrolled.
                var aargs = [];
                for(var x=0; x<args.length; x++){
                        aargs[x] = args[x];
                }

                var unrollAdvice  = function(marr){ 
                        if(!marr){
                                dojo.debug("Null argument to unrollAdvice()");
                                return;
                        }
                  
                        var callObj = marr[0]||dj_global;
                        var callFunc = marr[1];
                        
                        if(!callObj[callFunc]){
                                dojo.raise("function \"" + callFunc + "\" does not exist on \"" + callObj + "\"");
                        }
                        
                        var aroundObj = marr[2]||dj_global;
                        var aroundFunc = marr[3];
                        var msg = marr[6];
                        var maxCount = marr[7];
                        if(maxCount > -1){
                                if(maxCount == 0){
                                        return;
                                }
                                marr[7]--;
                        }
                        var undef;

                        var to = {
                                args: [],
                                jp_: this,
                                object: obj,
                                proceed: function(){
                                        return callObj[callFunc].apply(callObj, to.args);
                                }
                        };
                        to.args = aargs;

                        var delay = parseInt(marr[4]);
                        var hasDelay = ((!isNaN(delay))&&(marr[4]!==null)&&(typeof marr[4] != "undefined"));
                        if(marr[5]){
                                var rate = parseInt(marr[5]);
                                var cur = new Date();
                                var timerSet = false;
                                if((marr["last"])&&((cur-marr.last)<=rate)){
                                        if(dojo.event._canTimeout){
                                                if(marr["delayTimer"]){
                                                        clearTimeout(marr.delayTimer);
                                                }
                                                var tod = parseInt(rate*2); // is rate*2 naive?
                                                var mcpy = dojo.lang.shallowCopy(marr);
                                                marr.delayTimer = setTimeout(function(){
                                                        // FIXME: on IE at least, event objects from the
                                                        // browser can go out of scope. How (or should?) we
                                                        // deal with it?
                                                        mcpy[5] = 0;
                                                        unrollAdvice(mcpy);
                                                }, tod);
                                        }
                                        return;
                                }else{
                                        marr.last = cur;
                                }
                        }

                        // FIXME: need to enforce rates for a connection here!

                        if(aroundFunc){
                                // NOTE: around advice can't delay since we might otherwise depend
                                // on execution order!
                                aroundObj[aroundFunc].call(aroundObj, to);
                        }else{
                                // var tmjp = dojo.event.MethodJoinPoint.getForMethod(obj, methname);
                                if((hasDelay)&&((dojo.render.html)||(dojo.render.svg))){  // FIXME: the render checks are grotty!
                                        dj_global["setTimeout"](function(){
                                                if(msg){
                                                        callObj[callFunc].call(callObj, to); 
                                                }else{
                                                        callObj[callFunc].apply(callObj, args); 
                                                }
                                        }, delay);
                                }else{ // many environments can't support delay!
                                        if(msg){
                                                callObj[callFunc].call(callObj, to); 
                                        }else{
                                                callObj[callFunc].apply(callObj, args); 
                                        }
                                }
                        }
                };

                var unRollSquelch = function(){
                        if(this.squelch){
                                try{
                                        return unrollAdvice.apply(this, arguments);
                                }catch(e){ 
                                        dojo.debug(e);
                                }
                        }else{
                                return unrollAdvice.apply(this, arguments);
                        }
                };

                if((this["before"])&&(this.before.length>0)){
                        // pass a cloned array, if this event disconnects this event forEach on this.before wont work
                        dojo.lang.forEach(this.before.concat(new Array()), unRollSquelch);
                }

                var result;
                try{
                        if((this["around"])&&(this.around.length>0)){
                                var mi = new dojo.event.MethodInvocation(this, obj, args);
                                result = mi.proceed();
                        }else if(this.methodfunc){
                                result = this.object[this.methodname].apply(this.object, args);
                        }
                }catch(e){ 
                        if(!this.squelch){ 
                                dojo.debug(e,"when calling",this.methodname,"on",this.object,"with arguments",args);
                                dojo.raise(e);
                        } 
                }

                if((this["after"])&&(this.after.length>0)){
                        // see comment on this.before above
                        dojo.lang.forEach(this.after.concat(new Array()), unRollSquelch);
                }

                return (this.methodfunc) ? result : null;
        },

        getArr: function(/*String*/kind){
                // summary: return a list of listeners of the past "kind"
                // kind:
                //              can be one of: "before", "after", "around", "before-around", or
                //              "after-around"
                var type = "after";
                // FIXME: we should be able to do this through props or Array.in()
                if((typeof kind == "string")&&(kind.indexOf("before")!=-1)){
                        type = "before";
                }else if(kind=="around"){
                        type = "around";
                }
                if(!this[type]){ this[type] = []; }
                return this[type]; // Array
        },

        kwAddAdvice: function(/*Object*/args){
                // summary:
                //              adds advice to the joinpoint with arguments in a map
                // args:
                //              An object that can have the following properties:
                //                      - adviceType
                //                      - adviceObj
                //                      - adviceFunc 
                //                      - aroundObj
                //                      - aroundFunc
                //                      - once
                //                      - delay
                //                      - rate
                //                      - adviceMsg
                //                      - maxCalls
                this.addAdvice( args["adviceObj"], args["adviceFunc"], 
                                                args["aroundObj"], args["aroundFunc"], 
                                                args["adviceType"], args["precedence"], 
                                                args["once"], args["delay"], args["rate"], 
                                                args["adviceMsg"], args["maxCalls"]);
        },

        addAdvice: function(    thisAdviceObj, thisAdvice, 
                                                        thisAroundObj, thisAround, 
                                                        adviceType, precedence, 
                                                        once, delay, rate, asMessage,
                                                        maxCalls){
                // summary:
                //              add advice to this joinpoint using positional parameters
                // thisAdviceObj:
                //              the scope in which to locate/execute the named adviceFunc.
                // thisAdviceFunc:
                //              the name of the function being conected
                // thisAroundObj:
                //              the scope in which to locate/execute the named aroundFunc.
                // thisAroundFunc:
                //              the name of the function that will be used to mediate the
                //              advice call.
                // adviceType: 
                //              Optional. String. One of "before", "after", "around",
                //              "before-around", or "after-around". FIXME
                // once:
                //              boolean that determines whether or not this advice will create
                //              a new connection if an identical advice set has already been
                //              provided. Defaults to "false".
                // delay:
                //              an optional delay (in ms), as an integer, for dispatch of a
                //              listener after the source has been fired.
                // rate:
                //              an optional rate throttling parameter (integer, in ms). When
                //              specified, this particular connection will not fire more than
                //              once in the interval specified by the rate
                // adviceMsg:
                //              boolean. Should the listener have all the parameters passed in
                //              as a single argument?
                // maxCalls:
                //              Integer. The maximum number of times this connection can be
                //              used before being auto-disconnected. -1 signals that the
                //              connection should never be disconnected.
                var arr = this.getArr(adviceType);
                if(!arr){
                        dojo.raise("bad this: " + this);
                }

                var ao = [thisAdviceObj, thisAdvice, thisAroundObj, thisAround, delay, rate, asMessage, maxCalls];
                
                if(once){
                        if(this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr) >= 0){
                                return;
                        }
                }

                if(precedence == "first"){
                        arr.unshift(ao);
                }else{
                        arr.push(ao);
                }
        },

        hasAdvice: function(thisAdviceObj, thisAdvice, adviceType, arr){
                // summary:
                //              returns the array index of the first existing connection
                //              betweened the passed advice and this joinpoint. Will be -1 if
                //              none exists.
                // thisAdviceObj:
                //              the scope in which to locate/execute the named adviceFunc.
                // thisAdviceFunc:
                //              the name of the function being conected
                // adviceType: 
                //              Optional. String. One of "before", "after", "around",
                //              "before-around", or "after-around". FIXME
                // arr:
                //              Optional. The list of advices to search. Will be found via
                //              adviceType if not passed
                if(!arr){ arr = this.getArr(adviceType); }
                var ind = -1;
                for(var x=0; x<arr.length; x++){
                        var aao = (typeof thisAdvice == "object") ? (new String(thisAdvice)).toString() : thisAdvice;
                        var a1o = (typeof arr[x][1] == "object") ? (new String(arr[x][1])).toString() : arr[x][1];
                        if((arr[x][0] == thisAdviceObj)&&(a1o == aao)){
                                ind = x;
                        }
                }
                return ind; // Integer
        },

        removeAdvice: function(thisAdviceObj, thisAdvice, adviceType, once){
                // summary:
                //              returns the array index of the first existing connection
                //              betweened the passed advice and this joinpoint. Will be -1 if
                //              none exists.
                // thisAdviceObj:
                //              the scope in which to locate/execute the named adviceFunc.
                // thisAdviceFunc:
                //              the name of the function being conected
                // adviceType: 
                //              Optional. String. One of "before", "after", "around",
                //              "before-around", or "after-around". FIXME
                // once:
                //              Optional. Should this only remove the first occurance of the
                //              connection?
                var arr = this.getArr(adviceType);
                var ind = this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr);
                if(ind == -1){
                        return false;
                }
                while(ind != -1){
                        arr.splice(ind, 1);
                        if(once){ break; }
                        ind = this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr);
                }
                return true;
        }
});


dojo.provide("dojo.event.topic");

dojo.event.topic = new function(){
        this.topics = {};

        this.getTopic = function(/*String*/topic){
                // summary:
                //              returns a topic implementation object of type
                //              dojo.event.topic.TopicImpl
                // topic:
                //              a unique, opaque string that names the topic
                if(!this.topics[topic]){
                        this.topics[topic] = new this.TopicImpl(topic);
                }
                return this.topics[topic]; // a dojo.event.topic.TopicImpl object
        }

        this.registerPublisher = function(/*String*/topic, /*Object*/obj, /*String*/funcName){
                // summary:
                //              registers a function as a publisher on a topic. Subsequent
                //              calls to the function will cause a publish event on the topic
                //              with the arguments passed to the function passed to registered
                //              listeners.
                // topic: 
                //              a unique, opaque string that names the topic
                // obj:
                //              the scope to locate the function in
                // funcName:
                //              the name of the function to register
                var topic = this.getTopic(topic);
                topic.registerPublisher(obj, funcName);
        }

        this.subscribe = function(/*String*/topic, /*Object*/obj, /*String*/funcName){
                // summary:
                //              susbscribes the function to the topic. Subsequent events
                //              dispached to the topic will create a function call for the
                //              obj.funcName() function.
                // topic: 
                //              a unique, opaque string that names the topic
                // obj:
                //              the scope to locate the function in
                // funcName:
                //              the name of the function to being registered as a listener
                var topic = this.getTopic(topic);
                topic.subscribe(obj, funcName);
        }

        this.unsubscribe = function(/*String*/topic, /*Object*/obj, /*String*/funcName){
                // summary:
                //              unsubscribes the obj.funcName() from the topic
                // topic: 
                //              a unique, opaque string that names the topic
                // obj:
                //              the scope to locate the function in
                // funcName:
                //              the name of the function to being unregistered as a listener
                var topic = this.getTopic(topic);
                topic.unsubscribe(obj, funcName);
        }

        this.destroy = function(/*String*/topic){
                // summary: 
                //              destroys the topic and unregisters all listeners
                // topic:
                //              a unique, opaque string that names the topic
                this.getTopic(topic).destroy();
                delete this.topics[topic];
        }

        this.publishApply = function(/*String*/topic, /*Array*/args){
                // summary: 
                //              dispatches an event to the topic using the args array as the
                //              source for the call arguments to each listener. This is similar
                //              to JavaScript's built-in Function.apply()
                // topic:
                //              a unique, opaque string that names the topic
                // args:
                //              the arguments to be passed into listeners of the topic
                var topic = this.getTopic(topic);
                topic.sendMessage.apply(topic, args);
        }

        this.publish = function(/*String*/topic, /*Object*/message){
                // summary: 
                //              manually "publish" to the passed topic
                // topic:
                //              a unique, opaque string that names the topic
                // message:
                //              can be an array of parameters (similar to publishApply), or
                //              will be treated as one of many arguments to be passed along in
                //              a "flat" unrolling
                var topic = this.getTopic(topic);
                // if message is an array, we treat it as a set of arguments,
                // otherwise, we just pass on the arguments passed in as-is
                var args = [];
                // could we use concat instead here?
                for(var x=1; x<arguments.length; x++){
                        args.push(arguments[x]);
                }
                topic.sendMessage.apply(topic, args);
        }
}

dojo.event.topic.TopicImpl = function(topicName){
        // summary: a class to represent topics

        this.topicName = topicName;

        this.subscribe = function(/*Object*/listenerObject, /*Function or String*/listenerMethod){
                // summary:
                //              use dojo.event.connect() to attach the passed listener to the
                //              topic represented by this object
                // listenerObject:
                //              if a string and listenerMethod is ommitted, this is treated as
                //              the name of a function in the global namespace. If
                //              listenerMethod is provided, this is the scope to find/execute
                //              the function in.
                // listenerMethod:
                //              Optional. The function to register.
                var tf = listenerMethod||listenerObject;
                var to = (!listenerMethod) ? dj_global : listenerObject;
                return dojo.event.kwConnect({ // dojo.event.MethodJoinPoint
                        srcObj:         this, 
                        srcFunc:        "sendMessage", 
                        adviceObj:      to,
                        adviceFunc: tf
                });
        }

        this.unsubscribe = function(/*Object*/listenerObject, /*Function or String*/listenerMethod){
                // summary:
                //              use dojo.event.disconnect() to attach the passed listener to the
                //              topic represented by this object
                // listenerObject:
                //              if a string and listenerMethod is ommitted, this is treated as
                //              the name of a function in the global namespace. If
                //              listenerMethod is provided, this is the scope to find the
                //              function in.
                // listenerMethod:
                //              Optional. The function to unregister.
                var tf = (!listenerMethod) ? listenerObject : listenerMethod;
                var to = (!listenerMethod) ? null : listenerObject;
                return dojo.event.kwDisconnect({ // dojo.event.MethodJoinPoint
                        srcObj:         this, 
                        srcFunc:        "sendMessage", 
                        adviceObj:      to,
                        adviceFunc: tf
                });
        }

        this._getJoinPoint = function(){
                return dojo.event.MethodJoinPoint.getForMethod(this, "sendMessage");
        }

        this.setSquelch = function(/*Boolean*/shouldSquelch){
                // summary: 
                //              determine whether or not exceptions in the calling of a
                //              listener in the chain should stop execution of the chain.
                this._getJoinPoint().squelch = shouldSquelch;
        }

        this.destroy = function(){
                // summary: disconnects all listeners from this topic
                this._getJoinPoint().disconnect();
        }

        this.registerPublisher = function(      /*Object*/publisherObject, 
                                                                                /*Function or String*/publisherMethod){
                // summary:
                //              registers the passed function as a publisher on this topic.
                //              Each time the function is called, an event will be published on
                //              this topic.
                // publisherObject:
                //              if a string and listenerMethod is ommitted, this is treated as
                //              the name of a function in the global namespace. If
                //              listenerMethod is provided, this is the scope to find the
                //              function in.
                // publisherMethod:
                //              Optional. The function to register.
                dojo.event.connect(publisherObject, publisherMethod, this, "sendMessage");
        }

        this.sendMessage = function(message){
                // summary: a stub to be called when a message is sent to the topic.

                // The message has been propagated
        }
}


dojo.provide("dojo.event.browser");


// FIXME: any particular reason this is in the global scope?
dojo._ie_clobber = new function(){
        this.clobberNodes = [];

        function nukeProp(node, prop){
                // try{ node.removeAttribute(prop);     }catch(e){ /* squelch */ }
                try{ node[prop] = null;                         }catch(e){ /* squelch */ }
                try{ delete node[prop];                         }catch(e){ /* squelch */ }
                // FIXME: JotLive needs this, but I'm not sure if it's too slow or not
                try{ node.removeAttribute(prop);        }catch(e){ /* squelch */ }
        }

        this.clobber = function(nodeRef){
                var na;
                var tna;
                if(nodeRef){
                        tna = nodeRef.all || nodeRef.getElementsByTagName("*");
                        na = [nodeRef];
                        for(var x=0; x<tna.length; x++){
                                // if we're gonna be clobbering the thing, at least make sure
                                // we aren't trying to do it twice
                                if(tna[x]["__doClobber__"]){
                                        na.push(tna[x]);
                                }
                        }
                }else{
                        try{ window.onload = null; }catch(e){}
                        na = (this.clobberNodes.length) ? this.clobberNodes : document.all;
                }
                tna = null;
                var basis = {};
                for(var i = na.length-1; i>=0; i=i-1){
                        var el = na[i];
                        try{
                                if(el && el["__clobberAttrs__"]){
                                        for(var j=0; j<el.__clobberAttrs__.length; j++){
                                                nukeProp(el, el.__clobberAttrs__[j]);
                                        }
                                        nukeProp(el, "__clobberAttrs__");
                                        nukeProp(el, "__doClobber__");
                                }
                        }catch(e){ /* squelch! */};
                }
                na = null;
        }
}

if(dojo.render.html.ie){
        dojo.addOnUnload(function(){
                dojo._ie_clobber.clobber();
                try{
                        if((dojo["widget"])&&(dojo.widget["manager"])){
                                dojo.widget.manager.destroyAll();
                        }
                }catch(e){}

                // Workaround for IE leak recommended in ticket #1727 by schallm
                if(dojo.widget){
                        for(var name in dojo.widget._templateCache){
                                if(dojo.widget._templateCache[name].node){
                                        dojo.dom.destroyNode(dojo.widget._templateCache[name].node);
                                        dojo.widget._templateCache[name].node = null;
                                        delete dojo.widget._templateCache[name].node;
                                }
                        }
                }

                try{ window.onload = null; }catch(e){}
                try{ window.onunload = null; }catch(e){}
                dojo._ie_clobber.clobberNodes = [];
                // CollectGarbage();
        });
}

dojo.event.browser = new function(){

        var clobberIdx = 0;

        this.normalizedEventName = function(/*String*/eventName){
                switch(eventName){
                        case "CheckboxStateChange":
                        case "DOMAttrModified":
                        case "DOMMenuItemActive":
                        case "DOMMenuItemInactive":
                        case "DOMMouseScroll":
                        case "DOMNodeInserted":
                        case "DOMNodeRemoved":
                        case "RadioStateChange":
                                return eventName;
                                break;
                        default:
                                var lcn = eventName.toLowerCase();
                                return (lcn.indexOf("on") == 0) ? lcn.substr(2) : lcn;
                                break;
                }
        }
        
        this.clean = function(/*DOMNode*/node){
                // summary:
                //              removes native event handlers so that destruction of the node
                //              will not leak memory. On most browsers this is a no-op, but
                //              it's critical for manual node removal on IE.
                // node:
                //              A DOM node. All of it's children will also be cleaned.
                if(dojo.render.html.ie){ 
                        dojo._ie_clobber.clobber(node);
                }
        }

        this.addClobberNode = function(/*DOMNode*/node){
                // summary:
                //              register the passed node to support event stripping
                // node:
                //              A DOM node
                if(!dojo.render.html.ie){ return; }
                if(!node["__doClobber__"]){
                        node.__doClobber__ = true;
                        dojo._ie_clobber.clobberNodes.push(node);
                        // this might not be the most efficient thing to do, but it's
                        // much less error prone than other approaches which were
                        // previously tried and failed
                        node.__clobberAttrs__ = [];
                }
        }

        this.addClobberNodeAttrs = function(/*DOMNode*/node, /*Array*/props){
                // summary:
                //              register the passed node to support event stripping
                // node:
                //              A DOM node to stip properties from later
                // props:
                //              A list of propeties to strip from the node
                if(!dojo.render.html.ie){ return; }
                this.addClobberNode(node);
                for(var x=0; x<props.length; x++){
                        node.__clobberAttrs__.push(props[x]);
                }
        }

        this.removeListener = function( /*DOMNode*/ node, 
                                                                        /*String*/      evtName, 
                                                                        /*Function*/fp, 
                                                                        /*Boolean*/     capture){
                // summary:
                //              clobbers the listener from the node
                // evtName:
                //              the name of the handler to remove the function from
                // node:
                //              DOM node to attach the event to
                // fp:
                //              the function to register
                // capture:
                //              Optional. should this listener prevent propigation?
                if(!capture){ var capture = false; }
                evtName = dojo.event.browser.normalizedEventName(evtName);
                if(evtName == "key"){
                        if(dojo.render.html.ie){
                                this.removeListener(node, "onkeydown", fp, capture);
                        }
                        evtName = "keypress";
                }
                // FIXME: this is mostly a punt, we aren't actually doing anything on IE
                if(node.removeEventListener){
                        node.removeEventListener(evtName, fp, capture);
                }
        }

        this.addListener = function(/*DOMNode*/node, /*String*/evtName, /*Function*/fp, /*Boolean*/capture, /*Boolean*/dontFix){
                // summary:
                //              adds a listener to the node
                // evtName:
                //              the name of the handler to add the listener to can be either of
                //              the form "onclick" or "click"
                // node:
                //              DOM node to attach the event to
                // fp:
                //              the function to register
                // capture:
                //              Optional. Should this listener prevent propigation?
                // dontFix:
                //              Optional. Should we avoid registering a new closure around the
                //              listener to enable fixEvent for dispatch of the registered
                //              function?
                if(!node){ return; } // FIXME: log and/or bail?
                if(!capture){ var capture = false; }
                evtName = dojo.event.browser.normalizedEventName(evtName);
                if(evtName == "key"){
                        if(dojo.render.html.ie){
                                this.addListener(node, "onkeydown", fp, capture, dontFix);
                        }
                        evtName = "keypress";
                }

                if(!dontFix){
                        // build yet another closure around fp in order to inject fixEvent
                        // around the resulting event
                        var newfp = function(evt){
                                if(!evt){ evt = window.event; }
                                var ret = fp(dojo.event.browser.fixEvent(evt, this));
                                if(capture){
                                        dojo.event.browser.stopEvent(evt);
                                }
                                return ret;
                        }
                }else{
                        newfp = fp;
                }

                if(node.addEventListener){ 
                        node.addEventListener(evtName, newfp, capture);
                        return newfp;
                }else{
                        evtName = "on"+evtName;
                        if(typeof node[evtName] == "function" ){
                                var oldEvt = node[evtName];
                                node[evtName] = function(e){
                                        oldEvt(e);
                                        return newfp(e);
                                }
                        }else{
                                node[evtName]=newfp;
                        }
                        if(dojo.render.html.ie){
                                this.addClobberNodeAttrs(node, [evtName]);
                        }
                        return newfp;
                }
        }

        this.isEvent = function(/*Object*/obj){
                // summary: 
                //              Tries to determine whether or not the object is a DOM event.

                // FIXME: event detection hack ... could test for additional attributes
                // if necessary
                return (typeof obj != "undefined")&&(obj)&&(typeof Event != "undefined")&&(obj.eventPhase); // Boolean
                // Event does not support instanceof in Opera, otherwise:
                //return (typeof Event != "undefined")&&(obj instanceof Event);
        }

        this.currentEvent = null;
        
        this.callListener = function(/*Function*/listener, /*DOMNode*/curTarget){
                // summary:
                //              calls the specified listener in the context of the passed node
                //              with the current DOM event object as the only parameter
                // listener:
                //              the function to call
                // curTarget:
                //              the Node to call the function in the scope of
                if(typeof listener != 'function'){
                        dojo.raise("listener not a function: " + listener);
                }
                dojo.event.browser.currentEvent.currentTarget = curTarget;
                return listener.call(curTarget, dojo.event.browser.currentEvent);
        }

        this._stopPropagation = function(){
                dojo.event.browser.currentEvent.cancelBubble = true; 
        }

        this._preventDefault = function(){
                dojo.event.browser.currentEvent.returnValue = false;
        }

        this.keys = {
                KEY_BACKSPACE: 8,
                KEY_TAB: 9,
                KEY_CLEAR: 12,
                KEY_ENTER: 13,
                KEY_SHIFT: 16,
                KEY_CTRL: 17,
                KEY_ALT: 18,
                KEY_PAUSE: 19,
                KEY_CAPS_LOCK: 20,
                KEY_ESCAPE: 27,
                KEY_SPACE: 32,
                KEY_PAGE_UP: 33,
                KEY_PAGE_DOWN: 34,
                KEY_END: 35,
                KEY_HOME: 36,
                KEY_LEFT_ARROW: 37,
                KEY_UP_ARROW: 38,
                KEY_RIGHT_ARROW: 39,
                KEY_DOWN_ARROW: 40,
                KEY_INSERT: 45,
                KEY_DELETE: 46,
                KEY_HELP: 47,
                KEY_LEFT_WINDOW: 91,
                KEY_RIGHT_WINDOW: 92,
                KEY_SELECT: 93,
                KEY_NUMPAD_0: 96,
                KEY_NUMPAD_1: 97,
                KEY_NUMPAD_2: 98,
                KEY_NUMPAD_3: 99,
                KEY_NUMPAD_4: 100,
                KEY_NUMPAD_5: 101,
                KEY_NUMPAD_6: 102,
                KEY_NUMPAD_7: 103,
                KEY_NUMPAD_8: 104,
                KEY_NUMPAD_9: 105,
                KEY_NUMPAD_MULTIPLY: 106,
                KEY_NUMPAD_PLUS: 107,
                KEY_NUMPAD_ENTER: 108,
                KEY_NUMPAD_MINUS: 109,
                KEY_NUMPAD_PERIOD: 110,
                KEY_NUMPAD_DIVIDE: 111,
                KEY_F1: 112,
                KEY_F2: 113,
                KEY_F3: 114,
                KEY_F4: 115,
                KEY_F5: 116,
                KEY_F6: 117,
                KEY_F7: 118,
                KEY_F8: 119,
                KEY_F9: 120,
                KEY_F10: 121,
                KEY_F11: 122,
                KEY_F12: 123,
                KEY_F13: 124,
                KEY_F14: 125,
                KEY_F15: 126,
                KEY_NUM_LOCK: 144,
                KEY_SCROLL_LOCK: 145
        };

        // reverse lookup
        this.revKeys = [];
        for(var key in this.keys){
                this.revKeys[this.keys[key]] = key;
        }

        this.fixEvent = function(/*Event*/evt, /*DOMNode*/sender){
                // summary:
                //              normalizes properties on the event object including event
                //              bubbling methods, keystroke normalization, and x/y positions
                // evt: the native event object
                // sender: the node to treat as "currentTarget"
                if(!evt){
                        if(window["event"]){
                                evt = window.event;
                        }
                }
                
                if((evt["type"])&&(evt["type"].indexOf("key") == 0)){ // key events
                        evt.keys = this.revKeys;
                        // FIXME: how can we eliminate this iteration?
                        for(var key in this.keys){
                                evt[key] = this.keys[key];
                        }
                        if(evt["type"] == "keydown" && dojo.render.html.ie){
                                switch(evt.keyCode){
                                        case evt.KEY_SHIFT:
                                        case evt.KEY_CTRL:
                                        case evt.KEY_ALT:
                                        case evt.KEY_CAPS_LOCK:
                                        case evt.KEY_LEFT_WINDOW:
                                        case evt.KEY_RIGHT_WINDOW:
                                        case evt.KEY_SELECT:
                                        case evt.KEY_NUM_LOCK:
                                        case evt.KEY_SCROLL_LOCK:
                                        // I'll get these in keypress after the OS munges them based on numlock
                                        case evt.KEY_NUMPAD_0:
                                        case evt.KEY_NUMPAD_1:
                                        case evt.KEY_NUMPAD_2:
                                        case evt.KEY_NUMPAD_3:
                                        case evt.KEY_NUMPAD_4:
                                        case evt.KEY_NUMPAD_5:
                                        case evt.KEY_NUMPAD_6:
                                        case evt.KEY_NUMPAD_7:
                                        case evt.KEY_NUMPAD_8:
                                        case evt.KEY_NUMPAD_9:
                                        case evt.KEY_NUMPAD_PERIOD:
                                                break; // just ignore the keys that can morph
                                        case evt.KEY_NUMPAD_MULTIPLY:
                                        case evt.KEY_NUMPAD_PLUS:
                                        case evt.KEY_NUMPAD_ENTER:
                                        case evt.KEY_NUMPAD_MINUS:
                                        case evt.KEY_NUMPAD_DIVIDE:
                                                break; // I could handle these but just pick them up in keypress
                                        case evt.KEY_PAUSE:
                                        case evt.KEY_TAB:
                                        case evt.KEY_BACKSPACE:
                                        case evt.KEY_ENTER:
                                        case evt.KEY_ESCAPE:
                                        case evt.KEY_PAGE_UP:
                                        case evt.KEY_PAGE_DOWN:
                                        case evt.KEY_END:
                                        case evt.KEY_HOME:
                                        case evt.KEY_LEFT_ARROW:
                                        case evt.KEY_UP_ARROW:
                                        case evt.KEY_RIGHT_ARROW:
                                        case evt.KEY_DOWN_ARROW:
                                        case evt.KEY_INSERT:
                                        case evt.KEY_DELETE:
                                        case evt.KEY_F1:
                                        case evt.KEY_F2:
                                        case evt.KEY_F3:
                                        case evt.KEY_F4:
                                        case evt.KEY_F5:
                                        case evt.KEY_F6:
                                        case evt.KEY_F7:
                                        case evt.KEY_F8:
                                        case evt.KEY_F9:
                                        case evt.KEY_F10:
                                        case evt.KEY_F11:
                                        case evt.KEY_F12:
                                        case evt.KEY_F12:
                                        case evt.KEY_F13:
                                        case evt.KEY_F14:
                                        case evt.KEY_F15:
                                        case evt.KEY_CLEAR:
                                        case evt.KEY_HELP:
                                                evt.key = evt.keyCode;
                                                break;
                                        default:
                                                if(evt.ctrlKey || evt.altKey){
                                                        var unifiedCharCode = evt.keyCode;
                                                        // if lower case but keycode is uppercase, convert it
                                                        if(unifiedCharCode >= 65 && unifiedCharCode <= 90 && evt.shiftKey == false){
                                                                unifiedCharCode += 32;
                                                        }
                                                        if(unifiedCharCode >= 1 && unifiedCharCode <= 26 && evt.ctrlKey){
                                                                unifiedCharCode += 96; // 001-032 = ctrl+[a-z]
                                                        }
                                                        evt.key = String.fromCharCode(unifiedCharCode);
                                                }
                                }
                        } else if(evt["type"] == "keypress"){
                                if(dojo.render.html.opera){
                                        if(evt.which == 0){
                                                evt.key = evt.keyCode;
                                        }else if(evt.which > 0){
                                                switch(evt.which){
                                                        case evt.KEY_SHIFT:
                                                        case evt.KEY_CTRL:
                                                        case evt.KEY_ALT:
                                                        case evt.KEY_CAPS_LOCK:
                                                        case evt.KEY_NUM_LOCK:
                                                        case evt.KEY_SCROLL_LOCK:
                                                                break;
                                                        case evt.KEY_PAUSE:
                                                        case evt.KEY_TAB:
                                                        case evt.KEY_BACKSPACE:
                                                        case evt.KEY_ENTER:
                                                        case evt.KEY_ESCAPE:
                                                                evt.key = evt.which;
                                                                break;
                                                        default:
                                                                var unifiedCharCode = evt.which;
                                                                if((evt.ctrlKey || evt.altKey || evt.metaKey) && (evt.which >= 65 && evt.which <= 90 && evt.shiftKey == false)){
                                                                        unifiedCharCode += 32;
                                                                }
                                                                evt.key = String.fromCharCode(unifiedCharCode);
                                                }
                                        }
                                }else if(dojo.render.html.ie){ // catch some IE keys that are hard to get in keyDown
                                        // key combinations were handled in onKeyDown
                                        if(!evt.ctrlKey && !evt.altKey && evt.keyCode >= evt.KEY_SPACE){
                                                evt.key = String.fromCharCode(evt.keyCode);
                                        }
                                }else if(dojo.render.html.safari){
                                        switch(evt.keyCode){
                                                case 25: evt.key = evt.KEY_TAB; evt.shift = true;break;
                                                case 63232: evt.key = evt.KEY_UP_ARROW; break;
                                                case 63233: evt.key = evt.KEY_DOWN_ARROW; break;
                                                case 63234: evt.key = evt.KEY_LEFT_ARROW; break;
                                                case 63235: evt.key = evt.KEY_RIGHT_ARROW; break;
                                                case 63236: evt.key = evt.KEY_F1; break;
                                                case 63237: evt.key = evt.KEY_F2; break;
                                                case 63238: evt.key = evt.KEY_F3; break;
                                                case 63239: evt.key = evt.KEY_F4; break;
                                                case 63240: evt.key = evt.KEY_F5; break;
                                                case 63241: evt.key = evt.KEY_F6; break;
                                                case 63242: evt.key = evt.KEY_F7; break;
                                                case 63243: evt.key = evt.KEY_F8; break;
                                                case 63244: evt.key = evt.KEY_F9; break;
                                                case 63245: evt.key = evt.KEY_F10; break;
                                                case 63246: evt.key = evt.KEY_F11; break;
                                                case 63247: evt.key = evt.KEY_F12; break;
                                                case 63250: evt.key = evt.KEY_PAUSE; break;
                                                case 63272: evt.key = evt.KEY_DELETE; break;
                                                case 63273: evt.key = evt.KEY_HOME; break;
                                                case 63275: evt.key = evt.KEY_END; break;
                                                case 63276: evt.key = evt.KEY_PAGE_UP; break;
                                                case 63277: evt.key = evt.KEY_PAGE_DOWN; break;
                                                case 63302: evt.key = evt.KEY_INSERT; break;
                                                case 63248://prtscr
                                                case 63249://scrolllock
                                                case 63289://numlock
                                                        break;
                                                default: 
                                                        evt.key = evt.charCode >= evt.KEY_SPACE ? String.fromCharCode(evt.charCode) : evt.keyCode;
                                        }
                                }else{
                                        evt.key = evt.charCode > 0 ? String.fromCharCode(evt.charCode) : evt.keyCode;
                                }
                        }
                }
                if(dojo.render.html.ie){
                        if(!evt.target){ evt.target = evt.srcElement; }
                        if(!evt.currentTarget){ evt.currentTarget = (sender ? sender : evt.srcElement); }
                        if(!evt.layerX){ evt.layerX = evt.offsetX; }
                        if(!evt.layerY){ evt.layerY = evt.offsetY; }
                        // FIXME: scroll position query is duped from dojo.html to avoid dependency on that entire module
                        // DONOT replace the following to use dojo.body(), in IE, document.documentElement should be used
                        // here rather than document.body
                        var doc = (evt.srcElement && evt.srcElement.ownerDocument) ? evt.srcElement.ownerDocument : document;
                        var docBody = ((dojo.render.html.ie55)||(doc["compatMode"] == "BackCompat")) ? doc.body : doc.documentElement;
                        if(!evt.pageX){ evt.pageX = evt.clientX + (docBody.scrollLeft || 0) }
                        if(!evt.pageY){ evt.pageY = evt.clientY + (docBody.scrollTop || 0) }
                        // mouseover
                        if(evt.type == "mouseover"){ evt.relatedTarget = evt.fromElement; }
                        // mouseout
                        if(evt.type == "mouseout"){ evt.relatedTarget = evt.toElement; }
                        this.currentEvent = evt;
                        evt.callListener = this.callListener;
                        evt.stopPropagation = this._stopPropagation;
                        evt.preventDefault = this._preventDefault;
                }
                return evt; // Event
        }

        this.stopEvent = function(/*Event*/evt){
                // summary:
                //              prevents propigation and clobbers the default action of the
                //              passed event
                // evt: Optional for IE. The native event object.
                if(window.event){
                        evt.cancelBubble = true;
                        evt.returnValue = false;
                }else{
                        evt.preventDefault();
                        evt.stopPropagation();
                }
        }
}

dojo.kwCompoundRequire({
        common: ["dojo.event.common", "dojo.event.topic"],
        browser: ["dojo.event.browser"],
        dashboard: ["dojo.event.browser"]
});
dojo.provide("dojo.event.*");

dojo.provide("dojo.gfx.color");



// TODO: rewrite the "x2y" methods to take advantage of the parsing
//       abilities of the Color object. Also, beef up the Color
//       object (as possible) to parse most common formats

// takes an r, g, b, a(lpha) value, [r, g, b, a] array, "rgb(...)" string, hex string (#aaa, #aaaaaa, aaaaaaa)
dojo.gfx.color.Color = function(r, g, b, a) {
        // dojo.debug("r:", r[0], "g:", r[1], "b:", r[2]);
        if(dojo.lang.isArray(r)){
                this.r = r[0];
                this.g = r[1];
                this.b = r[2];
                this.a = r[3]||1.0;
        }else if(dojo.lang.isString(r)){
                var rgb = dojo.gfx.color.extractRGB(r);
                this.r = rgb[0];
                this.g = rgb[1];
                this.b = rgb[2];
                this.a = g||1.0;
        }else if(r instanceof dojo.gfx.color.Color){
                // why does this create a new instance if we were passed one?
                this.r = r.r;
                this.b = r.b;
                this.g = r.g;
                this.a = r.a;
        }else{
                this.r = r;
                this.g = g;
                this.b = b;
                this.a = a;
        }
}

dojo.gfx.color.Color.fromArray = function(arr) {
        return new dojo.gfx.color.Color(arr[0], arr[1], arr[2], arr[3]);
}

dojo.extend(dojo.gfx.color.Color, {
        toRgb: function(includeAlpha) {
                if(includeAlpha) {
                        return this.toRgba();
                } else {
                        return [this.r, this.g, this.b];
                }
        },
        toRgba: function() {
                return [this.r, this.g, this.b, this.a];
        },
        toHex: function() {
                return dojo.gfx.color.rgb2hex(this.toRgb());
        },
        toCss: function() {
                return "rgb(" + this.toRgb().join() + ")";
        },
        toString: function() {
                return this.toHex(); // decent default?
        },
        blend: function(color, weight){
                var rgb = null;
                if(dojo.lang.isArray(color)){
                        rgb = color;
                }else if(color instanceof dojo.gfx.color.Color){
                        rgb = color.toRgb();
                }else{
                        rgb = new dojo.gfx.color.Color(color).toRgb();
                }
                return dojo.gfx.color.blend(this.toRgb(), rgb, weight);
        }
});

dojo.gfx.color.named = {
        white:      [255,255,255],
        black:      [0,0,0],
        red:        [255,0,0],
        green:      [0,255,0],
        lime:       [0,255,0],
        blue:       [0,0,255],
        navy:       [0,0,128],
        gray:       [128,128,128],
        silver:     [192,192,192]
};

dojo.gfx.color.blend = function(a, b, weight){
        // summary: 
        //              blend colors a and b (both as RGB array or hex strings) with weight
        //              from -1 to +1, 0 being a 50/50 blend
        if(typeof a == "string"){
                return dojo.gfx.color.blendHex(a, b, weight);
        }
        if(!weight){
                weight = 0;
        }
        weight = Math.min(Math.max(-1, weight), 1);

        // alex: this interface blows.
        // map -1 to 1 to the range 0 to 1
        weight = ((weight + 1)/2);
        
        var c = [];

        // var stop = (1000*weight);
        for(var x = 0; x < 3; x++){
                c[x] = parseInt( b[x] + ( (a[x] - b[x]) * weight) );
        }
        return c;
}

// very convenient blend that takes and returns hex values
// (will get called automatically by blend when blend gets strings)
dojo.gfx.color.blendHex = function(a, b, weight) {
        return dojo.gfx.color.rgb2hex(dojo.gfx.color.blend(dojo.gfx.color.hex2rgb(a), dojo.gfx.color.hex2rgb(b), weight));
}

// get RGB array from css-style color declarations
dojo.gfx.color.extractRGB = function(color) {
        var hex = "0123456789abcdef";
        color = color.toLowerCase();
        if( color.indexOf("rgb") == 0 ) {
                var matches = color.match(/rgba*\((\d+), *(\d+), *(\d+)/i);
                var ret = matches.splice(1, 3);
                return ret;
        } else {
                var colors = dojo.gfx.color.hex2rgb(color);
                if(colors) {
                        return colors;
                } else {
                        // named color (how many do we support?)
                        return dojo.gfx.color.named[color] || [255, 255, 255];
                }
        }
}

dojo.gfx.color.hex2rgb = function(hex) {
        var hexNum = "0123456789ABCDEF";
        var rgb = new Array(3);
        if( hex.indexOf("#") == 0 ) { hex = hex.substring(1); }
        hex = hex.toUpperCase();
        if(hex.replace(new RegExp("["+hexNum+"]", "g"), "") != "") {
                return null;
        }
        if( hex.length == 3 ) {
                rgb[0] = hex.charAt(0) + hex.charAt(0)
                rgb[1] = hex.charAt(1) + hex.charAt(1)
                rgb[2] = hex.charAt(2) + hex.charAt(2);
        } else {
                rgb[0] = hex.substring(0, 2);
                rgb[1] = hex.substring(2, 4);
                rgb[2] = hex.substring(4);
        }
        for(var i = 0; i < rgb.length; i++) {
                rgb[i] = hexNum.indexOf(rgb[i].charAt(0)) * 16 + hexNum.indexOf(rgb[i].charAt(1));
        }
        return rgb;
}

dojo.gfx.color.rgb2hex = function(r, g, b) {
        if(dojo.lang.isArray(r)) {
                g = r[1] || 0;
                b = r[2] || 0;
                r = r[0] || 0;
        }
        var ret = dojo.lang.map([r, g, b], function(x) {
                x = new Number(x);
                var s = x.toString(16);
                while(s.length < 2) { s = "0" + s; }
                return s;
        });
        ret.unshift("#");
        return ret.join("");
}

dojo.provide("dojo.lfx.Animation");



/*
        Animation package based on Dan Pupius' work: http://pupius.co.uk/js/Toolkit.Drawing.js
*/
dojo.lfx.Line = function(/*int*/ start, /*int*/ end){
        // summary: dojo.lfx.Line is the object used to generate values
        //                      from a start value to an end value
        this.start = start;
        this.end = end;
        if(dojo.lang.isArray(start)){
                /* start: Array
                   end: Array
                   pId: a */
                var diff = [];
                dojo.lang.forEach(this.start, function(s,i){
                        diff[i] = this.end[i] - s;
                }, this);
                
                this.getValue = function(/*float*/ n){
                        var res = [];
                        dojo.lang.forEach(this.start, function(s, i){
                                res[i] = (diff[i] * n) + s;
                        }, this);
                        return res; // Array
                }
        }else{
                var diff = end - start;
                        
                this.getValue = function(/*float*/ n){
                        //      summary: returns the point on the line
                        //      n: a floating point number greater than 0 and less than 1
                        return (diff * n) + this.start; // Decimal
                }
        }
}

if((dojo.render.html.khtml)&&(!dojo.render.html.safari)){
        // the cool kids are obviously not using konqueror...
        // found a very wierd bug in floats constants, 1.5 evals as 1
        // seems somebody mixed up ints and floats in 3.5.4 ??
        // FIXME: investigate more and post a KDE bug (Fredrik)
        dojo.lfx.easeDefault = function(/*Decimal?*/ n){
                //      summary: Returns the point for point n on a sin wave.
                return (parseFloat("0.5")+((Math.sin( (n+parseFloat("1.5")) * Math.PI))/2));
        }
}else{
        dojo.lfx.easeDefault = function(/*Decimal?*/ n){
                return (0.5+((Math.sin( (n+1.5) * Math.PI))/2));
        }
}

dojo.lfx.easeIn = function(/*Decimal?*/ n){
        //      summary: returns the point on an easing curve
        //      n: a floating point number greater than 0 and less than 1
        return Math.pow(n, 3);
}

dojo.lfx.easeOut = function(/*Decimal?*/ n){
        //      summary: returns the point on the line
        //      n: a floating point number greater than 0 and less than 1
        return ( 1 - Math.pow(1 - n, 3) );
}

dojo.lfx.easeInOut = function(/*Decimal?*/ n){
        //      summary: returns the point on the line
        //      n: a floating point number greater than 0 and less than 1
        return ( (3 * Math.pow(n, 2)) - (2 * Math.pow(n, 3)) );
}

dojo.lfx.IAnimation = function(){
        // summary: dojo.lfx.IAnimation is an interface that implements
        //                      commonly used functions of animation objects
}
dojo.lang.extend(dojo.lfx.IAnimation, {
        // public properties
        curve: null,
        duration: 1000,
        easing: null,
        repeatCount: 0,
        rate: 10,
        
        // events
        handler: null,
        beforeBegin: null,
        onBegin: null,
        onAnimate: null,
        onEnd: null,
        onPlay: null,
        onPause: null,
        onStop: null,
        
        // public methods
        play: null,
        pause: null,
        stop: null,
        
        connect: function(/*Event*/ evt, /*Object*/ scope, /*Function*/ newFunc){
                // summary: Convenience function.  Quickly connect to an event
                //                      of this object and save the old functions connected to it.
                // evt: The name of the event to connect to.
                // scope: the scope in which to run newFunc.
                // newFunc: the function to run when evt is fired.
                if(!newFunc){
                        /* scope: Function
                           newFunc: null
                           pId: f */
                        newFunc = scope;
                        scope = this;
                }
                newFunc = dojo.lang.hitch(scope, newFunc);
                var oldFunc = this[evt]||function(){};
                this[evt] = function(){
                        var ret = oldFunc.apply(this, arguments);
                        newFunc.apply(this, arguments);
                        return ret;
                }
                return this; // dojo.lfx.IAnimation
        },

        fire: function(/*Event*/ evt, /*Array*/ args){
                // summary: Convenience function.  Fire event "evt" and pass it
                //                      the arguments specified in "args".
                // evt: The event to fire.
                // args: The arguments to pass to the event.
                if(this[evt]){
                        this[evt].apply(this, (args||[]));
                }
                return this; // dojo.lfx.IAnimation
        },
        
        repeat: function(/*int*/ count){
                // summary: Set the repeat count of this object.
                // count: How many times to repeat the animation.
                this.repeatCount = count;
                return this; // dojo.lfx.IAnimation
        },

        // private properties
        _active: false,
        _paused: false
});

dojo.lfx.Animation = function(  /*Object*/ handlers, 
                                                                /*int*/ duration, 
                                                                /*dojo.lfx.Line*/ curve, 
                                                                /*function*/ easing, 
                                                                /*int*/ repeatCount, 
                                                                /*int*/ rate){
        //      summary
        //              a generic animation object that fires callbacks into it's handlers
        //              object at various states
        //      handlers: { handler: Function?, onstart: Function?, onstop: Function?, onanimate: Function? }
        dojo.lfx.IAnimation.call(this);
        if(dojo.lang.isNumber(handlers)||(!handlers && duration.getValue)){
                // no handlers argument:
                rate = repeatCount;
                repeatCount = easing;
                easing = curve;
                curve = duration;
                duration = handlers;
                handlers = null;
        }else if(handlers.getValue||dojo.lang.isArray(handlers)){
                // no handlers or duration:
                rate = easing;
                repeatCount = curve;
                easing = duration;
                curve = handlers;
                duration = null;
                handlers = null;
        }
        if(dojo.lang.isArray(curve)){
                /* curve: Array
                   pId: a */
                this.curve = new dojo.lfx.Line(curve[0], curve[1]);
        }else{
                this.curve = curve;
        }
        if(duration != null && duration > 0){ this.duration = duration; }
        if(repeatCount){ this.repeatCount = repeatCount; }
        if(rate){ this.rate = rate; }
        if(handlers){
                dojo.lang.forEach([
                                "handler", "beforeBegin", "onBegin", 
                                "onEnd", "onPlay", "onStop", "onAnimate"
                        ], function(item){
                                if(handlers[item]){
                                        this.connect(item, handlers[item]);
                                }
                        }, this);
        }
        if(easing && dojo.lang.isFunction(easing)){
                this.easing=easing;
        }
}
dojo.inherits(dojo.lfx.Animation, dojo.lfx.IAnimation);
dojo.lang.extend(dojo.lfx.Animation, {
        // "private" properties
        _startTime: null,
        _endTime: null,
        _timer: null,
        _percent: 0,
        _startRepeatCount: 0,

        // public methods
        play: function(/*int?*/ delay, /*bool?*/ gotoStart){
                // summary: Start the animation.
                // delay: How many milliseconds to delay before starting.
                // gotoStart: If true, starts the animation from the beginning; otherwise,
                //            starts it from its current position.
                if(gotoStart){
                        clearTimeout(this._timer);
                        this._active = false;
                        this._paused = false;
                        this._percent = 0;
                }else if(this._active && !this._paused){
                        return this; // dojo.lfx.Animation
                }
                
                this.fire("handler", ["beforeBegin"]);
                this.fire("beforeBegin");

                if(delay > 0){
                        setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay);
                        return this; // dojo.lfx.Animation
                }
                
                this._startTime = new Date().valueOf();
                if(this._paused){
                        this._startTime -= (this.duration * this._percent / 100);
                }
                this._endTime = this._startTime + this.duration;

                this._active = true;
                this._paused = false;
                
                var step = this._percent / 100;
                var value = this.curve.getValue(step);
                if(this._percent == 0 ){
                        if(!this._startRepeatCount){
                                this._startRepeatCount = this.repeatCount;
                        }
                        this.fire("handler", ["begin", value]);
                        this.fire("onBegin", [value]);
                }

                this.fire("handler", ["play", value]);
                this.fire("onPlay", [value]);

                this._cycle();
                return this; // dojo.lfx.Animation
        },

        pause: function(){
                // summary: Pauses a running animation.
                clearTimeout(this._timer);
                if(!this._active){ return this; /*dojo.lfx.Animation*/}
                this._paused = true;
                var value = this.curve.getValue(this._percent / 100);
                this.fire("handler", ["pause", value]);
                this.fire("onPause", [value]);
                return this; // dojo.lfx.Animation
        },

        gotoPercent: function(/*Decimal*/ pct, /*bool?*/ andPlay){
                // summary: Sets the progress of the animation.
                // pct: A percentage in decimal notation (between and including 0.0 and 1.0).
                // andPlay: If true, play the animation after setting the progress.
                clearTimeout(this._timer);
                this._active = true;
                this._paused = true;
                this._percent = pct;
                if(andPlay){ this.play(); }
                return this; // dojo.lfx.Animation
        },

        stop: function(/*bool?*/ gotoEnd){
                // summary: Stops a running animation.
                // gotoEnd: If true, the animation will end.
                clearTimeout(this._timer);
                var step = this._percent / 100;
                if(gotoEnd){
                        step = 1;
                }
                var value = this.curve.getValue(step);
                this.fire("handler", ["stop", value]);
                this.fire("onStop", [value]);
                this._active = false;
                this._paused = false;
                return this; // dojo.lfx.Animation
        },

        status: function(){
                // summary: Returns a string representation of the status of
                //                      the animation.
                if(this._active){
                        return this._paused ? "paused" : "playing"; // String
                }else{
                        return "stopped"; // String
                }
                return this;
        },

        // "private" methods
        _cycle: function(){
                clearTimeout(this._timer);
                if(this._active){
                        var curr = new Date().valueOf();
                        var step = (curr - this._startTime) / (this._endTime - this._startTime);

                        if(step >= 1){
                                step = 1;
                                this._percent = 100;
                        }else{
                                this._percent = step * 100;
                        }
                        
                        // Perform easing
                        if((this.easing)&&(dojo.lang.isFunction(this.easing))){
                                step = this.easing(step);
                        }

                        var value = this.curve.getValue(step);
                        this.fire("handler", ["animate", value]);
                        this.fire("onAnimate", [value]);

                        if( step < 1 ){
                                this._timer = setTimeout(dojo.lang.hitch(this, "_cycle"), this.rate);
                        }else{
                                this._active = false;
                                this.fire("handler", ["end"]);
                                this.fire("onEnd");

                                if(this.repeatCount > 0){
                                        this.repeatCount--;
                                        this.play(null, true);
                                }else if(this.repeatCount == -1){
                                        this.play(null, true);
                                }else{
                                        if(this._startRepeatCount){
                                                this.repeatCount = this._startRepeatCount;
                                                this._startRepeatCount = 0;
                                        }
                                }
                        }
                }
                return this; // dojo.lfx.Animation
        }
});

dojo.lfx.Combine = function(/*dojo.lfx.IAnimation...*/ animations){
        // summary: An animation object to play animations passed to it at the same time.
        dojo.lfx.IAnimation.call(this);
        this._anims = [];
        this._animsEnded = 0;
        
        var anims = arguments;
        if(anims.length == 1 && (dojo.lang.isArray(anims[0]) || dojo.lang.isArrayLike(anims[0]))){
                /* animations: dojo.lfx.IAnimation[]
                   pId: a */
                anims = anims[0];
        }
        
        dojo.lang.forEach(anims, function(anim){
                this._anims.push(anim);
                anim.connect("onEnd", dojo.lang.hitch(this, "_onAnimsEnded"));
        }, this);
}
dojo.inherits(dojo.lfx.Combine, dojo.lfx.IAnimation);
dojo.lang.extend(dojo.lfx.Combine, {
        // private members
        _animsEnded: 0,
        
        // public methods
        play: function(/*int?*/ delay, /*bool?*/ gotoStart){
                // summary: Start the animations.
                // delay: How many milliseconds to delay before starting.
                // gotoStart: If true, starts the animations from the beginning; otherwise,
                //            starts them from their current position.
                if( !this._anims.length ){ return this; /*dojo.lfx.Combine*/}

                this.fire("beforeBegin");

                if(delay > 0){
                        setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay);
                        return this; // dojo.lfx.Combine
                }
                
                if(gotoStart || this._anims[0].percent == 0){
                        this.fire("onBegin");
                }
                this.fire("onPlay");
                this._animsCall("play", null, gotoStart);
                return this; // dojo.lfx.Combine
        },
        
        pause: function(){
                // summary: Pauses the running animations.
                this.fire("onPause");
                this._animsCall("pause"); 
                return this; // dojo.lfx.Combine
        },
        
        stop: function(/*bool?*/ gotoEnd){
                // summary: Stops the running animations.
                // gotoEnd: If true, the animations will end.
                this.fire("onStop");
                this._animsCall("stop", gotoEnd);
                return this; // dojo.lfx.Combine
        },
        
        // private methods
        _onAnimsEnded: function(){
                this._animsEnded++;
                if(this._animsEnded >= this._anims.length){
                        this.fire("onEnd");
                }
                return this; // dojo.lfx.Combine
        },
        
        _animsCall: function(/*String*/ funcName){
                var args = [];
                if(arguments.length > 1){
                        for(var i = 1 ; i < arguments.length ; i++){
                                args.push(arguments[i]);
                        }
                }
                var _this = this;
                dojo.lang.forEach(this._anims, function(anim){
                        anim[funcName](args);
                }, _this);
                return this; // dojo.lfx.Combine
        }
});

dojo.lfx.Chain = function(/*dojo.lfx.IAnimation...*/ animations) {
        // summary: An animation object to play animations passed to it
        //                      one after another.
        dojo.lfx.IAnimation.call(this);
        this._anims = [];
        this._currAnim = -1;
        
        var anims = arguments;
        if(anims.length == 1 && (dojo.lang.isArray(anims[0]) || dojo.lang.isArrayLike(anims[0]))){
                /* animations: dojo.lfx.IAnimation[]
                   pId: a */
                anims = anims[0];
        }
        
        var _this = this;
        dojo.lang.forEach(anims, function(anim, i, anims_arr){
                this._anims.push(anim);
                if(i < anims_arr.length - 1){
                        anim.connect("onEnd", dojo.lang.hitch(this, "_playNext") );
                }else{
                        anim.connect("onEnd", dojo.lang.hitch(this, function(){ this.fire("onEnd"); }) );
                }
        }, this);
}
dojo.inherits(dojo.lfx.Chain, dojo.lfx.IAnimation);
dojo.lang.extend(dojo.lfx.Chain, {
        // private members
        _currAnim: -1,
        
        // public methods
        play: function(/*int?*/ delay, /*bool?*/ gotoStart){
                // summary: Start the animation sequence.
                // delay: How many milliseconds to delay before starting.
                // gotoStart: If true, starts the sequence from the beginning; otherwise,
                //            starts it from its current position.
                if( !this._anims.length ) { return this; /*dojo.lfx.Chain*/}
                if( gotoStart || !this._anims[this._currAnim] ) {
                        this._currAnim = 0;
                }

                var currentAnimation = this._anims[this._currAnim];

                this.fire("beforeBegin");
                if(delay > 0){
                        setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay);
                        return this; // dojo.lfx.Chain
                }
                
                if(currentAnimation){
                        if(this._currAnim == 0){
                                this.fire("handler", ["begin", this._currAnim]);
                                this.fire("onBegin", [this._currAnim]);
                        }
                        this.fire("onPlay", [this._currAnim]);
                        currentAnimation.play(null, gotoStart);
                }
                return this; // dojo.lfx.Chain
        },
        
        pause: function(){
                // summary: Pauses the running animation sequence.
                if( this._anims[this._currAnim] ) {
                        this._anims[this._currAnim].pause();
                        this.fire("onPause", [this._currAnim]);
                }
                return this; // dojo.lfx.Chain
        },
        
        playPause: function(){
                // summary: If the animation sequence is playing, pause it; otherwise,
                //                      play it.
                if(this._anims.length == 0){ return this; }
                if(this._currAnim == -1){ this._currAnim = 0; }
                var currAnim = this._anims[this._currAnim];
                if( currAnim ) {
                        if( !currAnim._active || currAnim._paused ) {
                                this.play();
                        } else {
                                this.pause();
                        }
                }
                return this; // dojo.lfx.Chain
        },
        
        stop: function(){
                // summary: Stops the running animations.
                var currAnim = this._anims[this._currAnim];
                if(currAnim){
                        currAnim.stop();
                        this.fire("onStop", [this._currAnim]);
                }
                return currAnim; // dojo.lfx.IAnimation
        },
        
        // private methods
        _playNext: function(){
                if( this._currAnim == -1 || this._anims.length == 0 ) { return this; }
                this._currAnim++;
                if( this._anims[this._currAnim] ){
                        this._anims[this._currAnim].play(null, true);
                }
                return this; // dojo.lfx.Chain
        }
});

dojo.lfx.combine = function(/*dojo.lfx.IAnimation...*/ animations){
        // summary: Convenience function.  Returns a dojo.lfx.Combine created
        //                      using the animations passed in.
        var anims = arguments;
        if(dojo.lang.isArray(arguments[0])){
                /* animations: dojo.lfx.IAnimation[]
                   pId: a */
                anims = arguments[0];
        }
        if(anims.length == 1){ return anims[0]; }
        return new dojo.lfx.Combine(anims); // dojo.lfx.Combine
}

dojo.lfx.chain = function(/*dojo.lfx.IAnimation...*/ animations){
        // summary: Convenience function.  Returns a dojo.lfx.Chain created
        //                      using the animations passed in.
        var anims = arguments;
        if(dojo.lang.isArray(arguments[0])){
                /* animations: dojo.lfx.IAnimation[]
                   pId: a */
                anims = arguments[0];
        }
        if(anims.length == 1){ return anims[0]; }
        return new dojo.lfx.Chain(anims); // dojo.lfx.Combine
}

dojo.provide("dojo.html.common");



dojo.lang.mixin(dojo.html, dojo.dom);

dojo.html.body = function(){
        dojo.deprecated("dojo.html.body() moved to dojo.body()", "0.5");
        return dojo.body();
}

// FIXME: we are going to assume that we can throw any and every rendering
// engine into the IE 5.x box model. In Mozilla, we do this w/ CSS.
// Need to investigate for KHTML and Opera

dojo.html.getEventTarget = function(/* DOMEvent */evt){
        //      summary
        //      Returns the target of an event
        if(!evt) { evt = dojo.global().event || {} };
        var t = (evt.srcElement ? evt.srcElement : (evt.target ? evt.target : null));
        while((t)&&(t.nodeType!=1)){ t = t.parentNode; }
        return t;       //      HTMLElement
}

dojo.html.getViewport = function(){
        //      summary
        //      Returns the dimensions of the viewable area of a browser window
        var _window = dojo.global();
        var _document = dojo.doc();
        var w = 0;
        var h = 0;

        if(dojo.render.html.mozilla){
                // mozilla
                w = _document.documentElement.clientWidth;
                h = _window.innerHeight;
        }else if(!dojo.render.html.opera && _window.innerWidth){
                //in opera9, dojo.body().clientWidth should be used, instead
                //of window.innerWidth/document.documentElement.clientWidth
                //so we have to check whether it is opera
                w = _window.innerWidth;
                h = _window.innerHeight;
        } else if (!dojo.render.html.opera && dojo.exists(_document, "documentElement.clientWidth")){
                // IE6 Strict
                var w2 = _document.documentElement.clientWidth;
                // this lets us account for scrollbars
                if(!w || w2 && w2 < w) {
                        w = w2;
                }
                h = _document.documentElement.clientHeight;
        } else if (dojo.body().clientWidth){
                // IE, Opera
                w = dojo.body().clientWidth;
                h = dojo.body().clientHeight;
        }
        return { width: w, height: h }; //      object
}

dojo.html.getScroll = function(){
        //      summary
        //      Returns the scroll position of the document
        var _window = dojo.global();
        var _document = dojo.doc();
        var top = _window.pageYOffset || _document.documentElement.scrollTop || dojo.body().scrollTop || 0;
        var left = _window.pageXOffset || _document.documentElement.scrollLeft || dojo.body().scrollLeft || 0;
        return { 
                top: top, 
                left: left, 
                offset:{ x: left, y: top }      //      note the change, NOT an Array with added properties. 
        };      //      object
}

dojo.html.getParentByType = function(/* HTMLElement */node, /* string */type) {
        //      summary
        //      Returns the first ancestor of node with tagName type.
        var _document = dojo.doc();
        var parent = dojo.byId(node);
        type = type.toLowerCase();
        while((parent)&&(parent.nodeName.toLowerCase()!=type)){
                if(parent==(_document["body"]||_document["documentElement"])){
                        return null;
                }
                parent = parent.parentNode;
        }
        return parent;  //      HTMLElement
}

dojo.html.getAttribute = function(/* HTMLElement */node, /* string */attr){
        //      summary
        //      Returns the value of attribute attr from node.
        node = dojo.byId(node);
        // FIXME: need to add support for attr-specific accessors
        if((!node)||(!node.getAttribute)){
                // if(attr !== 'nwType'){
                //      alert("getAttr of '" + attr + "' with bad node"); 
                // }
                return null;
        }
        var ta = typeof attr == 'string' ? attr : new String(attr);

        // first try the approach most likely to succeed
        var v = node.getAttribute(ta.toUpperCase());
        if((v)&&(typeof v == 'string')&&(v!="")){ 
                return v;       //      string 
        }

        // try returning the attributes value, if we couldn't get it as a string
        if(v && v.value){ 
                return v.value; //      string 
        }

        // this should work on Opera 7, but it's a little on the crashy side
        if((node.getAttributeNode)&&(node.getAttributeNode(ta))){
                return (node.getAttributeNode(ta)).value;       //      string
        }else if(node.getAttribute(ta)){
                return node.getAttribute(ta);   //      string
        }else if(node.getAttribute(ta.toLowerCase())){
                return node.getAttribute(ta.toLowerCase());     //      string
        }
        return null;    //      string
}
        
dojo.html.hasAttribute = function(/* HTMLElement */node, /* string */attr){
        //      summary
        //      Determines whether or not the specified node carries a value for the attribute in question.
        return dojo.html.getAttribute(dojo.byId(node), attr) ? true : false;    //      boolean
}
        
dojo.html.getCursorPosition = function(/* DOMEvent */e){
        //      summary
        //      Returns the mouse position relative to the document (not the viewport).
        //      For example, if you have a document that is 10000px tall,
        //      but your browser window is only 100px tall,
        //      if you scroll to the bottom of the document and call this function it
        //      will return {x: 0, y: 10000}
        //      NOTE: for events delivered via dojo.event.connect() and/or dojoAttachEvent (for widgets),
        //      you can just access evt.pageX and evt.pageY, rather than calling this function.
        e = e || dojo.global().event;
        var cursor = {x:0, y:0};
        if(e.pageX || e.pageY){
                cursor.x = e.pageX;
                cursor.y = e.pageY;
        }else{
                var de = dojo.doc().documentElement;
                var db = dojo.body();
                cursor.x = e.clientX + ((de||db)["scrollLeft"]) - ((de||db)["clientLeft"]);
                cursor.y = e.clientY + ((de||db)["scrollTop"]) - ((de||db)["clientTop"]);
        }
        return cursor;  //      object
}

dojo.html.isTag = function(/* HTMLElement */node) {
        //      summary
        //      Like dojo.dom.isTag, except case-insensitive
        node = dojo.byId(node);
        if(node && node.tagName) {
                for (var i=1; i<arguments.length; i++){
                        if (node.tagName.toLowerCase()==String(arguments[i]).toLowerCase()){
                                return String(arguments[i]).toLowerCase();      //      string
                        }
                }
        }
        return "";      //      string
}

//define dojo.html.createExternalElement for IE to workaround the annoying activation "feature" in new IE
//details: http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/overview/activating_activex.asp
if(dojo.render.html.ie && !dojo.render.html.ie70){
        //only define createExternalElement for IE in none https to avoid "mixed content" warning dialog
        if(window.location.href.substr(0,6).toLowerCase() != "https:"){
                (function(){
                        // FIXME: this seems not to work correctly on IE 7!!

                        //The trick is to define a function in a script.src property:
                        // <script src="javascript:'function createExternalElement(){...}'"></script>,
                        //which will be treated as an external javascript file in IE
                        var xscript = dojo.doc().createElement('script');
                        xscript.src = "javascript:'dojo.html.createExternalElement=function(doc, tag){ return doc.createElement(tag); }'";
                        dojo.doc().getElementsByTagName("head")[0].appendChild(xscript);
                })();
        }
}else{
        //for other browsers, simply use document.createElement
        //is enough
        dojo.html.createExternalElement = function(/* HTMLDocument */doc, /* string */tag){
                //      summary
                //      Creates an element in the HTML document, here for ActiveX activation workaround.
                return doc.createElement(tag);  //      HTMLElement
        }
}

dojo.html._callDeprecated = function(inFunc, replFunc, args, argName, retValue){
        dojo.deprecated("dojo.html." + inFunc,
                                        "replaced by dojo.html." + replFunc + "(" + (argName ? "node, {"+ argName + ": " + argName + "}" : "" ) + ")" + (retValue ? "." + retValue : ""), "0.5");
        var newArgs = [];
        if(argName){ var argsIn = {}; argsIn[argName] = args[1]; newArgs.push(args[0]); newArgs.push(argsIn); }
        else { newArgs = args }
        var ret = dojo.html[replFunc].apply(dojo.html, args);
        if(retValue){ return ret[retValue]; }
        else { return ret; }
}

dojo.html.getViewportWidth = function(){
        return dojo.html._callDeprecated("getViewportWidth", "getViewport", arguments, null, "width");
}
dojo.html.getViewportHeight = function(){
        return dojo.html._callDeprecated("getViewportHeight", "getViewport", arguments, null, "height");
}
dojo.html.getViewportSize = function(){
        return dojo.html._callDeprecated("getViewportSize", "getViewport", arguments);
}
dojo.html.getScrollTop = function(){
        return dojo.html._callDeprecated("getScrollTop", "getScroll", arguments, null, "top");
}
dojo.html.getScrollLeft = function(){
        return dojo.html._callDeprecated("getScrollLeft", "getScroll", arguments, null, "left");
}
dojo.html.getScrollOffset = function(){
        return dojo.html._callDeprecated("getScrollOffset", "getScroll", arguments, null, "offset");
}

dojo.provide("dojo.uri.Uri");

dojo.uri = new function() {
        this.dojoUri = function (/*dojo.uri.Uri||String*/uri) {
                // summary: returns a Uri object resolved relative to the dojo root
                return new dojo.uri.Uri(dojo.hostenv.getBaseScriptUri(), uri);
        }

        this.moduleUri = function(/*String*/module, /*dojo.uri.Uri||String*/uri){
                // summary: returns a Uri object relative to a module
                // description: Examples: dojo.uri.moduleUri("dojo.widget","templates/template.html"), or dojo.uri.moduleUri("acme","images/small.png")
                var loc = dojo.hostenv.getModuleSymbols(module).join('/');
                if(!loc){
                        return null;
                }
                if(loc.lastIndexOf("/") != loc.length-1){
                        loc += "/";
                }
                
                //If the path is an absolute path (starts with a / or is on another domain/xdomain)
                //then don't add the baseScriptUri.
                var colonIndex = loc.indexOf(":");
                var slashIndex = loc.indexOf("/");
                if(loc.charAt(0) != "/" && (colonIndex == -1 || colonIndex > slashIndex)){
                        loc = dojo.hostenv.getBaseScriptUri() + loc;
                }

                return new dojo.uri.Uri(loc,uri);
        }

        this.Uri = function (/*dojo.uri.Uri||String...*/) {
                // summary: Constructor to create an object representing a URI.
                // description: 
                //  Each argument is evaluated in order relative to the next until
                //  a canonical uri is produced. To get an absolute Uri relative
                //  to the current document use
                //      new dojo.uri.Uri(document.baseURI, uri)

                // TODO: support for IPv6, see RFC 2732

                // resolve uri components relative to each other
                var uri = arguments[0];
                for (var i = 1; i < arguments.length; i++) {
                        if(!arguments[i]) { continue; }

                        // Safari doesn't support this.constructor so we have to be explicit
                        var relobj = new dojo.uri.Uri(arguments[i].toString());
                        var uriobj = new dojo.uri.Uri(uri.toString());

                        if ((relobj.path=="")&&(relobj.scheme==null)&&(relobj.authority==null)&&(relobj.query==null)) {
                                if (relobj.fragment != null) { uriobj.fragment = relobj.fragment; }
                                relobj = uriobj;
                        } else if (relobj.scheme == null) {
                                relobj.scheme = uriobj.scheme;

                                if (relobj.authority == null) {
                                        relobj.authority = uriobj.authority;

                                        if (relobj.path.charAt(0) != "/") {
                                                var path = uriobj.path.substring(0,
                                                        uriobj.path.lastIndexOf("/") + 1) + relobj.path;

                                                var segs = path.split("/");
                                                for (var j = 0; j < segs.length; j++) {
                                                        if (segs[j] == ".") {
                                                                if (j == segs.length - 1) { segs[j] = ""; }
                                                                else { segs.splice(j, 1); j--; }
                                                        } else if (j > 0 && !(j == 1 && segs[0] == "") &&
                                                                segs[j] == ".." && segs[j-1] != "..") {

                                                                if (j == segs.length - 1) { segs.splice(j, 1); segs[j - 1] = ""; }
                                                                else { segs.splice(j - 1, 2); j -= 2; }
                                                        }
                                                }
                                                relobj.path = segs.join("/");
                                        }
                                }
                        }

                        uri = "";
                        if (relobj.scheme != null) { uri += relobj.scheme + ":"; }
                        if (relobj.authority != null) { uri += "//" + relobj.authority; }
                        uri += relobj.path;
                        if (relobj.query != null) { uri += "?" + relobj.query; }
                        if (relobj.fragment != null) { uri += "#" + relobj.fragment; }
                }

                this.uri = uri.toString();

                // break the uri into its main components
                var regexp = "^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?$";
                var r = this.uri.match(new RegExp(regexp));

                this.scheme = r[2] || (r[1] ? "" : null);
                this.authority = r[4] || (r[3] ? "" : null);
                this.path = r[5]; // can never be undefined
                this.query = r[7] || (r[6] ? "" : null);
                this.fragment  = r[9] || (r[8] ? "" : null);

                if (this.authority != null) {
                        // server based naming authority
                        regexp = "^((([^:]+:)?([^@]+))@)?([^:]*)(:([0-9]+))?$";
                        r = this.authority.match(new RegExp(regexp));

                        this.user = r[3] || null;
                        this.password = r[4] || null;
                        this.host = r[5];
                        this.port = r[7] || null;
                }

                this.toString = function(){ return this.uri; }
        }
};

dojo.provide("dojo.html.style");



dojo.html.getClass = function(/* HTMLElement */node){
        //      summary
        //      Returns the string value of the list of CSS classes currently assigned directly 
        //      to the node in question. Returns an empty string if no class attribute is found;
        node = dojo.byId(node);
        if(!node){ return ""; }
        var cs = "";
        if(node.className){
                cs = node.className;
        }else if(dojo.html.hasAttribute(node, "class")){
                cs = dojo.html.getAttribute(node, "class");
        }
        return cs.replace(/^\s+|\s+$/g, "");    //      string
}

dojo.html.getClasses = function(/* HTMLElement */node) {
        //      summary
        //      Returns an array of CSS classes currently assigned directly to the node in question. 
        //      Returns an empty array if no classes are found;
        var c = dojo.html.getClass(node);
        return (c == "") ? [] : c.split(/\s+/g);        //      array
}

dojo.html.hasClass = function(/* HTMLElement */node, /* string */classname){
        //      summary
        //      Returns whether or not the specified classname is a portion of the
        //      class list currently applied to the node. Does not cover cascaded
        //      styles, only classes directly applied to the node.
        return (new RegExp('(^|\\s+)'+classname+'(\\s+|$)')).test(dojo.html.getClass(node))     //      boolean
}

dojo.html.prependClass = function(/* HTMLElement */node, /* string */classStr){
        //      summary
        //      Adds the specified class to the beginning of the class list on the
        //      passed node. This gives the specified class the highest precidence
        //      when style cascading is calculated for the node. Returns true or
        //      false; indicating success or failure of the operation, respectively.
        classStr += " " + dojo.html.getClass(node);
        return dojo.html.setClass(node, classStr);      //      boolean
}

dojo.html.addClass = function(/* HTMLElement */node, /* string */classStr){
        //      summary
        //      Adds the specified class to the end of the class list on the
        //      passed &node;. Returns &true; or &false; indicating success or failure.
        if (dojo.html.hasClass(node, classStr)) {
          return false;
        }
        classStr = (dojo.html.getClass(node) + " " + classStr).replace(/^\s+|\s+$/g,"");
        return dojo.html.setClass(node, classStr);      //      boolean
}

dojo.html.setClass = function(/* HTMLElement */node, /* string */classStr){
        //      summary
        //      Clobbers the existing list of classes for the node, replacing it with
        //      the list given in the 2nd argument. Returns true or false
        //      indicating success or failure.
        node = dojo.byId(node);
        var cs = new String(classStr);
        try{
                if(typeof node.className == "string"){
                        node.className = cs;
                }else if(node.setAttribute){
                        node.setAttribute("class", classStr);
                        node.className = cs;
                }else{
                        return false;
                }
        }catch(e){
                dojo.debug("dojo.html.setClass() failed", e);
        }
        return true;
}

dojo.html.removeClass = function(/* HTMLElement */node, /* string */classStr, /* boolean? */allowPartialMatches){
        //      summary
        //      Removes the className from the node;. Returns true or false indicating success or failure.
        try{
                if (!allowPartialMatches) {
                        var newcs = dojo.html.getClass(node).replace(new RegExp('(^|\\s+)'+classStr+'(\\s+|$)'), "$1$2");
                } else {
                        var newcs = dojo.html.getClass(node).replace(classStr,'');
                }
                dojo.html.setClass(node, newcs);
        }catch(e){
                dojo.debug("dojo.html.removeClass() failed", e);
        }
        return true;    //      boolean
}

dojo.html.replaceClass = function(/* HTMLElement */node, /* string */newClass, /* string */oldClass) {
        //      summary
        //      Replaces 'oldClass' and adds 'newClass' to node
        dojo.html.removeClass(node, oldClass);
        dojo.html.addClass(node, newClass);
}

// Enum type for getElementsByClass classMatchType arg:
dojo.html.classMatchType = {
        ContainsAll : 0, // all of the classes are part of the node's class (default)
        ContainsAny : 1, // any of the classes are part of the node's class
        IsOnly : 2 // only all of the classes are part of the node's class
}


dojo.html.getElementsByClass = function(
        /* string */classStr, 
        /* HTMLElement? */parent, 
        /* string? */nodeType, 
        /* integer? */classMatchType, 
        /* boolean? */useNonXpath
){
        //      summary
        //      Returns an array of nodes for the given classStr, children of a
        //      parent, and optionally of a certain nodeType
        // FIXME: temporarily set to false because of several dojo tickets related
        // to the xpath version not working consistently in firefox.
        useNonXpath = false;
        var _document = dojo.doc();
        parent = dojo.byId(parent) || _document;
        var classes = classStr.split(/\s+/g);
        var nodes = [];
        if( classMatchType != 1 && classMatchType != 2 ) classMatchType = 0; // make it enum
        var reClass = new RegExp("(\\s|^)((" + classes.join(")|(") + "))(\\s|$)");
        var srtLength = classes.join(" ").length;
        var candidateNodes = [];
        
        if(!useNonXpath && _document.evaluate) { // supports dom 3 xpath
                var xpath = ".//" + (nodeType || "*") + "[contains(";
                if(classMatchType != dojo.html.classMatchType.ContainsAny){
                        xpath += "concat(' ',@class,' '), ' " +
                        classes.join(" ') and contains(concat(' ',@class,' '), ' ") +
                        " ')";
                        if (classMatchType == 2) {
                                xpath += " and string-length(@class)="+srtLength+"]";
                        }else{
                                xpath += "]";
                        }
                }else{
                        xpath += "concat(' ',@class,' '), ' " +
                        classes.join(" ') or contains(concat(' ',@class,' '), ' ") +
                        " ')]";
                }
                var xpathResult = _document.evaluate(xpath, parent, null, XPathResult.ANY_TYPE, null);
                var result = xpathResult.iterateNext();
                while(result){
                        try{
                                candidateNodes.push(result);
                                result = xpathResult.iterateNext();
                        }catch(e){ break; }
                }
                return candidateNodes;  //      NodeList
        }else{
                if(!nodeType){
                        nodeType = "*";
                }
                candidateNodes = parent.getElementsByTagName(nodeType);

                var node, i = 0;
                outer:
                while(node = candidateNodes[i++]){
                        var nodeClasses = dojo.html.getClasses(node);
                        if(nodeClasses.length == 0){ continue outer; }
                        var matches = 0;
        
                        for(var j = 0; j < nodeClasses.length; j++){
                                if(reClass.test(nodeClasses[j])){
                                        if(classMatchType == dojo.html.classMatchType.ContainsAny){
                                                nodes.push(node);
                                                continue outer;
                                        }else{
                                                matches++;
                                        }
                                }else{
                                        if(classMatchType == dojo.html.classMatchType.IsOnly){
                                                continue outer;
                                        }
                                }
                        }
        
                        if(matches == classes.length){
                                if(     (classMatchType == dojo.html.classMatchType.IsOnly)&&
                                        (matches == nodeClasses.length)){
                                        nodes.push(node);
                                }else if(classMatchType == dojo.html.classMatchType.ContainsAll){
                                        nodes.push(node);
                                }
                        }
                }
                return nodes;   //      NodeList
        }
}
dojo.html.getElementsByClassName = dojo.html.getElementsByClass;

dojo.html.toCamelCase = function(/* string */selector){
        //      summary
        //      Translates a CSS selector string to a camel-cased 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.html.toSelectorCase = function(/* string */selector){
        //      summary
        //      Translates a camel cased string to a selector cased one.
        return selector.replace(/([A-Z])/g, "-$1" ).toLowerCase();      //      string
}

if (dojo.render.html.ie) {
        // IE branch
        dojo.html.getComputedStyle = function(/*HTMLElement|String*/node, /*String*/property, /*String*/value) {
                // summary
                // Get the computed style value for style "property" on "node" (IE).
                node = dojo.byId(node); // FIXME: remove ability to access nodes by id for this time-critical function
                if(!node || !node.currentStyle){return value;}
                // FIXME: standardize on camel-case input to improve speed
                return node.currentStyle[dojo.html.toCamelCase(property)]; // String
        }
        // SJM: getComputedStyle should be abandoned and replaced with the below function.
        // All our supported browsers can return CSS2 compliant CssStyleDeclaration objects
        // which can be queried directly for multiple styles.
        dojo.html.getComputedStyles = function(/*HTMLElement*/node) {
                // summary
                // Get a style object containing computed styles for HTML Element node (IE).
                return node.currentStyle; // CSSStyleDeclaration
        }
} else {
        // non-IE branch
        dojo.html.getComputedStyle = function(/*HTMLElement|String*/node, /*String*/property, /*Any*/value) {
                // summary
                // Get the computed style value for style "property" on "node" (non-IE).
                node = dojo.byId(node);
                if(!node || !node.style){return value;}
                var s = document.defaultView.getComputedStyle(node, null);
                // s may be null on Safari
                return (s&&s[dojo.html.toCamelCase(property)])||''; // String
        }       
        // SJM: getComputedStyle should be abandoned and replaced with the below function.
        // All our supported browsers can return CSS2 compliant CssStyleDeclaration objects
        // which can be queried directly for multiple styles.
        dojo.html.getComputedStyles = function(node) {
                // summary
                // Get a style object containing computed styles for HTML Element node (non-IE).
                return document.defaultView.getComputedStyle(node, null); // CSSStyleDeclaration
        }       
}

dojo.html.getStyleProperty = function(/* HTMLElement */node, /* string */cssSelector){
        //      summary
        //      Returns the value of the passed style
        node = dojo.byId(node);
        return (node && node.style ? node.style[dojo.html.toCamelCase(cssSelector)] : undefined);       //      string
}

dojo.html.getStyle = function(/* HTMLElement */node, /* string */cssSelector){
        //      summary
        //      Returns the computed value of the passed style
        var value = dojo.html.getStyleProperty(node, cssSelector);
        return (value ? value : dojo.html.getComputedStyle(node, cssSelector)); //      string || integer
}

dojo.html.setStyle = function(/* HTMLElement */node, /* string */cssSelector, /* string */value){
        //      summary
        //      Set the value of passed style on node
        node = dojo.byId(node);
        if(node && node.style){
                var camelCased = dojo.html.toCamelCase(cssSelector);
                node.style[camelCased] = value;
        }
}

dojo.html.setStyleText = function (/* HTMLElement */target, /* string */text) {
        //      summary
        //      Try to set the entire cssText property of the passed target; equiv of setting style attribute.
        try {
                target.style.cssText = text;
        } catch (e) {
                target.setAttribute("style", text);
        }
}

dojo.html.copyStyle = function(/* HTMLElement */target, /* HTMLElement */source){
        //      summary
        // work around for opera which doesn't have cssText, and for IE which fails on setAttribute 
        if(!source.style.cssText){ 
                target.setAttribute("style", source.getAttribute("style")); 
        }else{
                target.style.cssText = source.style.cssText; 
        }
        dojo.html.addClass(target, dojo.html.getClass(source));
}

dojo.html.getUnitValue = function(/* HTMLElement */node, /* string */cssSelector, /* boolean? */autoIsZero){
        //      summary
        //      Get the value of passed selector, with the specific units used
        var s = dojo.html.getComputedStyle(node, cssSelector);
        if((!s)||((s == 'auto')&&(autoIsZero))){ 
                return { value: 0, units: 'px' };       //      object 
        }
        // FIXME: is regex inefficient vs. parseInt or some manual test? 
        var match = s.match(/(\-?[\d.]+)([a-z%]*)/i);
        if (!match){return dojo.html.getUnitValue.bad;}
        return { value: Number(match[1]), units: match[2].toLowerCase() };      //      object
}
dojo.html.getUnitValue.bad = { value: NaN, units: '' };

if (dojo.render.html.ie) {
        // IE branch
        dojo.html.toPixelValue = function(/* HTMLElement */element, /* String */styleValue){
                // summary
                //  Extract value in pixels from styleValue (IE version).
                //  If a value cannot be extracted, zero is returned.
                if(!styleValue){return 0;}
                if(styleValue.slice(-2) == 'px'){return parseFloat(styleValue);}
                var pixelValue = 0;
                with(element){
                        var sLeft = style.left;
                        var rsLeft = runtimeStyle.left;
                        runtimeStyle.left = currentStyle.left;
                        try {
                                style.left = styleValue || 0;
                                pixelValue = style.pixelLeft;
                                style.left = sLeft;
                                runtimeStyle.left = rsLeft;
                        }catch(e){
                                // FIXME: it's possible for styleValue to be incompatible with
                                // style.left. In particular, border width values of 
                                // "thick", "medium", or "thin" will provoke an exception.
                        }
                }
                return pixelValue; // Number
        }
} else {
        // non-IE branch
        dojo.html.toPixelValue = function(/* HTMLElement */element, /* String */styleValue){
                // summary
                //  Extract value in pixels from styleValue (non-IE version).
                //  If a value cannot be extracted, zero is returned.
                return (styleValue && (styleValue.slice(-2)=='px') ? parseFloat(styleValue) : 0); // Number
        }
}

dojo.html.getPixelValue = function(/* HTMLElement */node, /* string */styleProperty, /* boolean? */autoIsZero){
        // summary
        //  Get a computed style value, in pixels.
        // node: HTMLElement
        //  Node to interrogate
        // styleProperty: String
        //  Style property to query, in either css-selector or camelCase (property) format.
        // autoIsZero: Boolean
        //  Deprecated. Any value that cannot be converted to pixels is returned as zero.
        // 
        //  summary
        //  Get the value of passed selector in pixels.
        //
        return dojo.html.toPixelValue(node, dojo.html.getComputedStyle(node, styleProperty));
} 

dojo.html.setPositivePixelValue = function(/* HTMLElement */node, /* string */selector, /* integer */value){
        //      summary
        //      Attempt to set the value of selector on node as a positive pixel value.
        if(isNaN(value)){return false;}
        node.style[selector] = Math.max(0, value) + 'px'; 
        return true;    //      boolean
}

dojo.html.styleSheet = null;

// FIXME: this is a really basic stub for adding and removing cssRules, but
// it assumes that you know the index of the cssRule that you want to add 
// or remove, making it less than useful.  So we need something that can 
// search for the selector that you you want to remove.
dojo.html.insertCssRule = function(/* string */selector, /* string */declaration, /* integer? */index) {
        //      summary
        //      Attempt to insert declaration as selector on the internal stylesheet; if index try to set it there.
        if (!dojo.html.styleSheet) {
                if (document.createStyleSheet) { // IE
                        dojo.html.styleSheet = document.createStyleSheet();
                } else if (document.styleSheets[0]) { // rest
                        // FIXME: should create a new style sheet here
                        // fall back on an exsiting style sheet
                        dojo.html.styleSheet = document.styleSheets[0];
                } else { 
                        return null;    //      integer 
                } // fail
        }

        if (arguments.length < 3) { // index may == 0
                if (dojo.html.styleSheet.cssRules) { // W3
                        index = dojo.html.styleSheet.cssRules.length;
                } else if (dojo.html.styleSheet.rules) { // IE
                        index = dojo.html.styleSheet.rules.length;
                } else { 
                        return null;    //      integer 
                } // fail
        }

        if (dojo.html.styleSheet.insertRule) { // W3
                var rule = selector + " { " + declaration + " }";
                return dojo.html.styleSheet.insertRule(rule, index);    //      integer
        } else if (dojo.html.styleSheet.addRule) { // IE
                return dojo.html.styleSheet.addRule(selector, declaration, index);      //      integer
        } else { 
                return null; // integer
        } // fail
}

dojo.html.removeCssRule = function(/* integer? */index){
        //      summary
        //      Attempt to remove the rule at index.
        if(!dojo.html.styleSheet){
                dojo.debug("no stylesheet defined for removing rules");
                return false;
        }
        if(dojo.render.html.ie){
                if(!index){
                        index = dojo.html.styleSheet.rules.length;
                        dojo.html.styleSheet.removeRule(index);
                }
        }else if(document.styleSheets[0]){
                if(!index){
                        index = dojo.html.styleSheet.cssRules.length;
                }
                dojo.html.styleSheet.deleteRule(index);
        }
        return true;    //      boolean
}

dojo.html._insertedCssFiles = []; // cache container needed because IE reformats cssText when added to DOM
dojo.html.insertCssFile = function(/* string */URI, /* HTMLDocument? */doc, /* boolean? */checkDuplicates, /* boolean */fail_ok){
        //      summary
        // calls css by XmlHTTP and inserts it into DOM as <style [widgetType="widgetType"]> *downloaded cssText*</style>
        if(!URI){ return; }
        if(!doc){ doc = document; }
        var cssStr = dojo.hostenv.getText(URI, false, fail_ok);
        if(cssStr===null){ return; }
        cssStr = dojo.html.fixPathsInCssText(cssStr, URI);

        if(checkDuplicates){
                var idx = -1, node, ent = dojo.html._insertedCssFiles;
                for(var i = 0; i < ent.length; i++){
                        if((ent[i].doc == doc) && (ent[i].cssText == cssStr)){
                                idx = i; node = ent[i].nodeRef;
                                break;
                        }
                }
                // make sure we havent deleted our node
                if(node){
                        var styles = doc.getElementsByTagName("style");
                        for(var i = 0; i < styles.length; i++){
                                if(styles[i] == node){
                                        return;
                                }
                        }
                        // delete this entry
                        dojo.html._insertedCssFiles.shift(idx, 1);
                }
        }

        var style = dojo.html.insertCssText(cssStr, doc);
        dojo.html._insertedCssFiles.push({'doc': doc, 'cssText': cssStr, 'nodeRef': style});

        // insert custom attribute ex dbgHref="../foo.css" usefull when debugging in DOM inspectors, no?
        if(style && djConfig.isDebug){
                style.setAttribute("dbgHref", URI);
        }
        return style;   //      HTMLStyleElement
}

dojo.html.insertCssText = function(/* string */cssStr, /* HTMLDocument? */doc, /* string? */URI){
        //      summary
        //      Attempt to insert CSS rules into the document through inserting a style element
        // DomNode Style  = insertCssText(String ".dojoMenu {color: green;}"[, DomDoc document, dojo.uri.Uri Url ])
        if(!cssStr){ 
                return; //      HTMLStyleElement
        }
        if(!doc){ doc = document; }
        if(URI){// fix paths in cssStr
                cssStr = dojo.html.fixPathsInCssText(cssStr, URI);
        }
        var style = doc.createElement("style");
        style.setAttribute("type", "text/css");
        // IE is b0rken enough to require that we add the element to the doc
        // before changing it's properties
        var head = doc.getElementsByTagName("head")[0];
        if(!head){ // must have a head tag 
                dojo.debug("No head tag in document, aborting styles");
                return; //      HTMLStyleElement
        }else{
                head.appendChild(style);
        }
        if(style.styleSheet){// IE
                var setFunc = function(){ 
                        try{
                                style.styleSheet.cssText = cssStr;
                        }catch(e){ dojo.debug(e); }
                };
                if(style.styleSheet.disabled){
                        setTimeout(setFunc, 10);
                }else{
                        setFunc();
                }
        }else{ // w3c
                var cssText = doc.createTextNode(cssStr);
                style.appendChild(cssText);
        }
        return style;   //      HTMLStyleElement
}

dojo.html.fixPathsInCssText = function(/* string */cssStr, /* string */URI){
        //      summary
        // usage: cssText comes from dojoroot/src/widget/templates/Foobar.css
        //      it has .dojoFoo { background-image: url(images/bar.png);} then uri should point to dojoroot/src/widget/templates/
        if(!cssStr || !URI){ return; }
        var match, str = "", url = "", urlChrs = "[\\t\\s\\w\\(\\)\\/\\.\\\\'\"-:#=&?~]+";
        var regex = new RegExp('url\\(\\s*('+urlChrs+')\\s*\\)');
        var regexProtocol = /(file|https?|ftps?):\/\//;
        regexTrim = new RegExp("^[\\s]*(['\"]?)("+urlChrs+")\\1[\\s]*?$");
        if(dojo.render.html.ie55 || dojo.render.html.ie60){
                var regexIe = new RegExp("AlphaImageLoader\\((.*)src\=['\"]("+urlChrs+")['\"]");
                // TODO: need to decide how to handle relative paths and AlphaImageLoader see #1441
                // current implementation breaks on build with intern_strings
                while(match = regexIe.exec(cssStr)){
                        url = match[2].replace(regexTrim, "$2");
                        if(!regexProtocol.exec(url)){
                                url = (new dojo.uri.Uri(URI, url).toString());
                        }
                        str += cssStr.substring(0, match.index) + "AlphaImageLoader(" + match[1] + "src='" + url + "'";
                        cssStr = cssStr.substr(match.index + match[0].length);
                }
                cssStr = str + cssStr;
                str = "";
        }

        while(match = regex.exec(cssStr)){
                url = match[1].replace(regexTrim, "$2");
                if(!regexProtocol.exec(url)){
                        url = (new dojo.uri.Uri(URI, url).toString());
                }
                str += cssStr.substring(0, match.index) + "url(" + url + ")";
                cssStr = cssStr.substr(match.index + match[0].length);
        }
        return str + cssStr;    //      string
}

dojo.html.setActiveStyleSheet = function(/* string */title){
        //      summary
        //      Activate style sheet with specified title.
        var i = 0, a, els = dojo.doc().getElementsByTagName("link");
        while (a = els[i++]) {
                if(a.getAttribute("rel").indexOf("style") != -1 && a.getAttribute("title")){
                        a.disabled = true;
                        if (a.getAttribute("title") == title) { a.disabled = false; }
                }
        }
}

dojo.html.getActiveStyleSheet = function(){
        //      summary
        //      return the title of the currently active stylesheet
        var i = 0, a, els = dojo.doc().getElementsByTagName("link");
        while (a = els[i++]) {
                if (a.getAttribute("rel").indexOf("style") != -1 
                        && a.getAttribute("title") 
                        && !a.disabled
                ){
                        return a.getAttribute("title"); //      string 
                }
        }
        return null;    //      string
}

dojo.html.getPreferredStyleSheet = function(){
        //      summary
        //      Return the preferred stylesheet title (i.e. link without alt attribute)
        var i = 0, a, els = dojo.doc().getElementsByTagName("link");
        while (a = els[i++]) {
                if(a.getAttribute("rel").indexOf("style") != -1
                        && a.getAttribute("rel").indexOf("alt") == -1
                        && a.getAttribute("title")
                ){ 
                        return a.getAttribute("title");         //      string
                }
        }
        return null;    //      string
}

dojo.html.applyBrowserClass = function(/* HTMLElement */node){
        //      summary
        //      Applies pre-set class names based on browser & version to the passed node.
        //      Modified version of Morris' CSS hack.
        var drh=dojo.render.html;
        var classes = {
                dj_ie: drh.ie,
                dj_ie55: drh.ie55,
                dj_ie6: drh.ie60,
                dj_ie7: drh.ie70,
                dj_iequirks: drh.ie && drh.quirks,
                dj_opera: drh.opera,
                dj_opera8: drh.opera && (Math.floor(dojo.render.version)==8),
                dj_opera9: drh.opera && (Math.floor(dojo.render.version)==9),
                dj_khtml: drh.khtml,
                dj_safari: drh.safari,
                dj_gecko: drh.mozilla
        }; // no dojo unsupported browsers
        for(var p in classes){
                if(classes[p]){
                        dojo.html.addClass(node, p);
                }
        }
};

dojo.provide("dojo.html.display");


dojo.html._toggle = function(node, tester, setter){
        node = dojo.byId(node);
        setter(node, !tester(node));
        return tester(node);
}

dojo.html.show = function(/* HTMLElement */node){
        //      summary
        //      Show the passed element by reverting display property set by dojo.html.hide
        node = dojo.byId(node);
        if(dojo.html.getStyleProperty(node, 'display')=='none'){
                dojo.html.setStyle(node, 'display', (node.dojoDisplayCache||''));
                node.dojoDisplayCache = undefined;      // cannot use delete on a node in IE6
        }
}

dojo.html.hide = function(/* HTMLElement */node){
        //      summary
        //      Hide the passed element by setting display:none
        node = dojo.byId(node);
        if(typeof node["dojoDisplayCache"] == "undefined"){ // it could == '', so we cannot say !node.dojoDisplayCount
                var d = dojo.html.getStyleProperty(node, 'display')
                if(d!='none'){
                        node.dojoDisplayCache = d;
                }
        }
        dojo.html.setStyle(node, 'display', 'none');
}

dojo.html.setShowing = function(/* HTMLElement */node, /* boolean? */showing){
        //      summary
        // Calls show() if showing is true, hide() otherwise
        dojo.html[(showing ? 'show' : 'hide')](node);
}

dojo.html.isShowing = function(/* HTMLElement */node){
        //      summary
        //      Returns whether the element is displayed or not.
        // FIXME: returns true if node is bad, isHidden would be easier to make correct
        return (dojo.html.getStyleProperty(node, 'display') != 'none'); //      boolean
}

dojo.html.toggleShowing = function(/* HTMLElement */node){
        //      summary
        // Call setShowing() on node with the complement of isShowing(), then return the new value of isShowing()
        return dojo.html._toggle(node, dojo.html.isShowing, dojo.html.setShowing);      //      boolean
}

// Simple mapping of tag names to display values
// FIXME: simplistic 
dojo.html.displayMap = { tr: '', td: '', th: '', img: 'inline', span: 'inline', input: 'inline', button: 'inline' };

dojo.html.suggestDisplayByTagName = function(/* HTMLElement */node){
        //      summary
        // Suggest a value for the display property that will show 'node' based on it's tag
        node = dojo.byId(node);
        if(node && node.tagName){
                var tag = node.tagName.toLowerCase();
                return (tag in dojo.html.displayMap ? dojo.html.displayMap[tag] : 'block');     //      string
        }
}

dojo.html.setDisplay = function(/* HTMLElement */node, /* string */display){
        //      summary
        //      Sets the value of style.display to value of 'display' parameter if it is a string.
        //      Otherwise, if 'display' is false, set style.display to 'none'.
        //      Finally, set 'display' to a suggested display value based on the node's tag
        dojo.html.setStyle(node, 'display', ((display instanceof String || typeof display == "string") ? display : (display ? dojo.html.suggestDisplayByTagName(node) : 'none')));
}

dojo.html.isDisplayed = function(/* HTMLElement */node){
        //      summary
        //      Is true if the the computed display style for node is not 'none'
        //      FIXME: returns true if node is bad, isNotDisplayed would be easier to make correct
        return (dojo.html.getComputedStyle(node, 'display') != 'none'); //      boolean
}

dojo.html.toggleDisplay = function(/* HTMLElement */node){
        //      summary
        //      Call setDisplay() on node with the complement of isDisplayed(), then
        //      return the new value of isDisplayed()
        return dojo.html._toggle(node, dojo.html.isDisplayed, dojo.html.setDisplay);    //      boolean
}

dojo.html.setVisibility = function(/* HTMLElement */node, /* string */visibility){
        //      summary
        //      Sets the value of style.visibility to value of 'visibility' parameter if it is a string.
        //      Otherwise, if 'visibility' is false, set style.visibility to 'hidden'. Finally, set style.visibility to 'visible'.
        dojo.html.setStyle(node, 'visibility', ((visibility instanceof String || typeof visibility == "string") ? visibility : (visibility ? 'visible' : 'hidden')));
}

dojo.html.isVisible = function(/* HTMLElement */node){
        //      summary
        //      Returns true if the the computed visibility style for node is not 'hidden'
        //      FIXME: returns true if node is bad, isInvisible would be easier to make correct
        return (dojo.html.getComputedStyle(node, 'visibility') != 'hidden');    //      boolean
}

dojo.html.toggleVisibility = function(node){
        //      summary
        // Call setVisibility() on node with the complement of isVisible(), then return the new value of isVisible()
        return dojo.html._toggle(node, dojo.html.isVisible, dojo.html.setVisibility);   //      boolean
}

dojo.html.setOpacity = function(/* HTMLElement */node, /* float */opacity, /* boolean? */dontFixOpacity){
        //      summary
        //      Sets the opacity of node in a cross-browser way.
        //      float between 0.0 (transparent) and 1.0 (opaque)
        node = dojo.byId(node);
        var h = dojo.render.html;
        if(!dontFixOpacity){
                if( opacity >= 1.0){
                        if(h.ie){
                                dojo.html.clearOpacity(node);
                                return;
                        }else{
                                opacity = 0.999999;
                        }
                }else if( opacity < 0.0){ opacity = 0; }
        }
        if(h.ie){
                if(node.nodeName.toLowerCase() == "tr"){
                        // FIXME: is this too naive? will we get more than we want?
                        var tds = node.getElementsByTagName("td");
                        for(var x=0; x<tds.length; x++){
                                tds[x].style.filter = "Alpha(Opacity="+opacity*100+")";
                        }
                }
                node.style.filter = "Alpha(Opacity="+opacity*100+")";
        }else if(h.moz){
                node.style.opacity = opacity; // ffox 1.0 directly supports "opacity"
                node.style.MozOpacity = opacity;
        }else if(h.safari){
                node.style.opacity = opacity; // 1.3 directly supports "opacity"
                node.style.KhtmlOpacity = opacity;
        }else{
                node.style.opacity = opacity;
        }
}

dojo.html.clearOpacity = function(/* HTMLElement */node){
        //      summary
        //      Clears any opacity setting on the passed element.
        node = dojo.byId(node);
        var ns = node.style;
        var h = dojo.render.html;
        if(h.ie){
                try {
                        if( node.filters && node.filters.alpha ){
                                ns.filter = ""; // FIXME: may get rid of other filter effects
                        }
                } catch(e) {
                        /*
                         * IE7 gives error if node.filters not set;
                         * don't know why or how to workaround (other than this)
                         */
                }
        }else if(h.moz){
                ns.opacity = 1;
                ns.MozOpacity = 1;
        }else if(h.safari){
                ns.opacity = 1;
                ns.KhtmlOpacity = 1;
        }else{
                ns.opacity = 1;
        }
}

dojo.html.getOpacity = function(/* HTMLElement */node){
        //      summary
        //      Returns the opacity of the passed element
        node = dojo.byId(node);
        var h = dojo.render.html;
        if(h.ie){
                var opac = (node.filters && node.filters.alpha &&
                        typeof node.filters.alpha.opacity == "number"
                        ? node.filters.alpha.opacity : 100) / 100;
        }else{
                var opac = node.style.opacity || node.style.MozOpacity ||
                        node.style.KhtmlOpacity || 1;
        }
        return opac >= 0.999999 ? 1.0 : Number(opac);   //      float
}


dojo.provide("dojo.html.color");




dojo.html.getBackgroundColor = function(/* HTMLElement */node){
        //      summary
        //      returns the background color of the passed node as a 32-bit color (RGBA)
        node = dojo.byId(node);
        var color;
        do{
                color = dojo.html.getStyle(node, "background-color");
                // Safari doesn't say "transparent"
                if(color.toLowerCase() == "rgba(0, 0, 0, 0)") { color = "transparent"; }
                if(node == document.getElementsByTagName("body")[0]) { node = null; break; }
                node = node.parentNode;
        }while(node && dojo.lang.inArray(["transparent", ""], color));
        if(color == "transparent"){
                color = [255, 255, 255, 0];
        }else{
                color = dojo.gfx.color.extractRGB(color);
        }
        return color;   //      array
}

dojo.provide("dojo.html.layout");





dojo.html.sumAncestorProperties = function(/* HTMLElement */node, /* string */prop){
        //      summary
        //      Returns the sum of the passed property on all ancestors of node.
        node = dojo.byId(node);
        if(!node){ return 0; } // FIXME: throw an error?
        
        var retVal = 0;
        while(node){
                if(dojo.html.getComputedStyle(node, 'position') == 'fixed'){
                        return 0;
                }
                var val = node[prop];
                if(val){
                        retVal += val - 0;
                        if(node==dojo.body()){ break; }// opera and khtml #body & #html has the same values, we only need one value
                }
                node = node.parentNode;
        }
        return retVal;  //      integer
}

dojo.html.setStyleAttributes = function(/* HTMLElement */node, /* string */attributes) { 
        //      summary
        //      allows a dev to pass a string similar to what you'd pass in style="", and apply it to a node.
        node = dojo.byId(node);
        var splittedAttribs=attributes.replace(/(;)?\s*$/, "").split(";"); 
        for(var i=0; i<splittedAttribs.length; i++){ 
                var nameValue=splittedAttribs[i].split(":"); 
                var name=nameValue[0].replace(/\s*$/, "").replace(/^\s*/, "").toLowerCase();
                var value=nameValue[1].replace(/\s*$/, "").replace(/^\s*/, "");
                switch(name){
                        case "opacity":
                                dojo.html.setOpacity(node, value); 
                                break; 
                        case "content-height":
                                dojo.html.setContentBox(node, {height: value}); 
                                break; 
                        case "content-width":
                                dojo.html.setContentBox(node, {width: value}); 
                                break; 
                        case "outer-height":
                                dojo.html.setMarginBox(node, {height: value}); 
                                break; 
                        case "outer-width":
                                dojo.html.setMarginBox(node, {width: value}); 
                                break; 
                        default:
                                node.style[dojo.html.toCamelCase(name)]=value; 
                }
        } 
}

dojo.html.boxSizing = {
        MARGIN_BOX: "margin-box",
        BORDER_BOX: "border-box",
        PADDING_BOX: "padding-box",
        CONTENT_BOX: "content-box"
};

dojo.html.getAbsolutePosition = dojo.html.abs = function(/* HTMLElement */node, /* boolean? */includeScroll, /* string? */boxType){
        //      summary
        //      Gets the absolute position of the passed element based on the document itself.
        node = dojo.byId(node, node.ownerDocument);
        var ret = {
                x: 0,
                y: 0
        };

        var bs = dojo.html.boxSizing;
        if(!boxType) { boxType = bs.CONTENT_BOX; }
        var nativeBoxType = 2; //BORDER box
        var targetBoxType;
        switch(boxType){
                case bs.MARGIN_BOX:
                        targetBoxType = 3;
                        break;
                case bs.BORDER_BOX:
                        targetBoxType = 2;
                        break;
                case bs.PADDING_BOX:
                default:
                        targetBoxType = 1;
                        break;
                case bs.CONTENT_BOX:
                        targetBoxType = 0;
                        break;
        }

        var h = dojo.render.html;
        var db = document["body"]||document["documentElement"];

        if(h.ie){
                with(node.getBoundingClientRect()){
                        ret.x = left-2;
                        ret.y = top-2;
                }
        }else if(document.getBoxObjectFor){
                // mozilla
                nativeBoxType = 1; //getBoxObjectFor return padding box coordinate
                try{
                        var bo = document.getBoxObjectFor(node);
                        ret.x = bo.x - dojo.html.sumAncestorProperties(node, "scrollLeft");
                        ret.y = bo.y - dojo.html.sumAncestorProperties(node, "scrollTop");
                }catch(e){
                        // squelch
                }
        }else{
                if(node["offsetParent"]){
                        var endNode;
                        // in Safari, if the node is an absolutely positioned child of
                        // the body and the body has a margin the offset of the child
                        // and the body contain the body's margins, so we need to end
                        // at the body
                        if(     (h.safari)&&
                                (node.style.getPropertyValue("position") == "absolute")&&
                                (node.parentNode == db)){
                                endNode = db;
                        }else{
                                endNode = db.parentNode;
                        }

                        //TODO: set correct nativeBoxType for safari/konqueror

                        if(node.parentNode != db){
                                var nd = node;
                                if(dojo.render.html.opera){ nd = db; }
                                ret.x -= dojo.html.sumAncestorProperties(nd, "scrollLeft");
                                ret.y -= dojo.html.sumAncestorProperties(nd, "scrollTop");
                        }
                        var curnode = node;
                        do{
                                var n = curnode["offsetLeft"];
                                //FIXME: ugly hack to workaround the submenu in 
                                //popupmenu2 does not shown up correctly in opera. 
                                //Someone have a better workaround?
                                if(!h.opera || n>0){
                                        ret.x += isNaN(n) ? 0 : n;
                                }
                                var m = curnode["offsetTop"];
                                ret.y += isNaN(m) ? 0 : m;
                                curnode = curnode.offsetParent;
                        }while((curnode != endNode)&&(curnode != null));
                }else if(node["x"]&&node["y"]){
                        ret.x += isNaN(node.x) ? 0 : node.x;
                        ret.y += isNaN(node.y) ? 0 : node.y;
                }
        }

        // account for document scrolling!
        if(includeScroll){
                var scroll = dojo.html.getScroll();
                ret.y += scroll.top;
                ret.x += scroll.left;
        }

        var extentFuncArray=[dojo.html.getPaddingExtent, dojo.html.getBorderExtent, dojo.html.getMarginExtent];
        if(nativeBoxType > targetBoxType){
                for(var i=targetBoxType;i<nativeBoxType;++i){
                        ret.y += extentFuncArray[i](node, 'top');
                        ret.x += extentFuncArray[i](node, 'left');
                }
        }else if(nativeBoxType < targetBoxType){
                for(var i=targetBoxType;i>nativeBoxType;--i){
                        ret.y -= extentFuncArray[i-1](node, 'top');
                        ret.x -= extentFuncArray[i-1](node, 'left');
                }
        }
        ret.top = ret.y;
        ret.left = ret.x;
        return ret;     //      object
}

dojo.html.isPositionAbsolute = function(/* HTMLElement */node){
        //      summary
        //      Returns true if the element is absolutely positioned.
        return (dojo.html.getComputedStyle(node, 'position') == 'absolute');    //      boolean
}

dojo.html._sumPixelValues = function(/* HTMLElement */node, selectors, autoIsZero){
        var total = 0;
        for(var x=0; x<selectors.length; x++){
                total += dojo.html.getPixelValue(node, selectors[x], autoIsZero);
        }
        return total;
}

dojo.html.getMargin = function(/* HTMLElement */node){
        //      summary
        //      Returns the width and height of the passed node's margin
        return {
                width: dojo.html._sumPixelValues(node, ["margin-left", "margin-right"], (dojo.html.getComputedStyle(node, 'position') == 'absolute')),
                height: dojo.html._sumPixelValues(node, ["margin-top", "margin-bottom"], (dojo.html.getComputedStyle(node, 'position') == 'absolute'))
        };      //      object
}

dojo.html.getBorder = function(/* HTMLElement */node){
        //      summary
        //      Returns the width and height of the passed node's border
        return {
                width: dojo.html.getBorderExtent(node, 'left') + dojo.html.getBorderExtent(node, 'right'),
                height: dojo.html.getBorderExtent(node, 'top') + dojo.html.getBorderExtent(node, 'bottom')
        };      //      object
}

dojo.html.getBorderExtent = function(/* HTMLElement */node, /* string */side){
        //      summary
        //      returns the width of the requested border
        return (dojo.html.getStyle(node, 'border-' + side + '-style') == 'none' ? 0 : dojo.html.getPixelValue(node, 'border-' + side + '-width'));      // integer
}

dojo.html.getMarginExtent = function(/* HTMLElement */node, /* string */side){
        //      summary
        //      returns the width of the requested margin
        return dojo.html._sumPixelValues(node, ["margin-" + side], dojo.html.isPositionAbsolute(node)); //      integer
}

dojo.html.getPaddingExtent = function(/* HTMLElement */node, /* string */side){
        //      summary
        //      Returns the width of the requested padding 
        return dojo.html._sumPixelValues(node, ["padding-" + side], true);      //      integer
}

dojo.html.getPadding = function(/* HTMLElement */node){
        //      summary
        //      Returns the width and height of the passed node's padding
        return {
                width: dojo.html._sumPixelValues(node, ["padding-left", "padding-right"], true),
                height: dojo.html._sumPixelValues(node, ["padding-top", "padding-bottom"], true)
        };      //      object
}

dojo.html.getPadBorder = function(/* HTMLElement */node){
        //      summary
        //      Returns the width and height of the passed node's padding and border
        var pad = dojo.html.getPadding(node);
        var border = dojo.html.getBorder(node);
        return { width: pad.width + border.width, height: pad.height + border.height }; //      object
}

dojo.html.getBoxSizing = function(/* HTMLElement */node){
        //      summary
        //      Returns which box model the passed element is working with
        var h = dojo.render.html;
        var bs = dojo.html.boxSizing;
        if(((h.ie)||(h.opera)) && node.nodeName.toLowerCase() != "img"){ 
                var cm = document["compatMode"];
                if((cm == "BackCompat")||(cm == "QuirksMode")){
                        return bs.BORDER_BOX;   //      string
                }else{
                        return bs.CONTENT_BOX;  //      string
                }
        }else{
                if(arguments.length == 0){ node = document.documentElement; }
                var sizing;
                if(!h.ie){
                        sizing = dojo.html.getStyle(node, "-moz-box-sizing");
                        if(!sizing){ 
                                sizing = dojo.html.getStyle(node, "box-sizing");
                        }
                }
                return (sizing ? sizing : bs.CONTENT_BOX);      //      string
        }
}

dojo.html.isBorderBox = function(/* HTMLElement */node){
        //      summary
        //      returns whether the passed element is using border box sizing or not.
        return (dojo.html.getBoxSizing(node) == dojo.html.boxSizing.BORDER_BOX);        //      boolean
}

dojo.html.getBorderBox = function(/* HTMLElement */node){
        //      summary
        //      Returns the dimensions of the passed element based on border-box sizing.
        node = dojo.byId(node);
        return { width: node.offsetWidth, height: node.offsetHeight };  //      object
}

dojo.html.getPaddingBox = function(/* HTMLElement */node){
        //      summary
        //      Returns the dimensions of the padding box (see http://www.w3.org/TR/CSS21/box.html)
        var box = dojo.html.getBorderBox(node);
        var border = dojo.html.getBorder(node);
        return {
                width: box.width - border.width,
                height:box.height - border.height
        };      //      object
}

dojo.html.getContentBox = function(/* HTMLElement */node){
        //      summary
        //      Returns the dimensions of the content box (see http://www.w3.org/TR/CSS21/box.html)
        node = dojo.byId(node);
        var padborder = dojo.html.getPadBorder(node);
        return {
                width: node.offsetWidth - padborder.width,
                height: node.offsetHeight - padborder.height
        };      //      object
}

dojo.html.setContentBox = function(/* HTMLElement */node, /* object */args){
        //      summary
        //      Sets the dimensions of the passed node according to content sizing.
        node = dojo.byId(node);
        var width = 0; var height = 0;
        var isbb = dojo.html.isBorderBox(node);
        var padborder = (isbb ? dojo.html.getPadBorder(node) : { width: 0, height: 0});
        var ret = {};
        if(typeof args.width != "undefined"){
                width = args.width + padborder.width;
                ret.width = dojo.html.setPositivePixelValue(node, "width", width);
        }
        if(typeof args.height != "undefined"){
                height = args.height + padborder.height;
                ret.height = dojo.html.setPositivePixelValue(node, "height", height);
        }
        return ret;     //      object
}

dojo.html.getMarginBox = function(/* HTMLElement */node){
        //      summary
        //      returns the dimensions of the passed node including any margins.
        var borderbox = dojo.html.getBorderBox(node);
        var margin = dojo.html.getMargin(node);
        return { width: borderbox.width + margin.width, height: borderbox.height + margin.height };     //      object
}

dojo.html.setMarginBox = function(/* HTMLElement */node, /* object */args){
        //      summary
        //      Sets the dimensions of the passed node using margin box calcs.
        node = dojo.byId(node);
        var width = 0; var height = 0;
        var isbb = dojo.html.isBorderBox(node);
        var padborder = (!isbb ? dojo.html.getPadBorder(node) : { width: 0, height: 0 });
        var margin = dojo.html.getMargin(node);
        var ret = {};
        if(typeof args.width != "undefined"){
                width = args.width - padborder.width;
                width -= margin.width;
                ret.width = dojo.html.setPositivePixelValue(node, "width", width);
        }
        if(typeof args.height != "undefined"){
                height = args.height - padborder.height;
                height -= margin.height;
                ret.height = dojo.html.setPositivePixelValue(node, "height", height);
        }
        return ret;     //      object
}

dojo.html.getElementBox = function(/* HTMLElement */node, /* string */type){
        //      summary
        //      return dimesions of a node based on the passed box model type.
        var bs = dojo.html.boxSizing;
        switch(type){
                case bs.MARGIN_BOX:
                        return dojo.html.getMarginBox(node);    //      object
                case bs.BORDER_BOX:
                        return dojo.html.getBorderBox(node);    //      object
                case bs.PADDING_BOX:
                        return dojo.html.getPaddingBox(node);   //      object
                case bs.CONTENT_BOX:
                default:
                        return dojo.html.getContentBox(node);   //      object
        }
}
// in: coordinate array [x,y,w,h] or dom node
// return: coordinate object
dojo.html.toCoordinateObject = dojo.html.toCoordinateArray = function(/* array */coords, /* boolean? */includeScroll, /* string? */boxtype) {
        //      summary
        //      Converts an array of coordinates into an object of named arguments.
        if(coords instanceof Array || typeof coords == "array"){
                dojo.deprecated("dojo.html.toCoordinateArray", "use dojo.html.toCoordinateObject({left: , top: , width: , height: }) instead", "0.5");
                // coords is already an array (of format [x,y,w,h]), just return it
                while ( coords.length < 4 ) { coords.push(0); }
                while ( coords.length > 4 ) { coords.pop(); }
                var ret = {
                        left: coords[0],
                        top: coords[1],
                        width: coords[2],
                        height: coords[3]
                };
        }else if(!coords.nodeType && !(coords instanceof String || typeof coords == "string") &&
                         ('width' in coords || 'height' in coords || 'left' in coords ||
                          'x' in coords || 'top' in coords || 'y' in coords)){
                // coords is a coordinate object or at least part of one
                var ret = {
                        left: coords.left||coords.x||0,
                        top: coords.top||coords.y||0,
                        width: coords.width||0,
                        height: coords.height||0
                };
        }else{
                // coords is an dom object (or dom object id); return it's coordinates
                var node = dojo.byId(coords);
                var pos = dojo.html.abs(node, includeScroll, boxtype);
                var marginbox = dojo.html.getMarginBox(node);
                var ret = {
                        left: pos.left,
                        top: pos.top,
                        width: marginbox.width,
                        height: marginbox.height
                };
        }
        ret.x = ret.left;
        ret.y = ret.top;
        return ret;     //      object
}

dojo.html.setMarginBoxWidth = dojo.html.setOuterWidth = function(node, width){
        return dojo.html._callDeprecated("setMarginBoxWidth", "setMarginBox", arguments, "width");
}
dojo.html.setMarginBoxHeight = dojo.html.setOuterHeight = function(){
        return dojo.html._callDeprecated("setMarginBoxHeight", "setMarginBox", arguments, "height");
}
dojo.html.getMarginBoxWidth = dojo.html.getOuterWidth = function(){
        return dojo.html._callDeprecated("getMarginBoxWidth", "getMarginBox", arguments, null, "width");
}
dojo.html.getMarginBoxHeight = dojo.html.getOuterHeight = function(){
        return dojo.html._callDeprecated("getMarginBoxHeight", "getMarginBox", arguments, null, "height");
}
dojo.html.getTotalOffset = function(node, type, includeScroll){
        return dojo.html._callDeprecated("getTotalOffset", "getAbsolutePosition", arguments, null, type);
}
dojo.html.getAbsoluteX = function(node, includeScroll){
        return dojo.html._callDeprecated("getAbsoluteX", "getAbsolutePosition", arguments, null, "x");
}
dojo.html.getAbsoluteY = function(node, includeScroll){
        return dojo.html._callDeprecated("getAbsoluteY", "getAbsolutePosition", arguments, null, "y");
}
dojo.html.totalOffsetLeft = function(node, includeScroll){
        return dojo.html._callDeprecated("totalOffsetLeft", "getAbsolutePosition", arguments, null, "left");
}
dojo.html.totalOffsetTop = function(node, includeScroll){
        return dojo.html._callDeprecated("totalOffsetTop", "getAbsolutePosition", arguments, null, "top");
}
dojo.html.getMarginWidth = function(node){
        return dojo.html._callDeprecated("getMarginWidth", "getMargin", arguments, null, "width");
}
dojo.html.getMarginHeight = function(node){
        return dojo.html._callDeprecated("getMarginHeight", "getMargin", arguments, null, "height");
}
dojo.html.getBorderWidth = function(node){
        return dojo.html._callDeprecated("getBorderWidth", "getBorder", arguments, null, "width");
}
dojo.html.getBorderHeight = function(node){
        return dojo.html._callDeprecated("getBorderHeight", "getBorder", arguments, null, "height");
}
dojo.html.getPaddingWidth = function(node){
        return dojo.html._callDeprecated("getPaddingWidth", "getPadding", arguments, null, "width");
}
dojo.html.getPaddingHeight = function(node){
        return dojo.html._callDeprecated("getPaddingHeight", "getPadding", arguments, null, "height");
}
dojo.html.getPadBorderWidth = function(node){
        return dojo.html._callDeprecated("getPadBorderWidth", "getPadBorder", arguments, null, "width");
}
dojo.html.getPadBorderHeight = function(node){
        return dojo.html._callDeprecated("getPadBorderHeight", "getPadBorder", arguments, null, "height");
}
dojo.html.getBorderBoxWidth = dojo.html.getInnerWidth = function(){
        return dojo.html._callDeprecated("getBorderBoxWidth", "getBorderBox", arguments, null, "width");
}
dojo.html.getBorderBoxHeight = dojo.html.getInnerHeight = function(){
        return dojo.html._callDeprecated("getBorderBoxHeight", "getBorderBox", arguments, null, "height");
}
dojo.html.getContentBoxWidth = dojo.html.getContentWidth = function(){
        return dojo.html._callDeprecated("getContentBoxWidth", "getContentBox", arguments, null, "width");
}
dojo.html.getContentBoxHeight = dojo.html.getContentHeight = function(){
        return dojo.html._callDeprecated("getContentBoxHeight", "getContentBox", arguments, null, "height");
}
dojo.html.setContentBoxWidth = dojo.html.setContentWidth = function(node, width){
        return dojo.html._callDeprecated("setContentBoxWidth", "setContentBox", arguments, "width");
}
dojo.html.setContentBoxHeight = dojo.html.setContentHeight = function(node, height){
        return dojo.html._callDeprecated("setContentBoxHeight", "setContentBox", arguments, "height");
}

dojo.provide("dojo.lfx.html");








dojo.lfx.html._byId = function(nodes){
        if(!nodes){ return []; }
        if(dojo.lang.isArrayLike(nodes)){
                if(!nodes.alreadyChecked){
                        var n = [];
                        dojo.lang.forEach(nodes, function(node){
                                n.push(dojo.byId(node));
                        });
                        n.alreadyChecked = true;
                        return n;
                }else{
                        return nodes;
                }
        }else{
                var n = [];
                n.push(dojo.byId(nodes));
                n.alreadyChecked = true;
                return n;
        }
}

dojo.lfx.html.propertyAnimation = function(     /*DOMNode[]*/ nodes, 
                                                                                        /*Object[]*/ propertyMap, 
                                                                                        /*int*/ duration,
                                                                                        /*function*/ easing,
                                                                                        /*Object*/ handlers){
        // summary: Returns an animation that will transition the properties of "nodes"
        //                      depending how they are defined in "propertyMap".
        // nodes: An array of DOMNodes or one DOMNode.
        // propertyMap: { property: String, start: Decimal?, end: Decimal?, units: String? }
        //                              An array of objects defining properties to change.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // handlers: { handler: Function?, onstart: Function?, onstop: Function?, onanimate: Function? }
        nodes = dojo.lfx.html._byId(nodes);

        var targs = {
                "propertyMap": propertyMap,
                "nodes": nodes,
                "duration": duration,
                "easing": easing||dojo.lfx.easeDefault
        };
        
        var setEmUp = function(args){
                if(args.nodes.length==1){
                        // FIXME: we're only supporting start-value filling when one node is
                        // passed
                        
                        var pm = args.propertyMap;
                        if(!dojo.lang.isArray(args.propertyMap)){
                                // it's stupid to have to pack an array with a set of objects
                                // when you can just pass in an object list
                                var parr = [];
                                for(var pname in pm){
                                        pm[pname].property = pname;
                                        parr.push(pm[pname]);
                                }
                                pm = args.propertyMap = parr;
                        }
                        dojo.lang.forEach(pm, function(prop){
                                if(dj_undef("start", prop)){
                                        if(prop.property != "opacity"){
                                                prop.start = parseInt(dojo.html.getComputedStyle(args.nodes[0], prop.property));
                                        }else{
                                                prop.start = dojo.html.getOpacity(args.nodes[0]);
                                        }
                                }
                        });
                }
        }

        var coordsAsInts = function(coords){
                var cints = [];
                dojo.lang.forEach(coords, function(c){ 
                        cints.push(Math.round(c));
                });
                return cints;
        }

        var setStyle = function(n, style){
                n = dojo.byId(n);
                if(!n || !n.style){ return; }
                for(var s in style){
                        try{
                                if(s == "opacity"){
                                        dojo.html.setOpacity(n, style[s]);
                                }else{
                                                n.style[s] = style[s];
                                }
                        }catch(e){ dojo.debug(e); }
                }
        }

        var propLine = function(properties){
                this._properties = properties;
                this.diffs = new Array(properties.length);
                dojo.lang.forEach(properties, function(prop, i){
                        // calculate the end - start to optimize a bit
                        if(dojo.lang.isFunction(prop.start)){
                                prop.start = prop.start(prop, i);
                        }
                        if(dojo.lang.isFunction(prop.end)){
                                prop.end = prop.end(prop, i);
                        }
                        if(dojo.lang.isArray(prop.start)){
                                // don't loop through the arrays
                                this.diffs[i] = null;
                        }else if(prop.start instanceof dojo.gfx.color.Color){
                                // save these so we don't have to call toRgb() every getValue() call
                                prop.startRgb = prop.start.toRgb();
                                prop.endRgb = prop.end.toRgb();
                        }else{
                                this.diffs[i] = prop.end - prop.start;
                        }
                }, this);

                this.getValue = function(n){
                        var ret = {};
                        dojo.lang.forEach(this._properties, function(prop, i){
                                var value = null;
                                if(dojo.lang.isArray(prop.start)){
                                        // FIXME: what to do here?
                                }else if(prop.start instanceof dojo.gfx.color.Color){
                                        value = (prop.units||"rgb") + "(";
                                        for(var j = 0 ; j < prop.startRgb.length ; j++){
                                                value += Math.round(((prop.endRgb[j] - prop.startRgb[j]) * n) + prop.startRgb[j]) + (j < prop.startRgb.length - 1 ? "," : "");
                                        }
                                        value += ")";
                                }else{
                                        value = ((this.diffs[i]) * n) + prop.start + (prop.property != "opacity" ? prop.units||"px" : "");
                                }
                                ret[dojo.html.toCamelCase(prop.property)] = value;
                        }, this);
                        return ret;
                }
        }
        
        var anim = new dojo.lfx.Animation({
                        beforeBegin: function(){ 
                                setEmUp(targs); 
                                anim.curve = new propLine(targs.propertyMap);
                        },
                        onAnimate: function(propValues){
                                dojo.lang.forEach(targs.nodes, function(node){
                                        setStyle(node, propValues);
                                });
                        }
                },
                targs.duration, 
                null,
                targs.easing
        );
        if(handlers){
                for(var x in handlers){
                        if(dojo.lang.isFunction(handlers[x])){
                                anim.connect(x, anim, handlers[x]);
                        }
                }
        }
        
        return anim; // dojo.lfx.Animation
}

dojo.lfx.html._makeFadeable = function(nodes){
        var makeFade = function(node){
                if(dojo.render.html.ie){
                        // only set the zoom if the "tickle" value would be the same as the
                        // default
                        if( (node.style.zoom.length == 0) &&
                                (dojo.html.getStyle(node, "zoom") == "normal") ){
                                // make sure the node "hasLayout"
                                // NOTE: this has been tested with larger and smaller user-set text
                                // sizes and works fine
                                node.style.zoom = "1";
                                // node.style.zoom = "normal";
                        }
                        // don't set the width to auto if it didn't already cascade that way.
                        // We don't want to f anyones designs
                        if(     (node.style.width.length == 0) &&
                                (dojo.html.getStyle(node, "width") == "auto") ){
                                node.style.width = "auto";
                        }
                }
        }
        if(dojo.lang.isArrayLike(nodes)){
                dojo.lang.forEach(nodes, makeFade);
        }else{
                makeFade(nodes);
        }
}

dojo.lfx.html.fade = function(/*DOMNode[]*/ nodes,
                                                          /*Object*/values,
                                                          /*int?*/ duration,
                                                          /*Function?*/ easing,
                                                          /*Function?*/ callback){
        // summary:Returns an animation that will fade the "nodes" from the start to end values passed.
        // nodes: An array of DOMNodes or one DOMNode.
        // values: { start: Decimal?, end: Decimal? }
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var props = { property: "opacity" };
        if(!dj_undef("start", values)){
                props.start = values.start;
        }else{
                props.start = function(){ return dojo.html.getOpacity(nodes[0]); };
        }

        if(!dj_undef("end", values)){
                props.end = values.end;
        }else{
                dojo.raise("dojo.lfx.html.fade needs an end value");
        }

        var anim = dojo.lfx.propertyAnimation(nodes, [ props ], duration, easing);
        anim.connect("beforeBegin", function(){
                dojo.lfx.html._makeFadeable(nodes);
        });
        if(callback){
                anim.connect("onEnd", function(){ callback(nodes, anim); });
        }

        return anim; // dojo.lfx.Animation
}

dojo.lfx.html.fadeIn = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will fade "nodes" from its current opacity to fully opaque.
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        return dojo.lfx.html.fade(nodes, { end: 1 }, duration, easing, callback); // dojo.lfx.Animation
}

dojo.lfx.html.fadeOut = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will fade "nodes" from its current opacity to fully transparent.
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.       
        return dojo.lfx.html.fade(nodes, { end: 0 }, duration, easing, callback); // dojo.lfx.Animation
}

dojo.lfx.html.fadeShow = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will fade "nodes" from transparent to opaque and shows
        //                      "nodes" at the end if it is hidden.
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.       
        nodes=dojo.lfx.html._byId(nodes);
        dojo.lang.forEach(nodes, function(node){
                dojo.html.setOpacity(node, 0.0);
        });

        var anim = dojo.lfx.html.fadeIn(nodes, duration, easing, callback);
        anim.connect("beforeBegin", function(){ 
                if(dojo.lang.isArrayLike(nodes)){
                        dojo.lang.forEach(nodes, dojo.html.show);
                }else{
                        dojo.html.show(nodes);
                }
        });

        return anim; // dojo.lfx.Animation
}

dojo.lfx.html.fadeHide = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will fade "nodes" from its current opacity to opaque and hides
        //                      "nodes" at the end.
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        var anim = dojo.lfx.html.fadeOut(nodes, duration, easing, function(){
                if(dojo.lang.isArrayLike(nodes)){
                        dojo.lang.forEach(nodes, dojo.html.hide);
                }else{
                        dojo.html.hide(nodes);
                }
                if(callback){ callback(nodes, anim); }
        });
        
        return anim; // dojo.lfx.Animation
}

dojo.lfx.html.wipeIn = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will show and wipe in "nodes".
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];

        dojo.lang.forEach(nodes, function(node){
                var oprop = {  };       // old properties of node (before we mucked w/them)
                
                // get node height, either it's natural height or it's height specified via style or class attributes
                // (for FF, the node has to be (temporarily) rendered to measure height)
                // TODO: should this offscreen code be part of dojo.html, so that getBorderBox() works on hidden nodes?
                var origTop, origLeft, origPosition;
                with(node.style){
                        origTop=top; origLeft=left; origPosition=position;
                        top="-9999px"; left="-9999px"; position="absolute";
                        display="";
                }
                var nodeHeight = dojo.html.getBorderBox(node).height;
                with(node.style){
                        top=origTop; left=origLeft; position=origPosition;
                        display="none";
                }

                var anim = dojo.lfx.propertyAnimation(node,
                        {       "height": {
                                        start: 1, // 0 causes IE to display the whole panel
                                        end: function(){ return nodeHeight; } 
                                }
                        }, 
                        duration, 
                        easing);
        
                anim.connect("beforeBegin", function(){
                        oprop.overflow = node.style.overflow;
                        oprop.height = node.style.height;
                        with(node.style){
                                overflow = "hidden";
                                height = "1px"; // 0 causes IE to display the whole panel
                        }
                        dojo.html.show(node);
                });
                
                anim.connect("onEnd", function(){ 
                        with(node.style){
                                overflow = oprop.overflow;
                                height = oprop.height;
                        }
                        if(callback){ callback(node, anim); }
                });
                anims.push(anim);
        });
        
        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lfx.html.wipeOut = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will wipe out and hide "nodes".
        // nodes: An array of DOMNodes or one DOMNode.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];
        
        dojo.lang.forEach(nodes, function(node){
                var oprop = {  };       // old properties of node (before we mucked w/them)
                var anim = dojo.lfx.propertyAnimation(node,
                        {       "height": {
                                        start: function(){ return dojo.html.getContentBox(node).height; },
                                        end: 1 // 0 causes IE to display the whole panel
                                } 
                        },
                        duration,
                        easing,
                        {
                                "beforeBegin": function(){
                                        oprop.overflow = node.style.overflow;
                                        oprop.height = node.style.height;
                                        with(node.style){
                                                overflow = "hidden";
                                        }
                                        dojo.html.show(node);
                                },
                                
                                "onEnd": function(){ 
                                        dojo.html.hide(node);
                                        with(node.style){
                                                overflow = oprop.overflow;
                                                height = oprop.height;
                                        }
                                        if(callback){ callback(node, anim); }
                                }
                        }
                );
                anims.push(anim);
        });

        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lfx.html.slideTo = function(/*DOMNode*/ nodes,
                                                                 /*Object*/ coords,
                                                                 /*int?*/ duration,
                                                                 /*Function?*/ easing,
                                                                 /*Function?*/ callback){
        // summary: Returns an animation that will slide "nodes" from its current position to
        //                      the position defined in "coords".
        // nodes: An array of DOMNodes or one DOMNode.
        // coords: { top: Decimal?, left: Decimal? }
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];
        var compute = dojo.html.getComputedStyle;
        
        if(dojo.lang.isArray(coords)){
                /* coords: Array
                   pId: a */
                dojo.deprecated('dojo.lfx.html.slideTo(node, array)', 'use dojo.lfx.html.slideTo(node, {top: value, left: value});', '0.5');
                coords = { top: coords[0], left: coords[1] };
        }
        dojo.lang.forEach(nodes, function(node){
                var top = null;
                var left = null;
                
                var init = (function(){
                        var innerNode = node;
                        return function(){
                                var pos = compute(innerNode, 'position');
                                top = (pos == 'absolute' ? node.offsetTop : parseInt(compute(node, 'top')) || 0);
                                left = (pos == 'absolute' ? node.offsetLeft : parseInt(compute(node, 'left')) || 0);

                                if (!dojo.lang.inArray(['absolute', 'relative'], pos)) {
                                        var ret = dojo.html.abs(innerNode, true);
                                        dojo.html.setStyleAttributes(innerNode, "position:absolute;top:"+ret.y+"px;left:"+ret.x+"px;");
                                        top = ret.y;
                                        left = ret.x;
                                }
                        }
                })();
                init();
                
                var anim = dojo.lfx.propertyAnimation(node,
                        {       "top": { start: top, end: (coords.top||0) },
                                "left": { start: left, end: (coords.left||0)  }
                        },
                        duration,
                        easing,
                        { "beforeBegin": init }
                );

                if(callback){
                        anim.connect("onEnd", function(){ callback(nodes, anim); });
                }

                anims.push(anim);
        });
        
        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lfx.html.slideBy = function(/*DOMNode*/ nodes, /*Object*/ coords, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){
        // summary: Returns an animation that will slide "nodes" from its current position
        //                      to its current position plus the numbers defined in "coords".
        // nodes: An array of DOMNodes or one DOMNode.
        // coords: { top: Decimal?, left: Decimal? }
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];
        var compute = dojo.html.getComputedStyle;

        if(dojo.lang.isArray(coords)){
                /* coords: Array
                   pId: a */
                dojo.deprecated('dojo.lfx.html.slideBy(node, array)', 'use dojo.lfx.html.slideBy(node, {top: value, left: value});', '0.5');
                coords = { top: coords[0], left: coords[1] };
        }

        dojo.lang.forEach(nodes, function(node){
                var top = null;
                var left = null;
                
                var init = (function(){
                        var innerNode = node;
                        return function(){
                                var pos = compute(innerNode, 'position');
                                top = (pos == 'absolute' ? node.offsetTop : parseInt(compute(node, 'top')) || 0);
                                left = (pos == 'absolute' ? node.offsetLeft : parseInt(compute(node, 'left')) || 0);

                                if (!dojo.lang.inArray(['absolute', 'relative'], pos)) {
                                        var ret = dojo.html.abs(innerNode, true);
                                        dojo.html.setStyleAttributes(innerNode, "position:absolute;top:"+ret.y+"px;left:"+ret.x+"px;");
                                        top = ret.y;
                                        left = ret.x;
                                }
                        }
                })();
                init();
                
                var anim = dojo.lfx.propertyAnimation(node,
                        {
                                "top": { start: top, end: top+(coords.top||0) },
                                "left": { start: left, end: left+(coords.left||0) }
                        },
                        duration,
                        easing).connect("beforeBegin", init);

                if(callback){
                        anim.connect("onEnd", function(){ callback(nodes, anim); });
                }

                anims.push(anim);
        });

        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lfx.html.explode = function(/*DOMNode*/ start,
                                                                 /*DOMNode*/ endNode,
                                                                 /*int?*/ duration,
                                                                 /*Function?*/ easing,
                                                                 /*Function?*/ callback){
        // summary: Returns an animation that will 
        // start:
        // endNode:
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        var h = dojo.html;
        start = dojo.byId(start);
        endNode = dojo.byId(endNode);
        var startCoords = h.toCoordinateObject(start, true);
        var outline = document.createElement("div");
        h.copyStyle(outline, endNode);
        if(endNode.explodeClassName){ outline.className = endNode.explodeClassName; }
        with(outline.style){
                position = "absolute";
                display = "none";
                // border = "1px solid black";
                var backgroundStyle = h.getStyle(start, "background-color");
                backgroundColor = backgroundStyle ? backgroundStyle.toLowerCase() : "transparent";
                backgroundColor = (backgroundColor == "transparent") ? "rgb(221, 221, 221)" : backgroundColor;
        }
        dojo.body().appendChild(outline);

        with(endNode.style){
                visibility = "hidden";
                display = "block";
        }
        var endCoords = h.toCoordinateObject(endNode, true);
        with(endNode.style){
                display = "none";
                visibility = "visible";
        }

        var props = { opacity: { start: 0.5, end: 1.0 } };
        dojo.lang.forEach(["height", "width", "top", "left"], function(type){
                props[type] = { start: startCoords[type], end: endCoords[type] }
        });
        
        var anim = new dojo.lfx.propertyAnimation(outline, 
                props,
                duration,
                easing,
                {
                        "beforeBegin": function(){
                                h.setDisplay(outline, "block");
                        },
                        "onEnd": function(){
                                h.setDisplay(endNode, "block");
                                outline.parentNode.removeChild(outline);
                        }
                }
        );

        if(callback){
                anim.connect("onEnd", function(){ callback(endNode, anim); });
        }
        return anim; // dojo.lfx.Animation
}

dojo.lfx.html.implode = function(/*DOMNode*/ startNode,
                                                                 /*DOMNode*/ end,
                                                                 /*int?*/ duration,
                                                                 /*Function?*/ easing,
                                                                 /*Function?*/ callback){
        // summary: Returns an animation that will 
        // startNode:
        // end:
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        var h = dojo.html;
        startNode = dojo.byId(startNode);
        end = dojo.byId(end);
        var startCoords = dojo.html.toCoordinateObject(startNode, true);
        var endCoords = dojo.html.toCoordinateObject(end, true);

        var outline = document.createElement("div");
        dojo.html.copyStyle(outline, startNode);
        if (startNode.explodeClassName) { outline.className = startNode.explodeClassName; }
        dojo.html.setOpacity(outline, 0.3);
        with(outline.style){
                position = "absolute";
                display = "none";
                backgroundColor = h.getStyle(startNode, "background-color").toLowerCase();
        }
        dojo.body().appendChild(outline);

        var props = { opacity: { start: 1.0, end: 0.5 } };
        dojo.lang.forEach(["height", "width", "top", "left"], function(type){
                props[type] = { start: startCoords[type], end: endCoords[type] }
        });
        
        var anim = new dojo.lfx.propertyAnimation(outline,
                props,
                duration,
                easing,
                {
                        "beforeBegin": function(){
                                dojo.html.hide(startNode);
                                dojo.html.show(outline);
                        },
                        "onEnd": function(){
                                outline.parentNode.removeChild(outline);
                        }
                }
        );

        if(callback){
                anim.connect("onEnd", function(){ callback(startNode, anim); });
        }
        return anim; // dojo.lfx.Animation
}

dojo.lfx.html.highlight = function(/*DOMNode[]*/ nodes,
                                                                   /*dojo.gfx.color.Color*/ startColor,
                                                                   /*int?*/ duration,
                                                                   /*Function?*/ easing,
                                                                   /*Function?*/ callback){
        // summary: Returns an animation that will set the background color
        //                      of "nodes" to startColor and transition it to "nodes"
        //                      original color.
        // startColor: Color to transition from.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];

        dojo.lang.forEach(nodes, function(node){
                var color = dojo.html.getBackgroundColor(node);
                var bg = dojo.html.getStyle(node, "background-color").toLowerCase();
                var bgImage = dojo.html.getStyle(node, "background-image");
                var wasTransparent = (bg == "transparent" || bg == "rgba(0, 0, 0, 0)");
                while(color.length > 3) { color.pop(); }

                var rgb = new dojo.gfx.color.Color(startColor);
                var endRgb = new dojo.gfx.color.Color(color);

                var anim = dojo.lfx.propertyAnimation(node, 
                        { "background-color": { start: rgb, end: endRgb } }, 
                        duration, 
                        easing,
                        {
                                "beforeBegin": function(){ 
                                        if(bgImage){
                                                node.style.backgroundImage = "none";
                                        }
                                        node.style.backgroundColor = "rgb(" + rgb.toRgb().join(",") + ")";
                                },
                                "onEnd": function(){ 
                                        if(bgImage){
                                                node.style.backgroundImage = bgImage;
                                        }
                                        if(wasTransparent){
                                                node.style.backgroundColor = "transparent";
                                        }
                                        if(callback){
                                                callback(node, anim);
                                        }
                                }
                        }
                );

                anims.push(anim);
        });
        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lfx.html.unhighlight = function(/*DOMNode[]*/ nodes,
                                                                         /*dojo.gfx.color.Color*/ endColor,
                                                                         /*int?*/ duration,
                                                                         /*Function?*/ easing,
                                                                         /*Function?*/ callback){
        // summary: Returns an animation that will transition "nodes" background color
        //                      from its current color to "endColor".
        // endColor: Color to transition to.
        // duration: Duration of the animation in milliseconds.
        // easing: An easing function.
        // callback: Function to run at the end of the animation.
        nodes = dojo.lfx.html._byId(nodes);
        var anims = [];

        dojo.lang.forEach(nodes, function(node){
                var color = new dojo.gfx.color.Color(dojo.html.getBackgroundColor(node));
                var rgb = new dojo.gfx.color.Color(endColor);

                var bgImage = dojo.html.getStyle(node, "background-image");
                
                var anim = dojo.lfx.propertyAnimation(node, 
                        { "background-color": { start: color, end: rgb } },
                        duration, 
                        easing,
                        {
                                "beforeBegin": function(){ 
                                        if(bgImage){
                                                node.style.backgroundImage = "none";
                                        }
                                        node.style.backgroundColor = "rgb(" + color.toRgb().join(",") + ")";
                                },
                                "onEnd": function(){ 
                                        if(callback){
                                                callback(node, anim);
                                        }
                                }
                        }
                );
                anims.push(anim);
        });
        return dojo.lfx.combine(anims); // dojo.lfx.Combine
}

dojo.lang.mixin(dojo.lfx, dojo.lfx.html);

dojo.kwCompoundRequire({
        browser: ["dojo.lfx.html"],
        dashboard: ["dojo.lfx.html"]
});
dojo.provide("dojo.lfx.*");