Index: /CKRobot/trunk/README.textile
===================================================================
--- /CKRobot/trunk/README.textile (revision 7127)
+++ /CKRobot/trunk/README.textile (revision 7127)
@@ -0,0 +1,63 @@
+h2. Brief
+
+CKRobot is a high-level functional testing automation tool designed specifically for CKEditor, the "robot" works from
+outside web browsers to verify editor behaviors from an end user's perspective, interacting with the editor UI purely,
+all is driven by a pretty intuitive (JavaScript) test script describing the testing procedures.
+
+Unlike "CKTester":http://docs.cksource.com/CKTester/Users_Guide (CKEditor's unit testing tool), CKRobot doesn't hit the browser sandbox limitation, so tasks like typing
+inside the editor iframe was made possible, plus the possibility of covering different browsers on multiple platform, making
+it a very good companion of CKTester in the sense of functional testing.
+
+h2. Important Notes
+
+# Browsers will be located at the default installation location, otherwise you need to specify it manually
+by passing the location via JVM argument, e.g. -Dwebdriver.firefox.bin="d:\Program Files\Mozilla Firefox\firefox.exe"
+# Name references in test script are *UI language aware*, this means e.g. editor must be running with the default editor language (en) to have them passed,
+you can achieve that by changing browser's "language preferences":http://www.w3.org/International/questions/qa-lang-priorities.
+# Browser window need to fronted (and focus gained) when the robot is working, otherwise there will be exception thrown regard invisible element.
+
+h2. Quick Start
+
+# git clone this repository
+# cd to the root directory
+# "ckrobot -h" to kick start the CLI.
+# "ckrobot -r samples" to launch the sample test scripts.
+
+h2. Test Script
+
+You can grok the way of authoring test script by checking into the default sample scripts, detailed API document could
+ be generated using "_dev/docs".
+
+h2. Script Meta
+
+A test script holds a group of meta data that communicate with the runner of its preferences, those are defined as comment annotations
+at the beginning of the javascript file, the following are currently supported:
+
+* @tc Each file much hold this to declare itself a CKRobot test script.
+* @name The title of this piece of test, will be used as the test case name in test runner.
+* @browsers A list of browser names that the script dedicate to, this's useful when the test script is supposed to be running only for one or more browers.
+
+h2. Environment Variables
+
+Within test script variables could be used to avoid hard-coded strings that requires alternation when environment changes, e.g. base url of editor sample pages.
+The refereed variables are resolved from the content of a file named *vars.js* inside of the tests repository (-r).
+
+h2. Test Framework
+
+The familiarised "YUITest":https://github.com/yui/yuitest is used for both the runner and test apis, which is consistent with CKTester.
+
+h2. Test Report
+
+The test report is available in JUnit test report format which is the most friendly one for other consumers, output by default in "reports" dir, as well as the html version.
+
+h2. Tested Browers
+
+* InternetExplorer 7-9 (ie)
+* Firefox 3.x (ff)
+
+h2. Tested OS
+ * Windows7
+
+h2. Selenium
+
+Selenium/WebDriver version "2.0b1":http://code.google.com/p/selenium/downloads/detail?name=selenium-server-standalone-2.0b1.jar (lib/selenium.jar) is used but not the latest Selenium release.
Index: /CKRobot/trunk/_dev/docs.bat
===================================================================
--- /CKRobot/trunk/_dev/docs.bat (revision 7127)
+++ /CKRobot/trunk/_dev/docs.bat (revision 7127)
@@ -0,0 +1,10 @@
+@ECHO OFF
+::
+:: Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+:: For licensing, see LICENSE.html or http://ckeditor.com/license
+::
+:: Builds the documentation files.
+::
+
+del /F /Q "../docs/*.*"
+java -jar jsdoc-toolkit/jsrun.jar jsdoc-toolkit/app/run.js -c=docs.conf
Index: /CKRobot/trunk/_dev/docs.conf
===================================================================
--- /CKRobot/trunk/_dev/docs.conf (revision 7127)
+++ /CKRobot/trunk/_dev/docs.conf (revision 7127)
@@ -0,0 +1,22 @@
+{
+ // Source files to parse.
+ _:
+ [
+ '../src/api.js'
+ ],
+
+ // Document all functions, even uncommented ones.
+ a: true,
+
+ // Recursively, up to 100 directories depth.
+ r: 100,
+
+ // use this directory as the output directory
+ d: '../docs',
+
+ // Template.
+ t: 'template',
+
+ // Verbose mode.
+ v: false
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame.js (revision 7127)
@@ -0,0 +1,33 @@
+IO.include("frame/Opt.js");
+IO.include("frame/Chain.js");
+IO.include("frame/Link.js");
+IO.include("frame/String.js");
+IO.include("frame/Hash.js");
+IO.include("frame/Namespace.js");
+//IO.include("frame/Reflection.js");
+
+/** A few helper functions to make life a little easier. */
+
+function defined(o) {
+ return (o !== undefined);
+}
+
+function copy(o) { // todo check for circular refs
+ if (o == null || typeof(o) != 'object') return o;
+ var c = new o.constructor();
+ for(var p in o) c[p] = copy(o[p]);
+ return c;
+}
+
+function isUnique(arr) {
+ var l = arr.length;
+ for(var i = 0; i < l; i++ ) {
+ if (arr.lastIndexOf(arr[i]) > i) return false;
+ }
+ return true;
+}
+
+/** Returns the given string with all regex meta characters backslashed. */
+RegExp.escapeMeta = function(str) {
+ return str.replace(/([$^\\\/()|?+*\[\]{}.-])/g, "\\$1");
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Chain.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Chain.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Chain.js (revision 7127)
@@ -0,0 +1,102 @@
+/**@constructor*/
+function ChainNode(object, link) {
+ this.value = object;
+ this.link = link; // describes this node's relationship to the previous node
+}
+
+/**@constructor*/
+function Chain(valueLinks) {
+ this.nodes = [];
+ this.cursor = -1;
+
+ if (valueLinks && valueLinks.length > 0) {
+ this.push(valueLinks[0], "//");
+ for (var i = 1, l = valueLinks.length; i < l; i+=2) {
+ this.push(valueLinks[i+1], valueLinks[i]);
+ }
+ }
+}
+
+Chain.prototype.push = function(o, link) {
+ if (this.nodes.length > 0 && link) this.nodes.push(new ChainNode(o, link));
+ else this.nodes.push(new ChainNode(o));
+}
+
+Chain.prototype.unshift = function(o, link) {
+ if (this.nodes.length > 0 && link) this.nodes[0].link = link;
+ this.nodes.unshift(new ChainNode(o));
+ this.cursor++;
+}
+
+Chain.prototype.get = function() {
+ if (this.cursor < 0 || this.cursor > this.nodes.length-1) return null;
+ return this.nodes[this.cursor];
+}
+
+Chain.prototype.first = function() {
+ this.cursor = 0;
+ return this.get();
+}
+
+Chain.prototype.last = function() {
+ this.cursor = this.nodes.length-1;
+ return this.get();
+}
+
+Chain.prototype.next = function() {
+ this.cursor++;
+ return this.get();
+}
+
+Chain.prototype.prev = function() {
+ this.cursor--;
+ return this.get();
+}
+
+Chain.prototype.toString = function() {
+ var string = "";
+ for (var i = 0, l = this.nodes.length; i < l; i++) {
+ if (this.nodes[i].link) string += " -("+this.nodes[i].link+")-> ";
+ string += this.nodes[i].value.toString();
+ }
+ return string;
+}
+
+Chain.prototype.joinLeft = function() {
+ var result = "";
+ for (var i = 0, l = this.cursor; i < l; i++) {
+ if (result && this.nodes[i].link) result += this.nodes[i].link;
+ result += this.nodes[i].value.toString();
+ }
+ return result;
+}
+
+
+/* USAGE:
+
+var path = "one/two/three.four/five-six";
+var pathChain = new Chain(path.split(/([\/.-])/));
+print(pathChain);
+
+var lineage = new Chain();
+lineage.push("Port");
+lineage.push("Les", "son");
+lineage.push("Dawn", "daughter");
+lineage.unshift("Purdie", "son");
+
+print(lineage);
+
+// walk left
+for (var node = lineage.last(); node !== null; node = lineage.prev()) {
+ print("< "+node.value);
+}
+
+// walk right
+var node = lineage.first()
+while (node !== null) {
+ print(node.value);
+ node = lineage.next();
+ if (node && node.link) print("had a "+node.link+" named");
+}
+
+*/
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Dumper.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Dumper.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Dumper.js (revision 7127)
@@ -0,0 +1,144 @@
+/**
+ * @class
+
+This is a lightly modified version of Kevin Jones' JavaScript
+library Data.Dump. To download the original visit:
+ http://openjsan.org/doc/k/ke/kevinj/Data/Dump/
+
+AUTHORS
+
+The Data.Dump JavaScript module is written by Kevin Jones
+(kevinj@cpan.org), based on Data::Dump by Gisle Aas (gisle@aas.no),
+based on Data::Dumper by Gurusamy Sarathy (gsar@umich.edu).
+
+COPYRIGHT
+
+Copyright 2007 Kevin Jones. Copyright 1998-2000,2003-2004 Gisle Aas.
+Copyright 1996-1998 Gurusamy Sarathy.
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the Perl Artistic License
+
+See http://www.perl.com/perl/misc/Artistic.html
+
+ * @static
+ */
+Dumper = {
+ /** @param [...] The objects to dump. */
+ dump: function () {
+ if (arguments.length > 1)
+ return this._dump(arguments);
+ else if (arguments.length == 1)
+ return this._dump(arguments[0]);
+ else
+ return "()";
+ },
+
+ _dump: function (obj) {
+ if (typeof obj == 'undefined') return 'undefined';
+ var out;
+ if (obj.serialize) { return obj.serialize(); }
+ var type = this._typeof(obj);
+ if (obj.circularReference) obj.circularReference++;
+ switch (type) {
+ case 'circular':
+ out = "{ //circularReference\n}";
+ break;
+ case 'object':
+ var pairs = new Array;
+
+ for (var prop in obj) {
+ if (prop != "circularReference" && obj.hasOwnProperty(prop)) { //hide inherited properties
+ pairs.push(prop + ': ' + this._dump(obj[prop]));
+ }
+ }
+
+ out = '{' + this._format_list(pairs) + '}';
+ break;
+
+ case 'string':
+ for (var prop in Dumper.ESC) {
+ if (Dumper.ESC.hasOwnProperty(prop)) {
+ obj = obj.replace(prop, Dumper.ESC[prop]);
+ }
+ }
+
+ // Escape UTF-8 Strings
+ if (obj.match(/^[\x00-\x7f]*$/)) {
+ out = '"' + obj.replace(/\"/g, "\\\"").replace(/([\n\r]+)/g, "\\$1") + '"';
+ }
+ else {
+ out = "unescape('"+escape(obj)+"')";
+ }
+ break;
+
+ case 'array':
+ var elems = new Array;
+
+ for (var i=0; i 60 ? '\n' : ' ';
+ return nl + list.join(',' + nl) + nl;
+ },
+
+ _typeof: function (obj) {
+ if (obj && obj.circularReference && obj.circularReference > 1) return 'circular';
+ if (Array.prototype.isPrototypeOf(obj)) return 'array';
+ if (Date.prototype.isPrototypeOf(obj)) return 'date';
+ if (typeof obj.nodeType != 'undefined') return 'element';
+ return typeof(obj);
+ },
+
+ _dump_dom: function (obj) {
+ return '"' + Dumper.nodeTypes[obj.nodeType] + '"';
+ }
+};
+
+Dumper.ESC = {
+ "\t": "\\t",
+ "\n": "\\n",
+ "\f": "\\f"
+};
+
+Dumper.nodeTypes = {
+ 1: "ELEMENT_NODE",
+ 2: "ATTRIBUTE_NODE",
+ 3: "TEXT_NODE",
+ 4: "CDATA_SECTION_NODE",
+ 5: "ENTITY_REFERENCE_NODE",
+ 6: "ENTITY_NODE",
+ 7: "PROCESSING_INSTRUCTION_NODE",
+ 8: "COMMENT_NODE",
+ 9: "DOCUMENT_NODE",
+ 10: "DOCUMENT_TYPE_NODE",
+ 11: "DOCUMENT_FRAGMENT_NODE",
+ 12: "NOTATION_NODE"
+};
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Hash.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Hash.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Hash.js (revision 7127)
@@ -0,0 +1,84 @@
+/**
+ @constructor
+ @example
+ var _index = new Hash();
+ _index.set("a", "apple");
+ _index.set("b", "blue");
+ _index.set("c", "coffee");
+
+ for (var p = _index.first(); p; p = _index.next()) {
+ print(p.key+" is for "+p.value);
+ }
+
+ */
+var Hash = function() {
+ this._map = {};
+ this._keys = [];
+ this._vals = [];
+ this.reset();
+}
+
+Hash.prototype.set = function(k, v) {
+ if (k != "") {
+ this._keys.push(k);
+ this._map["="+k] = this._vals.length;
+ this._vals.push(v);
+ }
+}
+
+Hash.prototype.replace = function(k, k2, v) {
+ if (k == k2) return;
+
+ var offset = this._map["="+k];
+ this._keys[offset] = k2;
+ if (typeof v != "undefined") this._vals[offset] = v;
+ this._map["="+k2] = offset;
+ delete(this._map["="+k]);
+}
+
+Hash.prototype.drop = function(k) {
+ if (k != "") {
+ var offset = this._map["="+k];
+ this._keys.splice(offset, 1);
+ this._vals.splice(offset, 1);
+ delete(this._map["="+k]);
+ for (var p in this._map) {
+ if (this._map[p] >= offset) this._map[p]--;
+ }
+ if (this._cursor >= offset && this._cursor > 0) this._cursor--;
+ }
+}
+
+Hash.prototype.get = function(k) {
+ if (k != "") {
+ return this._vals[this._map["="+k]];
+ }
+}
+
+Hash.prototype.keys = function() {
+ return this._keys;
+}
+
+Hash.prototype.hasKey = function(k) {
+ if (k != "") {
+ return (typeof this._map["="+k] != "undefined");
+ }
+}
+
+Hash.prototype.values = function() {
+ return this._vals;
+}
+
+Hash.prototype.reset = function() {
+ this._cursor = 0;
+}
+
+Hash.prototype.first = function() {
+ this.reset();
+ return this.next();
+}
+
+Hash.prototype.next = function() {
+ if (this._cursor++ < this._keys.length)
+ return {key: this._keys[this._cursor-1], value: this._vals[this._cursor-1]};
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Link.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Link.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Link.js (revision 7127)
@@ -0,0 +1,153 @@
+/** Handle the creation of HTML links to documented symbols.
+ @constructor
+*/
+function Link() {
+ this.alias = "";
+ this.src = "";
+ this.file = "";
+ this.text = "";
+ this.innerName = "";
+ this.classLink = false;
+ this.targetName = "";
+
+ this.target = function(targetName) {
+ if (defined(targetName)) this.targetName = targetName;
+ return this;
+ }
+ this.inner = function(inner) {
+ if (defined(inner)) this.innerName = inner;
+ return this;
+ }
+ this.withText = function(text) {
+ if (defined(text)) this.text = text;
+ return this;
+ }
+ this.toSrc = function(filename) {
+ if (defined(filename)) this.src = filename;
+ return this;
+ }
+ this.toSymbol = function(alias) {
+ if (defined(alias)) this.alias = new String(alias);
+ return this;
+ }
+ this.toClass = function(alias) {
+ this.classLink = true;
+ return this.toSymbol(alias);
+ }
+ this.toFile = function(file) {
+ if (defined(file)) this.file = file;
+ return this;
+ }
+
+ this.toString = function() {
+ var linkString;
+ var thisLink = this;
+
+ if (this.alias) {
+ linkString = this.alias.replace(/(^|[^a-z$0-9_#.:^-])([|a-z$0-9_#.:^-]+)($|[^a-z$0-9_#.:^-])/i,
+ function(match, prematch, symbolName, postmatch) {
+ var symbolNames = symbolName.split("|");
+ var links = [];
+ for (var i = 0, l = symbolNames.length; i < l; i++) {
+ thisLink.alias = symbolNames[i];
+ links.push(thisLink._makeSymbolLink(symbolNames[i]));
+ }
+ return prematch+links.join("|")+postmatch;
+ }
+ );
+ }
+ else if (this.src) {
+ linkString = thisLink._makeSrcLink(this.src);
+ }
+ else if (this.file) {
+ linkString = thisLink._makeFileLink(this.file);
+ }
+
+ return linkString;
+ }
+}
+
+/** prefixed for hashes */
+Link.hashPrefix = "";
+
+/** Appended to the front of relative link paths. */
+Link.base = "";
+
+Link.symbolNameToLinkName = function(symbol) {
+ var linker = "";
+ if (symbol.isStatic) linker = ".";
+ else if (symbol.isInner) linker = "-";
+
+ return Link.hashPrefix+linker+symbol.name;
+}
+
+/** Create a link to another symbol. */
+Link.prototype._makeSymbolLink = function(alias) {
+ var linkBase = Link.base+publish.conf.symbolsDir;
+ var linkTo = Link.symbolSet.getSymbol(alias);
+ var linkPath;
+ var target = (this.targetName)? " target=\""+this.targetName+"\"" : "";
+
+ // is it an internal link?
+ if (alias.charAt(0) == "#") var linkPath = alias;
+
+ // if there is no symbol by that name just return the name unaltered
+ else if (!linkTo) return this.text || alias;
+
+ // it's a symbol in another file
+ else {
+ if (!linkTo.is("CONSTRUCTOR") && !linkTo.isNamespace) { // it's a method or property
+ if (linkTo.isEvent) {
+ linkPath =
+ (Link.filemap)? Link.filemap[linkTo.memberOf]
+ :
+ escape(linkTo.memberOf) || "_global_";
+ linkPath += publish.conf.ext + "#event:" + Link.symbolNameToLinkName(linkTo);
+ }
+ else {
+ linkPath =
+ (Link.filemap)? Link.filemap[linkTo.memberOf]
+ :
+ escape(linkTo.memberOf) || "_global_";
+ linkPath += publish.conf.ext + "#" + Link.symbolNameToLinkName(linkTo);
+ }
+ }
+ else {
+ linkPath = (Link.filemap)? Link.filemap[linkTo.alias] : escape(linkTo.alias);
+ linkPath += publish.conf.ext;// + (this.classLink? "":"#" + Link.hashPrefix + "constructor");
+ }
+ linkPath = linkBase + linkPath
+ }
+
+ var linkText = this.text || alias;
+
+ var link = {linkPath: linkPath, linkText: linkText, linkInner: (this.innerName? "#"+this.innerName : "")};
+
+ if (typeof JSDOC.PluginManager != "undefined") {
+ JSDOC.PluginManager.run("onSymbolLink", link);
+ }
+
+ return ""+link.linkText+"";
+}
+
+/** Create a link to a source file. */
+Link.prototype._makeSrcLink = function(srcFilePath) {
+ var target = (this.targetName)? " target=\""+this.targetName+"\"" : "";
+
+ // transform filepath into a filename
+ var srcFile = srcFilePath.replace(/\.\.?[\\\/]/g, "").replace(/[:\\\/]/g, "_");
+ var outFilePath = Link.base + publish.conf.srcDir + srcFile + publish.conf.ext;
+
+ if (!this.text) this.text = FilePath.fileName(srcFilePath);
+ return ""+this.text+"";
+}
+
+/** Create a link to a source file. */
+Link.prototype._makeFileLink = function(filePath) {
+ var target = (this.targetName)? " target=\""+this.targetName+"\"" : "";
+
+ var outFilePath = Link.base + filePath;
+
+ if (!this.text) this.text = filePath;
+ return ""+this.text+"";
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Namespace.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Namespace.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Namespace.js (revision 7127)
@@ -0,0 +1,10 @@
+_global_ = this;
+
+function Namespace(name, f) {
+ var n = name.split(".");
+ for (var o = _global_, i = 0, l = n.length; i < l; i++) {
+ o = o[n[i]] = o[n[i]] || {};
+ }
+
+ if (f) f();
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Opt.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Opt.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Opt.js (revision 7127)
@@ -0,0 +1,134 @@
+/** @namespace */
+Opt = {
+ /**
+ * Get commandline option values.
+ * @param {Array} args Commandline arguments. Like ["-a=xml", "-b", "--class=new", "--debug"]
+ * @param {object} optNames Map short names to long names. Like {a:"accept", b:"backtrace", c:"class", d:"debug"}.
+ * @return {object} Short names and values. Like {a:"xml", b:true, c:"new", d:true}
+ */
+ get: function(args, optNames) {
+ var opt = {"_": []}; // the unnamed option allows multiple values
+ for (var i = 0; i < args.length; i++) {
+ var arg = new String(args[i]);
+ var name;
+ var value;
+ if (arg.charAt(0) == "-") {
+ if (arg.charAt(1) == "-") { // it's a longname like --foo
+ arg = arg.substring(2);
+ var m = arg.split("=");
+ name = m.shift();
+ value = m.shift();
+ if (typeof value == "undefined") value = true;
+
+ for (var n in optNames) { // convert it to a shortname
+ if (name == optNames[n]) {
+ name = n;
+ }
+ }
+ }
+ else { // it's a shortname like -f
+ arg = arg.substring(1);
+ var m = arg.split("=");
+ name = m.shift();
+ value = m.shift();
+ if (typeof value == "undefined") value = true;
+
+ for (var n in optNames) { // find the matching key
+ if (name == n || name+'[]' == n) {
+ name = n;
+ break;
+ }
+ }
+ }
+ if (name.match(/(.+)\[\]$/)) { // it's an array type like n[]
+ name = RegExp.$1;
+ if (!opt[name]) opt[name] = [];
+ }
+
+ if (opt[name] && opt[name].push) {
+ opt[name].push(value);
+ }
+ else {
+ opt[name] = value;
+ }
+ }
+ else { // not associated with any optname
+ opt._.push(args[i]);
+ }
+ }
+ return opt;
+ }
+}
+
+/*t:
+ plan(11, "Testing Opt.");
+
+ is(
+ typeof Opt,
+ "object",
+ "Opt is an object."
+ );
+
+ is(
+ typeof Opt.get,
+ "function",
+ "Opt.get is a function."
+ );
+
+ var optNames = {a:"accept", b:"backtrace", c:"class", d:"debug", "e[]":"exceptions"};
+ var t_options = Opt.get(["-a=xml", "-b", "--class=new", "--debug", "-e=one", "-e=two", "foo", "bar"], optNames);
+
+ is(
+ t_options.a,
+ "xml",
+ "an option defined with a short name can be accessed by its short name."
+ );
+
+ is(
+ t_options.b,
+ true,
+ "an option defined with a short name and no value are true."
+ );
+
+ is(
+ t_options.c,
+ "new",
+ "an option defined with a long name can be accessed by its short name."
+ );
+
+ is(
+ t_options.d,
+ true,
+ "an option defined with a long name and no value are true."
+ );
+
+ is(
+ typeof t_options.e,
+ "object",
+ "an option that can accept multiple values is defined."
+ );
+
+ is(
+ t_options.e.length,
+ 2,
+ "an option that can accept multiple values can have more than one value."
+ );
+
+ is(
+ t_options.e[1],
+ "two",
+ "an option that can accept multiple values can be accessed as an array."
+ );
+
+ is(
+ typeof t_options._,
+ "object",
+ "the property '_' is defined for unnamed options."
+ );
+
+ is(
+ t_options._[0],
+ "foo",
+ "the property '_' can be accessed as an array."
+ );
+ */
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Reflection.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Reflection.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/Reflection.js (revision 7127)
@@ -0,0 +1,26 @@
+/**@constructor*/
+function Reflection(obj) {
+ this.obj = obj;
+}
+
+Reflection.prototype.getConstructorName = function() {
+ if (this.obj.constructor.name) return this.obj.constructor.name;
+ var src = this.obj.constructor.toSource();
+ var name = src.substring(name.indexOf("function")+8, src.indexOf('(')).replace(/ /g,'');
+ return name;
+}
+
+Reflection.prototype.getMethod = function(name) {
+ for (var p in this.obj) {
+ if (p == name && typeof(this.obj[p]) == "function") return this.obj[p];
+ }
+ return null;
+}
+
+Reflection.prototype.getParameterNames = function() {
+ var src = this.obj.toSource();
+ src = src.substring(
+ src.indexOf("(", 8)+1, src.indexOf(")")
+ );
+ return src.split(/, ?/);
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/String.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/String.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/frame/String.js (revision 7127)
@@ -0,0 +1,93 @@
+/**
+ @name String
+ @class Additions to the core string object.
+*/
+
+/** @author Steven Levithan, released as public domain. */
+String.prototype.trim = function() {
+ var str = this.replace(/^\s+/, '');
+ for (var i = str.length - 1; i >= 0; i--) {
+ if (/\S/.test(str.charAt(i))) {
+ str = str.substring(0, i + 1);
+ break;
+ }
+ }
+ return str;
+}
+/*t:
+ plan(6, "Testing String.prototype.trim.");
+
+ var s = " a bc ".trim();
+ is(s, "a bc", "multiple spaces front and back are trimmed.");
+
+ s = "a bc\n\n".trim();
+ is(s, "a bc", "newlines only in back are trimmed.");
+
+ s = "\ta bc".trim();
+ is(s, "a bc", "tabs only in front are trimmed.");
+
+ s = "\n \t".trim();
+ is(s, "", "an all-space string is trimmed to empty.");
+
+ s = "a b\nc".trim();
+ is(s, "a b\nc", "a string with no spaces in front or back is trimmed to itself.");
+
+ s = "".trim();
+ is(s, "", "an empty string is trimmed to empty.");
+
+*/
+
+String.prototype.balance = function(open, close) {
+ var i = 0;
+ while (this.charAt(i) != open) {
+ if (i == this.length) return [-1, -1];
+ i++;
+ }
+
+ var j = i+1;
+ var balance = 1;
+ while (j < this.length) {
+ if (this.charAt(j) == open) balance++;
+ if (this.charAt(j) == close) balance--;
+ if (balance == 0) break;
+ j++;
+ if (j == this.length) return [-1, -1];
+ }
+
+ return [i, j];
+}
+/*t:
+ plan(16, "Testing String.prototype.balance.");
+
+ var s = "{abc}".balance("{","}");
+ is(s[0], 0, "opener in first is found.");
+ is(s[1], 4, "closer in last is found.");
+
+ s = "ab{c}de".balance("{","}");
+ is(s[0], 2, "opener in middle is found.");
+ is(s[1], 4, "closer in middle is found.");
+
+ s = "a{b{c}de}f".balance("{","}");
+ is(s[0], 1, "nested opener is found.");
+ is(s[1], 8, "nested closer is found.");
+
+ s = "{}".balance("{","}");
+ is(s[0], 0, "opener with no content is found.");
+ is(s[1], 1, "closer with no content is found.");
+
+ s = "".balance("{","}");
+ is(s[0], -1, "empty string opener is -1.");
+ is(s[1], -1, "empty string closer is -1.");
+
+ s = "{abc".balance("{","}");
+ is(s[0], -1, "opener with no closer returns -1.");
+ is(s[1], -1, "no closer returns -1.");
+
+ s = "abc".balance("{","}");
+ is(s[0], -1, "no opener or closer returns -1 for opener.");
+ is(s[1], -1, "no opener or closer returns -1 for closer.");
+
+ s = "aX11/MIT License
+ * (See the accompanying README file for full details.)
+ */
+
+/**
+ Yet another unit testing tool for JavaScript.
+ @author Michael Mathews micmath@gmail.com
+ @param {object} testCases Properties are testcase names, values are functions to execute as tests.
+*/
+function testrun(testCases) {
+ var ran = 0;
+ for (t in testCases) {
+ var result = testCases[t]();
+ ran++;
+ }
+
+ return testrun.reportOut+"-------------------------------\n"+((testrun.fails>0)? ":( Failed "+testrun.fails+"/" : ":) Passed all ")+testrun.count+" test"+((testrun.count == 1)? "":"s")+".\n";
+}
+
+
+testrun.count = 0;
+testrun.current = null;
+testrun.passes = 0;
+testrun.fails = 0;
+testrun.reportOut = "";
+
+/** @private */
+testrun.report = function(text) {
+ testrun.reportOut += text+"\n";
+}
+
+/**
+ Check if test evaluates to true.
+ @param {string} test To be evaluated.
+ @param {string} message Optional. To be displayed in the report.
+ @return {boolean} True if the string test evaluates to true.
+*/
+ok = function(test, message) {
+ testrun.count++;
+
+ var result;
+ try {
+ result = eval(test);
+
+ if (result) {
+ testrun.passes++;
+ testrun.report(" OK "+testrun.count+" - "+((message != null)? message : ""));
+ }
+ else {
+ testrun.fails++;
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+ }
+ }
+ catch(e) {
+ testrun.fails++
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+
+ }
+}
+
+/**
+ Check if test is same as expected.
+ @param {string} test To be evaluated.
+ @param {string} expected
+ @param {string} message Optional. To be displayed in the report.
+ @return {boolean} True if (test == expected). Note that the comparison is not a strict equality check.
+*/
+is = function(test, expected, message) {
+ testrun.count++;
+
+ var result;
+ try {
+ result = eval(test);
+
+ if (result == expected) {
+ testrun.passes++
+ testrun.report(" OK "+testrun.count+" - "+((message != null)? message : ""));
+ }
+ else {
+ testrun.fails++
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+ testrun.report("expected: "+expected);
+ testrun.report(" got: "+result);
+ }
+ }
+ catch(e) {
+ testrun.fails++
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+ testrun.report("expected: "+expected);
+ testrun.report(" got: "+result);}
+}
+
+/**
+ Check if test matches pattern.
+ @param {string} test To be evaluated.
+ @param {string} pattern Used to create a RegExp.
+ @param {string} message Optional. To be displayed in the report.
+ @return {boolean} True if test matches pattern.
+*/
+like = function(test, pattern, message) {
+ testrun.count++;
+
+ var result;
+ try {
+ result = eval(test);
+ var rgx = new RegExp(pattern);
+
+ if (rgx.test(result)) {
+ testrun.passes++
+ testrun.report(" OK "+testrun.count+" - "+((message != null)? message : ""));
+ }
+ else {
+ testrun.fails++
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+ testrun.report(" this: "+result);
+ testrun.report("is not like: "+pattern);
+ }
+ }
+ catch(e) {
+ testrun.fails++
+ testrun.report("NOT OK "+testrun.count+" - "+((message != null)? message : ""));
+ }
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/FOODOC.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/FOODOC.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/FOODOC.js (revision 7127)
@@ -0,0 +1,26 @@
+/**
+ This is the main container for the FOODOC handler.
+ @namespace
+*/
+FOODOC = {
+};
+
+/** The current version string of this application. */
+FOODOC.VERSION = "1.0";
+
+FOODOC.handle = function(srcFile, src) {
+ LOG.inform("Handling file '" + srcFile + "'");
+
+ return [
+ new JSDOC.Symbol(
+ "foo",
+ [],
+ "VIRTUAL",
+ new JSDOC.DocComment("/** This is a foo. */")
+ )
+ ];
+};
+
+FOODOC.publish = function(symbolgroup) {
+ LOG.inform("Publishing symbolgroup.");
+};
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC.js (revision 7127)
@@ -0,0 +1,26 @@
+/**
+ * This is the main container for the XMLDOC handler.
+ * @namespace
+ * @author Brett Fattori (bfattori@fry.com)
+ * @version $Revision: 498 $
+ */
+XMLDOC = {
+
+};
+
+/** The current version string of this application. */
+XMLDOC.VERSION = "1.0";
+
+/** Include the library necessary to handle XML files */
+IO.includeDir("handlers/XMLDOC/");
+
+/**
+ * @type Symbol[]
+ */
+XMLDOC.handle = function(srcFile, src) {
+
+};
+
+XMLDOC.publish = function(symbolgroup) {
+
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js (revision 7127)
@@ -0,0 +1,159 @@
+LOG.inform("XMLDOC.DomReader loaded");
+
+XMLDOC.DomReader = function(root) {
+
+ this.dom = root;
+
+ /**
+ * The current node the reader is on
+ */
+ this.node = root;
+
+ /**
+ * Get the current node the reader is on
+ * @type XMLDOC.Parser.node
+ */
+ XMLDOC.DomReader.prototype.getNode = function() {
+ return this.node;
+ };
+
+ /**
+ * Set the node the reader should be positioned on.
+ * @param node {XMLDOC.Parser.node}
+ */
+ XMLDOC.DomReader.prototype.setNode = function(node) {
+ this.node = node;
+ };
+
+ /**
+ * A helper method to make sure the current node will
+ * never return null, unless null is passed as the root.
+ * @param step {String} An expression to evaluate - should return a node or null
+ */
+ XMLDOC.DomReader.prototype.navigate = function(step) {
+ var n;
+ if ((n = step) != null)
+ {
+ this.node = n;
+ return this.node;
+ }
+ return null;
+ };
+
+ /**
+ * Get the root node of the current node's document.
+ */
+ XMLDOC.DomReader.prototype.root = function() {
+ this.navigate(this.dom);
+ };
+
+ /**
+ * Get the parent of the current node.
+ */
+ XMLDOC.DomReader.prototype.parent = function() {
+ return this.navigate(this.node.parentNode());
+ };
+
+ /**
+ * Get the first child of the current node.
+ */
+ XMLDOC.DomReader.prototype.firstChild = function() {
+ return this.navigate(this.node.firstChild());
+ };
+
+ /**
+ * Get the last child of the current node.
+ */
+ XMLDOC.DomReader.prototype.lastChild = function() {
+ return this.navigate(this.node.lastChild());
+ };
+
+ /**
+ * Get the next sibling of the current node.
+ */
+ XMLDOC.DomReader.prototype.nextSibling = function() {
+ return this.navigate(this.node.nextSibling());
+ };
+
+ /**
+ * Get the previous sibling of the current node.
+ */
+ XMLDOC.DomReader.prototype.prevSibling = function() {
+ return this.navigate(this.node.prevSibling());
+ };
+
+ //===============================================================================================
+ // Support methods
+
+ /**
+ * Walk the tree starting with the current node, calling the plug-in for
+ * each node visited. Each time the plug-in is called, the DomReader
+ * is passed as the only parameter. Use the {@link XMLDOC.DomReader#getNode} method
+ * to access the current node. This method uses a depth first traversal pattern.
+ *
+ * @param srcFile {String} The source file being evaluated
+ */
+ XMLDOC.DomReader.prototype.getSymbols = function(srcFile)
+ {
+ XMLDOC.DomReader.symbols = [];
+ XMLDOC.DomReader.currentFile = srcFile;
+ JSDOC.Symbol.srcFile = (srcFile || "");
+
+ if (defined(JSDOC.PluginManager)) {
+ JSDOC.PluginManager.run("onDomGetSymbols", this);
+ }
+
+ return XMLDOC.DomReader.symbols;
+ };
+
+ /**
+ * Find the node with the given name using a depth first traversal.
+ * Does not modify the DomReader's current node.
+ *
+ * @param name {String} The name of the node to find
+ * @return the node that was found, or null if not found
+ */
+ XMLDOC.DomReader.prototype.findNode = function(name)
+ {
+ var findNode = null;
+
+ // Start at the current node and move into the subtree,
+ // looking for the node with the given name
+ function deeper(node, find)
+ {
+ var look = null;
+
+ if (node) {
+ if (node.name == find)
+ {
+ return node;
+ }
+
+ if (node.firstChild())
+ {
+ look = deeper(node.firstChild(), find);
+ }
+
+ if (!look && node.nextSibling())
+ {
+ look = deeper(node.nextSibling(), find);
+ }
+ }
+
+ return look;
+ }
+
+ return deeper(this.getNode().firstChild(), name);
+ };
+
+ /**
+ * Find the next node with the given name using a depth first traversal.
+ *
+ * @param name {String} The name of the node to find
+ */
+ XMLDOC.DomReader.prototype.findPreviousNode = function(name)
+ {
+ };
+
+};
+
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js (revision 7127)
@@ -0,0 +1,16 @@
+LOG.inform("XMLDOC.symbolize loaded");
+
+/**
+ * Convert the source file to a set of symbols
+ */
+XMLDOC.symbolize = function(srcFile, src) {
+
+ LOG.inform("Symbolizing file '" + srcFile + "'");
+
+ // XML files already have a defined structure, so we don't need to
+ // do anything but parse them. The DOM reader can create a symbol
+ // table from the parsed XML.
+ var dr = new XMLDOC.DomReader(XMLDOC.Parser.parse(src));
+ return dr.getSymbols(srcFile);
+
+};
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js (revision 7127)
@@ -0,0 +1,292 @@
+LOG.inform("XMLDOC.Parser loaded");
+
+/**
+ * XML Parser object. Returns an {@link #XMLDOC.Parser.node} which is
+ * the root element of the parsed document.
+ *
+ * By default, this parser will only handle well formed XML. To
+ * allow the parser to handle HTML, set the XMLDOC.Parser.strictMode
+ * variable to false before calling XMLDOC.Parser.parse().
+ *
+ * Note: If you pass poorly formed XML, it will cause the parser to throw
+ * an exception.
+ *
+ * @author Brett Fattori (bfattori@fry.com)
+ * @author $Author: micmath $
+ * @version $Revision: 497 $
+ */
+XMLDOC.Parser = {};
+
+/**
+ * Strict mode setting. Setting this to false allows HTML-style source to
+ * be parsed. Normally, well formed XML has defined end tags, or empty tags
+ * are properly formed. Default: true
+ * @type Boolean
+ */
+XMLDOC.Parser.strictMode = true;
+
+/**
+ * A node in an XML Document. Node types are ROOT, ELEMENT, COMMENT, PI, and TEXT.
+ * @param parent {XMLDOC.Parser.node} The parent node
+ * @param name {String} The node name
+ * @param type {String} One of the types
+ */
+XMLDOC.Parser.node = function(parent, name, type)
+{
+ this.name = name;
+ this.type = type || "ELEMENT";
+ this.parent = parent;
+ this.charData = "";
+ this.attrs = {};
+ this.nodes = [];
+ this.cPtr = 0;
+
+ XMLDOC.Parser.node.prototype.getAttributeNames = function() {
+ var a = [];
+ for (var o in this.attrs)
+ {
+ a.push(o);
+ }
+
+ return a;
+ };
+
+ XMLDOC.Parser.node.prototype.getAttribute = function(attr) {
+ return this.attrs[attr];
+ };
+
+ XMLDOC.Parser.node.prototype.setAttribute = function(attr, val) {
+ this.attrs[attr] = val;
+ };
+
+ XMLDOC.Parser.node.prototype.getChild = function(idx) {
+ return this.nodes[idx];
+ };
+
+ XMLDOC.Parser.node.prototype.parentNode = function() {
+ return this.parent;
+ };
+
+ XMLDOC.Parser.node.prototype.firstChild = function() {
+ return this.nodes[0];
+ };
+
+ XMLDOC.Parser.node.prototype.lastChild = function() {
+ return this.nodes[this.nodes.length - 1];
+ };
+
+ XMLDOC.Parser.node.prototype.nextSibling = function() {
+ var p = this.parent;
+ if (p && (p.nodes.indexOf(this) + 1 != p.nodes.length))
+ {
+ return p.getChild(p.nodes.indexOf(this) + 1);
+ }
+ return null;
+ };
+
+ XMLDOC.Parser.node.prototype.prevSibling = function() {
+ var p = this.parent;
+ if (p && (p.nodes.indexOf(this) - 1 >= 0))
+ {
+ return p.getChild(p.nodes.indexOf(this) - 1);
+ }
+ return null;
+ };
+};
+
+/**
+ * Parse an XML Document from the specified source. The XML should be
+ * well formed, unless strict mode is disabled, then the parser will
+ * handle HTML-style XML documents.
+ * @param src {String} The source to parse
+ */
+XMLDOC.Parser.parse = function(src)
+{
+ var A = [];
+
+ // Normailize whitespace
+ A = src.split("\r\n");
+ src = A.join("\n");
+ A = src.split("\r");
+ src = A.join("\n");
+
+ // Remove XML and DOCTYPE specifier
+ src.replace(/<\?XML .*\?>/i, "");
+ src.replace(//i, "");
+
+ // The document is the root node and cannot be modified or removed
+ var doc = new XMLDOC.Parser.node(null, "ROOT", "DOCUMENT");
+
+ // Let's break it down
+ XMLDOC.Parser.eat(doc, src);
+
+ return doc;
+};
+
+/**
+ * The XML fragment processing routine. This method is private and should not be called
+ * directly.
+ * @param parentNode {XMLDOC.Parser.node} The node which is the parent of this fragment
+ * @param src {String} The source within the fragment to process
+ * @private
+ */
+XMLDOC.Parser.eat = function(parentNode, src)
+{
+ // A simple tag def
+ var reTag = new RegExp("<(!|)(\\?|--|)((.|\\s)*?)\\2>","g");
+
+ // Special tag types
+ var reCommentTag = //;
+ var rePITag = /<\?((.|\s)*?)\?>/;
+
+ // A start tag (with potential empty marker)
+ var reStartTag = /<(.*?)( +([\w_\-]*)=(\"|')(.*)\4)*(\/)?>/;
+
+ // An empty HTML style tag (not proper XML, but we'll accept it so we can process HTML)
+ var reHTMLEmptyTag = /<(.*?)( +([\w_\-]*)=(\"|')(.*)\4)*>/;
+
+ // Fully enclosing tag with nested tags
+ var reEnclosingTag = /<(.*?)( +([\w_\-]*)=(\"|')(.*?)\4)*>((.|\s)*?)<\/\1>/;
+
+ // Breaks down attributes
+ var reAttributes = new RegExp(" +([\\w_\\-]*)=(\"|')(.*?)\\2","g");
+
+ // Find us a tag
+ var tag;
+ while ((tag = reTag.exec(src)) != null)
+ {
+ if (tag.index > 0)
+ {
+ // The next tag has some text before it
+ var text = src.substring(0, tag.index).replace(/^[ \t\n]+((.|\n)*?)[ \t\n]+$/, "$1");
+
+ if (text.length > 0 && (text != "\n"))
+ {
+ var txtnode = new XMLDOC.Parser.node(parentNode, "", "TEXT");
+ txtnode.charData = text;
+
+ // Append the new text node
+ parentNode.nodes.push(txtnode);
+ }
+
+ // Reset the lastIndex of reTag
+ reTag.lastIndex -= src.substring(0, tag.index).length;
+
+ // Eat the text
+ src = src.substring(tag.index);
+ }
+
+ if (reCommentTag.test(tag[0]))
+ {
+ // Is this a comment?
+ var comment = new XMLDOC.Parser.node(parentNode, "", "COMMENT");
+ comment.charData = reCommentTag.exec(tag[0])[1];
+
+ // Append the comment
+ parentNode.nodes.push(comment);
+
+ // Move the lastIndex of reTag
+ reTag.lastIndex -= tag[0].length;
+
+ // Eat the tag
+ src = src.replace(reCommentTag, "");
+ }
+ else if (rePITag.test(tag[0]))
+ {
+ // Is this a processing instruction?
+ var pi = new XMLDOC.Parser.node(parentNode, "", "PI");
+ pi.charData = rePITag.exec(tag[0])[1];
+
+ // Append the processing instruction
+ parentNode.nodes.push(pi);
+
+ // Move the lastIndex of reTag
+ reTag.lastIndex -= tag[0].length;
+
+ // Eat the tag
+ src = src.replace(rePITag, "");
+ }
+ else if (reStartTag.test(tag[0]))
+ {
+ // Break it down
+ var e = reStartTag.exec(tag[0]);
+ var elem = new XMLDOC.Parser.node(parentNode, e[1], "ELEMENT");
+
+ // Get attributes from the tag
+ var a;
+ while ((a = reAttributes.exec(e[2])) != null )
+ {
+ elem.attrs[a[1]] = a[3];
+ }
+
+ // Is this an empty XML-style tag?
+ if (e[6] == "/")
+ {
+ // Append the empty element
+ parentNode.nodes.push(elem);
+
+ // Move the lastIndex of reTag (include the start tag length)
+ reTag.lastIndex -= e[0].length;
+
+ // Eat the tag
+ src = src.replace(reStartTag, "");
+ }
+ else
+ {
+ // Check for malformed XML tags
+ var htmlParsed = false;
+ var htmlStartTag = reHTMLEmptyTag.exec(src);
+
+ // See if there isn't an end tag within this block
+ var reHTMLEndTag = new RegExp("");
+ var htmlEndTag = reHTMLEndTag.exec(src);
+
+ if (XMLDOC.Parser.strictMode && htmlEndTag == null)
+ {
+ // Poorly formed XML fails in strict mode
+ var err = new Error("Malformed XML passed to XMLDOC.Parser... Error contains malformed 'src'");
+ err.src = src;
+ throw err;
+ }
+ else if (htmlEndTag == null)
+ {
+ // This is an HTML-style empty tag, store the element for it in non-strict mode
+ parentNode.nodes.push(elem);
+
+ // Eat the tag
+ src = src.replace(reHTMLEmptyTag, "");
+ htmlParsed = true;
+ }
+
+ // If we didn't parse HTML-style, it must be an enclosing tag
+ if (!htmlParsed)
+ {
+ var enc = reEnclosingTag.exec(src);
+
+ // Go deeper into the document
+ XMLDOC.Parser.eat(elem, enc[6]);
+
+ // Append the new element node
+ parentNode.nodes.push(elem);
+
+ // Eat the tag
+ src = src.replace(reEnclosingTag, "");
+ }
+ }
+
+ // Reset the lastIndex of reTag
+ reTag.lastIndex = 0;
+ }
+ }
+
+ // No tag was found... append the text if there is any
+ src = src.replace(/^[ \t\n]+((.|\n)*?)[ \t\n]+$/, "$1");
+ if (src.length > 0 && (src != "\n"))
+ {
+ var txtNode = new XMLDOC.Parser.node(parentNode, "", "TEXT");
+ txtNode.charData = src;
+
+ // Append the new text node
+ parentNode.nodes.push(txtNode);
+ }
+};
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC.js (revision 7127)
@@ -0,0 +1,104 @@
+/**
+ @overview
+ @date $Date: 2009-09-04 14:43:41 +0800 (周五, 04 九月 2009) $
+ @version $Revision: 814 $
+ @location $HeadURL: http://jsdoc-toolkit.googlecode.com/svn/tags/jsdoc_toolkit-2.3.2/jsdoc-toolkit/app/lib/JSDOC.js $
+ @name JSDOC.js
+ */
+
+/**
+ This is the main container for the JSDOC application.
+ @namespace
+*/
+JSDOC = {
+};
+
+/**
+ @requires Opt
+ */
+if (typeof arguments == "undefined") arguments = [];
+JSDOC.opt = Opt.get(
+ arguments,
+ {
+ a: "allfunctions",
+ c: "conf",
+ d: "directory",
+ "D[]": "define",
+ e: "encoding",
+ "E[]": "exclude",
+ h: "help",
+ n: "nocode",
+ o: "out",
+ p: "private",
+ q: "quiet",
+ r: "recurse",
+ S: "securemodules",
+ s: "suppress",
+ t: "template",
+ T: "testmode",
+ u: "unique",
+ v: "verbose",
+ x: "ext"
+ }
+);
+
+/** The current version string of this application. */
+JSDOC.VERSION = "2.3.2";
+
+/** Print out usage information and quit. */
+JSDOC.usage = function() {
+ print("USAGE: java -jar jsrun.jar app/run.js [OPTIONS] ...");
+ print("");
+ print("OPTIONS:");
+ print(" -a or --allfunctions\n Include all functions, even undocumented ones.\n");
+ print(" -c or --conf\n Load a configuration file.\n");
+ print(" -d= or --directory=\n Output to this directory (defaults to \"out\").\n");
+ print(" -D=\"myVar:My value\" or --define=\"myVar:My value\"\n Multiple. Define a variable, available in JsDoc as JSDOC.opt.D.myVar.\n");
+ print(" -e= or --encoding=\n Use this encoding to read and write files.\n");
+ print(" -E=\"REGEX\" or --exclude=\"REGEX\"\n Multiple. Exclude files based on the supplied regex.\n");
+ print(" -h or --help\n Show this message and exit.\n");
+ print(" -n or --nocode\n Ignore all code, only document comments with @name tags.\n");
+ print(" -o= or --out=\n Print log messages to a file (defaults to stdout).\n");
+ print(" -p or --private\n Include symbols tagged as private, underscored and inner symbols.\n");
+ print(" -q or --quiet\n Do not output any messages, not even warnings.\n");
+ print(" -r= or --recurse=\n Descend into src directories.\n");
+ print(" -s or --suppress\n Suppress source code output.\n");
+ print(" -S or --securemodules\n Use Secure Modules mode to parse source code.\n");
+ print(" -t= or --template=\n Required. Use this template to format the output.\n");
+ print(" -T or --test\n Run all unit tests and exit.\n");
+ print(" -u or --unique\n Force file names to be unique, but not based on symbol names.\n");
+ print(" -v or --verbose\n Provide verbose feedback about what is happening.\n");
+ print(" -x=[,EXT]... or --ext=[,EXT]...\n Scan source files with the given extension/s (defaults to js).\n");
+
+ quit();
+}
+
+/*t:
+ plan(4, "Testing JSDOC namespace.");
+
+ is(
+ typeof JSDOC,
+ "object",
+ "JSDOC.usage is a function."
+ );
+
+ is(
+ typeof JSDOC.VERSION,
+ "string",
+ "JSDOC.VERSION is a string."
+ );
+
+ is(
+ typeof JSDOC.usage,
+ "function",
+ "JSDOC.usage is a function."
+ );
+
+ is(
+ typeof JSDOC.opt,
+ "object",
+ "JSDOC.opt is a object."
+ );
+ */
+
+if (this.IO) IO.includeDir("lib/JSDOC/");
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocComment.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocComment.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocComment.js (revision 7127)
@@ -0,0 +1,200 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ Create a new DocComment. This takes a raw documentation comment,
+ and wraps it in useful accessors.
+ @class Represents a documentation comment object.
+ */
+JSDOC.DocComment = function(/**String*/comment) {
+ this.init();
+ if (typeof comment != "undefined") {
+ this.parse(comment);
+ }
+}
+
+JSDOC.DocComment.prototype.init = function() {
+ this.isUserComment = true;
+ this.src = "";
+ this.meta = "";
+ this.tagTexts = [];
+ this.tags = [];
+}
+
+/**
+ @requires JSDOC.DocTag
+ */
+JSDOC.DocComment.prototype.parse = function(/**String*/comment) {
+ if (comment == "") {
+ comment = "/** @desc */";
+ this.isUserComment = false;
+ }
+
+ this.src = JSDOC.DocComment.unwrapComment(comment);
+
+ this.meta = "";
+ if (this.src.indexOf("#") == 0) {
+ this.src.match(/#(.+[+-])([\s\S]*)$/);
+ if (RegExp.$1) this.meta = RegExp.$1;
+ if (RegExp.$2) this.src = RegExp.$2;
+ }
+
+ if (typeof JSDOC.PluginManager != "undefined") {
+ JSDOC.PluginManager.run("onDocCommentSrc", this);
+ }
+
+ this.fixDesc();
+
+ this.src = JSDOC.DocComment.shared+"\n"+this.src;
+
+ this.tagTexts =
+ this.src
+ .split(/(^|[\r\n])\s*@/)
+ .filter(function($){return $.match(/\S/)});
+
+ /**
+ The tags found in the comment.
+ @type JSDOC.DocTag[]
+ */
+ this.tags = this.tagTexts.map(function($){return new JSDOC.DocTag($)});
+
+ if (typeof JSDOC.PluginManager != "undefined") {
+ JSDOC.PluginManager.run("onDocCommentTags", this);
+ }
+}
+
+/*t:
+ plan(5, "testing JSDOC.DocComment");
+ requires("../frame/String.js");
+ requires("../lib/JSDOC/DocTag.js");
+
+ var com = new JSDOC.DocComment("/**@foo some\n* comment here*"+"/");
+ is(com.tagTexts[0], "foo some\ncomment here", "first tag text is found.");
+ is(com.tags[0].title, "foo", "the title is found in a comment with one tag.");
+
+ var com = new JSDOC.DocComment("/** @foo first\n* @bar second*"+"/");
+ is(com.getTag("bar").length, 1, "getTag() returns one tag by that title.");
+
+ JSDOC.DocComment.shared = "@author John Smith";
+ var com = new JSDOC.DocComment("/**@foo some\n* comment here*"+"/");
+ is(com.tags[0].title, "author", "shared comment is added.");
+ is(com.tags[1].title, "foo", "shared comment is added to existing tag.");
+*/
+
+/**
+ If no @desc tag is provided, this function will add it.
+ */
+JSDOC.DocComment.prototype.fixDesc = function() {
+ if (this.meta && this.meta != "@+") return;
+ if (/^\s*[^@\s]/.test(this.src)) {
+ this.src = "@desc "+this.src;
+ }
+}
+
+/*t:
+ plan(5, "testing JSDOC.DocComment#fixDesc");
+
+ var com = new JSDOC.DocComment();
+
+ com.src = "this is a desc\n@author foo";
+ com.fixDesc();
+ is(com.src, "@desc this is a desc\n@author foo", "if no @desc tag is provided one is added.");
+
+ com.src = "x";
+ com.fixDesc();
+ is(com.src, "@desc x", "if no @desc tag is provided one is added to a single character.");
+
+ com.src = "\nx";
+ com.fixDesc();
+ is(com.src, "@desc \nx", "if no @desc tag is provided one is added to return and character.");
+
+ com.src = " ";
+ com.fixDesc();
+ is(com.src, " ", "if no @desc tag is provided one is not added to just whitespace.");
+
+ com.src = "";
+ com.fixDesc();
+ is(com.src, "", "if no @desc tag is provided one is not added to empty.");
+*/
+
+/**
+ Remove slash-star comment wrapper from a raw comment string.
+ @type String
+ */
+JSDOC.DocComment.unwrapComment = function(/**String*/comment) {
+ if (!comment) return "";
+ var unwrapped = comment.replace(/(^\/\*\*|\*\/$)/g, "").replace(/^\s*\* ?/gm, "");
+ return unwrapped;
+}
+
+/*t:
+ plan(5, "testing JSDOC.DocComment.unwrapComment");
+
+ var com = "/**x*"+"/";
+ var unwrapped = JSDOC.DocComment.unwrapComment(com);
+ is(unwrapped, "x", "a single character jsdoc is found.");
+
+ com = "/***x*"+"/";
+ unwrapped = JSDOC.DocComment.unwrapComment(com);
+ is(unwrapped, "x", "three stars are allowed in the opener.");
+
+ com = "/****x*"+"/";
+ unwrapped = JSDOC.DocComment.unwrapComment(com);
+ is(unwrapped, "*x", "fourth star in the opener is kept.");
+
+ com = "/**x\n * y\n*"+"/";
+ unwrapped = JSDOC.DocComment.unwrapComment(com);
+ is(unwrapped, "x\ny\n", "leading stars and spaces are trimmed.");
+
+ com = "/**x\n * y\n*"+"/";
+ unwrapped = JSDOC.DocComment.unwrapComment(com);
+ is(unwrapped, "x\n y\n", "only first space after leading stars are trimmed.");
+*/
+
+/**
+ Provides a printable version of the comment.
+ @type String
+ */
+JSDOC.DocComment.prototype.toString = function() {
+ return this.src;
+}
+
+/*t:
+ plan(1, "testing JSDOC.DocComment#fixDesc");
+ var com = new JSDOC.DocComment();
+ com.src = "foo";
+ is(""+com, "foo", "stringifying a comment returns the unwrapped src.");
+*/
+
+/**
+ Given the title of a tag, returns all tags that have that title.
+ @type JSDOC.DocTag[]
+ */
+JSDOC.DocComment.prototype.getTag = function(/**String*/tagTitle) {
+ return this.tags.filter(function($){return $.title == tagTitle});
+}
+
+/*t:
+ plan(1, "testing JSDOC.DocComment#getTag");
+ requires("../frame/String.js");
+ requires("../lib/JSDOC/DocTag.js");
+
+ var com = new JSDOC.DocComment("/**@foo some\n* @bar\n* @bar*"+"/");
+ is(com.getTag("bar").length, 2, "getTag returns expected number of tags.");
+*/
+
+/**
+ Used to store the currently shared tag text.
+*/
+JSDOC.DocComment.shared = "";
+
+/*t:
+ plan(2, "testing JSDOC.DocComment.shared");
+ requires("../frame/String.js");
+ requires("../lib/JSDOC/DocTag.js");
+
+ JSDOC.DocComment.shared = "@author Michael";
+
+ var com = new JSDOC.DocComment("/**@foo\n* @foo*"+"/");
+ is(com.getTag("author").length, 1, "getTag returns shared tag.");
+ is(com.getTag("foo").length, 2, "getTag returns unshared tags too.");
+*/
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocTag.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocTag.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/DocTag.js (revision 7127)
@@ -0,0 +1,294 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ @constructor
+ */
+JSDOC.DocTag = function(src) {
+ this.init();
+ if (typeof src != "undefined") {
+ this.parse(src);
+ }
+}
+
+/**
+ Create and initialize the properties of this.
+ */
+JSDOC.DocTag.prototype.init = function() {
+ this.title = "";
+ this.type = "";
+ this.name = "";
+ this.isOptional = false;
+ this.defaultValue = "";
+ this.desc = "";
+
+ return this;
+}
+
+/**
+ Populate the properties of this from the given tag src.
+ @param {string} src
+ */
+JSDOC.DocTag.prototype.parse = function(src) {
+ if (typeof src != "string") throw "src must be a string not "+(typeof src);
+
+ try {
+ src = this.nibbleTitle(src);
+ if (JSDOC.PluginManager) {
+ JSDOC.PluginManager.run("onDocTagSynonym", this);
+ }
+
+ src = this.nibbleType(src);
+
+ // only some tags are allowed to have names.
+ if (this.title == "param" || this.title == "property" || this.title == "config") { // @config is deprecated
+ src = this.nibbleName(src);
+ }
+ }
+ catch(e) {
+ if (LOG) LOG.warn(e);
+ else throw e;
+ }
+ this.desc = src; // whatever is left
+
+ // example tags need to have whitespace preserved
+ if (this.title != "example") this.desc = this.desc.trim();
+
+ if (JSDOC.PluginManager) {
+ JSDOC.PluginManager.run("onDocTag", this);
+ }
+}
+
+/**
+ Automatically called when this is stringified.
+ */
+JSDOC.DocTag.prototype.toString = function() {
+ return this.desc;
+}
+
+/*t:
+ plan(1, "testing JSDOC.DocTag#toString");
+
+ var tag = new JSDOC.DocTag("param {object} date A valid date.");
+ is(""+tag, "A valid date.", "stringifying a tag returns the desc.");
+ */
+
+/**
+ Find and shift off the title of a tag.
+ @param {string} src
+ @return src
+ */
+JSDOC.DocTag.prototype.nibbleTitle = function(src) {
+ if (typeof src != "string") throw "src must be a string not "+(typeof src);
+
+ var parts = src.match(/^\s*(\S+)(?:\s([\s\S]*))?$/);
+
+ if (parts && parts[1]) this.title = parts[1];
+ if (parts && parts[2]) src = parts[2];
+ else src = "";
+
+ return src;
+}
+
+/*t:
+ plan(8, "testing JSDOC.DocTag#nibbleTitle");
+
+ var tag = new JSDOC.DocTag();
+
+ tag.init().nibbleTitle("aTitleGoesHere");
+ is(tag.title, "aTitleGoesHere", "a title can be found in a single-word string.");
+
+ var src = tag.init().nibbleTitle("aTitleGoesHere and the rest");
+ is(tag.title, "aTitleGoesHere", "a title can be found in a multi-word string.");
+ is(src, "and the rest", "the rest is returned when the title is nibbled off.");
+
+ src = tag.init().nibbleTitle("");
+ is(tag.title, "", "given an empty string the title is empty.");
+ is(src, "", "the rest is empty when the tag is empty.");
+
+ var src = tag.init().nibbleTitle(" aTitleGoesHere\n a description");
+ is(tag.title, "aTitleGoesHere", "leading and trailing spaces are not part of the title.");
+ is(src, " a description", "leading spaces (less one) are part of the description.");
+
+ tag.init().nibbleTitle("a.Title::Goes_Here foo");
+ is(tag.title, "a.Title::Goes_Here", "titles with punctuation are allowed.");
+ */
+
+/**
+ Find and shift off the type of a tag.
+ @requires frame/String.js
+ @param {string} src
+ @return src
+ */
+JSDOC.DocTag.prototype.nibbleType = function(src) {
+ if (typeof src != "string") throw "src must be a string not "+(typeof src);
+
+ if (src.match(/^\s*\{/)) {
+ var typeRange = src.balance("{", "}");
+ if (typeRange[1] == -1) {
+ throw "Malformed comment tag ignored. Tag type requires an opening { and a closing }: "+src;
+ }
+ this.type = src.substring(typeRange[0]+1, typeRange[1]).trim();
+ this.type = this.type.replace(/\s*,\s*/g, "|"); // multiples can be separated by , or |
+ src = src.substring(typeRange[1]+1);
+ }
+
+ return src;
+}
+
+/*t:
+ plan(5, "testing JSDOC.DocTag.parser.nibbleType");
+ requires("../frame/String.js");
+
+ var tag = new JSDOC.DocTag();
+
+ tag.init().nibbleType("{String[]} aliases");
+ is(tag.type, "String[]", "type can have non-alpha characters.");
+
+ tag.init().nibbleType("{ aTypeGoesHere } etc etc");
+ is(tag.type, "aTypeGoesHere", "type is trimmed.");
+
+ tag.init().nibbleType("{ oneType, twoType ,\n threeType } etc etc");
+ is(tag.type, "oneType|twoType|threeType", "multiple types can be separated by commas.");
+
+ var error;
+ try { tag.init().nibbleType("{widget foo"); }
+ catch(e) { error = e; }
+ is(typeof error, "string", "malformed tag type throws error.");
+ isnt(error.indexOf("Malformed"), -1, "error message tells tag is malformed.");
+ */
+
+/**
+ Find and shift off the name of a tag.
+ @requires frame/String.js
+ @param {string} src
+ @return src
+ */
+JSDOC.DocTag.prototype.nibbleName = function(src) {
+ if (typeof src != "string") throw "src must be a string not "+(typeof src);
+
+ src = src.trim();
+
+ // is optional?
+ if (src.charAt(0) == "[") {
+ var nameRange = src.balance("[", "]");
+ if (nameRange[1] == -1) {
+ throw "Malformed comment tag ignored. Tag optional name requires an opening [ and a closing ]: "+src;
+ }
+ this.name = src.substring(nameRange[0]+1, nameRange[1]).trim();
+ this.isOptional = true;
+
+ src = src.substring(nameRange[1]+1);
+
+ // has default value?
+ var nameAndValue = this.name.split("=");
+ if (nameAndValue.length) {
+ this.name = nameAndValue.shift().trim();
+ this.defaultValue = nameAndValue.join("=");
+ }
+ }
+ else {
+ var parts = src.match(/^(\S+)(?:\s([\s\S]*))?$/);
+ if (parts) {
+ if (parts[1]) this.name = parts[1];
+ if (parts[2]) src = parts[2].trim();
+ else src = "";
+ }
+ }
+
+ return src;
+}
+
+/*t:
+ requires("../frame/String.js");
+ plan(9, "testing JSDOC.DocTag.parser.nibbleName");
+
+ var tag = new JSDOC.DocTag();
+
+ tag.init().nibbleName("[foo] This is a description.");
+ is(tag.isOptional, true, "isOptional syntax is detected.");
+ is(tag.name, "foo", "optional param name is found.");
+
+ tag.init().nibbleName("[foo] This is a description.");
+ is(tag.isOptional, true, "isOptional syntax is detected when no type.");
+ is(tag.name, "foo", "optional param name is found when no type.");
+
+ tag.init().nibbleName("[foo=7] This is a description.");
+ is(tag.name, "foo", "optional param name is found when default value.");
+ is(tag.defaultValue, 7, "optional param default value is found when default value.");
+
+ //tag.init().nibbleName("[foo= a value] This is a description.");
+ //is(tag.defaultValue, " a value", "optional param default value is found when default value has spaces (issue #112).");
+
+ tag.init().nibbleName("[foo=[]] This is a description.");
+ is(tag.defaultValue, "[]", "optional param default value is found when default value is [] (issue #95).");
+
+ tag.init().nibbleName("[foo=a=b] This is a description.");
+ is(tag.name, "foo", "optional param name is found when default value is a=b.");
+ is(tag.defaultValue, "a=b", "optional param default value is found when default value is a=b.")
+ */
+
+/*t:
+ plan(32, "Testing JSDOC.DocTag.parser.");
+ requires("../frame/String.js");
+
+ var tag = new JSDOC.DocTag();
+
+ is(typeof tag, "object", "JSDOC.DocTag.parser with an empty string returns an object.");
+ is(typeof tag.title, "string", "returned object has a string property 'title'.");
+ is(typeof tag.type, "string", "returned object has a string property 'type'.");
+ is(typeof tag.name, "string", "returned object has a string property 'name'.");
+ is(typeof tag.defaultValue, "string", "returned object has a string property 'defaultValue'.");
+ is(typeof tag.isOptional, "boolean", "returned object has a boolean property 'isOptional'.");
+ is(typeof tag.desc, "string", "returned object has a string property 'desc'.");
+
+ tag = new JSDOC.DocTag("param {widget} foo");
+ is(tag.title, "param", "param title is found.");
+ is(tag.name, "foo", "param name is found when desc is missing.");
+ is(tag.desc, "", "param desc is empty when missing.");
+
+ tag = new JSDOC.DocTag("param {object} date A valid date.");
+ is(tag.name, "date", "param name is found with a type.");
+ is(tag.type, "object", "param type is found.");
+ is(tag.desc, "A valid date.", "param desc is found with a type.");
+
+ tag = new JSDOC.DocTag("param aName a description goes\n here.");
+ is(tag.name, "aName", "param name is found without a type.");
+ is(tag.desc, "a description goes\n here.", "param desc is found without a type.");
+
+ tag = new JSDOC.DocTag("param {widget}");
+ is(tag.name, "", "param name is empty when it is not given.");
+
+ tag = new JSDOC.DocTag("param {widget} [foo] This is a description.");
+ is(tag.name, "foo", "optional param name is found.");
+
+ tag = new JSDOC.DocTag("return {aType} This is a description.");
+ is(tag.type, "aType", "when return tag has no name, type is found.");
+ is(tag.desc, "This is a description.", "when return tag has no name, desc is found.");
+
+ tag = new JSDOC.DocTag("author Joe Coder ");
+ is(tag.title, "author", "author tag has a title.");
+ is(tag.type, "", "the author tag has no type.");
+ is(tag.name, "", "the author tag has no name.");
+ is(tag.desc, "Joe Coder ", "author tag has desc.");
+
+ tag = new JSDOC.DocTag("private \t\n ");
+ is(tag.title, "private", "private tag has a title.");
+ is(tag.type, "", "the private tag has no type.");
+ is(tag.name, "", "the private tag has no name.");
+ is(tag.desc, "", "private tag has no desc.");
+
+ tag = new JSDOC.DocTag("example\n example(code);\n more();");
+ is(tag.desc, " example(code);\n more();", "leading whitespace (less one) in examples code is preserved.");
+
+ tag = new JSDOC.DocTag("param theName \n");
+ is(tag.name, "theName", "name only is found.");
+
+ tag = new JSDOC.DocTag("type theDesc \n");
+ is(tag.desc, "theDesc", "desc only is found.");
+
+ tag = new JSDOC.DocTag("type {theType} \n");
+ is(tag.type, "theType", "type only is found.");
+
+ tag = new JSDOC.DocTag("");
+ is(tag.title, "", "title is empty when tag is empty.");
+ */
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js (revision 7127)
@@ -0,0 +1,126 @@
+/**
+ @constructor
+ @param [opt] Used to override the commandline options. Useful for testing.
+ @version $Id: JsDoc.js 773 2009-01-24 09:42:04Z micmath $
+*/
+JSDOC.JsDoc = function(/**object*/ opt) {
+ if (opt) {
+ JSDOC.opt = opt;
+ }
+
+ if (JSDOC.opt.h) {
+ JSDOC.usage();
+ quit();
+ }
+
+ // defend against options that are not sane
+ if (JSDOC.opt._.length == 0) {
+ LOG.warn("No source files to work on. Nothing to do.");
+ quit();
+ }
+ if (JSDOC.opt.t === true || JSDOC.opt.d === true) {
+ JSDOC.usage();
+ }
+
+ if (typeof JSDOC.opt.d == "string") {
+ if (!JSDOC.opt.d.charAt(JSDOC.opt.d.length-1).match(/[\\\/]/)) {
+ JSDOC.opt.d = JSDOC.opt.d+"/";
+ }
+ LOG.inform("Output directory set to '"+JSDOC.opt.d+"'.");
+ IO.mkPath(JSDOC.opt.d);
+ }
+ if (JSDOC.opt.e) IO.setEncoding(JSDOC.opt.e);
+
+ // the -r option: scan source directories recursively
+ if (typeof JSDOC.opt.r == "boolean") JSDOC.opt.r = 10;
+ else if (!isNaN(parseInt(JSDOC.opt.r))) JSDOC.opt.r = parseInt(JSDOC.opt.r);
+ else JSDOC.opt.r = 1;
+
+ // the -D option: define user variables
+ var D = {};
+ if (JSDOC.opt.D) {
+ for (var i = 0; i < JSDOC.opt.D.length; i++) {
+ var defineParts = JSDOC.opt.D[i].split(":", 2);
+ if (defineParts) D[defineParts[0]] = defineParts[1];
+ }
+ }
+ JSDOC.opt.D = D;
+ // combine any conf file D options with the commandline D options
+ if (defined(JSDOC.conf)) for (var c in JSDOC.conf.D) {
+ if (!defined(JSDOC.opt.D[c])) {
+ JSDOC.opt.D[c] = JSDOC.conf.D[c];
+ }
+ }
+
+ // Give plugins a chance to initialize
+ if (defined(JSDOC.PluginManager)) {
+ JSDOC.PluginManager.run("onInit", JSDOC.opt);
+ }
+
+ JSDOC.opt.srcFiles = JSDOC.JsDoc._getSrcFiles();
+ JSDOC.JsDoc._parseSrcFiles();
+ JSDOC.JsDoc.symbolSet = JSDOC.Parser.symbols;
+}
+
+/**
+ Retrieve source file list.
+ @returns {String[]} The pathnames of the files to be parsed.
+ */
+JSDOC.JsDoc._getSrcFiles = function() {
+ JSDOC.JsDoc.srcFiles = [];
+
+ var ext = ["js"];
+ if (JSDOC.opt.x) {
+ ext = JSDOC.opt.x.split(",").map(function($) {return $.toLowerCase()});
+ }
+
+ for (var i = 0; i < JSDOC.opt._.length; i++) {
+ JSDOC.JsDoc.srcFiles = JSDOC.JsDoc.srcFiles.concat(
+ IO.ls(JSDOC.opt._[i], JSDOC.opt.r).filter(
+ function($) {
+ var thisExt = $.split(".").pop().toLowerCase();
+
+ if (JSDOC.opt.E) {
+ for(var n = 0; n < JSDOC.opt.E.length; n++) {
+ if ($.match(new RegExp(JSDOC.opt.E[n]))) {
+ LOG.inform("Excluding " + $);
+ return false; // if the file matches the regex then it's excluded.
+ }
+ }
+ }
+
+ return (ext.indexOf(thisExt) > -1); // we're only interested in files with certain extensions
+ }
+ )
+ );
+ }
+
+ return JSDOC.JsDoc.srcFiles;
+}
+
+JSDOC.JsDoc._parseSrcFiles = function() {
+ JSDOC.Parser.init();
+ for (var i = 0, l = JSDOC.JsDoc.srcFiles.length; i < l; i++) {
+ var srcFile = JSDOC.JsDoc.srcFiles[i];
+
+ if (JSDOC.opt.v) LOG.inform("Parsing file: " + srcFile);
+
+ try {
+ var src = IO.readFile(srcFile);
+ }
+ catch(e) {
+ LOG.warn("Can't read source file '"+srcFile+"': "+e.message);
+ }
+
+ var tr = new JSDOC.TokenReader();
+ var ts = new JSDOC.TokenStream(tr.tokenize(new JSDOC.TextStream(src)));
+
+ JSDOC.Parser.parse(ts, srcFile);
+
+ }
+ JSDOC.Parser.finish();
+
+ if (JSDOC.PluginManager) {
+ JSDOC.PluginManager.run("onFinishedParsing", JSDOC.Parser.symbols);
+ }
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js (revision 7127)
@@ -0,0 +1,109 @@
+/**
+ @constructor
+*/
+JSDOC.JsPlate = function(templateFile) {
+ if (templateFile) this.template = IO.readFile(templateFile);
+
+ this.templateFile = templateFile;
+ this.code = "";
+ this.parse();
+}
+
+JSDOC.JsPlate.prototype.parse = function() {
+ this.template = this.template.replace(/\{#[\s\S]+?#\}/gi, "");
+ this.code = "var output=\u001e"+this.template;
+
+ this.code = this.code.replace(
+ //gi,
+ function (match, eachName, inName) {
+ return "\u001e;\rvar $"+eachName+"_keys = keys("+inName+");\rfor(var $"+eachName+"_i = 0; $"+eachName+"_i < $"+eachName+"_keys.length; $"+eachName+"_i++) {\rvar $"+eachName+"_last = ($"+eachName+"_i == $"+eachName+"_keys.length-1);\rvar $"+eachName+"_key = $"+eachName+"_keys[$"+eachName+"_i];\rvar "+eachName+" = "+inName+"[$"+eachName+"_key];\routput+=\u001e";
+ }
+ );
+ this.code = this.code.replace(//g, "\u001e;\rif ($1) { output+=\u001e");
+ this.code = this.code.replace(//g, "\u001e;}\relse if ($1) { output+=\u001e");
+ this.code = this.code.replace(//g, "\u001e;}\relse { output+=\u001e");
+ this.code = this.code.replace(/<\/(if|for)>/g, "\u001e;\r};\routput+=\u001e");
+ this.code = this.code.replace(
+ /\{\+\s*([\s\S]+?)\s*\+\}/gi,
+ function (match, code) {
+ code = code.replace(/"/g, "\u001e"); // prevent qoute-escaping of inline code
+ code = code.replace(/(\r?\n)/g, " ");
+ return "\u001e+ ("+code+") +\u001e";
+ }
+ );
+ this.code = this.code.replace(
+ /\{!\s*([\s\S]+?)\s*!\}/gi,
+ function (match, code) {
+ code = code.replace(/"/g, "\u001e"); // prevent qoute-escaping of inline code
+ code = code.replace(/(\n)/g, " ");
+ return "\u001e; "+code+";\routput+=\u001e";
+ }
+ );
+ this.code = this.code+"\u001e;";
+
+ this.code = this.code.replace(/(\r?\n)/g, "\\n");
+ this.code = this.code.replace(/"/g, "\\\"");
+ this.code = this.code.replace(/\u001e/g, "\"");
+}
+
+JSDOC.JsPlate.prototype.toCode = function() {
+ return this.code;
+}
+
+JSDOC.JsPlate.keys = function(obj) {
+ var keys = [];
+ if (obj.constructor.toString().indexOf("Array") > -1) {
+ for (var i = 0; i < obj.length; i++) {
+ keys.push(i);
+ }
+ }
+ else {
+ for (var i in obj) {
+ keys.push(i);
+ }
+ }
+ return keys;
+};
+
+JSDOC.JsPlate.values = function(obj) {
+ var values = [];
+ if (obj.constructor.toString().indexOf("Array") > -1) {
+ for (var i = 0; i < obj.length; i++) {
+ values.push(obj[i]);
+ }
+ }
+ else {
+ for (var i in obj) {
+ values.push(obj[i]);
+ }
+ }
+ return values;
+};
+
+JSDOC.JsPlate.prototype.process = function(data, compact) {
+ var keys = JSDOC.JsPlate.keys;
+ var values = JSDOC.JsPlate.values;
+
+ try {
+ eval(this.code);
+ }
+ catch (e) {
+ print(">> There was an error evaluating the compiled code from template: "+this.templateFile);
+ print(" The error was on line "+e.lineNumber+" "+e.name+": "+e.message);
+ var lines = this.code.split("\r");
+ if (e.lineNumber-2 >= 0) print("line "+(e.lineNumber-1)+": "+lines[e.lineNumber-2]);
+ print("line "+e.lineNumber+": "+lines[e.lineNumber-1]);
+ print("");
+ }
+
+ if (compact) { // patch by mcbain.asm
+ // Remove lines that contain only space-characters, usually left by lines in the template
+ // which originally only contained JSPlate tags or code. This makes it easier to write
+ // non-tricky templates which still put out nice code (not bloated with extra lines).
+ // Lines purposely left blank (just a line ending) are left alone.
+ output = output.replace(/\s+?(\r?)\n/g, "$1\n");
+ }
+
+ /*debug*///print(this.code);
+ return output;
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Lang.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Lang.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Lang.js (revision 7127)
@@ -0,0 +1,144 @@
+/**
+ @namespace
+*/
+JSDOC.Lang = {
+}
+
+JSDOC.Lang.isBuiltin = function(name) {
+ return (JSDOC.Lang.isBuiltin.coreObjects.indexOf(name) > -1);
+}
+JSDOC.Lang.isBuiltin.coreObjects = ['_global_', 'Array', 'Boolean', 'Date', 'Error', 'Function', 'Math', 'Number', 'Object', 'RegExp', 'String'];
+
+JSDOC.Lang.whitespace = function(ch) {
+ return JSDOC.Lang.whitespace.names[ch];
+}
+JSDOC.Lang.whitespace.names = {
+ " ": "SPACE",
+ "\f": "FORMFEED",
+ "\t": "TAB",
+ "\u0009": "UNICODE_TAB",
+ "\u000A": "UNICODE_NBR",
+ "\u0008": "VERTICAL_TAB"
+};
+
+JSDOC.Lang.newline = function(ch) {
+ return JSDOC.Lang.newline.names[ch];
+}
+JSDOC.Lang.newline.names = {
+ "\n": "NEWLINE",
+ "\r": "RETURN",
+ "\u000A": "UNICODE_LF",
+ "\u000D": "UNICODE_CR",
+ "\u2029": "UNICODE_PS",
+ "\u2028": "UNICODE_LS"
+};
+
+JSDOC.Lang.keyword = function(word) {
+ return JSDOC.Lang.keyword.names["="+word];
+}
+JSDOC.Lang.keyword.names = {
+ "=break": "BREAK",
+ "=case": "CASE",
+ "=catch": "CATCH",
+ "=const": "VAR",
+ "=continue": "CONTINUE",
+ "=default": "DEFAULT",
+ "=delete": "DELETE",
+ "=do": "DO",
+ "=else": "ELSE",
+ "=false": "FALSE",
+ "=finally": "FINALLY",
+ "=for": "FOR",
+ "=function": "FUNCTION",
+ "=if": "IF",
+ "=in": "IN",
+ "=instanceof": "INSTANCEOF",
+ "=new": "NEW",
+ "=null": "NULL",
+ "=return": "RETURN",
+ "=switch": "SWITCH",
+ "=this": "THIS",
+ "=throw": "THROW",
+ "=true": "TRUE",
+ "=try": "TRY",
+ "=typeof": "TYPEOF",
+ "=void": "VOID",
+ "=while": "WHILE",
+ "=with": "WITH",
+ "=var": "VAR"
+};
+
+JSDOC.Lang.punc = function(ch) {
+ return JSDOC.Lang.punc.names[ch];
+}
+JSDOC.Lang.punc.names = {
+ ";": "SEMICOLON",
+ ",": "COMMA",
+ "?": "HOOK",
+ ":": "COLON",
+ "||": "OR",
+ "&&": "AND",
+ "|": "BITWISE_OR",
+ "^": "BITWISE_XOR",
+ "&": "BITWISE_AND",
+ "===": "STRICT_EQ",
+ "==": "EQ",
+ "=": "ASSIGN",
+ "!==": "STRICT_NE",
+ "!=": "NE",
+ "<<": "LSH",
+ "<=": "LE",
+ "<": "LT",
+ ">>>": "URSH",
+ ">>": "RSH",
+ ">=": "GE",
+ ">": "GT",
+ "++": "INCREMENT",
+ "--": "DECREMENT",
+ "+": "PLUS",
+ "-": "MINUS",
+ "*": "MUL",
+ "/": "DIV",
+ "%": "MOD",
+ "!": "NOT",
+ "~": "BITWISE_NOT",
+ ".": "DOT",
+ "[": "LEFT_BRACKET",
+ "]": "RIGHT_BRACKET",
+ "{": "LEFT_CURLY",
+ "}": "RIGHT_CURLY",
+ "(": "LEFT_PAREN",
+ ")": "RIGHT_PAREN"
+};
+
+JSDOC.Lang.matching = function(name) {
+ return JSDOC.Lang.matching.names[name];
+}
+JSDOC.Lang.matching.names = {
+ "LEFT_PAREN": "RIGHT_PAREN",
+ "RIGHT_PAREN": "LEFT_PAREN",
+ "LEFT_CURLY": "RIGHT_CURLY",
+ "RIGHT_CURLY": "LEFT_CURLY",
+ "LEFT_BRACE": "RIGHT_BRACE",
+ "RIGHT_BRACE": "LEFT_BRACE"
+}
+
+JSDOC.Lang.isNumber = function(str) {
+ return /^(\.[0-9]|[0-9]+\.|[0-9])[0-9]*([eE][+-][0-9]+)?$/i.test(str);
+}
+
+JSDOC.Lang.isHexDec = function(str) {
+ return /^0x[0-9A-F]+$/i.test(str);
+}
+
+JSDOC.Lang.isWordChar = function(str) {
+ return /^[a-zA-Z0-9$_.]+$/.test(str);
+}
+
+JSDOC.Lang.isSpace = function(str) {
+ return (typeof JSDOC.Lang.whitespace(str) != "undefined");
+}
+
+JSDOC.Lang.isNewline = function(str) {
+ return (typeof JSDOC.Lang.newline(str) != "undefined");
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Parser.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Parser.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Parser.js (revision 7127)
@@ -0,0 +1,145 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ @namespace
+ @requires JSDOC.Walker
+ @requires JSDOC.Symbol
+ @requires JSDOC.DocComment
+*/
+JSDOC.Parser = {
+ conf: {
+ ignoreCode: JSDOC.opt.n,
+ ignoreAnonymous: true, // factory: true
+ treatUnderscoredAsPrivate: true, // factory: true
+ explain: false // factory: false
+ },
+
+ addSymbol: function(symbol) {
+
+if (JSDOC.Parser.rename) {
+ for (var n in JSDOC.Parser.rename) {
+ if (symbol.alias.indexOf(n) == 0) {
+ if (symbol.name == symbol.alias) {
+ symbol.name = symbol.name.replace(n, JSDOC.Parser.rename[n]);
+ }
+ symbol.alias = symbol.alias.replace(n, JSDOC.Parser.rename[n]);
+ }
+ }
+}
+
+if (JSDOC.opt.S) {
+ if (typeof JSDOC.Parser.secureModules == "undefined") JSDOC.Parser.secureModules = {};
+ if (/^exports\./.test(symbol.alias)) {
+ symbol.srcFile.match(/(^|[\\\/])([^\\\/]+)\.js/i);
+ var fileNS = RegExp.$2;
+ symbol.alias = symbol.alias.replace(/^exports\./, fileNS);
+ symbol.name = symbol.name.replace(/^exports\./, "");
+ symbol.memberOf = fileNS;
+
+ // need to create the namespace associated with this file first
+ if (!JSDOC.Parser.secureModules[fileNS]) {
+ JSDOC.Parser.secureModules[fileNS] = 1;
+ var nsSymbol = new JSDOC.Symbol(fileNS, [], "GLOBAL", new JSDOC.DocComment(""));
+ nsSymbol.isNamespace = true;
+ nsSymbol.srcFile = "";
+ nsSymbol.isPrivate = false;
+ nsSymbol.srcFile = symbol.srcFile;
+ nsSymbol.desc = (JSDOC.Parser.symbols.getSymbol(symbol.srcFile) || {desc: ""}).desc;
+ JSDOC.Parser.addSymbol(nsSymbol);
+
+ }
+ }
+ else { // a method that is not exported?
+ if (!symbol.isNamespace) return;
+ }
+}
+ // if a symbol alias is documented more than once the last one with the user docs wins
+ if (JSDOC.Parser.symbols.hasSymbol(symbol.alias)) {
+ var oldSymbol = JSDOC.Parser.symbols.getSymbol(symbol.alias);
+ if (oldSymbol.comment.isUserComment) {
+ if (symbol.comment.isUserComment) { // old and new are both documented
+ LOG.warn("The symbol '"+symbol.alias+"' is documented more than once.");
+ }
+ else { // old is documented but new isn't
+ return;
+ }
+ }
+ }
+
+ // we don't document anonymous things
+ if (JSDOC.Parser.conf.ignoreAnonymous && symbol.name.match(/\$anonymous\b/)) return;
+
+ // uderscored things may be treated as if they were marked private, this cascades
+ if (JSDOC.Parser.conf.treatUnderscoredAsPrivate && symbol.name.match(/[.#-]_[^.#-]+$/)) {
+ if (!symbol.comment.getTag("public").length > 0) symbol.isPrivate = true;
+ }
+
+ // -p flag is required to document private things
+ if (!JSDOC.opt.p && symbol.isPrivate) return; // issue #161 fixed by mcbain.asm
+
+ // ignored things are not documented, this doesn't cascade
+ if (symbol.isIgnored) return;
+ JSDOC.Parser.symbols.addSymbol(symbol);
+ },
+
+ addBuiltin: function(name) {
+ var builtin = new JSDOC.Symbol(name, [], "CONSTRUCTOR", new JSDOC.DocComment(""));
+ builtin.isNamespace = true;
+ builtin.srcFile = "";
+ builtin.isPrivate = false;
+ JSDOC.Parser.addSymbol(builtin);
+ return builtin;
+ },
+
+ init: function() {
+ JSDOC.Parser.symbols = new JSDOC.SymbolSet();
+ JSDOC.Parser.walker = new JSDOC.Walker();
+ },
+
+ finish: function() {
+ JSDOC.Parser.symbols.relate();
+
+ // make a litle report about what was found
+ if (JSDOC.Parser.conf.explain) {
+ var symbols = JSDOC.Parser.symbols.toArray();
+ var srcFile = "";
+ for (var i = 0, l = symbols.length; i < l; i++) {
+ var symbol = symbols[i];
+ if (srcFile != symbol.srcFile) {
+ srcFile = symbol.srcFile;
+ print("\n"+srcFile+"\n-------------------");
+ }
+ print(i+":\n alias => "+symbol.alias + "\n name => "+symbol.name+ "\n isa => "+symbol.isa + "\n memberOf => " + symbol.memberOf + "\n isStatic => " + symbol.isStatic + ", isInner => " + symbol.isInner+ ", isPrivate => " + symbol.isPrivate);
+ }
+ print("-------------------\n");
+ }
+ }
+}
+
+JSDOC.Parser.parse = function(/**JSDOC.TokenStream*/ts, /**String*/srcFile) {
+ JSDOC.Symbol.srcFile = (srcFile || "");
+ JSDOC.DocComment.shared = ""; // shared comments don't cross file boundaries
+
+ if (!JSDOC.Parser.walker) JSDOC.Parser.init();
+ JSDOC.Parser.walker.walk(ts); // adds to our symbols
+
+ // filter symbols by option
+ for (var p = JSDOC.Parser.symbols._index.first(); p; p = JSDOC.Parser.symbols._index.next()) {
+ var symbol = p.value;
+
+ if (!symbol) continue;
+
+ if (symbol.is("FILE") || symbol.is("GLOBAL")) {
+ continue;
+ }
+ else if (!JSDOC.opt.a && !symbol.comment.isUserComment) {
+ JSDOC.Parser.symbols.deleteSymbol(symbol.alias);
+ }
+
+ if (/#$/.test(symbol.alias)) { // we don't document prototypes
+ JSDOC.Parser.symbols.deleteSymbol(symbol.alias);
+ }
+ }
+
+ return JSDOC.Parser.symbols.toArray();
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js (revision 7127)
@@ -0,0 +1,33 @@
+/**
+ @namespace Holds functionality related to running plugins.
+*/
+JSDOC.PluginManager = {
+}
+
+/**
+ @param name A unique name that identifies that plugin.
+ @param handlers A collection of named functions. The names correspond to hooks in the core code.
+*/
+JSDOC.PluginManager.registerPlugin = function(/**String*/name, /**Object*/handlers) {
+ if (!defined(JSDOC.PluginManager.plugins))
+ /** The collection of all plugins. Requires a unique name for each.
+ */
+ JSDOC.PluginManager.plugins = {};
+
+
+ JSDOC.PluginManager.plugins[name] = handlers;
+}
+
+/**
+ @param hook The name of the hook that is being caught.
+ @param target Any object. This will be passed as the only argument to the handler whose
+ name matches the hook name. Handlers cannot return a value, so must modify the target
+ object to have an effect.
+*/
+JSDOC.PluginManager.run = function(/**String*/hook, /**Mixed*/target) {
+ for (var name in JSDOC.PluginManager.plugins) {
+ if (defined(JSDOC.PluginManager.plugins[name][hook])) {
+ JSDOC.PluginManager.plugins[name][hook](target);
+ }
+ }
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Symbol.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Symbol.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Symbol.js (revision 7127)
@@ -0,0 +1,645 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ Create a new Symbol.
+ @class Represents a symbol in the source code.
+ */
+JSDOC.Symbol = function() {
+ this.init();
+ if (arguments.length) this.populate.apply(this, arguments);
+}
+
+JSDOC.Symbol.count = 0;
+
+JSDOC.Symbol.prototype.init = function() {
+ this._name = "";
+ this._params = [];
+ this.$args = [];
+ this.addOn = "";
+ this.alias = "";
+ this.augments = [];
+ this.author = "";
+ this.classDesc = "";
+ this.comment = {};
+ this.defaultValue = undefined;
+ this.deprecated = "";
+ this.desc = "";
+ this.example = [];
+ this.exceptions = [];
+ this.fires = [];
+ this.id = JSDOC.Symbol.count++;
+ this.inherits = [];
+ this.inheritsFrom = [];
+ this.isa = "OBJECT";
+ this.isConstant = false;
+ this.isEvent = false;
+ this.isIgnored = false;
+ this.isInner = false;
+ this.isNamespace = false;
+ this.isPrivate = false;
+ this.isStatic = false;
+ this.memberOf = "";
+ this.methods = [];
+ this.properties = [];
+ this.requires = [];
+ this.returns = [];
+ this.see = [];
+ this.since = "";
+ this.srcFile = {};
+ this.type = "";
+ this.version = "";
+}
+
+JSDOC.Symbol.prototype.serialize = function() {
+ var keys = [];
+ for (var p in this) {
+ keys.push (p);
+ }
+ keys = keys.sort();
+
+ var out = "";
+ for (var i in keys) {
+ if (typeof this[keys[i]] == "function") continue;
+ out += keys[i]+" => "+Dumper.dump(this[keys[i]])+",\n";
+ }
+ return "\n{\n" + out + "}\n";
+}
+
+JSDOC.Symbol.prototype.clone = function() {
+ var clone = new JSDOC.Symbol();
+ clone.populate.apply(clone, this.$args); // repopulate using the original arguments
+ clone.srcFile = this.srcFile; // not the current srcFile, the one when the original was made
+ return clone;
+}
+
+JSDOC.Symbol.prototype.__defineSetter__("name",
+ function(n) { n = n.replace(/^_global_[.#-]/, ""); n = n.replace(/\.prototype\.?/g, '#'); this._name = n; }
+);
+JSDOC.Symbol.prototype.__defineGetter__("name",
+ function() { return this._name; }
+);
+JSDOC.Symbol.prototype.__defineSetter__("params",
+ function(v) {
+ for (var i = 0, l = v.length; i < l; i++) {
+ if (v[i].constructor != JSDOC.DocTag) { // may be a generic object parsed from signature, like {type:..., name:...}
+ this._params[i] = new JSDOC.DocTag("param"+((v[i].type)?" {"+v[i].type+"}":"")+" "+v[i].name);
+ }
+ else {
+ this._params[i] = v[i];
+ }
+ }
+ }
+);
+JSDOC.Symbol.prototype.__defineGetter__("params",
+ function() { return this._params; }
+);
+
+JSDOC.Symbol.prototype.getEvents = function() {
+ var events = [];
+ for (var i = 0, l = this.methods.length; i < l; i++) {
+ if (this.methods[i].isEvent) {
+ this.methods[i].name = this.methods[i].name.replace("event:", "");
+ events.push(this.methods[i]);
+ }
+ }
+ return events;
+}
+
+JSDOC.Symbol.prototype.getMethods = function() {
+ var nonEvents = [];
+ for (var i = 0, l = this.methods.length; i < l; i++) {
+ if (!this.methods[i].isEvent) {
+ nonEvents.push(this.methods[i]);
+ }
+ }
+ return nonEvents;
+}
+
+
+JSDOC.Symbol.prototype.populate = function(
+ /** String */ name,
+ /** Object[] */ params,
+ /** String */ isa,
+ /** JSDOC.DocComment */ comment
+) {
+ this.$args = arguments;
+
+ this.name = name;
+ this.alias = this.name;
+
+ this.params = params;
+ this.isa = (isa == "VIRTUAL")? "OBJECT":isa;
+ this.comment = comment || new JSDOC.DocComment("");
+ this.srcFile = JSDOC.Symbol.srcFile;
+
+ if (this.is("FILE") && !this.alias) this.alias = this.srcFile;
+
+ this.setTags();
+
+ if (typeof JSDOC.PluginManager != "undefined") {
+ JSDOC.PluginManager.run("onSymbol", this);
+ }
+}
+
+JSDOC.Symbol.prototype.setTags = function() {
+ // @author
+ var authors = this.comment.getTag("author");
+ if (authors.length) {
+ this.author = authors.map(function($){return $.desc;}).join(", ");
+ }
+
+ /*t:
+ plan(34, "testing JSDOC.Symbol");
+
+ requires("../lib/JSDOC/DocComment.js");
+ requires("../frame/String.js");
+ requires("../lib/JSDOC/DocTag.js");
+
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@author Joe Smith*"+"/"));
+ is(sym.author, "Joe Smith", "@author tag, author is found.");
+ */
+
+ // @desc
+ var descs = this.comment.getTag("desc");
+ if (descs.length) {
+ this.desc = descs.map(function($){return $.desc;}).join("\n"); // multiple descriptions are concatenated into one
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@desc This is a description.*"+"/"));
+ is(sym.desc, "This is a description.", "@desc tag, description is found.");
+ */
+
+ // @overview
+ if (this.is("FILE")) {
+ if (!this.alias) this.alias = this.srcFile;
+
+ var overviews = this.comment.getTag("overview");
+ if (overviews.length) {
+ this.desc = [this.desc].concat(overviews.map(function($){return $.desc;})).join("\n");
+ }
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@overview This is an overview.*"+"/"));
+ is(sym.desc, "\nThis is an overview.", "@overview tag, description is found.");
+ */
+
+ // @since
+ var sinces = this.comment.getTag("since");
+ if (sinces.length) {
+ this.since = sinces.map(function($){return $.desc;}).join(", ");
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@since 1.01*"+"/"));
+ is(sym.since, "1.01", "@since tag, description is found.");
+ */
+
+ // @constant
+ if (this.comment.getTag("constant").length) {
+ this.isConstant = true;
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@constant*"+"/"));
+ is(sym.isConstant, true, "@constant tag, isConstant set.");
+ */
+
+ // @version
+ var versions = this.comment.getTag("version");
+ if (versions.length) {
+ this.version = versions.map(function($){return $.desc;}).join(", ");
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@version 2.0x*"+"/"));
+ is(sym.version, "2.0x", "@version tag, version is found.");
+ */
+
+ // @deprecated
+ var deprecateds = this.comment.getTag("deprecated");
+ if (deprecateds.length) {
+ this.deprecated = deprecateds.map(function($){return $.desc;}).join("\n");
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@deprecated Use other method.*"+"/"));
+ is(sym.deprecated, "Use other method.", "@deprecated tag, desc is found.");
+ */
+
+ // @example
+ var examples = this.comment.getTag("example");
+ if (examples.length) {
+ this.example = examples.map(
+ // trim trailing whitespace
+ function($) {
+ $.desc = $.desc.replace(/\s+$/, "");
+ return $;
+ }
+ );
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@example This\n is an example. \n*"+"/"));
+ isnt(typeof sym.example[0], "undefined", "@example tag, creates sym.example array.");
+ is(sym.example[0], "This\n is an example.", "@example tag, desc is found.");
+ */
+
+ // @see
+ var sees = this.comment.getTag("see");
+ if (sees.length) {
+ var thisSee = this.see;
+ sees.map(function($){thisSee.push($.desc);});
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FILE", new JSDOC.DocComment("/**@see The other thing.*"+"/"));
+ is(sym.see, "The other thing.", "@see tag, desc is found.");
+ */
+
+ // @class
+ var classes = this.comment.getTag("class");
+ if (classes.length) {
+ this.isa = "CONSTRUCTOR";
+ this.classDesc = classes[0].desc; // desc can't apply to the constructor as there is none.
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@class This describes the class.*"+"/"));
+ is(sym.isa, "CONSTRUCTOR", "@class tag, makes symbol a constructor.");
+ is(sym.classDesc, "This describes the class.", "@class tag, class description is found.");
+ */
+
+ // @namespace
+ var namespaces = this.comment.getTag("namespace");
+ if (namespaces.length) {
+ this.classDesc = namespaces[0].desc;
+ this.isNamespace = true;
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@namespace This describes the namespace.*"+"/"));
+ is(sym.classDesc, "This describes the namespace.", "@namespace tag, class description is found.");
+ */
+
+ // @param
+ var params = this.comment.getTag("param");
+ if (params.length) {
+ // user-defined params overwrite those with same name defined by the parser
+ var thisParams = this.params;
+
+ if (thisParams.length == 0) { // none exist yet, so just bung all these user-defined params straight in
+ this.params = params;
+ }
+ else { // need to overlay these user-defined params on to existing parser-defined params
+ for (var i = 0, l = params.length; i < l; i++) {
+ if (thisParams[i]) {
+ if (params[i].type) thisParams[i].type = params[i].type;
+ thisParams[i].name = params[i].name;
+ thisParams[i].desc = params[i].desc;
+ thisParams[i].isOptional = params[i].isOptional;
+ thisParams[i].defaultValue = params[i].defaultValue;
+ }
+ else thisParams[i] = params[i];
+ }
+ }
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [{type: "array", name: "pages"}], "FUNCTION", new JSDOC.DocComment("/**Description.*"+"/"));
+ is(sym.params.length, 1, "parser defined param is found.");
+
+ sym = new JSDOC.Symbol("foo", [], "FUNCTION", new JSDOC.DocComment("/**Description.\n@param {array} pages*"+"/"));
+ is(sym.params.length, 1, "user defined param is found.");
+ is(sym.params[0].type, "array", "user defined param type is found.");
+ is(sym.params[0].name, "pages", "user defined param name is found.");
+
+ sym = new JSDOC.Symbol("foo", [{type: "array", name: "pages"}], "FUNCTION", new JSDOC.DocComment("/**Description.\n@param {string} uid*"+"/"));
+ is(sym.params.length, 1, "user defined param overwrites parser defined param.");
+ is(sym.params[0].type, "string", "user defined param type overwrites parser defined param type.");
+ is(sym.params[0].name, "uid", "user defined param name overwrites parser defined param name.");
+
+ sym = new JSDOC.Symbol("foo", [{type: "array", name: "pages"}, {type: "number", name: "count"}], "FUNCTION", new JSDOC.DocComment("/**Description.\n@param {string} uid*"+"/"));
+ is(sym.params.length, 2, "user defined params overlay parser defined params.");
+ is(sym.params[1].type, "number", "user defined param type overlays parser defined param type.");
+ is(sym.params[1].name, "count", "user defined param name overlays parser defined param name.");
+
+ sym = new JSDOC.Symbol("foo", [], "FUNCTION", new JSDOC.DocComment("/**Description.\n@param {array} pages The pages description.*"+"/"));
+ is(sym.params.length, 1, "user defined param with description is found.");
+ is(sym.params[0].desc, "The pages description.", "user defined param description is found.");
+ */
+
+ // @constructor
+ if (this.comment.getTag("constructor").length) {
+ this.isa = "CONSTRUCTOR";
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@constructor*"+"/"));
+ is(sym.isa, "CONSTRUCTOR", "@constructor tag, makes symbol a constructor.");
+ */
+
+ // @static
+ if (this.comment.getTag("static").length) {
+ this.isStatic = true;
+ if (this.isa == "CONSTRUCTOR") {
+ this.isNamespace = true;
+ }
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@static\n@constructor*"+"/"));
+ is(sym.isStatic, true, "@static tag, makes isStatic true.");
+ is(sym.isNamespace, true, "@static and @constructor tag, makes isNamespace true.");
+ */
+
+ // @inner
+ if (this.comment.getTag("inner").length) {
+ this.isInner = true;
+ this.isStatic = false;
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@inner*"+"/"));
+ is(sym.isStatic, false, "@inner tag, makes isStatic false.");
+ is(sym.isInner, true, "@inner makes isInner true.");
+ */
+
+ // @name
+ var names = this.comment.getTag("name");
+ if (names.length) {
+ this.name = names[0].desc;
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @field
+ if (this.comment.getTag("field").length) {
+ this.isa = "OBJECT";
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "FUNCTION", new JSDOC.DocComment("/**@field*"+"/"));
+ is(sym.isa, "OBJECT", "@field tag, makes symbol an object.");
+ */
+
+ // @function
+ if (this.comment.getTag("function").length) {
+ this.isa = "FUNCTION";
+ if (/event:/.test(this.alias)) this.isEvent = true;
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@function*"+"/"));
+ is(sym.isa, "FUNCTION", "@function tag, makes symbol a function.");
+ */
+
+ // @event
+ var events = this.comment.getTag("event");
+ if (events.length) {
+ this.isa = "FUNCTION";
+ this.isEvent = true;
+ if (!/event:/.test(this.alias))
+ this.alias = this.alias.replace(/^(.*[.#-])([^.#-]+)$/, "$1event:$2");
+ }
+
+ /*t:
+ var sym = new JSDOC.Symbol("foo", [], "OBJECT", new JSDOC.DocComment("/**@event*"+"/"));
+ is(sym.isa, "FUNCTION", "@event tag, makes symbol a function.");
+ is(sym.isEvent, true, "@event makes isEvent true.");
+ */
+
+ // @fires
+ var fires = this.comment.getTag("fires");
+ if (fires.length) {
+ for (var i = 0; i < fires.length; i++) {
+ this.fires.push(fires[i].desc);
+ }
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @property
+ var properties = this.comment.getTag("property");
+ if (properties.length) {
+ thisProperties = this.properties;
+ for (var i = 0; i < properties.length; i++) {
+ var property = new JSDOC.Symbol(this.alias+"#"+properties[i].name, [], "OBJECT", new JSDOC.DocComment("/**"+properties[i].desc+"\n@name "+properties[i].name+"\n@memberOf "+this.alias+"#*/"));
+ // TODO: shouldn't the following happen in the addProperty method of Symbol?
+ property.name = properties[i].name;
+ property.memberOf = this.alias;
+ if (properties[i].type) property.type = properties[i].type;
+ if (properties[i].defaultValue) property.defaultValue = properties[i].defaultValue;
+ this.addProperty(property);
+ JSDOC.Parser.addSymbol(property);
+ }
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @return
+ var returns = this.comment.getTag("return");
+ if (returns.length) { // there can be many return tags in a single doclet
+ this.returns = returns;
+ this.type = returns.map(function($){return $.type}).join(", ");
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @exception
+ this.exceptions = this.comment.getTag("throws");
+
+ /*t:
+ // todo
+ */
+
+ // @requires
+ var requires = this.comment.getTag("requires");
+ if (requires.length) {
+ this.requires = requires.map(function($){return $.desc});
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @type
+ var types = this.comment.getTag("type");
+ if (types.length) {
+ this.type = types[0].desc; //multiple type tags are ignored
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @private
+ if (this.comment.getTag("private").length || this.isInner) {
+ this.isPrivate = true;
+ }
+
+ // @ignore
+ if (this.comment.getTag("ignore").length) {
+ this.isIgnored = true;
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @inherits ... as ...
+ var inherits = this.comment.getTag("inherits");
+ if (inherits.length) {
+ for (var i = 0; i < inherits.length; i++) {
+ if (/^\s*([a-z$0-9_.#:-]+)(?:\s+as\s+([a-z$0-9_.#:-]+))?/i.test(inherits[i].desc)) {
+ var inAlias = RegExp.$1;
+ var inAs = RegExp.$2 || inAlias;
+
+ if (inAlias) inAlias = inAlias.replace(/\.prototype\.?/g, "#");
+
+ if (inAs) {
+ inAs = inAs.replace(/\.prototype\.?/g, "#");
+ inAs = inAs.replace(/^this\.?/, "#");
+ }
+
+ if (inAs.indexOf(inAlias) != 0) { //not a full namepath
+ var joiner = ".";
+ if (this.alias.charAt(this.alias.length-1) == "#" || inAs.charAt(0) == "#") {
+ joiner = "";
+ }
+ inAs = this.alias + joiner + inAs;
+ }
+ }
+ this.inherits.push({alias: inAlias, as: inAs});
+ }
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @augments
+ this.augments = this.comment.getTag("augments");
+
+ // @default
+ var defaults = this.comment.getTag("default");
+ if (defaults.length) {
+ if (this.is("OBJECT")) {
+ this.defaultValue = defaults[0].desc;
+ }
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @memberOf
+ var memberOfs = this.comment.getTag("memberOf");
+ if (memberOfs.length) {
+ this.memberOf = memberOfs[0].desc;
+ this.memberOf = this.memberOf.replace(/\.prototype\.?/g, "#");
+ }
+
+ /*t:
+ // todo
+ */
+
+ // @public
+ if (this.comment.getTag("public").length) {
+ this.isPrivate = false;
+ }
+
+ /*t:
+ // todo
+ */
+
+ if (JSDOC.PluginManager) {
+ JSDOC.PluginManager.run("onSetTags", this);
+ }
+}
+
+JSDOC.Symbol.prototype.is = function(what) {
+ return this.isa === what;
+}
+
+JSDOC.Symbol.prototype.isBuiltin = function() {
+ return JSDOC.Lang.isBuiltin(this.alias);
+}
+
+JSDOC.Symbol.prototype.setType = function(/**String*/comment, /**Boolean*/overwrite) {
+ if (!overwrite && this.type) return;
+ var typeComment = JSDOC.DocComment.unwrapComment(comment);
+ this.type = typeComment;
+}
+
+JSDOC.Symbol.prototype.inherit = function(symbol) {
+ if (!this.hasMember(symbol.name) && !symbol.isInner) {
+ if (symbol.is("FUNCTION"))
+ this.methods.push(symbol);
+ else if (symbol.is("OBJECT"))
+ this.properties.push(symbol);
+ }
+}
+
+JSDOC.Symbol.prototype.hasMember = function(name) {
+ return (this.hasMethod(name) || this.hasProperty(name));
+}
+
+JSDOC.Symbol.prototype.addMember = function(symbol) {
+ if (symbol.is("FUNCTION")) { this.addMethod(symbol); }
+ else if (symbol.is("OBJECT")) { this.addProperty(symbol); }
+}
+
+JSDOC.Symbol.prototype.hasMethod = function(name) {
+ var thisMethods = this.methods;
+ for (var i = 0, l = thisMethods.length; i < l; i++) {
+ if (thisMethods[i].name == name) return true;
+ if (thisMethods[i].alias == name) return true;
+ }
+ return false;
+}
+
+JSDOC.Symbol.prototype.addMethod = function(symbol) {
+ var methodAlias = symbol.alias;
+ var thisMethods = this.methods;
+ for (var i = 0, l = thisMethods.length; i < l; i++) {
+ if (thisMethods[i].alias == methodAlias) {
+ thisMethods[i] = symbol; // overwriting previous method
+ return;
+ }
+ }
+ thisMethods.push(symbol); // new method with this alias
+}
+
+JSDOC.Symbol.prototype.hasProperty = function(name) {
+ var thisProperties = this.properties;
+ for (var i = 0, l = thisProperties.length; i < l; i++) {
+ if (thisProperties[i].name == name) return true;
+ if (thisProperties[i].alias == name) return true;
+ }
+ return false;
+}
+
+JSDOC.Symbol.prototype.addProperty = function(symbol) {
+ var propertyAlias = symbol.alias;
+ var thisProperties = this.properties;
+ for (var i = 0, l = thisProperties.length; i < l; i++) {
+ if (thisProperties[i].alias == propertyAlias) {
+ thisProperties[i] = symbol; // overwriting previous property
+ return;
+ }
+ }
+
+ thisProperties.push(symbol); // new property with this alias
+}
+
+JSDOC.Symbol.srcFile = ""; //running reference to the current file being parsed
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js (revision 7127)
@@ -0,0 +1,241 @@
+/** @constructor */
+JSDOC.SymbolSet = function() {
+ this.init();
+}
+
+JSDOC.SymbolSet.prototype.init = function() {
+ this._index = new Hash();
+}
+
+JSDOC.SymbolSet.prototype.keys = function() {
+ return this._index.keys();
+}
+
+JSDOC.SymbolSet.prototype.hasSymbol = function(alias) {
+ return this._index.hasKey(alias);
+}
+
+JSDOC.SymbolSet.prototype.addSymbol = function(symbol) {
+ if (this.hasSymbol(symbol.alias)) {
+ LOG.warn("Overwriting symbol documentation for: "+symbol.alias + ".");
+ }
+ this._index.set(symbol.alias, symbol);
+}
+
+JSDOC.SymbolSet.prototype.getSymbol = function(alias) {
+ if (this.hasSymbol(alias)) return this._index.get(alias);
+}
+
+JSDOC.SymbolSet.prototype.getSymbolByName = function(name) {
+ for (var p = this._index.first(); p; p = this._index.next()) {
+ var symbol = p.value;
+ if (symbol.name == name) return symbol;
+ }
+}
+
+JSDOC.SymbolSet.prototype.toArray = function() {
+ return this._index.values();
+}
+
+JSDOC.SymbolSet.prototype.deleteSymbol = function(alias) {
+ if (!this.hasSymbol(alias)) return;
+ this._index.drop(alias);
+}
+
+JSDOC.SymbolSet.prototype.renameSymbol = function(oldName, newName) {
+ // todo: should check if oldname or newname already exist
+ this._index.replace(oldName, newName);
+ this._index.get(newName).alias = newName;
+ return newName;
+}
+
+JSDOC.SymbolSet.prototype.relate = function() {
+ this.resolveBorrows();
+ this.resolveMemberOf();
+ this.resolveAugments();
+}
+
+JSDOC.SymbolSet.prototype.resolveBorrows = function() {
+ for (var p = this._index.first(); p; p = this._index.next()) {
+ var symbol = p.value;
+ if (symbol.is("FILE") || symbol.is("GLOBAL")) continue;
+
+ var borrows = symbol.inherits;
+ for (var i = 0; i < borrows.length; i++) {
+
+if (/#$/.test(borrows[i].alias)) {
+ LOG.warn("Attempted to borrow entire instance of "+borrows[i].alias+" but that feature is not yet implemented.");
+ return;
+}
+ var borrowed = this.getSymbol(borrows[i].alias);
+
+ if (!borrowed) {
+ LOG.warn("Can't borrow undocumented "+borrows[i].alias+".");
+ continue;
+ }
+
+ if (borrows[i].as == borrowed.alias) {
+ var assumedName = borrowed.name.split(/([#.-])/).pop();
+ borrows[i].as = symbol.name+RegExp.$1+assumedName;
+ LOG.inform("Assuming borrowed as name is "+borrows[i].as+" but that feature is experimental.");
+ }
+
+ var borrowAsName = borrows[i].as;
+ var borrowAsAlias = borrowAsName;
+ if (!borrowAsName) {
+ LOG.warn("Malformed @borrow, 'as' is required.");
+ continue;
+ }
+
+ if (borrowAsName.length > symbol.alias.length && borrowAsName.indexOf(symbol.alias) == 0) {
+ borrowAsName = borrowAsName.replace(borrowed.alias, "")
+ }
+ else {
+ var joiner = "";
+ if (borrowAsName.charAt(0) != "#") joiner = ".";
+ borrowAsAlias = borrowed.alias + joiner + borrowAsName;
+ }
+
+ borrowAsName = borrowAsName.replace(/^[#.]/, "");
+
+ if (this.hasSymbol(borrowAsAlias)) continue;
+
+ var clone = borrowed.clone();
+ clone.name = borrowAsName;
+ clone.alias = borrowAsAlias;
+ this.addSymbol(clone);
+ }
+ }
+}
+
+JSDOC.SymbolSet.prototype.resolveMemberOf = function() {
+ for (var p = this._index.first(); p; p = this._index.next()) {
+ var symbol = p.value;
+ if (symbol.is("FILE") || symbol.is("GLOBAL")) continue;
+
+ // the memberOf value was provided in the @memberOf tag
+ else if (symbol.memberOf) {
+
+ // like foo.bar is a memberOf foo
+ if (symbol.alias.indexOf(symbol.memberOf) == 0) {
+ var memberMatch = new RegExp("^("+symbol.memberOf+")[.#-]?(.+)$");
+ var aliasParts = symbol.alias.match(memberMatch);
+
+ if (aliasParts) {
+ symbol.memberOf = aliasParts[1];
+ symbol.name = aliasParts[2];
+ }
+
+ var nameParts = symbol.name.match(memberMatch);
+
+ if (nameParts) {
+ symbol.name = nameParts[2];
+ }
+ }
+ // like bar is a memberOf foo
+ else {
+ var joiner = symbol.memberOf.charAt(symbol.memberOf.length-1);
+ if (!/[.#-]/.test(joiner)) symbol.memberOf += ".";
+ this.renameSymbol(symbol.alias, symbol.memberOf + symbol.name);
+ }
+ }
+ // the memberOf must be calculated
+ else {
+ var parts = symbol.alias.match(/^(.*[.#-])([^.#-]+)$/);
+ if (parts) {
+ symbol.memberOf = parts[1];
+ symbol.name = parts[2];
+ }
+ }
+
+ // set isStatic, isInner
+ if (symbol.memberOf) {
+ switch (symbol.memberOf.charAt(symbol.memberOf.length-1)) {
+ case '#' :
+ symbol.isStatic = false;
+ symbol.isInner = false;
+ break;
+ case '.' :
+ symbol.isStatic = true;
+ symbol.isInner = false;
+ break;
+ case '-' :
+ symbol.isStatic = false;
+ symbol.isInner = true;
+ break;
+ default: // memberOf ends in none of the above
+ symbol.isStatic = true;
+ break;
+ }
+ }
+
+ // unowned methods and fields belong to the global object
+ if (!symbol.is("CONSTRUCTOR") && !symbol.isNamespace && symbol.memberOf == "") {
+ symbol.memberOf = "_global_";
+ }
+
+ // clean up
+ if (symbol.memberOf.match(/[.#-]$/)) {
+ symbol.memberOf = symbol.memberOf.substr(0, symbol.memberOf.length-1);
+ }
+ // add to parent's methods or properties list
+ if (symbol.memberOf) {
+
+ var container = this.getSymbol(symbol.memberOf);
+ if (!container) {
+ if (JSDOC.Lang.isBuiltin(symbol.memberOf)) container = JSDOC.Parser.addBuiltin(symbol.memberOf);
+ else {
+ LOG.warn("Trying to document "+symbol.name +" as a member of undocumented symbol "+symbol.memberOf+".");
+ }
+ }
+
+ if (container) container.addMember(symbol);
+ }
+ }
+}
+
+JSDOC.SymbolSet.prototype.resolveAugments = function() {
+ for (var p = this._index.first(); p; p = this._index.next()) {
+ var symbol = p.value;
+
+ if (symbol.alias == "_global_" || symbol.is("FILE")) continue;
+ JSDOC.SymbolSet.prototype.walk.apply(this, [symbol]);
+ }
+}
+
+JSDOC.SymbolSet.prototype.walk = function(symbol) {
+ var augments = symbol.augments;
+ for(var i = 0; i < augments.length; i++) {
+ var contributer = this.getSymbol(augments[i]);
+ if (!contributer && JSDOC.Lang.isBuiltin(''+augments[i])) {
+ contributer = new JSDOC.Symbol("_global_."+augments[i], [], augments[i], new JSDOC.DocComment("Built in."));
+ contributer.isNamespace = true;
+ contributer.srcFile = "";
+ contributer.isPrivate = false;
+ JSDOC.Parser.addSymbol(contributer);
+ }
+
+ if (contributer) {
+ if (contributer.augments.length) {
+ JSDOC.SymbolSet.prototype.walk.apply(this, [contributer]);
+ }
+
+ symbol.inheritsFrom.push(contributer.alias);
+ //if (!isUnique(symbol.inheritsFrom)) {
+ // LOG.warn("Can't resolve augments: Circular reference: "+symbol.alias+" inherits from "+contributer.alias+" more than once.");
+ //}
+ //else {
+ var cmethods = contributer.methods;
+ var cproperties = contributer.properties;
+
+ for (var ci = 0, cl = cmethods.length; ci < cl; ci++) {
+ if (!cmethods[ci].isStatic) symbol.inherit(cmethods[ci]);
+ }
+ for (var ci = 0, cl = cproperties.length; ci < cl; ci++) {
+ if (!cproperties[ci].isStatic) symbol.inherit(cproperties[ci]);
+ }
+ //}
+ }
+ else LOG.warn("Can't augment contributer: "+augments[i]+", not found.");
+ }
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TextStream.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TextStream.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TextStream.js (revision 7127)
@@ -0,0 +1,41 @@
+
+/**
+ @constructor
+*/
+JSDOC.TextStream = function(text) {
+ if (typeof(text) == "undefined") text = "";
+ text = ""+text;
+ this.text = text;
+ this.cursor = 0;
+}
+
+JSDOC.TextStream.prototype.look = function(n) {
+ if (typeof n == "undefined") n = 0;
+
+ if (this.cursor+n < 0 || this.cursor+n >= this.text.length) {
+ var result = new String("");
+ result.eof = true;
+ return result;
+ }
+ return this.text.charAt(this.cursor+n);
+}
+
+JSDOC.TextStream.prototype.next = function(n) {
+ if (typeof n == "undefined") n = 1;
+ if (n < 1) return null;
+
+ var pulled = "";
+ for (var i = 0; i < n; i++) {
+ if (this.cursor+i < this.text.length) {
+ pulled += this.text.charAt(this.cursor+i);
+ }
+ else {
+ var result = new String("");
+ result.eof = true;
+ return result;
+ }
+ }
+
+ this.cursor += n;
+ return pulled;
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Token.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Token.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Token.js (revision 7127)
@@ -0,0 +1,18 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ @constructor
+*/
+JSDOC.Token = function(data, type, name) {
+ this.data = data;
+ this.type = type;
+ this.name = name;
+}
+
+JSDOC.Token.prototype.toString = function() {
+ return "<"+this.type+" name=\""+this.name+"\">"+this.data+"";
+}
+
+JSDOC.Token.prototype.is = function(what) {
+ return this.name === what || this.type === what;
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js (revision 7127)
@@ -0,0 +1,332 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ @class Search a {@link JSDOC.TextStream} for language tokens.
+*/
+JSDOC.TokenReader = function() {
+ this.keepDocs = true;
+ this.keepWhite = false;
+ this.keepComments = false;
+}
+
+/**
+ @type {JSDOC.Token[]}
+ */
+JSDOC.TokenReader.prototype.tokenize = function(/**JSDOC.TextStream*/stream) {
+ var tokens = [];
+ /**@ignore*/ tokens.last = function() { return tokens[tokens.length-1]; }
+ /**@ignore*/ tokens.lastSym = function() {
+ for (var i = tokens.length-1; i >= 0; i--) {
+ if (!(tokens[i].is("WHIT") || tokens[i].is("COMM"))) return tokens[i];
+ }
+ }
+
+ while (!stream.look().eof) {
+ if (this.read_mlcomment(stream, tokens)) continue;
+ if (this.read_slcomment(stream, tokens)) continue;
+ if (this.read_dbquote(stream, tokens)) continue;
+ if (this.read_snquote(stream, tokens)) continue;
+ if (this.read_regx(stream, tokens)) continue;
+ if (this.read_numb(stream, tokens)) continue;
+ if (this.read_punc(stream, tokens)) continue;
+ if (this.read_newline(stream, tokens)) continue;
+ if (this.read_space(stream, tokens)) continue;
+ if (this.read_word(stream, tokens)) continue;
+
+ // if execution reaches here then an error has happened
+ tokens.push(new JSDOC.Token(stream.next(), "TOKN", "UNKNOWN_TOKEN"));
+ }
+ return tokens;
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_word = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found = "";
+ while (!stream.look().eof && JSDOC.Lang.isWordChar(stream.look())) {
+ found += stream.next();
+ }
+
+ if (found === "") {
+ return false;
+ }
+ else {
+ var name;
+ if ((name = JSDOC.Lang.keyword(found))) tokens.push(new JSDOC.Token(found, "KEYW", name));
+ else tokens.push(new JSDOC.Token(found, "NAME", "NAME"));
+ return true;
+ }
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_punc = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found = "";
+ var name;
+ while (!stream.look().eof && JSDOC.Lang.punc(found+stream.look())) {
+ found += stream.next();
+ }
+
+ if (found === "") {
+ return false;
+ }
+ else {
+ tokens.push(new JSDOC.Token(found, "PUNC", JSDOC.Lang.punc(found)));
+ return true;
+ }
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_space = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found = "";
+
+ while (!stream.look().eof && JSDOC.Lang.isSpace(stream.look())) {
+ found += stream.next();
+ }
+
+ if (found === "") {
+ return false;
+ }
+ else {
+ if (this.collapseWhite) found = " ";
+ if (this.keepWhite) tokens.push(new JSDOC.Token(found, "WHIT", "SPACE"));
+ return true;
+ }
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_newline = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found = "";
+
+ while (!stream.look().eof && JSDOC.Lang.isNewline(stream.look())) {
+ found += stream.next();
+ }
+
+ if (found === "") {
+ return false;
+ }
+ else {
+ if (this.collapseWhite) found = "\n";
+ if (this.keepWhite) tokens.push(new JSDOC.Token(found, "WHIT", "NEWLINE"));
+ return true;
+ }
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_mlcomment = function(/**JSDOC.TokenStream*/stream, tokens) {
+ if (stream.look() == "/" && stream.look(1) == "*") {
+ var found = stream.next(2);
+
+ while (!stream.look().eof && !(stream.look(-1) == "/" && stream.look(-2) == "*")) {
+ found += stream.next();
+ }
+
+ // to start doclet we allow /** or /*** but not /**/ or /****
+ if (/^\/\*\*([^\/]|\*[^*])/.test(found) && this.keepDocs) tokens.push(new JSDOC.Token(found, "COMM", "JSDOC"));
+ else if (this.keepComments) tokens.push(new JSDOC.Token(found, "COMM", "MULTI_LINE_COMM"));
+ return true;
+ }
+ return false;
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_slcomment = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found;
+ if (
+ (stream.look() == "/" && stream.look(1) == "/" && (found=stream.next(2)))
+ ||
+ (stream.look() == "<" && stream.look(1) == "!" && stream.look(2) == "-" && stream.look(3) == "-" && (found=stream.next(4)))
+ ) {
+
+ while (!stream.look().eof && !JSDOC.Lang.isNewline(stream.look())) {
+ found += stream.next();
+ }
+
+ if (this.keepComments) {
+ tokens.push(new JSDOC.Token(found, "COMM", "SINGLE_LINE_COMM"));
+ }
+ return true;
+ }
+ return false;
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_dbquote = function(/**JSDOC.TokenStream*/stream, tokens) {
+ if (stream.look() == "\"") {
+ // find terminator
+ var string = stream.next();
+
+ while (!stream.look().eof) {
+ if (stream.look() == "\\") {
+ if (JSDOC.Lang.isNewline(stream.look(1))) {
+ do {
+ stream.next();
+ } while (!stream.look().eof && JSDOC.Lang.isNewline(stream.look()));
+ string += "\\\n";
+ }
+ else {
+ string += stream.next(2);
+ }
+ }
+ else if (stream.look() == "\"") {
+ string += stream.next();
+ tokens.push(new JSDOC.Token(string, "STRN", "DOUBLE_QUOTE"));
+ return true;
+ }
+ else {
+ string += stream.next();
+ }
+ }
+ }
+ return false; // error! unterminated string
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_snquote = function(/**JSDOC.TokenStream*/stream, tokens) {
+ if (stream.look() == "'") {
+ // find terminator
+ var string = stream.next();
+
+ while (!stream.look().eof) {
+ if (stream.look() == "\\") { // escape sequence
+ string += stream.next(2);
+ }
+ else if (stream.look() == "'") {
+ string += stream.next();
+ tokens.push(new JSDOC.Token(string, "STRN", "SINGLE_QUOTE"));
+ return true;
+ }
+ else {
+ string += stream.next();
+ }
+ }
+ }
+ return false; // error! unterminated string
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_numb = function(/**JSDOC.TokenStream*/stream, tokens) {
+ if (stream.look() === "0" && stream.look(1) == "x") {
+ return this.read_hex(stream, tokens);
+ }
+
+ var found = "";
+
+ while (!stream.look().eof && JSDOC.Lang.isNumber(found+stream.look())){
+ found += stream.next();
+ }
+
+ if (found === "") {
+ return false;
+ }
+ else {
+ if (/^0[0-7]/.test(found)) tokens.push(new JSDOC.Token(found, "NUMB", "OCTAL"));
+ else tokens.push(new JSDOC.Token(found, "NUMB", "DECIMAL"));
+ return true;
+ }
+}
+/*t:
+ requires("../lib/JSDOC/TextStream.js");
+ requires("../lib/JSDOC/Token.js");
+ requires("../lib/JSDOC/Lang.js");
+
+ plan(3, "testing JSDOC.TokenReader.prototype.read_numb");
+
+ //// setup
+ var src = "function foo(num){while (num+8.0 >= 0x20 && num < 0777){}}";
+ var tr = new JSDOC.TokenReader();
+ var tokens = tr.tokenize(new JSDOC.TextStream(src));
+
+ var hexToken, octToken, decToken;
+ for (var i = 0; i < tokens.length; i++) {
+ if (tokens[i].name == "HEX_DEC") hexToken = tokens[i];
+ if (tokens[i].name == "OCTAL") octToken = tokens[i];
+ if (tokens[i].name == "DECIMAL") decToken = tokens[i];
+ }
+ ////
+
+ is(decToken.data, "8.0", "decimal number is found in source.");
+ is(hexToken.data, "0x20", "hexdec number is found in source (issue #99).");
+ is(octToken.data, "0777", "octal number is found in source.");
+*/
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_hex = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var found = stream.next(2);
+
+ while (!stream.look().eof) {
+ if (JSDOC.Lang.isHexDec(found) && !JSDOC.Lang.isHexDec(found+stream.look())) { // done
+ tokens.push(new JSDOC.Token(found, "NUMB", "HEX_DEC"));
+ return true;
+ }
+ else {
+ found += stream.next();
+ }
+ }
+ return false;
+}
+
+/**
+ @returns {Boolean} Was the token found?
+ */
+JSDOC.TokenReader.prototype.read_regx = function(/**JSDOC.TokenStream*/stream, tokens) {
+ var last;
+ if (
+ stream.look() == "/"
+ &&
+ (
+
+ (
+ !(last = tokens.lastSym()) // there is no last, the regex is the first symbol
+ ||
+ (
+ !last.is("NUMB")
+ && !last.is("NAME")
+ && !last.is("RIGHT_PAREN")
+ && !last.is("RIGHT_BRACKET")
+ )
+ )
+ )
+ ) {
+ var regex = stream.next();
+
+ while (!stream.look().eof) {
+ if (stream.look() == "\\") { // escape sequence
+ regex += stream.next(2);
+ }
+ else if (stream.look() == "/") {
+ regex += stream.next();
+
+ while (/[gmi]/.test(stream.look())) {
+ regex += stream.next();
+ }
+
+ tokens.push(new JSDOC.Token(regex, "REGX", "REGX"));
+ return true;
+ }
+ else {
+ regex += stream.next();
+ }
+ }
+ // error: unterminated regex
+ }
+ return false;
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js (revision 7127)
@@ -0,0 +1,133 @@
+if (typeof JSDOC == "undefined") JSDOC = {};
+
+/**
+ @constructor
+*/
+JSDOC.TokenStream = function(tokens) {
+ this.tokens = (tokens || []);
+ this.rewind();
+}
+
+/**
+ @constructor
+ @private
+*/
+function VoidToken(/**String*/type) {
+ this.toString = function() {return ""};
+ this.is = function(){return false;}
+}
+
+JSDOC.TokenStream.prototype.rewind = function() {
+ this.cursor = -1;
+}
+
+/**
+ @type JSDOC.Token
+*/
+JSDOC.TokenStream.prototype.look = function(/**Number*/n, /**Boolean*/considerWhitespace) {
+ if (typeof n == "undefined") n = 0;
+
+ if (considerWhitespace == true) {
+ if (this.cursor+n < 0 || this.cursor+n > this.tokens.length) return {};
+ return this.tokens[this.cursor+n];
+ }
+ else {
+ var count = 0;
+ var i = this.cursor;
+
+ while (true) {
+ if (i < 0) return new JSDOC.Token("", "VOID", "START_OF_STREAM");
+ else if (i > this.tokens.length) return new JSDOC.Token("", "VOID", "END_OF_STREAM");
+
+ if (i != this.cursor && (this.tokens[i] === undefined || this.tokens[i].is("WHIT"))) {
+ if (n < 0) i--; else i++;
+ continue;
+ }
+
+ if (count == Math.abs(n)) {
+ return this.tokens[i];
+ }
+ count++;
+ (n < 0)? i-- : i++;
+ }
+
+ return new JSDOC.Token("", "VOID", "STREAM_ERROR"); // because null isn't an object and caller always expects an object
+ }
+}
+
+/**
+ @type JSDOC.Token|JSDOC.Token[]
+*/
+JSDOC.TokenStream.prototype.next = function(/**Number*/howMany) {
+ if (typeof howMany == "undefined") howMany = 1;
+ if (howMany < 1) return null;
+ var got = [];
+
+ for (var i = 1; i <= howMany; i++) {
+ if (this.cursor+i >= this.tokens.length) {
+ return null;
+ }
+ got.push(this.tokens[this.cursor+i]);
+ }
+ this.cursor += howMany;
+
+ if (howMany == 1) {
+ return got[0];
+ }
+ else return got;
+}
+
+/**
+ @type JSDOC.Token[]
+*/
+JSDOC.TokenStream.prototype.balance = function(/**String*/start, /**String*/stop) {
+ if (!stop) stop = JSDOC.Lang.matching(start);
+
+ var depth = 0;
+ var got = [];
+ var started = false;
+
+ while ((token = this.look())) {
+ if (token.is(start)) {
+ depth++;
+ started = true;
+ }
+
+ if (started) {
+ got.push(token);
+ }
+
+ if (token.is(stop)) {
+ depth--;
+ if (depth == 0) return got;
+ }
+ if (!this.next()) break;
+ }
+}
+
+JSDOC.TokenStream.prototype.getMatchingToken = function(/**String*/start, /**String*/stop) {
+ var depth = 0;
+ var cursor = this.cursor;
+
+ if (!start) {
+ start = JSDOC.Lang.matching(stop);
+ depth = 1;
+ }
+ if (!stop) stop = JSDOC.Lang.matching(start);
+
+ while ((token = this.tokens[cursor])) {
+ if (token.is(start)) {
+ depth++;
+ }
+
+ if (token.is(stop) && cursor) {
+ depth--;
+ if (depth == 0) return this.tokens[cursor];
+ }
+ cursor++;
+ }
+}
+
+JSDOC.TokenStream.prototype.insertAhead = function(/**JSDOC.Token*/token) {
+ this.tokens.splice(this.cursor+1, 0, token);
+}
Index: /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Util.js
===================================================================
--- /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Util.js (revision 7127)
+++ /CKRobot/trunk/_dev/jsdoc-toolkit/app/lib/JSDOC/Util.js (revision 7127)
@@ -0,0 +1,32 @@
+/**
+ * @namespace
+ * @deprecated Use {@link FilePath} instead.
+ */
+JSDOC.Util = {
+}
+
+/**
+ * @deprecated Use {@link FilePath.fileName} instead.
+ */
+JSDOC.Util.fileName = function(path) {
+ LOG.warn("JSDOC.Util.fileName is deprecated. Use FilePath.fileName instead.");
+ var nameStart = Math.max(path.lastIndexOf("/")+1, path.lastIndexOf("\\")+1, 0);
+ return path.substring(nameStart);
+}
+
+/**
+ * @deprecated Use {@link FilePath.fileExtension} instead.
+ */
+JSDOC.Util.fileExtension = function(filename) {
+ LOG.warn("JSDOC.Util.fileExtension is deprecated. Use FilePath.fileExtension instead.");
+ return filename.split(".").pop().toLowerCase();
+};
+
+/**
+ * @deprecated Use {@link FilePath.dir} instead.
+ */
+JSDOC.Util.dir = function(path) {
+ LOG.warn("JSDOC.Util.dir is deprecated. Use FilePath.dir instead.");
+ var nameStart = Math.max(path.lastIndexOf("/")+1, path.lastIndexOf("\\")+1, 0);
+ return path.substring(0, nameStart-1);
+}
Index: /CKRobot/trunk/ckrobot.bat
===================================================================
--- /CKRobot/trunk/ckrobot.bat (revision 7127)
+++ /CKRobot/trunk/ckrobot.bat (revision 7127)
@@ -0,0 +1,4 @@
+@echo off
+java ^
+-Dwebdriver.firefox.bin="d:/Program Files/Mozilla Firefox/firefox.exe" ^
+-cp lib\js.jar;lib\ant.jar;lib\ant-launcher.jar;lib\ant-junit.jar;lib\cli.jar;lib\selenium.jar;lib\selenium-server.jar; org.mozilla.javascript.tools.shell.Main -opt -1 src/runner.js %*
Index: /CKRobot/trunk/lib/env.js
===================================================================
--- /CKRobot/trunk/lib/env.js (revision 7127)
+++ /CKRobot/trunk/lib/env.js (revision 7127)
@@ -0,0 +1,13988 @@
+/*
+ * Envjs core-env.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+var Envjs = function(){
+ var i,
+ name,
+ override = function(){
+ for(i=0;i and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author john resig
+ */
+// Helper method for extending one object with another.
+function __extend__(a,b) {
+ for ( var i in b ) {
+ var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
+ if ( g || s ) {
+ if ( g ) { a.__defineGetter__(i, g); }
+ if ( s ) { a.__defineSetter__(i, s); }
+ } else {
+ a[i] = b[i];
+ }
+ } return a;
+}
+
+/**
+ * Writes message to system out
+ * @param {String} message
+ */
+Envjs.log = function(message){};
+
+/**
+ * Constants providing enumerated levels for logging in modules
+ */
+Envjs.DEBUG = 1;
+Envjs.INFO = 2;
+Envjs.WARN = 3;
+Envjs.ERROR = 3;
+Envjs.NONE = 3;
+
+/**
+ * Writes error info out to console
+ * @param {Error} e
+ */
+Envjs.lineSource = function(e){};
+
+
+/**
+ * TODO: used in ./event/eventtarget.js
+ * @param {Object} event
+ */
+Envjs.defaultEventBehaviors = {};
+
+
+/**
+ * describes which script src values will trigger Envjs to load
+ * the script like a browser would
+ */
+Envjs.scriptTypes = {
+ "text/javascript" :false,
+ "text/envjs" :true
+};
+
+/**
+ * will be called when loading a script throws an error
+ * @param {Object} script
+ * @param {Object} e
+ */
+Envjs.onScriptLoadError = function(script, e){
+ console.log('error loading script %s %s', script, e);
+};
+
+
+/**
+ * load and execute script tag text content
+ * @param {Object} script
+ */
+Envjs.loadInlineScript = function(script){
+ var tmpFile;
+ tmpFile = Envjs.writeToTempFile(script.text, 'js') ;
+ load(tmpFile);
+};
+
+/**
+ * Should evaluate script in some context
+ * @param {Object} context
+ * @param {Object} source
+ * @param {Object} name
+ */
+Envjs.eval = function(context, source, name){};
+
+
+/**
+ * Executes a script tag
+ * @param {Object} script
+ * @param {Object} parser
+ */
+Envjs.loadLocalScript = function(script){
+ //console.log("loading script %s", script);
+ var types,
+ src,
+ i,
+ base,
+ filename,
+ xhr;
+
+ if(script.type){
+ types = script.type.split(";");
+ for(i=0;i
+ * - Via an innerHTML parse of a
+ * - A modificiation of the 'src' attribute of an Image/HTMLImageElement
+ *
+ * NOTE: this is optional API. If this doesn't exist then the default
+ * 'loaded' event occurs.
+ *
+ * @param node {Object} the node
+ * @param node the src value
+ * @return 'true' to indicate the 'load' succeed, false otherwise
+ */
+Envjs.loadImage = function(node, src) {
+ return true;
+};
+
+
+/**
+ * A 'link' was requested by the document. Typically this occurs when:
+ * - During inital parse of a
+ * - Via an innerHTML parse of a
+ * - A modificiation of the 'href' attribute on a node in the tree
+ *
+ * @param node {Object} is the link node in question
+ * @param href {String} is the href.
+ *
+ * Return 'true' to indicate that the 'load' was successful, or false
+ * otherwise. The appropriate event is then triggered.
+ *
+ * NOTE: this is optional API. If this doesn't exist then the default
+ * 'loaded' event occurs
+ */
+Envjs.loadLink = function(node, href) {
+ return true;
+};
+
+(function(){
+
+
+/*
+ * cookie handling
+ * Private internal helper class used to save/retreive cookies
+ */
+
+/**
+ * Specifies the location of the cookie file
+ */
+Envjs.cookieFile = function(){
+ return 'testFile://'+Envjs.homedir+'/.cookies';
+};
+
+/**
+ * saves cookies to a local file
+ * @param {Object} htmldoc
+ */
+Envjs.saveCookies = function(){
+ var cookiejson = JSON.stringify(Envjs.cookies.peristent,null,'\t');
+ //console.log('persisting cookies %s', cookiejson);
+ Envjs.writeToFile(cookiejson, Envjs.cookieFile());
+};
+
+/**
+ * loads cookies from a local file
+ * @param {Object} htmldoc
+ */
+Envjs.loadCookies = function(){
+ var cookiejson,
+ js;
+ try{
+ cookiejson = Envjs.readFromFile(Envjs.cookieFile())
+ js = JSON.parse(cookiejson, null, '\t');
+ }catch(e){
+ //console.log('failed to load cookies %s', e);
+ js = {};
+ }
+ return js;
+};
+
+Envjs.cookies = {
+ persistent:{
+ //domain - key on domain name {
+ //path - key on path {
+ //name - key on name {
+ //value : cookie value
+ //other cookie properties
+ //}
+ //}
+ //}
+ //expire - provides a timestamp for expiring the cookie
+ //cookie - the cookie!
+ },
+ temporary:{//transient is a reserved word :(
+ //like above
+ }
+};
+
+var __cookies__;
+
+//HTMLDocument cookie
+Envjs.setCookie = function(url, cookie){
+ var i,
+ index,
+ name,
+ value,
+ properties = {},
+ attr,
+ attrs;
+ url = Envjs.urlsplit(url);
+ if(cookie)
+ attrs = cookie.split(";");
+ else
+ return;
+
+ //for now the strategy is to simply create a json object
+ //and post it to a file in the .cookies.js file. I hate parsing
+ //dates so I decided not to implement support for 'expires'
+ //(which is deprecated) and instead focus on the easier 'max-age'
+ //(which succeeds 'expires')
+ cookie = {};//keyword properties of the cookie
+ cookie['domain'] = url.hostname;
+ cookie['path'] = url.path||'/';
+ for(i=0;i -1){
+ name = __trim__(attrs[i].slice(0,index));
+ value = __trim__(attrs[i].slice(index+1));
+ if(name=='max-age'){
+ //we'll have to when to check these
+ //and garbage collect expired cookies
+ cookie[name] = parseInt(value, 10);
+ } else if( name == 'domain' ){
+ if(__domainValid__(url, value)){
+ cookie['domain'] = value;
+ }
+ } else if( name == 'path' ){
+ //not sure of any special logic for path
+ cookie['path'] = value;
+ } else {
+ //its not a cookie keyword so store it in our array of properties
+ //and we'll serialize individually in a moment
+ properties[name] = value;
+ }
+ }else{
+ if( attrs[i] == 'secure' ){
+ cookie[attrs[i]] = true;
+ }
+ }
+ }
+ if(!('max-age' in cookie)){
+ //it's a transient cookie so it only lasts as long as
+ //the window.location remains the same (ie in-memory cookie)
+ __mergeCookie__(Envjs.cookies.temporary, cookie, properties);
+ }else{
+ //the cookie is persistent
+ __mergeCookie__(Envjs.cookies.persistent, cookie, properties);
+ Envjs.saveCookies();
+ }
+};
+
+function __domainValid__(url, value){
+ var i,
+ domainParts = url.hostname.split('.').reverse(),
+ newDomainParts = value.split('.').reverse();
+ if(newDomainParts.length > 1){
+ for(i=0;i -1) {
+ for (name in cookies[domain][path]) {
+ // console.log('cookie domain path name %s', name);
+ cookieString +=
+ ((i++ > 0)?'; ':'') +
+ name + "=" +
+ cookies[domain][path][name].value;
+ }
+ }
+ }
+ }
+ }
+ return cookieString;
+};
+
+function __mergeCookie__(target, cookie, properties){
+ var name, now;
+ if(!target[cookie.domain]){
+ target[cookie.domain] = {};
+ }
+ if(!target[cookie.domain][cookie.path]){
+ target[cookie.domain][cookie.path] = {};
+ }
+ for(name in properties){
+ now = new Date().getTime();
+ target[cookie.domain][cookie.path][name] = {
+ "value":properties[name],
+ "secure":cookie.secure,
+ "max-age":cookie['max-age'],
+ "date-created":now,
+ "expiration":(cookie['max-age']===0) ?
+ 0 :
+ now + cookie['max-age']
+ };
+ //console.log('cookie is %o',target[cookie.domain][cookie.path][name]);
+ }
+};
+
+})();//end cookies
+/*
+ http://www.JSON.org/json2.js
+ 2008-07-15
+
+ Public Domain.
+
+ NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
+
+ See http://www.JSON.org/js.html
+
+
+ This code should be minified before deployment.
+ See http://javascript.crockford.com/jsmin.html
+
+ USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
+ NOT CONTROL.
+*/
+try{ JSON; }catch(e){
+JSON = function () {
+
+ function f(n) {
+ // Format integers to have at least two digits.
+ return n < 10 ? '0' + n : n;
+ }
+
+ Date.prototype.toJSON = function (key) {
+
+ return this.getUTCFullYear() + '-' +
+ f(this.getUTCMonth() + 1) + '-' +
+ f(this.getUTCDate()) + 'T' +
+ f(this.getUTCHours()) + ':' +
+ f(this.getUTCMinutes()) + ':' +
+ f(this.getUTCSeconds()) + 'Z';
+ };
+
+ String.prototype.toJSON = function (key) {
+ return String(this);
+ };
+ Number.prototype.toJSON =
+ Boolean.prototype.toJSON = function (key) {
+ return this.valueOf();
+ };
+
+ var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+ escapeable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+ gap,
+ indent,
+ meta = { // table of character substitutions
+ '\b': '\\b',
+ '\t': '\\t',
+ '\n': '\\n',
+ '\f': '\\f',
+ '\r': '\\r',
+ '"' : '\\"',
+ '\\': '\\\\'
+ },
+ rep;
+
+
+ function quote(string) {
+
+ escapeable.lastIndex = 0;
+ return escapeable.test(string) ?
+ '"' + string.replace(escapeable, function (a) {
+ var c = meta[a];
+ if (typeof c === 'string') {
+ return c;
+ }
+ return '\\u' + ('0000' +
+ (+(a.charCodeAt(0))).toString(16)).slice(-4);
+ }) + '"' :
+ '"' + string + '"';
+ }
+
+
+ function str(key, holder) {
+
+ var i, // The loop counter.
+ k, // The member key.
+ v, // The member value.
+ length,
+ mind = gap,
+ partial,
+ value = holder[key];
+
+ if (value && typeof value === 'object' &&
+ typeof value.toJSON === 'function') {
+ value = value.toJSON(key);
+ }
+ if (typeof rep === 'function') {
+ value = rep.call(holder, key, value);
+ }
+
+ switch (typeof value) {
+ case 'string':
+ return quote(value);
+
+ case 'number':
+ return isFinite(value) ? String(value) : 'null';
+
+ case 'boolean':
+ case 'null':
+
+ return String(value);
+
+ case 'object':
+
+ if (!value) {
+ return 'null';
+ }
+ gap += indent;
+ partial = [];
+
+ if (typeof value.length === 'number' &&
+ !(value.propertyIsEnumerable('length'))) {
+
+ length = value.length;
+ for (i = 0; i < length; i += 1) {
+ partial[i] = str(i, value) || 'null';
+ }
+
+ v = partial.length === 0 ? '[]' :
+ gap ? '[\n' + gap +
+ partial.join(',\n' + gap) + '\n' +
+ mind + ']' :
+ '[' + partial.join(',') + ']';
+ gap = mind;
+ return v;
+ }
+
+ if (rep && typeof rep === 'object') {
+ length = rep.length;
+ for (i = 0; i < length; i += 1) {
+ k = rep[i];
+ if (typeof k === 'string') {
+ v = str(k, value);
+ if (v) {
+ partial.push(quote(k) + (gap ? ': ' : ':') + v);
+ }
+ }
+ }
+ } else {
+
+ for (k in value) {
+ if (Object.hasOwnProperty.call(value, k)) {
+ v = str(k, value);
+ if (v) {
+ partial.push(quote(k) + (gap ? ': ' : ':') + v);
+ }
+ }
+ }
+ }
+
+ v = partial.length === 0 ? '{}' :
+ gap ? '{\n' + gap + partial.join(',\n' + gap) + '\n' +
+ mind + '}' : '{' + partial.join(',') + '}';
+ gap = mind;
+ return v;
+ }
+ }
+
+ return {
+ stringify: function (value, replacer, space) {
+
+ var i;
+ gap = '';
+ indent = '';
+
+ if (typeof space === 'number') {
+ for (i = 0; i < space; i += 1) {
+ indent += ' ';
+ }
+
+ } else if (typeof space === 'string') {
+ indent = space;
+ }
+
+ rep = replacer;
+ if (replacer && typeof replacer !== 'function' &&
+ (typeof replacer !== 'object' ||
+ typeof replacer.length !== 'number')) {
+ throw new Error('JSON.stringify');
+ }
+
+ return str('', {'': value});
+ },
+
+
+ parse: function (text, reviver) {
+ var j;
+ function walk(holder, key) {
+ var k, v, value = holder[key];
+ if (value && typeof value === 'object') {
+ for (k in value) {
+ if (Object.hasOwnProperty.call(value, k)) {
+ v = walk(value, k);
+ if (v !== undefined) {
+ value[k] = v;
+ } else {
+ delete value[k];
+ }
+ }
+ }
+ }
+ return reviver.call(holder, key, value);
+ }
+
+ cx.lastIndex = 0;
+ if (cx.test(text)) {
+ text = text.replace(cx, function (a) {
+ return '\\u' + ('0000' +
+ (+(a.charCodeAt(0))).toString(16)).slice(-4);
+ });
+ }
+
+
+ if (/^[\],:{}\s]*$/.
+test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@').
+replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']').
+replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
+
+ j = eval('(' + text + ')');
+
+ return typeof reviver === 'function' ?
+ walk({'': j}, '') : j;
+ }
+
+ throw new SyntaxError('JSON.parse');
+ }
+ };
+}();
+
+}
+
+/**
+ * synchronizes thread modifications
+ * @param {Function} fn
+ */
+Envjs.sync = function(fn){};
+
+/**
+ * sleep thread for specified duration
+ * @param {Object} millseconds
+ */
+Envjs.sleep = function(millseconds){};
+
+/**
+ * Interval to wait on event loop when nothing is happening
+ */
+Envjs.WAIT_INTERVAL = 20;//milliseconds
+
+/*
+ * Copyright (c) 2010 Nick Galbreath
+ * http://code.google.com/p/stringencoders/source/browse/#svn/trunk/javascript
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+/*
+ * url processing in the spirit of python's urlparse module
+ * see `pydoc urlparse` or
+ * http://docs.python.org/library/urlparse.html
+ *
+ * urlsplit: break apart a URL into components
+ * urlunsplit: reconsistute a URL from componets
+ * urljoin: join an absolute and another URL
+ * urldefrag: remove the fragment from a URL
+ *
+ * Take a look at the tests in urlparse-test.html
+ *
+ * On URL Normalization:
+ *
+ * urlsplit only does minor normalization the components Only scheme
+ * and hostname are lowercased urljoin does a bit more, normalizing
+ * paths with "." and "..".
+
+ * urlnormalize adds additional normalization
+ *
+ * * removes default port numbers
+ * http://abc.com:80/ -> http://abc.com/, etc
+ * * normalizes path
+ * http://abc.com -> http://abc.com/
+ * and other "." and ".." cleanups
+ * * if file, remove query and fragment
+ *
+ * It does not do:
+ * * normalizes escaped hex values
+ * http://abc.com/%7efoo -> http://abc.com/%7Efoo
+ * * normalize '+' <--> '%20'
+ *
+ * Differences with Python
+ *
+ * The javascript urlsplit returns a normal object with the following
+ * properties: scheme, netloc, hostname, port, path, query, fragment.
+ * All properties are read-write.
+ *
+ * In python, the resulting object is not a dict, but a specialized,
+ * read-only, and has alternative tuple interface (e.g. obj[0] ==
+ * obj.scheme). It's not clear why such a simple function requires
+ * a unique datastructure.
+ *
+ * urlunsplit in javascript takes an duck-typed object,
+ * { scheme: 'http', netloc: 'abc.com', ...}
+ * while in * python it takes a list-like object.
+ * ['http', 'abc.com'... ]
+ *
+ * For all functions, the javascript version use
+ * hostname+port if netloc is missing. In python
+ * hostname+port were always ignored.
+ *
+ * Similar functionality in different languages:
+ *
+ * http://php.net/manual/en/function.parse-url.php
+ * returns assocative array but cannot handle relative URL
+ *
+ * TODO: test allowfragments more
+ * TODO: test netloc missing, but hostname present
+ */
+
+var urlparse = {};
+
+// Unlike to be useful standalone
+//
+// NORMALIZE PATH with "../" and "./"
+// http://en.wikipedia.org/wiki/URL_normalization
+// http://tools.ietf.org/html/rfc3986#section-5.2.3
+//
+urlparse.normalizepath = function(path)
+{
+ if (!path || path === '/') {
+ return '/';
+ }
+
+ var parts = path.split('/');
+
+ var newparts = [];
+ // make sure path always starts with '/'
+ if (parts[0]) {
+ newparts.push('');
+ }
+
+ for (var i = 0; i < parts.length; ++i) {
+ if (parts[i] === '..') {
+ if (newparts.length > 1) {
+ newparts.pop();
+ } else {
+ newparts.push(parts[i]);
+ }
+ } else if (parts[i] != '.') {
+ newparts.push(parts[i]);
+ }
+ }
+
+ path = newparts.join('/');
+ if (!path) {
+ path = '/';
+ }
+ return path;
+};
+
+//
+// Does many of the normalizations that the stock
+// python urlsplit/urlunsplit/urljoin neglects
+//
+// Doesn't do hex-escape normalization on path or query
+// %7e -> %7E
+// Nor, '+' <--> %20 translation
+//
+urlparse.urlnormalize = function(url)
+{
+ var parts = urlparse.urlsplit(url);
+ switch (parts.scheme) {
+ case 'testFile':
+ // files can't have query strings
+ // and we don't bother with fragments
+ parts.query = '';
+ parts.fragment = '';
+ break;
+ case 'http':
+ case 'https':
+ // remove default port
+ if ((parts.scheme === 'http' && parts.port == 80) ||
+ (parts.scheme === 'https' && parts.port == 443)) {
+ parts.port = null;
+ // hostname is already lower case
+ parts.netloc = parts.hostname;
+ }
+ break;
+ default:
+ // if we don't have specific normalizations for this
+ // scheme, return the original url unmolested
+ return url;
+ }
+
+ // for [file|http|https]. Not sure about other schemes
+ parts.path = urlparse.normalizepath(parts.path);
+
+ return urlparse.urlunsplit(parts);
+};
+
+urlparse.urldefrag = function(url)
+{
+ var idx = url.indexOf('#');
+ if (idx == -1) {
+ return [ url, '' ];
+ } else {
+ return [ url.substr(0,idx), url.substr(idx+1) ];
+ }
+};
+
+urlparse.urlsplit = function(url, default_scheme, allow_fragments)
+{
+ var leftover;
+
+ if (typeof allow_fragments === 'undefined') {
+ allow_fragments = true;
+ }
+
+ // scheme (optional), host, port
+ var fullurl = /^([A-Za-z]+)?(:?\/\/)([0-9.\-A-Za-z]*)(?::(\d+))?(.*)$/;
+ // path, query, fragment
+ var parse_leftovers = /([^?#]*)?(?:\?([^#]*))?(?:#(.*))?$/;
+
+ var o = {};
+
+ var parts = url.match(fullurl);
+ if (parts) {
+ o.scheme = parts[1] || default_scheme || '';
+ o.hostname = parts[3].toLowerCase() || '';
+ o.port = parseInt(parts[4],10) || '';
+ // Probably should grab the netloc from regexp
+ // and then parse again for hostname/port
+
+ o.netloc = parts[3];
+ if (parts[4]) {
+ o.netloc += ':' + parts[4];
+ }
+
+ leftover = parts[5];
+ } else {
+ o.scheme = default_scheme || '';
+ o.netloc = '';
+ o.hostname = '';
+ leftover = url;
+ }
+ o.scheme = o.scheme.toLowerCase();
+
+ parts = leftover.match(parse_leftovers);
+
+ o.path = parts[1] || '';
+ o.query = parts[2] || '';
+
+ if (allow_fragments) {
+ o.fragment = parts[3] || '';
+ } else {
+ o.fragment = '';
+ }
+
+ return o;
+};
+
+urlparse.urlunsplit = function(o) {
+ var s = '';
+ if (o.scheme) {
+ s += o.scheme + '://';
+ }
+
+ if (o.netloc) {
+ if (s == '') {
+ s += '//';
+ }
+ s += o.netloc;
+ } else if (o.hostname) {
+ // extension. Python only uses netloc
+ if (s == '') {
+ s += '//';
+ }
+ s += o.hostname;
+ if (o.port) {
+ s += ':' + o.port;
+ }
+ }
+
+ if (o.path) {
+ s += o.path;
+ }
+
+ if (o.query) {
+ s += '?' + o.query;
+ }
+ if (o.fragment) {
+ s += '#' + o.fragment;
+ }
+ return s;
+};
+
+urlparse.urljoin = function(base, url, allow_fragments)
+{
+ if (typeof allow_fragments === 'undefined') {
+ allow_fragments = true;
+ }
+
+ var url_parts = urlparse.urlsplit(url);
+
+ // if url parts has a scheme (i.e. absolute)
+ // then nothing to do
+ if (url_parts.scheme) {
+ if (! allow_fragments) {
+ return url;
+ } else {
+ return urlparse.urldefrag(url)[0];
+ }
+ }
+ var base_parts = urlparse.urlsplit(base);
+
+ // copy base, only if not present
+ if (!base_parts.scheme) {
+ base_parts.scheme = url_parts.scheme;
+ }
+
+ // copy netloc, only if not present
+ if (!base_parts.netloc || !base_parts.hostname) {
+ base_parts.netloc = url_parts.netloc;
+ base_parts.hostname = url_parts.hostname;
+ base_parts.port = url_parts.port;
+ }
+
+ // paths
+ if (url_parts.path.length > 0) {
+ if (url_parts.path.charAt(0) == '/') {
+ base_parts.path = url_parts.path;
+ } else {
+ // relative path.. get rid of "current filename" and
+ // replace. Same as var parts =
+ // base_parts.path.split('/'); parts[parts.length-1] =
+ // url_parts.path; base_parts.path = parts.join('/');
+ var idx = base_parts.path.lastIndexOf('/');
+ if (idx == -1) {
+ base_parts.path = url_parts.path;
+ } else {
+ base_parts.path = base_parts.path.substr(0,idx) + '/' +
+ url_parts.path;
+ }
+ }
+ }
+
+ // clean up path
+ base_parts.path = urlparse.normalizepath(base_parts.path);
+
+ // copy query string
+ base_parts.query = url_parts.query;
+
+ // copy fragments
+ if (allow_fragments) {
+ base_parts.fragment = url_parts.fragment;
+ } else {
+ base_parts.fragment = '';
+ }
+
+ return urlparse.urlunsplit(base_parts);
+};
+
+/**
+ * getcwd - named after posix call of same name (see 'man 2 getcwd')
+ *
+ */
+Envjs.getcwd = function() {
+ return '.';
+};
+
+/**
+ * resolves location relative to doc location
+ *
+ * @param {Object} path Relative or absolute URL
+ * @param {Object} base (semi-optional) The base url used in resolving "path" above
+ */
+Envjs.uri = function(path, base) {
+ //console.log('constructing uri from path %s and base %s', path, base);
+
+ // Semi-common trick is to make an iframe with src='javascript:false'
+ // (or some equivalent). By returning '', the load is skipped
+ if (path.indexOf('javascript') === 0) {
+ return '';
+ }
+
+ // if path is absolute, then just normalize and return
+ if (path.match('^[a-zA-Z]+://')) {
+ return urlparse.urlnormalize(path);
+ }
+
+ // interesting special case, a few very large websites use
+ // '//foo/bar/' to mean 'http://foo/bar'
+ if (path.match('^//')) {
+ path = 'http:' + path;
+ }
+
+ // if base not passed in, try to get it from document
+ // Ideally I would like the caller to pass in document.baseURI to
+ // make this more self-sufficient and testable
+ if (!base && document) {
+ base = document.baseURI;
+ }
+
+ // about:blank doesn't count
+ if (base === 'about:blank'){
+ base = '';
+ }
+
+ // if base is still empty, then we are in QA mode loading local
+ // files. Get current working directory
+ if (!base) {
+ base = 'testFile://' + Envjs.getcwd() + '/';
+ }
+ // handles all cases if path is abosulte or relative to base
+ // 3rd arg is "false" --> remove fragments
+ var newurl = urlparse.urlnormalize(urlparse.urljoin(base, path, false));
+
+ return newurl;
+};
+
+
+
+/**
+ * Used in the XMLHttpRquest implementation to run a
+ * request in a seperate thread
+ * @param {Object} fn
+ */
+Envjs.runAsync = function(fn){};
+
+
+/**
+ * Used to write to a local file
+ * @param {Object} text
+ * @param {Object} url
+ */
+Envjs.writeToFile = function(text, url){};
+
+
+/**
+ * Used to write to a local file
+ * @param {Object} text
+ * @param {Object} suffix
+ */
+Envjs.writeToTempFile = function(text, suffix){};
+
+/**
+ * Used to read the contents of a local file
+ * @param {Object} url
+ */
+Envjs.readFromFile = function(url){};
+
+/**
+ * Used to delete a local file
+ * @param {Object} url
+ */
+Envjs.deleteFile = function(url){};
+
+/**
+ * establishes connection and calls responsehandler
+ * @param {Object} xhr
+ * @param {Object} responseHandler
+ * @param {Object} data
+ */
+Envjs.connection = function(xhr, responseHandler, data){};
+
+
+__extend__(Envjs, urlparse);
+
+/**
+ * Makes an object window-like by proxying object accessors
+ * @param {Object} scope
+ * @param {Object} parent
+ */
+Envjs.proxy = function(scope, parent, aliasList){};
+
+Envjs.javaEnabled = false;
+
+Envjs.homedir = '';
+Envjs.tmpdir = '';
+Envjs.os_name = '';
+Envjs.os_arch = '';
+Envjs.os_version = '';
+Envjs.lang = '';
+Envjs.platform = '';
+
+/**
+ *
+ * @param {Object} frameElement
+ * @param {Object} url
+ */
+Envjs.loadFrame = function(frame, url){
+ try {
+ if(frame.contentWindow){
+ //mark for garbage collection
+ frame.contentWindow = null;
+ }
+
+ //create a new scope for the window proxy
+ //platforms will need to override this function
+ //to make sure the scope is global-like
+ frame.contentWindow = (function(){return this;})();
+ new Window(frame.contentWindow, window);
+
+ //I dont think frames load asynchronously in firefox
+ //and I think the tests have verified this but for
+ //some reason I'm less than confident... Are there cases?
+ frame.contentDocument = frame.contentWindow.document;
+ frame.contentDocument.async = false;
+ if(url){
+ //console.log('envjs.loadFrame async %s', frame.contentDocument.async);
+ frame.contentWindow.location = url;
+ }
+ } catch(e) {
+ console.log("failed to load frame content: from %s %s", url, e);
+ }
+};
+
+
+// The following are in rhino/window.js
+// TODO: Envjs.unloadFrame
+// TODO: Envjs.proxy
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+/*
+ * Envjs rhino-env.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+var __context__ = Packages.org.mozilla.javascript.Context.getCurrentContext();
+
+Envjs.platform = "Rhino";
+Envjs.revision = "1.7.0.rc2";
+
+/*
+ * Envjs rhino-env.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author john resig
+ */
+// Helper method for extending one object with another.
+function __extend__(a,b) {
+ for ( var i in b ) {
+ var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
+ if ( g || s ) {
+ if ( g ) { a.__defineGetter__(i, g); }
+ if ( s ) { a.__defineSetter__(i, s); }
+ } else {
+ a[i] = b[i];
+ }
+ } return a;
+}
+
+/**
+ * Writes message to system out.
+ *
+ * Some sites redefine 'print' as in 'window.print', so instead of
+ * printing to stdout, you are popping open a new window, which might
+ * call print, etc, etc,etc This can cause infinite loops and can
+ * exhausing all memory.
+ *
+ * By defining this upfront now, Envjs.log will always call the native 'print'
+ * function
+ *
+ * @param {Object} message
+ */
+Envjs.log = print;
+
+Envjs.lineSource = function(e){
+ return e&&e.rhinoException?e.rhinoException.lineSource():"(line ?)";
+};
+/**
+ * load and execute script tag text content
+ * @param {Object} script
+ */
+Envjs.loadInlineScript = function(script){
+ if(script.ownerDocument.ownerWindow){
+ Envjs.eval(
+ script.ownerDocument.ownerWindow,
+ script.text,
+ 'eval('+script.text.substring(0,16)+'...):'+new Date().getTime()
+ );
+ }else{
+ Envjs.eval(
+ __this__,
+ script.text,
+ 'eval('+script.text.substring(0,16)+'...):'+new Date().getTime()
+ );
+ }
+ //console.log('evaluated at scope %s \n%s',
+ // script.ownerDocument.ownerWindow.guid, script.text);
+};
+
+
+Envjs.eval = function(context, source, name){
+ __context__.evaluateString(
+ context,
+ source,
+ name,
+ 0,
+ null
+ );
+};
+
+//Temporary patch for parser module
+Packages.org.mozilla.javascript.Context.
+ getCurrentContext().setOptimizationLevel(-1);
+
+/**
+ * Rhino provides a very succinct 'sync'
+ * @param {Function} fn
+ */
+try{
+ Envjs.sync = sync;
+ Envjs.spawn = spawn;
+} catch(e){
+ //sync unavailable on AppEngine
+ Envjs.sync = function(fn){
+ //console.log('Threadless platform, sync is safe');
+ return fn;
+ };
+
+ Envjs.spawn = function(fn){
+ //console.log('Threadless platform, spawn shares main thread.');
+ return fn();
+ };
+}
+
+/**
+ * sleep thread for specified duration
+ * @param {Object} millseconds
+ */
+Envjs.sleep = function(millseconds){
+ try{
+ java.lang.Thread.currentThread().sleep(millseconds);
+ }catch(e){
+ console.log('Threadless platform, cannot sleep.');
+ }
+};
+
+/**
+ * provides callback hook for when the system exits
+ */
+Envjs.onExit = function(callback){
+ var rhino = Packages.org.mozilla.javascript,
+ contextFactory = __context__.getFactory(),
+ listener = new rhino.ContextFactory.Listener({
+ contextReleased: function(context){
+ if(context === __context__)
+ console.log('context released', context);
+ contextFactory.removeListener(this);
+ if(callback)
+ callback();
+ }
+ });
+ contextFactory.addListener(listener);
+};
+
+/**
+ * Get 'Current Working Directory'
+ */
+Envjs.getcwd = function() {
+ return java.lang.System.getProperty('user.dir');
+}
+
+/**
+ *
+ * @param {Object} fn
+ * @param {Object} onInterupt
+ */
+Envjs.runAsync = function(fn, onInterupt){
+ ////Envjs.debug("running async");
+ var running = true,
+ run;
+
+ try{
+ run = Envjs.sync(function(){
+ fn();
+ Envjs.wait();
+ });
+ Envjs.spawn(run);
+ }catch(e){
+ console.log("error while running async operation", e);
+ try{if(onInterrupt)onInterrupt(e)}catch(ee){};
+ }
+};
+
+/**
+ * Used to write to a local file
+ * @param {Object} text
+ * @param {Object} url
+ */
+Envjs.writeToFile = function(text, url){
+ //Envjs.debug("writing text to url : " + url);
+ var out = new java.io.FileWriter(
+ new java.io.File(
+ new java.net.URI(url.toString())));
+ out.write( text, 0, text.length );
+ out.flush();
+ out.close();
+};
+
+/**
+ * Used to write to a local file
+ * @param {Object} text
+ * @param {Object} suffix
+ */
+Envjs.writeToTempFile = function(text, suffix){
+ //Envjs.debug("writing text to temp url : " + suffix);
+ // Create temp file.
+ var temp = java.io.File.createTempFile("envjs-tmp", suffix);
+
+ // Delete temp file when program exits.
+ temp.deleteOnExit();
+
+ // Write to temp file
+ var out = new java.io.FileWriter(temp);
+ out.write(text, 0, text.length);
+ out.close();
+ return temp.getAbsolutePath().toString()+'';
+};
+
+
+/**
+ * Used to read the contents of a local file
+ * @param {Object} url
+ */
+Envjs.readFromFile = function( url ){
+ var fileReader = new java.io.FileReader(
+ new java.io.File(
+ new java.net.URI( url )));
+
+ var stringwriter = new java.io.StringWriter(),
+ buffer = java.lang.reflect.Array.newInstance(java.lang.Character.TYPE, 1024),
+ length;
+
+ while ((length = fileReader.read(buffer, 0, 1024)) != -1) {
+ stringwriter.write(buffer, 0, length);
+ }
+
+ stringwriter.close();
+ return stringwriter.toString()+"";
+};
+
+
+/**
+ * Used to delete a local file
+ * @param {Object} url
+ */
+Envjs.deleteFile = function(url){
+ var file = new java.io.File( new java.net.URI( url ) );
+ file["delete"]();
+};
+
+/**
+ * establishes connection and calls responsehandler
+ * @param {Object} xhr
+ * @param {Object} responseHandler
+ * @param {Object} data
+ */
+Envjs.connection = function(xhr, responseHandler, data){
+ var url = java.net.URL(xhr.url),
+ connection,
+ header,
+ outstream,
+ buffer,
+ length,
+ binary = false,
+ name, value,
+ contentEncoding,
+ instream,
+ responseXML,
+ i;
+ if ( /^file\:/.test(url) ) {
+ try{
+ if ( "PUT" == xhr.method || "POST" == xhr.method ) {
+ data = data || "" ;
+ Envjs.writeToFile(data, url);
+ xhr.readyState = 4;
+ //could be improved, I just cant recall the correct http codes
+ xhr.status = 200;
+ xhr.statusText = "";
+ } else if ( xhr.method == "DELETE" ) {
+ Envjs.deleteFile(url);
+ xhr.readyState = 4;
+ //could be improved, I just cant recall the correct http codes
+ xhr.status = 200;
+ xhr.statusText = "";
+ } else {
+ connection = url.openConnection();
+ connection.connect();
+ //try to add some canned headers that make sense
+
+ try{
+ if(xhr.url.match(/html$/)){
+ xhr.responseHeaders["Content-Type"] = 'text/html';
+ }else if(xhr.url.match(/.xml$/)){
+ xhr.responseHeaders["Content-Type"] = 'text/xml';
+ }else if(xhr.url.match(/.js$/)){
+ xhr.responseHeaders["Content-Type"] = 'text/javascript';
+ }else if(xhr.url.match(/.json$/)){
+ xhr.responseHeaders["Content-Type"] = 'application/json';
+ }else{
+ xhr.responseHeaders["Content-Type"] = 'text/plain';
+ }
+ //xhr.responseHeaders['Last-Modified'] = connection.getLastModified();
+ //xhr.responseHeaders['Content-Length'] = headerValue+'';
+ //xhr.responseHeaders['Date'] = new Date()+'';*/
+ }catch(e){
+ console.log('failed to load response headers',e);
+ }
+ }
+ }catch(e){
+ console.log('failed to open file %s %s', url, e);
+ connection = null;
+ xhr.readyState = 4;
+ xhr.statusText = "Local File Protocol Error";
+ xhr.responseText = "
"+ e+ "
";
+ }
+ } else {
+ connection = url.openConnection();
+ connection.setRequestMethod( xhr.method );
+
+ // Add headers to Java connection
+ for (header in xhr.headers){
+ connection.addRequestProperty(header+'', xhr.headers[header]+'');
+ }
+
+ //write data to output stream if required
+ if(data){
+ if(data instanceof Document){
+ if ( xhr.method == "PUT" || xhr.method == "POST" ) {
+ connection.setDoOutput(true);
+ outstream = connection.getOutputStream(),
+ xml = (new XMLSerializer()).serializeToString(data);
+ buffer = new java.lang.String(xml).getBytes('UTF-8');
+ outstream.write(buffer, 0, buffer.length);
+ outstream.close();
+ }
+ }else if(data.length&&data.length>0){
+ if ( xhr.method == "PUT" || xhr.method == "POST" ) {
+ connection.setDoOutput(true);
+ outstream = connection.getOutputStream();
+ buffer = new java.lang.String(data).getBytes('UTF-8');
+ outstream.write(buffer, 0, buffer.length);
+ outstream.close();
+ }
+ }
+ connection.connect();
+ }else{
+ connection.connect();
+ }
+ }
+
+ if(connection){
+ try{
+ length = connection.getHeaderFields().size();
+ // Stick the response headers into responseHeaders
+ for (i = 0; i < length; i++) {
+ name = connection.getHeaderFieldKey(i);
+ value = connection.getHeaderField(i);
+ if (name)
+ xhr.responseHeaders[name+''] = value+'';
+ }
+ }catch(e){
+ console.log('failed to load response headers \n%s',e);
+ }
+
+ xhr.readyState = 4;
+ xhr.status = parseInt(connection.responseCode,10) || undefined;
+ xhr.statusText = connection.responseMessage || "";
+
+ contentEncoding = connection.getContentEncoding() || "utf-8";
+ instream = null;
+ responseXML = null;
+
+ try{
+ //console.log('contentEncoding %s', contentEncoding);
+ if( contentEncoding.equalsIgnoreCase("gzip") ||
+ contentEncoding.equalsIgnoreCase("decompress")){
+ //zipped content
+ binary = true;
+ outstream = new java.io.ByteArrayOutputStream();
+ buffer = java.lang.reflect.Array.newInstance(java.lang.Byte.TYPE, 1024);
+ instream = new java.util.zip.GZIPInputStream(connection.getInputStream())
+ }else{
+ //this is a text file
+ outstream = new java.io.StringWriter();
+ buffer = java.lang.reflect.Array.newInstance(java.lang.Character.TYPE, 1024);
+ instream = new java.io.InputStreamReader(connection.getInputStream());
+ }
+ }catch(e){
+ if (connection.getResponseCode() == 404){
+ console.log('failed to open connection stream \n %s %s',
+ e.toString(), e);
+ }else{
+ console.log('failed to open connection stream \n %s %s',
+ e.toString(), e);
+ }
+ instream = connection.getErrorStream();
+ }
+
+ while ((length = instream.read(buffer, 0, 1024)) != -1) {
+ outstream.write(buffer, 0, length);
+ }
+
+ outstream.close();
+ instream.close();
+
+ if(binary){
+ xhr.responseText = new String(outstream.toByteArray(), 'UTF-8') + '';
+ }else{
+ xhr.responseText = outstream.toString() + '';
+ }
+
+ }
+ if(responseHandler){
+ //Envjs.debug('calling ajax response handler');
+ responseHandler();
+ }
+};
+
+//Since we're running in rhino I guess we can safely assume
+//java is 'enabled'. I'm sure this requires more thought
+//than I've given it here
+Envjs.javaEnabled = true;
+
+Envjs.homedir = java.lang.System.getProperty("user.home");
+Envjs.tmpdir = java.lang.System.getProperty("java.io.tmpdir");
+Envjs.os_name = java.lang.System.getProperty("os.name");
+Envjs.os_arch = java.lang.System.getProperty("os.arch");
+Envjs.os_version = java.lang.System.getProperty("os.version");
+Envjs.lang = java.lang.System.getProperty("user.lang");
+
+
+/**
+ *
+ * @param {Object} frameElement
+ * @param {Object} url
+ */
+Envjs.loadFrame = function(frame, url){
+ try {
+ if(frame.contentWindow){
+ //mark for garbage collection
+ frame.contentWindow = null;
+ }
+
+ //create a new scope for the window proxy
+ frame.contentWindow = Envjs.proxy();
+ new Window(frame.contentWindow, window);
+
+ //I dont think frames load asynchronously in firefox
+ //and I think the tests have verified this but for
+ //some reason I'm less than confident... Are there cases?
+ frame.contentDocument = frame.contentWindow.document;
+ frame.contentDocument.async = false;
+ if(url){
+ //console.log('envjs.loadFrame async %s', frame.contentDocument.async);
+ frame.contentWindow.location = url;
+ }
+ } catch(e) {
+ console.log("failed to load frame content: from %s %s", url, e);
+ }
+};
+
+/**
+ * unloadFrame
+ * @param {Object} frame
+ */
+Envjs.unloadFrame = function(frame){
+ var all, length, i;
+ try{
+ //TODO: probably self-referencing structures within a document tree
+ //preventing it from being entirely garbage collected once orphaned.
+ //Should have code to walk tree and break all links between contained
+ //objects.
+ frame.contentDocument = null;
+ if(frame.contentWindow){
+ frame.contentWindow.close();
+ }
+ gc();
+ }catch(e){
+ console.log(e);
+ }
+};
+
+/**
+ * Makes an object window-like by proxying object accessors
+ * @param {Object} scope
+ * @param {Object} parent
+ */
+Envjs.proxy = function(scope, parent) {
+ try{
+ if(scope+'' == '[object global]'){
+ return scope
+ }else{
+ return __context__.initStandardObjects();
+ }
+ }catch(e){
+ console.log('failed to init standard objects %s %s \n%s', scope, parent, e);
+ }
+
+};
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+
+/**
+ * @author envjs team
+ */
+var Console,
+ console;
+
+/*
+ * Envjs console.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author envjs team
+ * borrowed 99%-ish with love from firebug-lite
+ *
+ * http://wiki.commonjs.org/wiki/Console
+ */
+Console = function(module){
+ var $level,
+ $logger,
+ $null = function(){};
+
+
+ if(Envjs[module] && Envjs[module].loglevel){
+ $level = Envjs.module.loglevel;
+ $logger = {
+ log: function(level){
+ logFormatted(arguments, (module)+" ");
+ },
+ debug: $level>1 ? $null: function() {
+ logFormatted(arguments, (module)+" debug");
+ },
+ info: $level>2 ? $null:function(){
+ logFormatted(arguments, (module)+" info");
+ },
+ warn: $level>3 ? $null:function(){
+ logFormatted(arguments, (module)+" warning");
+ },
+ error: $level>4 ? $null:function(){
+ logFormatted(arguments, (module)+" error");
+ }
+ };
+ } else {
+ $logger = {
+ log: function(level){
+ logFormatted(arguments, "");
+ },
+ debug: $null,
+ info: $null,
+ warn: $null,
+ error: $null
+ };
+ }
+
+ return $logger;
+};
+
+console = new Console("console",1);
+
+function logFormatted(objects, className)
+{
+ var html = [];
+
+ var format = objects[0];
+ var objIndex = 0;
+
+ if (typeof(format) != "string")
+ {
+ format = "";
+ objIndex = -1;
+ }
+
+ var parts = parseFormat(format);
+ for (var i = 0; i < parts.length; ++i)
+ {
+ var part = parts[i];
+ if (part && typeof(part) == "object")
+ {
+ var object = objects[++objIndex];
+ part.appender(object, html);
+ }
+ else {
+ appendText(part, html);
+ }
+ }
+
+ for (var i = objIndex+1; i < objects.length; ++i)
+ {
+ appendText(" ", html);
+
+ var object = objects[i];
+ if (typeof(object) == "string") {
+ appendText(object, html);
+ } else {
+ appendObject(object, html);
+ }
+ }
+
+ Envjs.log(html.join(' '));
+}
+
+function parseFormat(format)
+{
+ var parts = [];
+
+ var reg = /((^%|[^\\]%)(\d+)?(\.)([a-zA-Z]))|((^%|[^\\]%)([a-zA-Z]))/;
+ var appenderMap = {s: appendText, d: appendInteger, i: appendInteger, f: appendFloat};
+
+ for (var m = reg.exec(format); m; m = reg.exec(format))
+ {
+ var type = m[8] ? m[8] : m[5];
+ var appender = type in appenderMap ? appenderMap[type] : appendObject;
+ var precision = m[3] ? parseInt(m[3]) : (m[4] == "." ? -1 : 0);
+
+ parts.push(format.substr(0, m[0][0] == "%" ? m.index : m.index+1));
+ parts.push({appender: appender, precision: precision});
+
+ format = format.substr(m.index+m[0].length);
+ }
+
+ parts.push(format);
+
+ return parts;
+}
+
+function escapeHTML(value)
+{
+ return value;
+}
+
+function objectToString(object)
+{
+ try
+ {
+ return object+"";
+ }
+ catch (exc)
+ {
+ return null;
+ }
+}
+
+// ********************************************************************************************
+
+function appendText(object, html)
+{
+ html.push(escapeHTML(objectToString(object)));
+}
+
+function appendNull(object, html)
+{
+ html.push(escapeHTML(objectToString(object)));
+}
+
+function appendString(object, html)
+{
+ html.push(escapeHTML(objectToString(object)));
+}
+
+function appendInteger(object, html)
+{
+ html.push(escapeHTML(objectToString(object)));
+}
+
+function appendFloat(object, html)
+{
+ html.push(escapeHTML(objectToString(object)));
+}
+
+function appendFunction(object, html)
+{
+ var reName = /function ?(.*?)\(/;
+ var m = reName.exec(objectToString(object));
+ var name = m ? m[1] : "function";
+ html.push(escapeHTML(name));
+}
+
+function appendObject(object, html)
+{
+ try
+ {
+ if (object == undefined) {
+ appendNull("undefined", html);
+ } else if (object == null) {
+ appendNull("null", html);
+ } else if (typeof object == "string") {
+ appendString(object, html);
+ } else if (typeof object == "number") {
+ appendInteger(object, html);
+ } else if (typeof object == "function") {
+ appendFunction(object, html);
+ } else if (object.nodeType == 1) {
+ appendSelector(object, html);
+ } else if (typeof object == "object") {
+ appendObjectFormatted(object, html);
+ } else {
+ appendText(object, html);
+ }
+ }
+ catch (exc)
+ {
+ }
+}
+
+function appendObjectFormatted(object, html)
+{
+ var text = objectToString(object);
+ var reObject = /\[object (.*?)\]/;
+
+ var m = reObject.exec(text);
+ html.push( m ? m[1] : text);
+}
+
+function appendSelector(object, html)
+{
+
+ html.push(escapeHTML(object.nodeName.toLowerCase()));
+ if (object.id) {
+ html.push(escapeHTML(object.id));
+ }
+ if (object.className) {
+ html.push(escapeHTML(object.className));
+ }
+}
+
+function appendNode(node, html)
+{
+ if (node.nodeType == 1)
+ {
+ html.push( node.nodeName.toLowerCase());
+
+ for (var i = 0; i < node.attributes.length; ++i)
+ {
+ var attr = node.attributes[i];
+ if (!attr.specified) {
+ continue;
+ }
+
+ html.push( attr.nodeName.toLowerCase(),escapeHTML(attr.nodeValue));
+ }
+
+ if (node.firstChild)
+ {
+ for (var child = node.firstChild; child; child = child.nextSibling) {
+ appendNode(child, html);
+ }
+
+ html.push( node.nodeName.toLowerCase());
+ }
+ }
+ else if (node.nodeType === 3)
+ {
+ html.push(escapeHTML(node.nodeValue));
+ }
+};
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+/*
+ * Envjs dom.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ *
+ * Parts of the implementation were originally written by:\
+ * and Jon van Noort (jon@webarcana.com.au) \
+ * and David Joham (djoham@yahoo.com)",\
+ * and Scott Severtson
+ *
+ * This file simply provides the global definitions we need to \
+ * be able to correctly implement to core browser DOM interfaces."
+ */
+
+var Attr,
+ CDATASection,
+ CharacterData,
+ Comment,
+ Document,
+ DocumentFragment,
+ DocumentType,
+ DOMException,
+ DOMImplementation,
+ Element,
+ Entity,
+ EntityReference,
+ NamedNodeMap,
+ Namespace,
+ Node,
+ NodeList,
+ Notation,
+ ProcessingInstruction,
+ Text,
+ Range,
+ XMLSerializer,
+ DOMParser;
+
+
+
+/*
+ * Envjs dom.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author john resig
+ */
+// Helper method for extending one object with another.
+function __extend__(a,b) {
+ for ( var i in b ) {
+ var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
+ if ( g || s ) {
+ if ( g ) { a.__defineGetter__(i, g); }
+ if ( s ) { a.__defineSetter__(i, s); }
+ } else {
+ a[i] = b[i];
+ }
+ } return a;
+}
+
+/**
+ * @author john resig
+ */
+//from jQuery
+function __setArray__( target, array ) {
+ // Resetting the length to 0, then using the native Array push
+ // is a super-fast way to populate an object with array-like properties
+ target.length = 0;
+ Array.prototype.push.apply( target, array );
+}
+
+/**
+ * @class NodeList -
+ * provides the abstraction of an ordered collection of nodes
+ *
+ * @param ownerDocument : Document - the ownerDocument
+ * @param parentNode : Node - the node that the NodeList is attached to (or null)
+ */
+NodeList = function(ownerDocument, parentNode) {
+ this.length = 0;
+ this.parentNode = parentNode;
+ this.ownerDocument = ownerDocument;
+ this._readonly = false;
+ __setArray__(this, []);
+};
+
+__extend__(NodeList.prototype, {
+ item : function(index) {
+ var ret = null;
+ if ((index >= 0) && (index < this.length)) {
+ // bounds check
+ ret = this[index];
+ }
+ // if the index is out of bounds, default value null is returned
+ return ret;
+ },
+ get xml() {
+ var ret = "",
+ i;
+
+ // create string containing the concatenation of the string values of each child
+ for (i=0; i < this.length; i++) {
+ if(this[i]){
+ if(this[i].nodeType == Node.TEXT_NODE && i>0 &&
+ this[i-1].nodeType == Node.TEXT_NODE){
+ //add a single space between adjacent text nodes
+ ret += " "+this[i].xml;
+ }else{
+ ret += this[i].xml;
+ }
+ }
+ }
+ return ret;
+ },
+ toArray: function () {
+ var children = [],
+ i;
+ for ( i=0; i < this.length; i++) {
+ children.push (this[i]);
+ }
+ return children;
+ },
+ toString: function(){
+ return "[object NodeList]";
+ }
+});
+
+
+/**
+ * @method __findItemIndex__
+ * find the item index of the node
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param node : Node
+ * @return : int
+ */
+var __findItemIndex__ = function (nodelist, node) {
+ var ret = -1, i;
+ for (i=0; i= 0) && (refChildIndex <= nodelist.length)) {
+ // bounds check
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // node is a DocumentFragment
+ // append the children of DocumentFragment
+ Array.prototype.splice.apply(nodelist,
+ [refChildIndex, 0].concat(newChild.childNodes.toArray()));
+ }
+ else {
+ // append the newChild
+ Array.prototype.splice.apply(nodelist,[refChildIndex, 0, newChild]);
+ }
+ }
+};
+
+/**
+ * @method __replaceChild__
+ * replace the specified Node in the NodeList at the specified index
+ * Used by Node.replaceChild(). Note: Node.replaceChild() is responsible
+ * for Node Pointer surgery __replaceChild__ simply modifies the internal
+ * data structure (Array).
+ *
+ * @param newChild : Node - the Node to be inserted
+ * @param refChildIndex : int - the array index to hold the Node
+ */
+var __replaceChild__ = function(nodelist, newChild, refChildIndex) {
+ var ret = null;
+
+ // bounds check
+ if ((refChildIndex >= 0) && (refChildIndex < nodelist.length)) {
+ // preserve old child for return
+ ret = nodelist[refChildIndex];
+
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // node is a DocumentFragment
+ // get array containing children prior to refChild
+ Array.prototype.splice.apply(nodelist,
+ [refChildIndex, 1].concat(newChild.childNodes.toArray()));
+ }
+ else {
+ // simply replace node in array (links between Nodes are
+ // made at higher level)
+ nodelist[refChildIndex] = newChild;
+ }
+ }
+ // return replaced node
+ return ret;
+};
+
+/**
+ * @method __removeChild__
+ * remove the specified Node in the NodeList at the specified index
+ * Used by Node.removeChild(). Note: Node.removeChild() is responsible
+ * for Node Pointer surgery __removeChild__ simply modifies the internal
+ * data structure (Array).
+ * @param refChildIndex : int - the array index holding the Node to be removed
+ */
+var __removeChild__ = function(nodelist, refChildIndex) {
+ var ret = null;
+
+ if (refChildIndex > -1) {
+ // found it!
+ // return removed node
+ ret = nodelist[refChildIndex];
+
+ // rebuild array without removed child
+ Array.prototype.splice.apply(nodelist,[refChildIndex, 1]);
+ }
+ // return removed node
+ return ret;
+};
+
+/**
+ * @method __appendChild__
+ * append the specified Node to the NodeList. Used by Node.appendChild().
+ * Note: Node.appendChild() is responsible for Node Pointer surgery
+ * __appendChild__ simply modifies the internal data structure (Array).
+ * @param newChild : Node - the Node to be inserted
+ */
+var __appendChild__ = function(nodelist, newChild) {
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // node is a DocumentFragment
+ // append the children of DocumentFragment
+ Array.prototype.push.apply(nodelist, newChild.childNodes.toArray() );
+ } else {
+ // simply add node to array (links between Nodes are made at higher level)
+ Array.prototype.push.apply(nodelist, [newChild]);
+ }
+
+};
+
+/**
+ * @method __cloneNodes__ -
+ * Returns a NodeList containing clones of the Nodes in this NodeList
+ * @param deep : boolean -
+ * If true, recursively clone the subtree under each of the nodes;
+ * if false, clone only the nodes themselves (and their attributes,
+ * if it is an Element).
+ * @param parentNode : Node - the new parent of the cloned NodeList
+ * @return : NodeList - NodeList containing clones of the Nodes in this NodeList
+ */
+var __cloneNodes__ = function(nodelist, deep, parentNode) {
+ var cloneNodeList = new NodeList(nodelist.ownerDocument, parentNode);
+
+ // create list containing clones of each child
+ for (var i=0; i < nodelist.length; i++) {
+ __appendChild__(cloneNodeList, nodelist[i].cloneNode(deep));
+ }
+
+ return cloneNodeList;
+};
+
+
+var __ownerDocument__ = function(node){
+ return (node.nodeType == Node.DOCUMENT_NODE)?node:node.ownerDocument;
+};
+
+/**
+ * @class Node -
+ * The Node interface is the primary datatype for the entire
+ * Document Object Model. It represents a single node in the
+ * document tree.
+ * @param ownerDocument : Document - The Document object associated with this node.
+ */
+
+Node = function(ownerDocument) {
+ this.baseURI = 'about:blank';
+ this.namespaceURI = null;
+ this.nodeName = "";
+ this.nodeValue = null;
+
+ // A NodeList that contains all children of this node. If there are no
+ // children, this is a NodeList containing no nodes. The content of the
+ // returned NodeList is "live" in the sense that, for instance, changes to
+ // the children of the node object that it was created from are immediately
+ // reflected in the nodes returned by the NodeList accessors; it is not a
+ // static snapshot of the content of the node. This is true for every
+ // NodeList, including the ones returned by the getElementsByTagName method.
+ this.childNodes = new NodeList(ownerDocument, this);
+
+ // The first child of this node. If there is no such node, this is null
+ this.firstChild = null;
+ // The last child of this node. If there is no such node, this is null.
+ this.lastChild = null;
+ // The node immediately preceding this node. If there is no such node,
+ // this is null.
+ this.previousSibling = null;
+ // The node immediately following this node. If there is no such node,
+ // this is null.
+ this.nextSibling = null;
+
+ this.attributes = null;
+ // The namespaces in scope for this node
+ this._namespaces = new NamespaceNodeMap(ownerDocument, this);
+ this._readonly = false;
+
+ //IMPORTANT: These must come last so rhino will not iterate parent
+ // properties before child properties. (qunit.equiv issue)
+
+ // The parent of this node. All nodes, except Document, DocumentFragment,
+ // and Attr may have a parent. However, if a node has just been created
+ // and not yet added to the tree, or if it has been removed from the tree,
+ // this is null
+ this.parentNode = null;
+ // The Document object associated with this node
+ this.ownerDocument = ownerDocument;
+
+};
+
+// nodeType constants
+Node.ELEMENT_NODE = 1;
+Node.ATTRIBUTE_NODE = 2;
+Node.TEXT_NODE = 3;
+Node.CDATA_SECTION_NODE = 4;
+Node.ENTITY_REFERENCE_NODE = 5;
+Node.ENTITY_NODE = 6;
+Node.PROCESSING_INSTRUCTION_NODE = 7;
+Node.COMMENT_NODE = 8;
+Node.DOCUMENT_NODE = 9;
+Node.DOCUMENT_TYPE_NODE = 10;
+Node.DOCUMENT_FRAGMENT_NODE = 11;
+Node.NOTATION_NODE = 12;
+Node.NAMESPACE_NODE = 13;
+
+Node.DOCUMENT_POSITION_EQUAL = 0x00;
+Node.DOCUMENT_POSITION_DISCONNECTED = 0x01;
+Node.DOCUMENT_POSITION_PRECEDING = 0x02;
+Node.DOCUMENT_POSITION_FOLLOWING = 0x04;
+Node.DOCUMENT_POSITION_CONTAINS = 0x08;
+Node.DOCUMENT_POSITION_CONTAINED_BY = 0x10;
+Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
+
+
+__extend__(Node.prototype, {
+ get localName(){
+ return this.prefix?
+ this.nodeName.substring(this.prefix.length+1, this.nodeName.length):
+ this.nodeName;
+ },
+ get prefix(){
+ return this.nodeName.split(':').length>1?
+ this.nodeName.split(':')[0]:
+ null;
+ },
+ set prefix(value){
+ if(value === null){
+ this.nodeName = this.localName;
+ }else{
+ this.nodeName = value+':'+this.localName;
+ }
+ },
+ hasAttributes : function() {
+ if (this.attributes.length == 0) {
+ return false;
+ }else{
+ return true;
+ }
+ },
+ get textContent(){
+ return __recursivelyGatherText__(this);
+ },
+ set textContent(newText){
+ while(this.firstChild != null){
+ this.removeChild( this.firstChild );
+ }
+ var text = this.ownerDocument.createTextNode(newText);
+ this.appendChild(text);
+ },
+ insertBefore : function(newChild, refChild) {
+ var prevNode;
+
+ if(newChild==null){
+ return newChild;
+ }
+ if(refChild==null){
+ this.appendChild(newChild);
+ return this.newChild;
+ }
+
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Node is readonly
+ if (this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if newChild was not created by this Document
+ if (__ownerDocument__(this) != __ownerDocument__(newChild)) {
+ throw(new DOMException(DOMException.WRONG_DOCUMENT_ERR));
+ }
+
+ // throw Exception if the node is an ancestor
+ if (__isAncestor__(this, newChild)) {
+ throw(new DOMException(DOMException.HIERARCHY_REQUEST_ERR));
+ }
+ }
+
+ // if refChild is specified, insert before it
+ if (refChild) {
+ // find index of refChild
+ var itemIndex = __findItemIndex__(this.childNodes, refChild);
+ // throw Exception if there is no child node with this id
+ if (__ownerDocument__(this).implementation.errorChecking && (itemIndex < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ // if the newChild is already in the tree,
+ var newChildParent = newChild.parentNode;
+ if (newChildParent) {
+ // remove it
+ newChildParent.removeChild(newChild);
+ }
+
+ // insert newChild into childNodes
+ __insertBefore__(this.childNodes, newChild, itemIndex);
+
+ // do node pointer surgery
+ prevNode = refChild.previousSibling;
+
+ // handle DocumentFragment
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ if (newChild.childNodes.length > 0) {
+ // set the parentNode of DocumentFragment's children
+ for (var ind = 0; ind < newChild.childNodes.length; ind++) {
+ newChild.childNodes[ind].parentNode = this;
+ }
+
+ // link refChild to last child of DocumentFragment
+ refChild.previousSibling = newChild.childNodes[newChild.childNodes.length-1];
+ }
+ }else {
+ // set the parentNode of the newChild
+ newChild.parentNode = this;
+ // link refChild to newChild
+ refChild.previousSibling = newChild;
+ }
+
+ }else {
+ // otherwise, append to end
+ prevNode = this.lastChild;
+ this.appendChild(newChild);
+ }
+
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // do node pointer surgery for DocumentFragment
+ if (newChild.childNodes.length > 0) {
+ if (prevNode) {
+ prevNode.nextSibling = newChild.childNodes[0];
+ }else {
+ // this is the first child in the list
+ this.firstChild = newChild.childNodes[0];
+ }
+ newChild.childNodes[0].previousSibling = prevNode;
+ newChild.childNodes[newChild.childNodes.length-1].nextSibling = refChild;
+ }
+ }else {
+ // do node pointer surgery for newChild
+ if (prevNode) {
+ prevNode.nextSibling = newChild;
+ }else {
+ // this is the first child in the list
+ this.firstChild = newChild;
+ }
+ newChild.previousSibling = prevNode;
+ newChild.nextSibling = refChild;
+ }
+
+ return newChild;
+ },
+ replaceChild : function(newChild, oldChild) {
+ var ret = null;
+
+ if(newChild==null || oldChild==null){
+ return oldChild;
+ }
+
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Node is readonly
+ if (this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if newChild was not created by this Document
+ if (__ownerDocument__(this) != __ownerDocument__(newChild)) {
+ throw(new DOMException(DOMException.WRONG_DOCUMENT_ERR));
+ }
+
+ // throw Exception if the node is an ancestor
+ if (__isAncestor__(this, newChild)) {
+ throw(new DOMException(DOMException.HIERARCHY_REQUEST_ERR));
+ }
+ }
+
+ // get index of oldChild
+ var index = __findItemIndex__(this.childNodes, oldChild);
+
+ // throw Exception if there is no child node with this id
+ if (__ownerDocument__(this).implementation.errorChecking && (index < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ // if the newChild is already in the tree,
+ var newChildParent = newChild.parentNode;
+ if (newChildParent) {
+ // remove it
+ newChildParent.removeChild(newChild);
+ }
+
+ // add newChild to childNodes
+ ret = __replaceChild__(this.childNodes,newChild, index);
+
+
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // do node pointer surgery for Document Fragment
+ if (newChild.childNodes.length > 0) {
+ for (var ind = 0; ind < newChild.childNodes.length; ind++) {
+ newChild.childNodes[ind].parentNode = this;
+ }
+
+ if (oldChild.previousSibling) {
+ oldChild.previousSibling.nextSibling = newChild.childNodes[0];
+ } else {
+ this.firstChild = newChild.childNodes[0];
+ }
+
+ if (oldChild.nextSibling) {
+ oldChild.nextSibling.previousSibling = newChild;
+ } else {
+ this.lastChild = newChild.childNodes[newChild.childNodes.length-1];
+ }
+
+ newChild.childNodes[0].previousSibling = oldChild.previousSibling;
+ newChild.childNodes[newChild.childNodes.length-1].nextSibling = oldChild.nextSibling;
+ }
+ } else {
+ // do node pointer surgery for newChild
+ newChild.parentNode = this;
+
+ if (oldChild.previousSibling) {
+ oldChild.previousSibling.nextSibling = newChild;
+ }else{
+ this.firstChild = newChild;
+ }
+ if (oldChild.nextSibling) {
+ oldChild.nextSibling.previousSibling = newChild;
+ }else{
+ this.lastChild = newChild;
+ }
+ newChild.previousSibling = oldChild.previousSibling;
+ newChild.nextSibling = oldChild.nextSibling;
+ }
+
+ return ret;
+ },
+ removeChild : function(oldChild) {
+ if(!oldChild){
+ return null;
+ }
+ // throw Exception if NamedNodeMap is readonly
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ (this._readonly || oldChild._readonly)) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // get index of oldChild
+ var itemIndex = __findItemIndex__(this.childNodes, oldChild);
+
+ // throw Exception if there is no child node with this id
+ if (__ownerDocument__(this).implementation.errorChecking && (itemIndex < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ // remove oldChild from childNodes
+ __removeChild__(this.childNodes, itemIndex);
+
+ // do node pointer surgery
+ oldChild.parentNode = null;
+
+ if (oldChild.previousSibling) {
+ oldChild.previousSibling.nextSibling = oldChild.nextSibling;
+ }else {
+ this.firstChild = oldChild.nextSibling;
+ }
+ if (oldChild.nextSibling) {
+ oldChild.nextSibling.previousSibling = oldChild.previousSibling;
+ }else {
+ this.lastChild = oldChild.previousSibling;
+ }
+
+ oldChild.previousSibling = null;
+ oldChild.nextSibling = null;
+
+ return oldChild;
+ },
+ appendChild : function(newChild) {
+ if(!newChild){
+ return null;
+ }
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Node is readonly
+ if (this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if arg was not created by this Document
+ if (__ownerDocument__(this) != __ownerDocument__(this)) {
+ throw(new DOMException(DOMException.WRONG_DOCUMENT_ERR));
+ }
+
+ // throw Exception if the node is an ancestor
+ if (__isAncestor__(this, newChild)) {
+ throw(new DOMException(DOMException.HIERARCHY_REQUEST_ERR));
+ }
+ }
+
+ // if the newChild is already in the tree,
+ var newChildParent = newChild.parentNode;
+ if (newChildParent) {
+ // remove it
+ //console.debug('removing node %s', newChild);
+ newChildParent.removeChild(newChild);
+ }
+
+ // add newChild to childNodes
+ __appendChild__(this.childNodes, newChild);
+
+ if (newChild.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // do node pointer surgery for DocumentFragment
+ if (newChild.childNodes.length > 0) {
+ for (var ind = 0; ind < newChild.childNodes.length; ind++) {
+ newChild.childNodes[ind].parentNode = this;
+ }
+
+ if (this.lastChild) {
+ this.lastChild.nextSibling = newChild.childNodes[0];
+ newChild.childNodes[0].previousSibling = this.lastChild;
+ this.lastChild = newChild.childNodes[newChild.childNodes.length-1];
+ } else {
+ this.lastChild = newChild.childNodes[newChild.childNodes.length-1];
+ this.firstChild = newChild.childNodes[0];
+ }
+ }
+ } else {
+ // do node pointer surgery for newChild
+ newChild.parentNode = this;
+ if (this.lastChild) {
+ this.lastChild.nextSibling = newChild;
+ newChild.previousSibling = this.lastChild;
+ this.lastChild = newChild;
+ } else {
+ this.lastChild = newChild;
+ this.firstChild = newChild;
+ }
+ }
+ return newChild;
+ },
+ hasChildNodes : function() {
+ return (this.childNodes.length > 0);
+ },
+ cloneNode: function(deep) {
+ // use importNode to clone this Node
+ //do not throw any exceptions
+ try {
+ return __ownerDocument__(this).importNode(this, deep);
+ } catch (e) {
+ //there shouldn't be any exceptions, but if there are, return null
+ // may want to warn: $debug("could not clone node: "+e.code);
+ return null;
+ }
+ },
+ normalize : function() {
+ var i;
+ var inode;
+ var nodesToRemove = new NodeList();
+
+ if (this.nodeType == Node.ELEMENT_NODE || this.nodeType == Node.DOCUMENT_NODE) {
+ var adjacentTextNode = null;
+
+ // loop through all childNodes
+ for(i = 0; i < this.childNodes.length; i++) {
+ inode = this.childNodes.item(i);
+
+ if (inode.nodeType == Node.TEXT_NODE) {
+ // this node is a text node
+ if (inode.length < 1) {
+ // this text node is empty
+ // add this node to the list of nodes to be remove
+ __appendChild__(nodesToRemove, inode);
+ }else {
+ if (adjacentTextNode) {
+ // previous node was also text
+ adjacentTextNode.appendData(inode.data);
+ // merge the data in adjacent text nodes
+ // add this node to the list of nodes to be removed
+ __appendChild__(nodesToRemove, inode);
+ } else {
+ // remember this node for next cycle
+ adjacentTextNode = inode;
+ }
+ }
+ } else {
+ // (soon to be) previous node is not a text node
+ adjacentTextNode = null;
+ // normalize non Text childNodes
+ inode.normalize();
+ }
+ }
+
+ // remove redundant Text Nodes
+ for(i = 0; i < nodesToRemove.length; i++) {
+ inode = nodesToRemove.item(i);
+ inode.parentNode.removeChild(inode);
+ }
+ }
+ },
+ isSupported : function(feature, version) {
+ // use Implementation.hasFeature to determine if this feature is supported
+ return __ownerDocument__(this).implementation.hasFeature(feature, version);
+ },
+ getElementsByTagName : function(tagname) {
+ // delegate to _getElementsByTagNameRecursive
+ // recurse childNodes
+ var nodelist = new NodeList(__ownerDocument__(this));
+ for (var i = 0; i < this.childNodes.length; i++) {
+ __getElementsByTagNameRecursive__(this.childNodes.item(i),
+ tagname,
+ nodelist);
+ }
+ return nodelist;
+ },
+ getElementsByTagNameNS : function(namespaceURI, localName) {
+ // delegate to _getElementsByTagNameNSRecursive
+ return __getElementsByTagNameNSRecursive__(this, namespaceURI, localName,
+ new NodeList(__ownerDocument__(this)));
+ },
+ importNode : function(importedNode, deep) {
+ var i;
+ var importNode;
+
+ //there is no need to perform namespace checks since everything has already gone through them
+ //in order to have gotten into the DOM in the first place. The following line
+ //turns namespace checking off in ._isValidNamespace
+ __ownerDocument__(this).importing = true;
+
+ if (importedNode.nodeType == Node.ELEMENT_NODE) {
+ if (!__ownerDocument__(this).implementation.namespaceAware) {
+ // create a local Element (with the name of the importedNode)
+ importNode = __ownerDocument__(this).createElement(importedNode.tagName);
+
+ // create attributes matching those of the importedNode
+ for(i = 0; i < importedNode.attributes.length; i++) {
+ importNode.setAttribute(importedNode.attributes.item(i).name, importedNode.attributes.item(i).value);
+ }
+ } else {
+ // create a local Element (with the name & namespaceURI of the importedNode)
+ importNode = __ownerDocument__(this).createElementNS(importedNode.namespaceURI, importedNode.nodeName);
+
+ // create attributes matching those of the importedNode
+ for(i = 0; i < importedNode.attributes.length; i++) {
+ importNode.setAttributeNS(importedNode.attributes.item(i).namespaceURI,
+ importedNode.attributes.item(i).name, importedNode.attributes.item(i).value);
+ }
+
+ // create namespace definitions matching those of the importedNode
+ for(i = 0; i < importedNode._namespaces.length; i++) {
+ importNode._namespaces[i] = __ownerDocument__(this).createNamespace(importedNode._namespaces.item(i).localName);
+ importNode._namespaces[i].value = importedNode._namespaces.item(i).value;
+ }
+ }
+ } else if (importedNode.nodeType == Node.ATTRIBUTE_NODE) {
+ if (!__ownerDocument__(this).implementation.namespaceAware) {
+ // create a local Attribute (with the name of the importedAttribute)
+ importNode = __ownerDocument__(this).createAttribute(importedNode.name);
+ } else {
+ // create a local Attribute (with the name & namespaceURI of the importedAttribute)
+ importNode = __ownerDocument__(this).createAttributeNS(importedNode.namespaceURI, importedNode.nodeName);
+
+ // create namespace definitions matching those of the importedAttribute
+ for(i = 0; i < importedNode._namespaces.length; i++) {
+ importNode._namespaces[i] = __ownerDocument__(this).createNamespace(importedNode._namespaces.item(i).localName);
+ importNode._namespaces[i].value = importedNode._namespaces.item(i).value;
+ }
+ }
+
+ // set the value of the local Attribute to match that of the importedAttribute
+ importNode.value = importedNode.value;
+
+ } else if (importedNode.nodeType == Node.DOCUMENT_FRAGMENT_NODE) {
+ // create a local DocumentFragment
+ importNode = __ownerDocument__(this).createDocumentFragment();
+ } else if (importedNode.nodeType == Node.NAMESPACE_NODE) {
+ // create a local NamespaceNode (with the same name & value as the importedNode)
+ importNode = __ownerDocument__(this).createNamespace(importedNode.nodeName);
+ importNode.value = importedNode.value;
+ } else if (importedNode.nodeType == Node.TEXT_NODE) {
+ // create a local TextNode (with the same data as the importedNode)
+ importNode = __ownerDocument__(this).createTextNode(importedNode.data);
+ } else if (importedNode.nodeType == Node.CDATA_SECTION_NODE) {
+ // create a local CDATANode (with the same data as the importedNode)
+ importNode = __ownerDocument__(this).createCDATASection(importedNode.data);
+ } else if (importedNode.nodeType == Node.PROCESSING_INSTRUCTION_NODE) {
+ // create a local ProcessingInstruction (with the same target & data as the importedNode)
+ importNode = __ownerDocument__(this).createProcessingInstruction(importedNode.target, importedNode.data);
+ } else if (importedNode.nodeType == Node.COMMENT_NODE) {
+ // create a local Comment (with the same data as the importedNode)
+ importNode = __ownerDocument__(this).createComment(importedNode.data);
+ } else { // throw Exception if nodeType is not supported
+ throw(new DOMException(DOMException.NOT_SUPPORTED_ERR));
+ }
+
+ if (deep) {
+ // recurse childNodes
+ for(i = 0; i < importedNode.childNodes.length; i++) {
+ importNode.appendChild(__ownerDocument__(this).importNode(importedNode.childNodes.item(i), true));
+ }
+ }
+
+ //reset importing
+ __ownerDocument__(this).importing = false;
+ return importNode;
+
+ },
+ contains : function(node){
+ while(node && node != this ){
+ node = node.parentNode;
+ }
+ return !!node;
+ },
+ compareDocumentPosition : function(b){
+ //console.log("comparing document position %s %s", this, b);
+ var i,
+ length,
+ a = this,
+ parent,
+ aparents,
+ bparents;
+ //handle a couple simpler case first
+ if(a === b) {
+ return Node.DOCUMENT_POSITION_EQUAL;
+ }
+ if(a.ownerDocument !== b.ownerDocument) {
+ return Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC|
+ Node.DOCUMENT_POSITION_FOLLOWING|
+ Node.DOCUMENT_POSITION_DISCONNECTED;
+ }
+ if(a.parentNode === b.parentNode){
+ length = a.parentNode.childNodes.length;
+ for(i=0;i aparents.length){
+ return Node.DOCUMENT_POSITION_FOLLOWING;
+ }else if(bparents.length < aparents.length){
+ return Node.DOCUMENT_POSITION_PRECEDING;
+ }else{
+ //common ancestor diverge point
+ if (i === 0) {
+ return Node.DOCUMENT_POSITION_FOLLOWING;
+ } else {
+ parent = aparents[i-1];
+ }
+ return parent.compareDocumentPosition(bparents.pop());
+ }
+ }
+ }
+
+ return Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC|
+ Node.DOCUMENT_POSITION_DISCONNECTED;
+
+ },
+ toString : function() {
+ return '[object Node]';
+ }
+
+});
+
+
+
+/**
+ * @method __getElementsByTagNameRecursive__ - implements getElementsByTagName()
+ * @param elem : Element - The element which are checking and then recursing into
+ * @param tagname : string - The name of the tag to match on. The special value "*" matches all tags
+ * @param nodeList : NodeList - The accumulating list of matching nodes
+ *
+ * @return : NodeList
+ */
+var __getElementsByTagNameRecursive__ = function (elem, tagname, nodeList) {
+
+ if (elem.nodeType == Node.ELEMENT_NODE || elem.nodeType == Node.DOCUMENT_NODE) {
+
+ if(elem.nodeType !== Node.DOCUMENT_NODE &&
+ ((elem.nodeName.toUpperCase() == tagname.toUpperCase()) ||
+ (tagname == "*")) ){
+ // add matching node to nodeList
+ __appendChild__(nodeList, elem);
+ }
+
+ // recurse childNodes
+ for(var i = 0; i < elem.childNodes.length; i++) {
+ nodeList = __getElementsByTagNameRecursive__(elem.childNodes.item(i), tagname, nodeList);
+ }
+ }
+
+ return nodeList;
+};
+
+/**
+ * @method __getElementsByTagNameNSRecursive__
+ * implements getElementsByTagName()
+ *
+ * @param elem : Element - The element which are checking and then recursing into
+ * @param namespaceURI : string - the namespace URI of the required node
+ * @param localName : string - the local name of the required node
+ * @param nodeList : NodeList - The accumulating list of matching nodes
+ *
+ * @return : NodeList
+ */
+var __getElementsByTagNameNSRecursive__ = function(elem, namespaceURI, localName, nodeList) {
+ if (elem.nodeType == Node.ELEMENT_NODE || elem.nodeType == Node.DOCUMENT_NODE) {
+
+ if (((elem.namespaceURI == namespaceURI) || (namespaceURI == "*")) &&
+ ((elem.localName == localName) || (localName == "*"))) {
+ // add matching node to nodeList
+ __appendChild__(nodeList, elem);
+ }
+
+ // recurse childNodes
+ for(var i = 0; i < elem.childNodes.length; i++) {
+ nodeList = __getElementsByTagNameNSRecursive__(
+ elem.childNodes.item(i), namespaceURI, localName, nodeList);
+ }
+ }
+
+ return nodeList;
+};
+
+/**
+ * @method __isAncestor__ - returns true if node is ancestor of target
+ * @param target : Node - The node we are using as context
+ * @param node : Node - The candidate ancestor node
+ * @return : boolean
+ */
+var __isAncestor__ = function(target, node) {
+ // if this node matches, return true,
+ // otherwise recurse up (if there is a parentNode)
+ return ((target == node) || ((target.parentNode) && (__isAncestor__(target.parentNode, node))));
+};
+
+
+
+var __recursivelyGatherText__ = function(aNode) {
+ var accumulateText = "",
+ idx,
+ node;
+ for (idx=0;idx < aNode.childNodes.length;idx++){
+ node = aNode.childNodes.item(idx);
+ if(node.nodeType == Node.TEXT_NODE)
+ accumulateText += node.data;
+ else
+ accumulateText += __recursivelyGatherText__(node);
+ }
+ return accumulateText;
+};
+
+/**
+ * function __escapeXML__
+ * @param str : string - The string to be escaped
+ * @return : string - The escaped string
+ */
+var escAmpRegEx = /&(?!(amp;|lt;|gt;|quot|apos;))/g;
+var escLtRegEx = //g;
+var quotRegEx = /"/g;
+var aposRegEx = /'/g;
+
+function __escapeXML__(str) {
+ str = str.replace(escAmpRegEx, "&").
+ replace(escLtRegEx, "<").
+ replace(escGtRegEx, ">").
+ replace(quotRegEx, """).
+ replace(aposRegEx, "'");
+
+ return str;
+};
+
+/*
+function __escapeHTML5__(str) {
+ str = str.replace(escAmpRegEx, "&").
+ replace(escLtRegEx, "<").
+ replace(escGtRegEx, ">");
+
+ return str;
+};
+function __escapeHTML5Atribute__(str) {
+ str = str.replace(escAmpRegEx, "&").
+ replace(escLtRegEx, "<").
+ replace(escGtRegEx, ">").
+ replace(quotRegEx, """).
+ replace(aposRegEx, "'");
+
+ return str;
+};
+*/
+
+/**
+ * function __unescapeXML__
+ * @param str : string - The string to be unescaped
+ * @return : string - The unescaped string
+ */
+var unescAmpRegEx = /&/g;
+var unescLtRegEx = /</g;
+var unescGtRegEx = />/g;
+var unquotRegEx = /"/g;
+var unaposRegEx = /'/g;
+function __unescapeXML__(str) {
+ str = str.replace(unescAmpRegEx, "&").
+ replace(unescLtRegEx, "<").
+ replace(unescGtRegEx, ">").
+ replace(unquotRegEx, "\"").
+ replace(unaposRegEx, "'");
+
+ return str;
+};
+
+/**
+ * @class NamedNodeMap -
+ * used to represent collections of nodes that can be accessed by name
+ * typically a set of Element attributes
+ *
+ * @extends NodeList -
+ * note W3C spec says that this is not the case, but we need an item()
+ * method identical to NodeList's, so why not?
+ * @param ownerDocument : Document - the ownerDocument
+ * @param parentNode : Node - the node that the NamedNodeMap is attached to (or null)
+ */
+NamedNodeMap = function(ownerDocument, parentNode) {
+ NodeList.apply(this, arguments);
+ __setArray__(this, []);
+};
+NamedNodeMap.prototype = new NodeList();
+__extend__(NamedNodeMap.prototype, {
+ add: function(name){
+ this[this.length] = name;
+ },
+ getNamedItem : function(name) {
+ var ret = null;
+ //console.log('NamedNodeMap getNamedItem %s', name);
+ // test that Named Node exists
+ var itemIndex = __findNamedItemIndex__(this, name);
+
+ if (itemIndex > -1) {
+ // found it!
+ ret = this[itemIndex];
+ }
+ // if node is not found, default value null is returned
+ return ret;
+ },
+ setNamedItem : function(arg) {
+ //console.log('setNamedItem %s', arg);
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if arg was not created by this Document
+ if (this.ownerDocument != arg.ownerDocument) {
+ throw(new DOMException(DOMException.WRONG_DOCUMENT_ERR));
+ }
+
+ // throw Exception if DOMNamedNodeMap is readonly
+ if (this._readonly || (this.parentNode && this.parentNode._readonly)) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if arg is already an attribute of another Element object
+ if (arg.ownerElement && (arg.ownerElement != this.parentNode)) {
+ throw(new DOMException(DOMException.INUSE_ATTRIBUTE_ERR));
+ }
+ }
+
+ //console.log('setNamedItem __findNamedItemIndex__ ');
+ // get item index
+ var itemIndex = __findNamedItemIndex__(this, arg.name);
+ var ret = null;
+
+ //console.log('setNamedItem __findNamedItemIndex__ %s', itemIndex);
+ if (itemIndex > -1) { // found it!
+ ret = this[itemIndex]; // use existing Attribute
+
+ // throw Exception if DOMAttr is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && ret._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ } else {
+ this[itemIndex] = arg; // over-write existing NamedNode
+ this[arg.name.toLowerCase()] = arg;
+ }
+ } else {
+ // add new NamedNode
+ //console.log('setNamedItem add new named node map (by index)');
+ Array.prototype.push.apply(this, [arg]);
+ //console.log('setNamedItem add new named node map (by name) %s %s', arg, arg.name);
+ this[arg.name] = arg;
+ //console.log('finsished setNamedItem add new named node map (by name) %s', arg.name);
+
+ }
+
+ //console.log('setNamedItem parentNode');
+ arg.ownerElement = this.parentNode; // update ownerElement
+ // return old node or new node
+ //console.log('setNamedItem exit');
+ return ret;
+ },
+ removeNamedItem : function(name) {
+ var ret = null;
+ // test for exceptions
+ // throw Exception if NamedNodeMap is readonly
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ (this._readonly || (this.parentNode && this.parentNode._readonly))) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // get item index
+ var itemIndex = __findNamedItemIndex__(this, name);
+
+ // throw Exception if there is no node named name in this map
+ if (__ownerDocument__(this).implementation.errorChecking && (itemIndex < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ // get Node
+ var oldNode = this[itemIndex];
+ //this[oldNode.name] = undefined;
+
+ // throw Exception if Node is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && oldNode._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // return removed node
+ return __removeChild__(this, itemIndex);
+ },
+ getNamedItemNS : function(namespaceURI, localName) {
+ var ret = null;
+
+ // test that Named Node exists
+ var itemIndex = __findNamedItemNSIndex__(this, namespaceURI, localName);
+
+ if (itemIndex > -1) {
+ // found it! return NamedNode
+ ret = this[itemIndex];
+ }
+ // if node is not found, default value null is returned
+ return ret;
+ },
+ setNamedItemNS : function(arg) {
+ //console.log('setNamedItemNS %s', arg);
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if NamedNodeMap is readonly
+ if (this._readonly || (this.parentNode && this.parentNode._readonly)) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if arg was not created by this Document
+ if (__ownerDocument__(this) != __ownerDocument__(arg)) {
+ throw(new DOMException(DOMException.WRONG_DOCUMENT_ERR));
+ }
+
+ // throw Exception if arg is already an attribute of another Element object
+ if (arg.ownerElement && (arg.ownerElement != this.parentNode)) {
+ throw(new DOMException(DOMException.INUSE_ATTRIBUTE_ERR));
+ }
+ }
+
+ // get item index
+ var itemIndex = __findNamedItemNSIndex__(this, arg.namespaceURI, arg.localName);
+ var ret = null;
+
+ if (itemIndex > -1) {
+ // found it!
+ // use existing Attribute
+ ret = this[itemIndex];
+ // throw Exception if Attr is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && ret._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ } else {
+ // over-write existing NamedNode
+ this[itemIndex] = arg;
+ }
+ }else {
+ // add new NamedNode
+ Array.prototype.push.apply(this, [arg]);
+ }
+ arg.ownerElement = this.parentNode;
+
+ // return old node or null
+ return ret;
+ //console.log('finished setNamedItemNS %s', arg);
+ },
+ removeNamedItemNS : function(namespaceURI, localName) {
+ var ret = null;
+
+ // test for exceptions
+ // throw Exception if NamedNodeMap is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && (this._readonly || (this.parentNode && this.parentNode._readonly))) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // get item index
+ var itemIndex = __findNamedItemNSIndex__(this, namespaceURI, localName);
+
+ // throw Exception if there is no matching node in this map
+ if (__ownerDocument__(this).implementation.errorChecking && (itemIndex < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ // get Node
+ var oldNode = this[itemIndex];
+
+ // throw Exception if Node is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && oldNode._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ return __removeChild__(this, itemIndex); // return removed node
+ },
+ get xml() {
+ var ret = "";
+
+ // create string containing concatenation of all (but last) Attribute string values (separated by spaces)
+ for (var i=0; i < this.length -1; i++) {
+ ret += this[i].xml +" ";
+ }
+
+ // add last Attribute to string (without trailing space)
+ if (this.length > 0) {
+ ret += this[this.length -1].xml;
+ }
+
+ return ret;
+ },
+ toString : function(){
+ return "[object NamedNodeMap]";
+ }
+
+});
+
+/**
+ * @method __findNamedItemIndex__
+ * find the item index of the node with the specified name
+ *
+ * @param name : string - the name of the required node
+ * @param isnsmap : if its a NamespaceNodeMap
+ * @return : int
+ */
+var __findNamedItemIndex__ = function(namednodemap, name, isnsmap) {
+ var ret = -1;
+ // loop through all nodes
+ for (var i=0; i -1) {
+ // found it!
+ ret = true;
+ }
+ // if node is not found, default value false is returned
+ return ret;
+}
+
+/**
+ * @method __hasAttributeNS__
+ * Returns true if specified node exists
+ *
+ * @param namespaceURI : string - the namespace URI of the required node
+ * @param localName : string - the local name of the required node
+ * @return : boolean
+ */
+var __hasAttributeNS__ = function(namednodemap, namespaceURI, localName) {
+ var ret = false;
+ // test that Named Node exists
+ var itemIndex = __findNamedItemNSIndex__(namednodemap, namespaceURI, localName);
+ if (itemIndex > -1) {
+ // found it!
+ ret = true;
+ }
+ // if node is not found, default value false is returned
+ return ret;
+}
+
+/**
+ * @method __cloneNamedNodes__
+ * Returns a NamedNodeMap containing clones of the Nodes in this NamedNodeMap
+ *
+ * @param parentNode : Node - the new parent of the cloned NodeList
+ * @param isnsmap : bool - is this a NamespaceNodeMap
+ * @return NamedNodeMap containing clones of the Nodes in this NamedNodeMap
+ */
+var __cloneNamedNodes__ = function(namednodemap, parentNode, isnsmap) {
+ var cloneNamedNodeMap = isnsmap?
+ new NamespaceNodeMap(namednodemap.ownerDocument, parentNode):
+ new NamedNodeMap(namednodemap.ownerDocument, parentNode);
+
+ // create list containing clones of all children
+ for (var i=0; i < namednodemap.length; i++) {
+ __appendChild__(cloneNamedNodeMap, namednodemap[i].cloneNode(false));
+ }
+
+ return cloneNamedNodeMap;
+};
+
+
+/**
+ * @class NamespaceNodeMap -
+ * used to represent collections of namespace nodes that can be
+ * accessed by name typically a set of Element attributes
+ *
+ * @extends NamedNodeMap
+ *
+ * @param ownerDocument : Document - the ownerDocument
+ * @param parentNode : Node - the node that the NamespaceNodeMap is attached to (or null)
+ */
+var NamespaceNodeMap = function(ownerDocument, parentNode) {
+ this.NamedNodeMap = NamedNodeMap;
+ this.NamedNodeMap(ownerDocument, parentNode);
+ __setArray__(this, []);
+};
+NamespaceNodeMap.prototype = new NamedNodeMap();
+__extend__(NamespaceNodeMap.prototype, {
+ get xml() {
+ var ret = "",
+ ns,
+ ind;
+ // identify namespaces declared local to this Element (ie, not inherited)
+ for (ind = 0; ind < this.length; ind++) {
+ // if namespace declaration does not exist in the containing node's, parentNode's namespaces
+ ns = null;
+ try {
+ var ns = this.parentNode.parentNode._namespaces.
+ getNamedItem(this[ind].localName);
+ }catch (e) {
+ //breaking to prevent default namespace being inserted into return value
+ break;
+ }
+ if (!(ns && (""+ ns.nodeValue == ""+ this[ind].nodeValue))) {
+ // display the namespace declaration
+ ret += this[ind].xml +" ";
+ }
+ }
+ return ret;
+ }
+});
+
+/**
+ * @class Namespace -
+ * The Namespace interface represents an namespace in an Element object
+ *
+ * @param ownerDocument : The Document object associated with this node.
+ */
+Namespace = function(ownerDocument) {
+ Node.apply(this, arguments);
+ // the name of this attribute
+ this.name = "";
+
+ // If this attribute was explicitly given a value in the original document,
+ // this is true; otherwise, it is false.
+ // Note that the implementation is in charge of this attribute, not the user.
+ // If the user changes the value of the attribute (even if it ends up having
+ // the same value as the default value) then the specified flag is
+ // automatically flipped to true
+ this.specified = false;
+};
+Namespace.prototype = new Node();
+__extend__(Namespace.prototype, {
+ get value(){
+ // the value of the attribute is returned as a string
+ return this.nodeValue;
+ },
+ set value(value){
+ this.nodeValue = value+'';
+ },
+ get nodeType(){
+ return Node.NAMESPACE_NODE;
+ },
+ get xml(){
+ var ret = "";
+
+ // serialize Namespace Declaration
+ if (this.nodeName != "") {
+ ret += this.nodeName +"=\""+ __escapeXML__(this.nodeValue) +"\"";
+ }
+ else { // handle default namespace
+ ret += "xmlns=\""+ __escapeXML__(this.nodeValue) +"\"";
+ }
+
+ return ret;
+ },
+ toString: function(){
+ return '[object Namespace]';
+ }
+});
+
+
+/**
+ * @class CharacterData - parent abstract class for Text and Comment
+ * @extends Node
+ * @param ownerDocument : The Document object associated with this node.
+ */
+CharacterData = function(ownerDocument) {
+ Node.apply(this, arguments);
+};
+CharacterData.prototype = new Node();
+__extend__(CharacterData.prototype,{
+ get data(){
+ return this.nodeValue;
+ },
+ set data(data){
+ this.nodeValue = data;
+ },
+ get textContent(){
+ return this.nodeValue;
+ },
+ set textContent(newText){
+ this.nodeValue = newText;
+ },
+ get length(){return this.nodeValue.length;},
+ appendData: function(arg){
+ // throw Exception if CharacterData is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+ // append data
+ this.data = "" + this.data + arg;
+ },
+ deleteData: function(offset, count){
+ // throw Exception if CharacterData is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+ if (this.data) {
+ // throw Exception if offset is negative or greater than the data length,
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ ((offset < 0) || (offset > this.data.length) || (count < 0))) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+
+ // delete data
+ if(!count || (offset + count) > this.data.length) {
+ this.data = this.data.substring(0, offset);
+ }else {
+ this.data = this.data.substring(0, offset).
+ concat(this.data.substring(offset + count));
+ }
+ }
+ },
+ insertData: function(offset, arg){
+ // throw Exception if CharacterData is readonly
+ if(__ownerDocument__(this).implementation.errorChecking && this._readonly){
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ if(this.data){
+ // throw Exception if offset is negative or greater than the data length,
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ ((offset < 0) || (offset > this.data.length))) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+
+ // insert data
+ this.data = this.data.substring(0, offset).concat(arg, this.data.substring(offset));
+ }else {
+ // throw Exception if offset is negative or greater than the data length,
+ if (__ownerDocument__(this).implementation.errorChecking && (offset !== 0)) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+
+ // set data
+ this.data = arg;
+ }
+ },
+ replaceData: function(offset, count, arg){
+ // throw Exception if CharacterData is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ if (this.data) {
+ // throw Exception if offset is negative or greater than the data length,
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ ((offset < 0) || (offset > this.data.length) || (count < 0))) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+
+ // replace data
+ this.data = this.data.substring(0, offset).
+ concat(arg, this.data.substring(offset + count));
+ }else {
+ // set data
+ this.data = arg;
+ }
+ },
+ substringData: function(offset, count){
+ var ret = null;
+ if (this.data) {
+ // throw Exception if offset is negative or greater than the data length,
+ // or the count is negative
+ if (__ownerDocument__(this).implementation.errorChecking &&
+ ((offset < 0) || (offset > this.data.length) || (count < 0))) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+ // if count is not specified
+ if (!count) {
+ ret = this.data.substring(offset); // default to 'end of string'
+ }else{
+ ret = this.data.substring(offset, offset + count);
+ }
+ }
+ return ret;
+ },
+ toString : function(){
+ return "[object CharacterData]";
+ }
+});
+
+/**
+ * @class Text
+ * The Text interface represents the textual content (termed
+ * character data in XML) of an Element or Attr.
+ * If there is no markup inside an element's content, the text is
+ * contained in a single object implementing the Text interface that
+ * is the only child of the element. If there is markup, it is
+ * parsed into a list of elements and Text nodes that form the
+ * list of children of the element.
+ * @extends CharacterData
+ * @param ownerDocument The Document object associated with this node.
+ */
+Text = function(ownerDocument) {
+ CharacterData.apply(this, arguments);
+ this.nodeName = "#text";
+};
+Text.prototype = new CharacterData();
+__extend__(Text.prototype,{
+ get localName(){
+ return null;
+ },
+ // Breaks this Text node into two Text nodes at the specified offset,
+ // keeping both in the tree as siblings. This node then only contains
+ // all the content up to the offset point. And a new Text node, which
+ // is inserted as the next sibling of this node, contains all the
+ // content at and after the offset point.
+ splitText : function(offset) {
+ var data,
+ inode;
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Node is readonly
+ if (this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+ // throw Exception if offset is negative or greater than the data length,
+ if ((offset < 0) || (offset > this.data.length)) {
+ throw(new DOMException(DOMException.INDEX_SIZE_ERR));
+ }
+ }
+ if (this.parentNode) {
+ // get remaining string (after offset)
+ data = this.substringData(offset);
+ // create new TextNode with remaining string
+ inode = __ownerDocument__(this).createTextNode(data);
+ // attach new TextNode
+ if (this.nextSibling) {
+ this.parentNode.insertBefore(inode, this.nextSibling);
+ } else {
+ this.parentNode.appendChild(inode);
+ }
+ // remove remaining string from original TextNode
+ this.deleteData(offset);
+ }
+ return inode;
+ },
+ get nodeType(){
+ return Node.TEXT_NODE;
+ },
+ get xml(){
+ return __escapeXML__(""+ this.nodeValue);
+ },
+ toString: function(){
+ return "[object Text]";
+ }
+});
+
+/**
+ * @class CDATASection
+ * CDATA sections are used to escape blocks of text containing
+ * characters that would otherwise be regarded as markup.
+ * The only delimiter that is recognized in a CDATA section is
+ * the "\]\]\>" string that ends the CDATA section
+ * @extends Text
+ * @param ownerDocument : The Document object associated with this node.
+ */
+CDATASection = function(ownerDocument) {
+ Text.apply(this, arguments);
+ this.nodeName = '#cdata-section';
+};
+CDATASection.prototype = new Text();
+__extend__(CDATASection.prototype,{
+ get nodeType(){
+ return Node.CDATA_SECTION_NODE;
+ },
+ get xml(){
+ return "";
+ },
+ toString : function(){
+ return "[object CDATASection]";
+ }
+});
+/**
+ * @class Comment
+ * This represents the content of a comment, i.e., all the
+ * characters between the starting ''
+ * @extends CharacterData
+ * @param ownerDocument : The Document object associated with this node.
+ */
+Comment = function(ownerDocument) {
+ CharacterData.apply(this, arguments);
+ this.nodeName = "#comment";
+};
+Comment.prototype = new CharacterData();
+__extend__(Comment.prototype, {
+ get localName(){
+ return null;
+ },
+ get nodeType(){
+ return Node.COMMENT_NODE;
+ },
+ get xml(){
+ return "";
+ },
+ toString : function(){
+ return "[object Comment]";
+ }
+});
+
+
+/**
+ * @author envjs team
+ * @param {Document} onwnerDocument
+ */
+DocumentType = function(ownerDocument) {
+ Node.apply(this, arguments);
+ this.systemId = null;
+ this.publicId = null;
+};
+DocumentType.prototype = new Node();
+__extend__({
+ get name(){
+ return this.nodeName;
+ },
+ get entities(){
+ return null;
+ },
+ get internalSubsets(){
+ return null;
+ },
+ get notations(){
+ return null;
+ },
+ toString : function(){
+ return "[object DocumentType]";
+ }
+});
+
+/**
+ * @class Attr
+ * The Attr interface represents an attribute in an Element object
+ * @extends Node
+ * @param ownerDocument : The Document object associated with this node.
+ */
+Attr = function(ownerDocument) {
+ Node.apply(this, arguments);
+ // set when Attr is added to NamedNodeMap
+ this.ownerElement = null;
+ //TODO: our implementation of Attr is incorrect because we don't
+ // treat the value of the attribute as a child text node.
+};
+Attr.prototype = new Node();
+__extend__(Attr.prototype, {
+ // the name of this attribute
+ get name(){
+ return this.nodeName;
+ },
+ // the value of the attribute is returned as a string
+ get value(){
+ return this.nodeValue||'';
+ },
+ set value(value){
+ // throw Exception if Attribute is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+ // delegate to node
+ this.nodeValue = value;
+ },
+ get textContent(){
+ return this.nodeValue;
+ },
+ set textContent(newText){
+ this.nodeValue = newText;
+ },
+ get specified(){
+ return (this !== null && this !== undefined);
+ },
+ get nodeType(){
+ return Node.ATTRIBUTE_NODE;
+ },
+ get xml() {
+ if (this.nodeValue) {
+ return __escapeXML__(this.nodeValue+"");
+ } else {
+ return '';
+ }
+ },
+ toString : function() {
+ return '[object Attr]';
+ }
+});
+
+
+/**
+ * @class Element -
+ * By far the vast majority of objects (apart from text)
+ * that authors encounter when traversing a document are
+ * Element nodes.
+ * @extends Node
+ * @param ownerDocument : The Document object associated with this node.
+ */
+Element = function(ownerDocument) {
+ Node.apply(this, arguments);
+ this.attributes = new NamedNodeMap(this.ownerDocument, this);
+};
+Element.prototype = new Node();
+__extend__(Element.prototype, {
+ // The name of the element.
+ get tagName(){
+ return this.nodeName;
+ },
+
+ getAttribute: function(name) {
+ var ret = null;
+ // if attribute exists, use it
+ var attr = this.attributes.getNamedItem(name);
+ if (attr) {
+ ret = attr.value;
+ }
+ // if Attribute exists, return its value, otherwise, return null
+ return ret;
+ },
+ setAttribute : function (name, value) {
+ // if attribute exists, use it
+ var attr = this.attributes.getNamedItem(name);
+ //console.log('attr %s', attr);
+ //I had to add this check because as the script initializes
+ //the id may be set in the constructor, and the html element
+ //overrides the id property with a getter/setter.
+ if(__ownerDocument__(this)){
+ if (attr===null||attr===undefined) {
+ // otherwise create it
+ attr = __ownerDocument__(this).createAttribute(name);
+ //console.log('attr %s', attr);
+ }
+
+
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Attribute is readonly
+ if (attr._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if the value string contains an illegal character
+ if (!__isValidString__(value+'')) {
+ throw(new DOMException(DOMException.INVALID_CHARACTER_ERR));
+ }
+ }
+
+ // assign values to properties (and aliases)
+ attr.value = value + '';
+
+ // add/replace Attribute in NamedNodeMap
+ this.attributes.setNamedItem(attr);
+ //console.log('element setNamedItem %s', attr);
+ }else{
+ console.warn('Element has no owner document '+this.tagName+
+ '\n\t cant set attribute ' + name + ' = '+value );
+ }
+ },
+ removeAttribute : function removeAttribute(name) {
+ // delegate to NamedNodeMap.removeNamedItem
+ return this.attributes.removeNamedItem(name);
+ },
+ getAttributeNode : function getAttributeNode(name) {
+ // delegate to NamedNodeMap.getNamedItem
+ return this.attributes.getNamedItem(name);
+ },
+ setAttributeNode: function(newAttr) {
+ // if this Attribute is an ID
+ if (__isIdDeclaration__(newAttr.name)) {
+ this.id = newAttr.value; // cache ID for getElementById()
+ }
+ // delegate to NamedNodeMap.setNamedItem
+ return this.attributes.setNamedItem(newAttr);
+ },
+ removeAttributeNode: function(oldAttr) {
+ // throw Exception if Attribute is readonly
+ if (__ownerDocument__(this).implementation.errorChecking && oldAttr._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // get item index
+ var itemIndex = this.attributes._findItemIndex(oldAttr._id);
+
+ // throw Exception if node does not exist in this map
+ if (__ownerDocument__(this).implementation.errorChecking && (itemIndex < 0)) {
+ throw(new DOMException(DOMException.NOT_FOUND_ERR));
+ }
+
+ return this.attributes._removeChild(itemIndex);
+ },
+ getAttributeNS : function(namespaceURI, localName) {
+ var ret = "";
+ // delegate to NAmedNodeMap.getNamedItemNS
+ var attr = this.attributes.getNamedItemNS(namespaceURI, localName);
+ if (attr) {
+ ret = attr.value;
+ }
+ return ret; // if Attribute exists, return its value, otherwise return ""
+ },
+ setAttributeNS : function(namespaceURI, qualifiedName, value) {
+ // call NamedNodeMap.getNamedItem
+ //console.log('setAttributeNS %s %s %s', namespaceURI, qualifiedName, value);
+ var attr = this.attributes.getNamedItem(namespaceURI, qualifiedName);
+
+ if (!attr) { // if Attribute exists, use it
+ // otherwise create it
+ attr = __ownerDocument__(this).createAttributeNS(namespaceURI, qualifiedName);
+ }
+
+ value = '' + value;
+
+ // test for exceptions
+ if (__ownerDocument__(this).implementation.errorChecking) {
+ // throw Exception if Attribute is readonly
+ if (attr._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+
+ // throw Exception if the Namespace is invalid
+ if (!__isValidNamespace__(this.ownerDocument, namespaceURI, qualifiedName, true)) {
+ throw(new DOMException(DOMException.NAMESPACE_ERR));
+ }
+
+ // throw Exception if the value string contains an illegal character
+ if (!__isValidString__(value)) {
+ throw(new DOMException(DOMException.INVALID_CHARACTER_ERR));
+ }
+ }
+
+ // if this Attribute is an ID
+ //if (__isIdDeclaration__(name)) {
+ // this.id = value;
+ //}
+
+ // assign values to properties (and aliases)
+ attr.value = value;
+ attr.nodeValue = value;
+
+ // delegate to NamedNodeMap.setNamedItem
+ this.attributes.setNamedItemNS(attr);
+ },
+ removeAttributeNS : function(namespaceURI, localName) {
+ // delegate to NamedNodeMap.removeNamedItemNS
+ return this.attributes.removeNamedItemNS(namespaceURI, localName);
+ },
+ getAttributeNodeNS : function(namespaceURI, localName) {
+ // delegate to NamedNodeMap.getNamedItemNS
+ return this.attributes.getNamedItemNS(namespaceURI, localName);
+ },
+ setAttributeNodeNS : function(newAttr) {
+ // if this Attribute is an ID
+ if ((newAttr.prefix == "") && __isIdDeclaration__(newAttr.name)) {
+ this.id = newAttr.value+''; // cache ID for getElementById()
+ }
+
+ // delegate to NamedNodeMap.setNamedItemNS
+ return this.attributes.setNamedItemNS(newAttr);
+ },
+ hasAttribute : function(name) {
+ // delegate to NamedNodeMap._hasAttribute
+ return __hasAttribute__(this.attributes,name);
+ },
+ hasAttributeNS : function(namespaceURI, localName) {
+ // delegate to NamedNodeMap._hasAttributeNS
+ return __hasAttributeNS__(this.attributes, namespaceURI, localName);
+ },
+ get nodeType(){
+ return Node.ELEMENT_NODE;
+ },
+ get xml() {
+ var ret = "",
+ ns = "",
+ attrs,
+ attrstring,
+ i;
+
+ // serialize namespace declarations
+ if (this.namespaceURI ){
+ if((this === this.ownerDocument.documentElement) ||
+ (!this.parentNode)||
+ (this.parentNode && (this.parentNode.namespaceURI !== this.namespaceURI))) {
+ ns = ' xmlns' + (this.prefix?(':'+this.prefix):'') +
+ '="' + this.namespaceURI + '"';
+ }
+ }
+
+ // serialize Attribute declarations
+ attrs = this.attributes;
+ attrstring = "";
+ for(i=0;i< attrs.length;i++){
+ if(attrs[i].name.match('xmlns:')) {
+ attrstring += " "+attrs[i].name+'="'+attrs[i].xml+'"';
+ }
+ }
+ for(i=0;i< attrs.length;i++){
+ if(!attrs[i].name.match('xmlns:')) {
+ attrstring += " "+attrs[i].name+'="'+attrs[i].xml+'"';
+ }
+ }
+
+ if(this.hasChildNodes()){
+ // serialize this Element
+ ret += "<" + this.tagName + ns + attrstring +">";
+ ret += this.childNodes.xml;
+ ret += "";
+ }else{
+ ret += "<" + this.tagName + ns + attrstring +"/>";
+ }
+
+ return ret;
+ },
+ toString : function(){
+ return '[object Element]';
+ }
+});
+/**
+ * @class DOMException - raised when an operation is impossible to perform
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param code : int - the exception code (one of the DOMException constants)
+ */
+DOMException = function(code) {
+ this.code = code;
+};
+
+// DOMException constants
+// Introduced in DOM Level 1:
+DOMException.INDEX_SIZE_ERR = 1;
+DOMException.DOMSTRING_SIZE_ERR = 2;
+DOMException.HIERARCHY_REQUEST_ERR = 3;
+DOMException.WRONG_DOCUMENT_ERR = 4;
+DOMException.INVALID_CHARACTER_ERR = 5;
+DOMException.NO_DATA_ALLOWED_ERR = 6;
+DOMException.NO_MODIFICATION_ALLOWED_ERR = 7;
+DOMException.NOT_FOUND_ERR = 8;
+DOMException.NOT_SUPPORTED_ERR = 9;
+DOMException.INUSE_ATTRIBUTE_ERR = 10;
+
+// Introduced in DOM Level 2:
+DOMException.INVALID_STATE_ERR = 11;
+DOMException.SYNTAX_ERR = 12;
+DOMException.INVALID_MODIFICATION_ERR = 13;
+DOMException.NAMESPACE_ERR = 14;
+DOMException.INVALID_ACCESS_ERR = 15;
+
+/**
+ * @class DocumentFragment -
+ * DocumentFragment is a "lightweight" or "minimal" Document object.
+ * @extends Node
+ * @param ownerDocument : The Document object associated with this node.
+ */
+DocumentFragment = function(ownerDocument) {
+ Node.apply(this, arguments);
+ this.nodeName = "#document-fragment";
+};
+DocumentFragment.prototype = new Node();
+__extend__(DocumentFragment.prototype,{
+ get nodeType(){
+ return Node.DOCUMENT_FRAGMENT_NODE;
+ },
+ get xml(){
+ var xml = "",
+ count = this.childNodes.length;
+
+ // create string concatenating the serialized ChildNodes
+ for (var i = 0; i < count; i++) {
+ xml += this.childNodes.item(i).xml;
+ }
+
+ return xml;
+ },
+ toString : function(){
+ return "[object DocumentFragment]";
+ },
+ get localName(){
+ return null;
+ }
+});
+
+
+/**
+ * @class ProcessingInstruction -
+ * The ProcessingInstruction interface represents a
+ * "processing instruction", used in XML as a way to
+ * keep processor-specific information in the text of
+ * the document
+ * @extends Node
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param ownerDocument : The Document object associated with this node.
+ */
+ProcessingInstruction = function(ownerDocument) {
+ Node.apply(this, arguments);
+};
+ProcessingInstruction.prototype = new Node();
+__extend__(ProcessingInstruction.prototype, {
+ get data(){
+ return this.nodeValue;
+ },
+ set data(data){
+ // throw Exception if Node is readonly
+ if (__ownerDocument__(this).errorChecking && this._readonly) {
+ throw(new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR));
+ }
+ this.nodeValue = data;
+ },
+ get textContent(){
+ return this.data;
+ },
+ get localName(){
+ return null;
+ },
+ get target(){
+ // The target of this processing instruction.
+ // XML defines this as being the first token following the markup that begins the processing instruction.
+ // The content of this processing instruction.
+ return this.nodeName;
+ },
+ set target(value){
+ // The target of this processing instruction.
+ // XML defines this as being the first token following the markup that begins the processing instruction.
+ // The content of this processing instruction.
+ this.nodeName = value;
+ },
+ get nodeType(){
+ return Node.PROCESSING_INSTRUCTION_NODE;
+ },
+ get xml(){
+ return "";
+ },
+ toString : function(){
+ return "[object ProcessingInstruction]";
+ }
+});
+
+
+/**
+ * @author envjs team
+ */
+
+Entity = function() {
+ throw new Error("Entity Not Implemented" );
+};
+
+Entity.constants = {
+ // content taken from W3C "HTML 4.01 Specification"
+ // "W3C Recommendation 24 December 1999"
+
+ nbsp: "\u00A0",
+ iexcl: "\u00A1",
+ cent: "\u00A2",
+ pound: "\u00A3",
+ curren: "\u00A4",
+ yen: "\u00A5",
+ brvbar: "\u00A6",
+ sect: "\u00A7",
+ uml: "\u00A8",
+ copy: "\u00A9",
+ ordf: "\u00AA",
+ laquo: "\u00AB",
+ not: "\u00AC",
+ shy: "\u00AD",
+ reg: "\u00AE",
+ macr: "\u00AF",
+ deg: "\u00B0",
+ plusmn: "\u00B1",
+ sup2: "\u00B2",
+ sup3: "\u00B3",
+ acute: "\u00B4",
+ micro: "\u00B5",
+ para: "\u00B6",
+ middot: "\u00B7",
+ cedil: "\u00B8",
+ sup1: "\u00B9",
+ ordm: "\u00BA",
+ raquo: "\u00BB",
+ frac14: "\u00BC",
+ frac12: "\u00BD",
+ frac34: "\u00BE",
+ iquest: "\u00BF",
+ Agrave: "\u00C0",
+ Aacute: "\u00C1",
+ Acirc: "\u00C2",
+ Atilde: "\u00C3",
+ Auml: "\u00C4",
+ Aring: "\u00C5",
+ AElig: "\u00C6",
+ Ccedil: "\u00C7",
+ Egrave: "\u00C8",
+ Eacute: "\u00C9",
+ Ecirc: "\u00CA",
+ Euml: "\u00CB",
+ Igrave: "\u00CC",
+ Iacute: "\u00CD",
+ Icirc: "\u00CE",
+ Iuml: "\u00CF",
+ ETH: "\u00D0",
+ Ntilde: "\u00D1",
+ Ograve: "\u00D2",
+ Oacute: "\u00D3",
+ Ocirc: "\u00D4",
+ Otilde: "\u00D5",
+ Ouml: "\u00D6",
+ times: "\u00D7",
+ Oslash: "\u00D8",
+ Ugrave: "\u00D9",
+ Uacute: "\u00DA",
+ Ucirc: "\u00DB",
+ Uuml: "\u00DC",
+ Yacute: "\u00DD",
+ THORN: "\u00DE",
+ szlig: "\u00DF",
+ agrave: "\u00E0",
+ aacute: "\u00E1",
+ acirc: "\u00E2",
+ atilde: "\u00E3",
+ auml: "\u00E4",
+ aring: "\u00E5",
+ aelig: "\u00E6",
+ ccedil: "\u00E7",
+ egrave: "\u00E8",
+ eacute: "\u00E9",
+ ecirc: "\u00EA",
+ euml: "\u00EB",
+ igrave: "\u00EC",
+ iacute: "\u00ED",
+ icirc: "\u00EE",
+ iuml: "\u00EF",
+ eth: "\u00F0",
+ ntilde: "\u00F1",
+ ograve: "\u00F2",
+ oacute: "\u00F3",
+ ocirc: "\u00F4",
+ otilde: "\u00F5",
+ ouml: "\u00F6",
+ divide: "\u00F7",
+ oslash: "\u00F8",
+ ugrave: "\u00F9",
+ uacute: "\u00FA",
+ ucirc: "\u00FB",
+ uuml: "\u00FC",
+ yacute: "\u00FD",
+ thorn: "\u00FE",
+ yuml: "\u00FF",
+ fnof: "\u0192",
+ Alpha: "\u0391",
+ Beta: "\u0392",
+ Gamma: "\u0393",
+ Delta: "\u0394",
+ Epsilon: "\u0395",
+ Zeta: "\u0396",
+ Eta: "\u0397",
+ Theta: "\u0398",
+ Iota: "\u0399",
+ Kappa: "\u039A",
+ Lambda: "\u039B",
+ Mu: "\u039C",
+ Nu: "\u039D",
+ Xi: "\u039E",
+ Omicron: "\u039F",
+ Pi: "\u03A0",
+ Rho: "\u03A1",
+ Sigma: "\u03A3",
+ Tau: "\u03A4",
+ Upsilon: "\u03A5",
+ Phi: "\u03A6",
+ Chi: "\u03A7",
+ Psi: "\u03A8",
+ Omega: "\u03A9",
+ alpha: "\u03B1",
+ beta: "\u03B2",
+ gamma: "\u03B3",
+ delta: "\u03B4",
+ epsilon: "\u03B5",
+ zeta: "\u03B6",
+ eta: "\u03B7",
+ theta: "\u03B8",
+ iota: "\u03B9",
+ kappa: "\u03BA",
+ lambda: "\u03BB",
+ mu: "\u03BC",
+ nu: "\u03BD",
+ xi: "\u03BE",
+ omicron: "\u03BF",
+ pi: "\u03C0",
+ rho: "\u03C1",
+ sigmaf: "\u03C2",
+ sigma: "\u03C3",
+ tau: "\u03C4",
+ upsilon: "\u03C5",
+ phi: "\u03C6",
+ chi: "\u03C7",
+ psi: "\u03C8",
+ omega: "\u03C9",
+ thetasym: "\u03D1",
+ upsih: "\u03D2",
+ piv: "\u03D6",
+ bull: "\u2022",
+ hellip: "\u2026",
+ prime: "\u2032",
+ Prime: "\u2033",
+ oline: "\u203E",
+ frasl: "\u2044",
+ weierp: "\u2118",
+ image: "\u2111",
+ real: "\u211C",
+ trade: "\u2122",
+ alefsym: "\u2135",
+ larr: "\u2190",
+ uarr: "\u2191",
+ rarr: "\u2192",
+ darr: "\u2193",
+ harr: "\u2194",
+ crarr: "\u21B5",
+ lArr: "\u21D0",
+ uArr: "\u21D1",
+ rArr: "\u21D2",
+ dArr: "\u21D3",
+ hArr: "\u21D4",
+ forall: "\u2200",
+ part: "\u2202",
+ exist: "\u2203",
+ empty: "\u2205",
+ nabla: "\u2207",
+ isin: "\u2208",
+ notin: "\u2209",
+ ni: "\u220B",
+ prod: "\u220F",
+ sum: "\u2211",
+ minus: "\u2212",
+ lowast: "\u2217",
+ radic: "\u221A",
+ prop: "\u221D",
+ infin: "\u221E",
+ ang: "\u2220",
+ and: "\u2227",
+ or: "\u2228",
+ cap: "\u2229",
+ cup: "\u222A",
+ intXX: "\u222B",
+ there4: "\u2234",
+ sim: "\u223C",
+ cong: "\u2245",
+ asymp: "\u2248",
+ ne: "\u2260",
+ equiv: "\u2261",
+ le: "\u2264",
+ ge: "\u2265",
+ sub: "\u2282",
+ sup: "\u2283",
+ nsub: "\u2284",
+ sube: "\u2286",
+ supe: "\u2287",
+ oplus: "\u2295",
+ otimes: "\u2297",
+ perp: "\u22A5",
+ sdot: "\u22C5",
+ lceil: "\u2308",
+ rceil: "\u2309",
+ lfloor: "\u230A",
+ rfloor: "\u230B",
+ lang: "\u2329",
+ rang: "\u232A",
+ loz: "\u25CA",
+ spades: "\u2660",
+ clubs: "\u2663",
+ hearts: "\u2665",
+ diams: "\u2666",
+ quot: "\u0022",
+ amp: "\u0026",
+ lt: "\u003C",
+ gt: "\u003E",
+ OElig: "\u0152",
+ oelig: "\u0153",
+ Scaron: "\u0160",
+ scaron: "\u0161",
+ Yuml: "\u0178",
+ circ: "\u02C6",
+ tilde: "\u02DC",
+ ensp: "\u2002",
+ emsp: "\u2003",
+ thinsp: "\u2009",
+ zwnj: "\u200C",
+ zwj: "\u200D",
+ lrm: "\u200E",
+ rlm: "\u200F",
+ ndash: "\u2013",
+ mdash: "\u2014",
+ lsquo: "\u2018",
+ rsquo: "\u2019",
+ sbquo: "\u201A",
+ ldquo: "\u201C",
+ rdquo: "\u201D",
+ bdquo: "\u201E",
+ dagger: "\u2020",
+ Dagger: "\u2021",
+ permil: "\u2030",
+ lsaquo: "\u2039",
+ rsaquo: "\u203A",
+ euro: "\u20AC",
+
+ // non-standard entities
+ apos: "'"
+};
+
+/**
+ * @author envjs team
+ */
+
+EntityReference = function() {
+ throw new Error("EntityReference Not Implemented" );
+};
+
+/**
+ * @class DOMImplementation -
+ * provides a number of methods for performing operations
+ * that are independent of any particular instance of the
+ * document object model.
+ *
+ * @author Jon van Noort (jon@webarcana.com.au)
+ */
+DOMImplementation = function() {
+ this.preserveWhiteSpace = false; // by default, ignore whitespace
+ this.namespaceAware = true; // by default, handle namespaces
+ this.errorChecking = true; // by default, test for exceptions
+};
+
+__extend__(DOMImplementation.prototype,{
+ // @param feature : string - The package name of the feature to test.
+ // the legal only values are "XML" and "CORE" (case-insensitive).
+ // @param version : string - This is the version number of the package
+ // name to test. In Level 1, this is the string "1.0".*
+ // @return : boolean
+ hasFeature : function(feature, version) {
+ var ret = false;
+ if (feature.toLowerCase() == "xml") {
+ ret = (!version || (version == "1.0") || (version == "2.0"));
+ }
+ else if (feature.toLowerCase() == "core") {
+ ret = (!version || (version == "2.0"));
+ }
+ else if (feature == "http://www.w3.org/TR/SVG11/feature#BasicStructure") {
+ ret = (version == "1.1");
+ }
+ return ret;
+ },
+ createDocumentType : function(qname, publicId, systemId){
+ var doctype = new DocumentType();
+ doctype.nodeName = qname?qname.toUpperCase():null;
+ doctype.publicId = publicId?publicId:null;
+ doctype.systemId = systemId?systemId:null;
+ return doctype;
+ },
+ createDocument : function(nsuri, qname, doctype){
+
+ var doc = null, documentElement;
+
+ doc = new Document(this, null);
+ if(doctype){
+ doc.doctype = doctype;
+ }
+
+ if(nsuri && qname){
+ documentElement = doc.createElementNS(nsuri, qname);
+ }else if(qname){
+ documentElement = doc.createElement(qname);
+ }
+ if(documentElement){
+ doc.appendChild(documentElement);
+ }
+ return doc;
+ },
+ createHTMLDocument : function(title){
+ var doc = new HTMLDocument($implementation, null, "");
+ var html = doc.createElement("html"); doc.appendChild(html);
+ var head = doc.createElement("head"); html.appendChild(head);
+ var body = doc.createElement("body"); html.appendChild(body);
+ var t = doc.createElement("title"); head.appendChild(t);
+ if( title) {
+ t.appendChild(doc.createTextNode(title));
+ }
+ return doc;
+ },
+ translateErrCode : function(code) {
+ //convert DOMException Code to human readable error message;
+ var msg = "";
+
+ switch (code) {
+ case DOMException.INDEX_SIZE_ERR : // 1
+ msg = "INDEX_SIZE_ERR: Index out of bounds";
+ break;
+
+ case DOMException.DOMSTRING_SIZE_ERR : // 2
+ msg = "DOMSTRING_SIZE_ERR: The resulting string is too long to fit in a DOMString";
+ break;
+
+ case DOMException.HIERARCHY_REQUEST_ERR : // 3
+ msg = "HIERARCHY_REQUEST_ERR: The Node can not be inserted at this location";
+ break;
+
+ case DOMException.WRONG_DOCUMENT_ERR : // 4
+ msg = "WRONG_DOCUMENT_ERR: The source and the destination Documents are not the same";
+ break;
+
+ case DOMException.INVALID_CHARACTER_ERR : // 5
+ msg = "INVALID_CHARACTER_ERR: The string contains an invalid character";
+ break;
+
+ case DOMException.NO_DATA_ALLOWED_ERR : // 6
+ msg = "NO_DATA_ALLOWED_ERR: This Node / NodeList does not support data";
+ break;
+
+ case DOMException.NO_MODIFICATION_ALLOWED_ERR : // 7
+ msg = "NO_MODIFICATION_ALLOWED_ERR: This object cannot be modified";
+ break;
+
+ case DOMException.NOT_FOUND_ERR : // 8
+ msg = "NOT_FOUND_ERR: The item cannot be found";
+ break;
+
+ case DOMException.NOT_SUPPORTED_ERR : // 9
+ msg = "NOT_SUPPORTED_ERR: This implementation does not support function";
+ break;
+
+ case DOMException.INUSE_ATTRIBUTE_ERR : // 10
+ msg = "INUSE_ATTRIBUTE_ERR: The Attribute has already been assigned to another Element";
+ break;
+
+ // Introduced in DOM Level 2:
+ case DOMException.INVALID_STATE_ERR : // 11
+ msg = "INVALID_STATE_ERR: The object is no longer usable";
+ break;
+
+ case DOMException.SYNTAX_ERR : // 12
+ msg = "SYNTAX_ERR: Syntax error";
+ break;
+
+ case DOMException.INVALID_MODIFICATION_ERR : // 13
+ msg = "INVALID_MODIFICATION_ERR: Cannot change the type of the object";
+ break;
+
+ case DOMException.NAMESPACE_ERR : // 14
+ msg = "NAMESPACE_ERR: The namespace declaration is incorrect";
+ break;
+
+ case DOMException.INVALID_ACCESS_ERR : // 15
+ msg = "INVALID_ACCESS_ERR: The object does not support this function";
+ break;
+
+ default :
+ msg = "UNKNOWN: Unknown Exception Code ("+ code +")";
+ }
+
+ return msg;
+ },
+ toString : function(){
+ return "[object DOMImplementation]";
+ }
+});
+
+
+
+/**
+ * @method DOMImplementation._isNamespaceDeclaration - Return true, if attributeName is a namespace declaration
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param attributeName : string - the attribute name
+ * @return : boolean
+ */
+function __isNamespaceDeclaration__(attributeName) {
+ // test if attributeName is 'xmlns'
+ return (attributeName.indexOf('xmlns') > -1);
+}
+
+/**
+ * @method DOMImplementation._isIdDeclaration - Return true, if attributeName is an id declaration
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param attributeName : string - the attribute name
+ * @return : boolean
+ */
+function __isIdDeclaration__(attributeName) {
+ // test if attributeName is 'id' (case insensitive)
+ return attributeName?(attributeName.toLowerCase() == 'id'):false;
+}
+
+/**
+ * @method DOMImplementation._isValidName - Return true,
+ * if name contains no invalid characters
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param name : string - the candidate name
+ * @return : boolean
+ */
+function __isValidName__(name) {
+ // test if name contains only valid characters
+ return name.match(re_validName);
+}
+var re_validName = /^[a-zA-Z_:][a-zA-Z0-9\.\-_:]*$/;
+
+/**
+ * @method DOMImplementation._isValidString - Return true, if string does not contain any illegal chars
+ * All of the characters 0 through 31 and character 127 are nonprinting control characters.
+ * With the exception of characters 09, 10, and 13, (Ox09, Ox0A, and Ox0D)
+ * Note: different from _isValidName in that ValidStrings may contain spaces
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param name : string - the candidate string
+ * @return : boolean
+ */
+function __isValidString__(name) {
+ // test that string does not contains invalid characters
+ return (name.search(re_invalidStringChars) < 0);
+}
+var re_invalidStringChars = /\x01|\x02|\x03|\x04|\x05|\x06|\x07|\x08|\x0B|\x0C|\x0E|\x0F|\x10|\x11|\x12|\x13|\x14|\x15|\x16|\x17|\x18|\x19|\x1A|\x1B|\x1C|\x1D|\x1E|\x1F|\x7F/;
+
+/**
+ * @method DOMImplementation._parseNSName - parse the namespace name.
+ * if there is no colon, the
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param qualifiedName : string - The qualified name
+ * @return : NSName - [
+ .prefix : string - The prefix part of the qname
+ .namespaceName : string - The namespaceURI part of the qname
+ ]
+ */
+function __parseNSName__(qualifiedName) {
+ var resultNSName = {};
+ // unless the qname has a namespaceName, the prefix is the entire String
+ resultNSName.prefix = qualifiedName;
+ resultNSName.namespaceName = "";
+ // split on ':'
+ var delimPos = qualifiedName.indexOf(':');
+ if (delimPos > -1) {
+ // get prefix
+ resultNSName.prefix = qualifiedName.substring(0, delimPos);
+ // get namespaceName
+ resultNSName.namespaceName = qualifiedName.substring(delimPos +1, qualifiedName.length);
+ }
+ return resultNSName;
+}
+
+/**
+ * @method DOMImplementation._parseQName - parse the qualified name
+ * @author Jon van Noort (jon@webarcana.com.au)
+ * @param qualifiedName : string - The qualified name
+ * @return : QName
+ */
+function __parseQName__(qualifiedName) {
+ var resultQName = {};
+ // unless the qname has a prefix, the local name is the entire String
+ resultQName.localName = qualifiedName;
+ resultQName.prefix = "";
+ // split on ':'
+ var delimPos = qualifiedName.indexOf(':');
+ if (delimPos > -1) {
+ // get prefix
+ resultQName.prefix = qualifiedName.substring(0, delimPos);
+ // get localName
+ resultQName.localName = qualifiedName.substring(delimPos +1, qualifiedName.length);
+ }
+ return resultQName;
+}
+/**
+ * @author envjs team
+ */
+Notation = function() {
+ throw new Error("Notation Not Implemented" );
+};/**
+ * @author thatcher
+ */
+Range = function(){
+
+};
+
+__extend__(Range.prototype, {
+ get startContainer(){
+
+ },
+ get endContainer(){
+
+ },
+ get startOffset(){
+
+ },
+ get endOffset(){
+
+ },
+ get collapsed(){
+
+ },
+ get commonAncestorContainer(){
+
+ },
+ setStart: function(refNode, offset){//throws RangeException
+
+ },
+ setEnd: function(refNode, offset){//throws RangeException
+
+ },
+ setStartBefore: function(refNode){//throws RangeException
+
+ },
+ setStartAfter: function(refNode){//throws RangeException
+
+ },
+ setEndBefore: function(refNode){//throws RangeException
+
+ },
+ setEndAfter: function(refNode){//throws RangeException
+
+ },
+ collapse: function(toStart){//throws RangeException
+
+ },
+ selectNode: function(refNode){//throws RangeException
+
+ },
+ selectNodeContents: function(refNode){//throws RangeException
+
+ },
+ compareBoundaryPoints: function(how, sourceRange){
+
+ },
+ deleteContents: function(){
+
+ },
+ extractContents: function(){
+
+ },
+ cloneContents: function(){
+
+ },
+ insertNode: function(newNode){
+
+ },
+ surroundContents: function(newParent){
+
+ },
+ cloneRange: function(){
+
+ },
+ toString: function(){
+ return '[object Range]';
+ },
+ detach: function(){
+
+ }
+});
+
+
+ // CompareHow
+Range.START_TO_START = 0;
+Range.START_TO_END = 1;
+Range.END_TO_END = 2;
+Range.END_TO_START = 3;
+
+/*
+ * Forward declarations
+ */
+var __isValidNamespace__;
+
+/**
+ * @class Document - The Document interface represents the entire HTML
+ * or XML document. Conceptually, it is the root of the document tree,
+ * and provides the primary access to the document's data.
+ *
+ * @extends Node
+ * @param implementation : DOMImplementation - the creator Implementation
+ */
+Document = function(implementation, docParentWindow) {
+ Node.apply(this, arguments);
+
+ //TODO: Temporary!!! Cnage back to true!!!
+ this.async = true;
+ // The Document Type Declaration (see DocumentType) associated with this document
+ this.doctype = null;
+ // The DOMImplementation object that handles this document.
+ this.implementation = implementation;
+
+ this.nodeName = "#document";
+ // initially false, set to true by parser
+ this.parsing = false;
+ this.baseURI = 'about:blank';
+
+ this.ownerDocument = null;
+
+ this.importing = false;
+};
+
+Document.prototype = new Node();
+__extend__(Document.prototype,{
+ get localName(){
+ return null;
+ },
+ get textContent(){
+ return null;
+ },
+ get all(){
+ return this.getElementsByTagName("*");
+ },
+ get documentElement(){
+ var i, length = this.childNodes?this.childNodes.length:0;
+ for(i=0;i -1 ){
+ valid = false;
+ }
+
+ if ((valid) && (!isAttribute)) {
+ // if the namespaceURI is not null
+ if (!namespaceURI) {
+ valid = false;
+ }
+ }
+
+ // if the qualifiedName has a prefix
+ if ((valid) && (qName.prefix === "")) {
+ valid = false;
+ }
+ }
+
+ // if the qualifiedName has a prefix that is "xml" and the namespaceURI is
+ // different from "http://www.w3.org/XML/1998/namespace" [Namespaces].
+ if ((valid) && (qName.prefix === "xml") && (namespaceURI !== "http://www.w3.org/XML/1998/namespace")) {
+ valid = false;
+ }
+
+ return valid;
+};
+/**
+ *
+ * This file only handles XML parser.
+ * It is extended by parser/domparser.js (and parser/htmlparser.js)
+ *
+ * This depends on e4x, which some engines may not have.
+ *
+ * @author thatcher
+ */
+DOMParser = function(principle, documentURI, baseURI) {
+ // TODO: why/what should these 3 args do?
+};
+__extend__(DOMParser.prototype,{
+ parseFromString: function(xmlstring, mimetype){
+ var doc = new Document(new DOMImplementation()),
+ e4;
+
+ // The following are e4x directives.
+ // Full spec is here:
+ // http://www.ecma-international.org/publications/standards/Ecma-357.htm
+ //
+ // that is pretty gross, so checkout this summary
+ // http://rephrase.net/days/07/06/e4x
+ //
+ // also see the Mozilla Developer Center:
+ // https://developer.mozilla.org/en/E4X
+ //
+ XML.ignoreComments = false;
+ XML.ignoreProcessingInstructions = false;
+ XML.ignoreWhitespace = false;
+
+ // for some reason e4x can't handle initial xml declarations
+ // https://bugzilla.mozilla.org/show_bug.cgi?id=336551
+ // The official workaround is the big regexp below
+ // but simpler one seems to be ok
+ // xmlstring = xmlstring.replace(/^<\?xml\s+version\s*=\s*(["'])[^\1]+\1[^?]*\?>/, "");
+ //
+ xmlstring = xmlstring.replace(/<\?xml.*\?>/);
+
+ e4 = new XMLList(xmlstring);
+
+ __toDomNode__(e4, doc, doc);
+
+ //console.log('xml \n %s', doc.documentElement.xml);
+ return doc;
+ }
+});
+
+var __toDomNode__ = function(e4, parent, doc){
+ var xnode,
+ domnode,
+ children,
+ target,
+ value,
+ length,
+ element,
+ kind,
+ item;
+ //console.log('converting e4x node list \n %s', e4)
+
+ // not using the for each(item in e4) since some engines can't
+ // handle the syntax (i.e. says syntax error)
+ //
+ // for each(xnode in e4) {
+ for (item in e4) {
+ // NO do not do this if (e4.hasOwnProperty(item)) {
+ // breaks spidermonkey
+ xnode = e4[item];
+
+ kind = xnode.nodeKind();
+ //console.log('treating node kind %s', kind);
+ switch(kind){
+ case 'element':
+ // add node
+ //console.log('creating element %s %s', xnode.localName(), xnode.namespace());
+ if(xnode.namespace() && (xnode.namespace()+'') !== ''){
+ //console.log('createElementNS %s %s',xnode.namespace()+'', xnode.localName() );
+ domnode = doc.createElementNS(xnode.namespace()+'', xnode.localName());
+ }else{
+ domnode = doc.createElement(xnode.name()+'');
+ }
+ parent.appendChild(domnode);
+
+ // add attributes
+ __toDomNode__(xnode.attributes(), domnode, doc);
+
+ // add children
+ children = xnode.children();
+ length = children.length();
+ //console.log('recursing? %s', length ? 'yes' : 'no');
+ if (length > 0) {
+ __toDomNode__(children, domnode, doc);
+ }
+ break;
+ case 'attribute':
+ // console.log('setting attribute %s %s %s',
+ // xnode.localName(), xnode.namespace(), xnode.valueOf());
+
+ //
+ // cross-platform alert. The original code used
+ // xnode.text() to get the attribute value
+ // This worked in Rhino, but did not in Spidermonkey
+ // valueOf seemed to work in both
+ //
+ if(xnode.namespace() && xnode.namespace().prefix){
+ //console.log("%s", xnode.namespace().prefix);
+ parent.setAttributeNS(xnode.namespace()+'',
+ xnode.namespace().prefix+':'+xnode.localName(),
+ xnode.valueOf());
+ }else if((xnode.name()+'').match('http://www.w3.org/2000/xmlns/::')){
+ if(xnode.localName()!=='xmlns'){
+ parent.setAttributeNS('http://www.w3.org/2000/xmlns/',
+ 'xmlns:'+xnode.localName(),
+ xnode.valueOf());
+ }
+ }else{
+ parent.setAttribute(xnode.localName()+'', xnode.valueOf());
+ }
+ break;
+ case 'text':
+ //console.log('creating text node : %s', xnode);
+ domnode = doc.createTextNode(xnode+'');
+ parent.appendChild(domnode);
+ break;
+ case 'comment':
+ //console.log('creating comment node : %s', xnode);
+ value = xnode+'';
+ domnode = doc.createComment(value.substring(4,value.length-3));
+ parent.appendChild(domnode);
+ break;
+ case 'processing-instruction':
+ //console.log('creating processing-instruction node : %s', xnode);
+ value = xnode+'';
+ target = value.split(' ')[0].substring(2);
+ value = value.split(' ').splice(1).join(' ').replace('?>','');
+ //console.log('creating processing-instruction data : %s', value);
+ domnode = doc.createProcessingInstruction(target, value);
+ parent.appendChild(domnode);
+ break;
+ default:
+ console.log('e4x DOM ERROR');
+ throw new Error("Assertion failed in xml parser");
+ }
+ }
+};
+/**
+ * @author envjs team
+ * @class XMLSerializer
+ */
+
+XMLSerializer = function() {};
+
+__extend__(XMLSerializer.prototype, {
+ serializeToString: function(node){
+ return node.xml;
+ },
+ toString : function(){
+ return "[object XMLSerializer]";
+ }
+});
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+/*
+ * Envjs event.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ *
+ * This file simply provides the global definitions we need to
+ * be able to correctly implement to core browser DOM Event interfaces.
+ */
+var Event,
+ MouseEvent,
+ UIEvent,
+ KeyboardEvent,
+ MutationEvent,
+ DocumentEvent,
+ EventTarget,
+ EventException,
+ //nonstandard but very useful for implementing mutation events
+ //among other things like general profiling
+ Aspect;
+/*
+ * Envjs event.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author john resig
+ */
+// Helper method for extending one object with another.
+function __extend__(a,b) {
+ for ( var i in b ) {
+ var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
+ if ( g || s ) {
+ if ( g ) { a.__defineGetter__(i, g); }
+ if ( s ) { a.__defineSetter__(i, s); }
+ } else {
+ a[i] = b[i];
+ }
+ } return a;
+}
+
+/**
+ * @author john resig
+ */
+//from jQuery
+function __setArray__( target, array ) {
+ // Resetting the length to 0, then using the native Array push
+ // is a super-fast way to populate an object with array-like properties
+ target.length = 0;
+ Array.prototype.push.apply( target, array );
+}
+/**
+ * Borrowed with love from:
+ *
+ * jQuery AOP - jQuery plugin to add features of aspect-oriented programming (AOP) to jQuery.
+ * http://jquery-aop.googlecode.com/
+ *
+ * Licensed under the MIT license:
+ * http://www.opensource.org/licenses/mit-license.php
+ *
+ * Version: 1.1
+ */
+(function() {
+
+ var _after = 1;
+ var _before = 2;
+ var _around = 3;
+ var _intro = 4;
+ var _regexEnabled = true;
+
+ /**
+ * Private weaving function.
+ */
+ var weaveOne = function(source, method, advice) {
+
+ var old = source[method];
+
+ var aspect;
+ if (advice.type == _after)
+ aspect = function() {
+ var returnValue = old.apply(this, arguments);
+ return advice.value.apply(this, [returnValue, method]);
+ };
+ else if (advice.type == _before)
+ aspect = function() {
+ advice.value.apply(this, [arguments, method]);
+ return old.apply(this, arguments);
+ };
+ else if (advice.type == _intro)
+ aspect = function() {
+ return advice.value.apply(this, arguments);
+ };
+ else if (advice.type == _around) {
+ aspect = function() {
+ var invocation = { object: this, args: arguments };
+ return advice.value.apply(invocation.object, [{ arguments: invocation.args, method: method, proceed :
+ function() {
+ return old.apply(invocation.object, invocation.args);
+ }
+ }] );
+ };
+ }
+
+ aspect.unweave = function() {
+ source[method] = old;
+ pointcut = source = aspect = old = null;
+ };
+
+ source[method] = aspect;
+
+ return aspect;
+
+ };
+
+
+ /**
+ * Private weaver and pointcut parser.
+ */
+ var weave = function(pointcut, advice)
+ {
+
+ var source = (typeof(pointcut.target.prototype) != 'undefined') ? pointcut.target.prototype : pointcut.target;
+ var advices = [];
+
+ // If it's not an introduction and no method was found, try with regex...
+ if (advice.type != _intro && typeof(source[pointcut.method]) == 'undefined')
+ {
+
+ for (var method in source)
+ {
+ if (source[method] != null && source[method] instanceof Function && method.match(pointcut.method))
+ {
+ advices[advices.length] = weaveOne(source, method, advice);
+ }
+ }
+
+ if (advices.length == 0)
+ throw 'No method: ' + pointcut.method;
+
+ }
+ else
+ {
+ // Return as an array of one element
+ advices[0] = weaveOne(source, pointcut.method, advice);
+ }
+
+ return _regexEnabled ? advices : advices[0];
+
+ };
+
+ Aspect =
+ {
+ /**
+ * Creates an advice after the defined point-cut. The advice will be executed after the point-cut method
+ * has completed execution successfully, and will receive one parameter with the result of the execution.
+ * This function returns an array of weaved aspects (Function).
+ *
+ * @example jQuery.aop.after( {target: window, method: 'MyGlobalMethod'}, function(result) { alert('Returned: ' + result); } );
+ * @result Array
+ *
+ * @example jQuery.aop.after( {target: String, method: 'indexOf'}, function(index) { alert('Result found at: ' + index + ' on:' + this); } );
+ * @result Array
+ *
+ * @name after
+ * @param Map pointcut Definition of the point-cut to apply the advice. A point-cut is the definition of the object/s and method/s to be weaved.
+ * @option Object target Target object to be weaved.
+ * @option String method Name of the function to be weaved. Regex are supported, but not on built-in objects.
+ * @param Function advice Function containing the code that will get called after the execution of the point-cut. It receives one parameter
+ * with the result of the point-cut's execution.
+ *
+ * @type Array
+ * @cat Plugins/General
+ */
+ after : function(pointcut, advice)
+ {
+ return weave( pointcut, { type: _after, value: advice } );
+ },
+
+ /**
+ * Creates an advice before the defined point-cut. The advice will be executed before the point-cut method
+ * but cannot modify the behavior of the method, or prevent its execution.
+ * This function returns an array of weaved aspects (Function).
+ *
+ * @example jQuery.aop.before( {target: window, method: 'MyGlobalMethod'}, function() { alert('About to execute MyGlobalMethod'); } );
+ * @result Array
+ *
+ * @example jQuery.aop.before( {target: String, method: 'indexOf'}, function(index) { alert('About to execute String.indexOf on: ' + this); } );
+ * @result Array
+ *
+ * @name before
+ * @param Map pointcut Definition of the point-cut to apply the advice. A point-cut is the definition of the object/s and method/s to be weaved.
+ * @option Object target Target object to be weaved.
+ * @option String method Name of the function to be weaved. Regex are supported, but not on built-in objects.
+ * @param Function advice Function containing the code that will get called before the execution of the point-cut.
+ *
+ * @type Array
+ * @cat Plugins/General
+ */
+ before : function(pointcut, advice)
+ {
+ return weave( pointcut, { type: _before, value: advice } );
+ },
+
+
+ /**
+ * Creates an advice 'around' the defined point-cut. This type of advice can control the point-cut method execution by calling
+ * the functions '.proceed()' on the 'invocation' object, and also, can modify the arguments collection before sending them to the function call.
+ * This function returns an array of weaved aspects (Function).
+ *
+ * @example jQuery.aop.around( {target: window, method: 'MyGlobalMethod'}, function(invocation) {
+ * alert('# of Arguments: ' + invocation.arguments.length);
+ * return invocation.proceed();
+ * } );
+ * @result Array
+ *
+ * @example jQuery.aop.around( {target: String, method: 'indexOf'}, function(invocation) {
+ * alert('Searching: ' + invocation.arguments[0] + ' on: ' + this);
+ * return invocation.proceed();
+ * } );
+ * @result Array
+ *
+ * @example jQuery.aop.around( {target: window, method: /Get(\d+)/}, function(invocation) {
+ * alert('Executing ' + invocation.method);
+ * return invocation.proceed();
+ * } );
+ * @desc Matches all global methods starting with 'Get' and followed by a number.
+ * @result Array
+ *
+ *
+ * @name around
+ * @param Map pointcut Definition of the point-cut to apply the advice. A point-cut is the definition of the object/s and method/s to be weaved.
+ * @option Object target Target object to be weaved.
+ * @option String method Name of the function to be weaved. Regex are supported, but not on built-in objects.
+ * @param Function advice Function containing the code that will get called around the execution of the point-cut. This advice will be called with one
+ * argument containing one function '.proceed()', the collection of arguments '.arguments', and the matched method name '.method'.
+ *
+ * @type Array
+ * @cat Plugins/General
+ */
+ around : function(pointcut, advice)
+ {
+ return weave( pointcut, { type: _around, value: advice } );
+ },
+
+ /**
+ * Creates an introduction on the defined point-cut. This type of advice replaces any existing methods with the same
+ * name. To restore them, just unweave it.
+ * This function returns an array with only one weaved aspect (Function).
+ *
+ * @example jQuery.aop.introduction( {target: window, method: 'MyGlobalMethod'}, function(result) { alert('Returned: ' + result); } );
+ * @result Array
+ *
+ * @example jQuery.aop.introduction( {target: String, method: 'log'}, function() { alert('Console: ' + this); } );
+ * @result Array
+ *
+ * @name introduction
+ * @param Map pointcut Definition of the point-cut to apply the advice. A point-cut is the definition of the object/s and method/s to be weaved.
+ * @option Object target Target object to be weaved.
+ * @option String method Name of the function to be weaved.
+ * @param Function advice Function containing the code that will be executed on the point-cut.
+ *
+ * @type Array
+ * @cat Plugins/General
+ */
+ introduction : function(pointcut, advice)
+ {
+ return weave( pointcut, { type: _intro, value: advice } );
+ },
+
+ /**
+ * Configures global options.
+ *
+ * @name setup
+ * @param Map settings Configuration options.
+ * @option Boolean regexMatch Enables/disables regex matching of method names.
+ *
+ * @example jQuery.aop.setup( { regexMatch: false } );
+ * @desc Disable regex matching.
+ *
+ * @type Void
+ * @cat Plugins/General
+ */
+ setup: function(settings)
+ {
+ _regexEnabled = settings.regexMatch;
+ }
+ };
+
+})();
+
+
+
+
+/**
+ * @name EventTarget
+ * @w3c:domlevel 2
+ * @uri -//TODO: paste dom event level 2 w3c spc uri here
+ */
+EventTarget = function(){};
+EventTarget.prototype.addEventListener = function(type, fn, phase){
+ __addEventListener__(this, type, fn, phase);
+};
+EventTarget.prototype.removeEventListener = function(type, fn){
+ __removeEventListener__(this, type, fn);
+};
+EventTarget.prototype.dispatchEvent = function(event, bubbles){
+ __dispatchEvent__(this, event, bubbles);
+};
+
+__extend__(Node.prototype, EventTarget.prototype);
+
+
+var $events = [{}];
+
+function __addEventListener__(target, type, fn, phase){
+ phase = !!phase?"CAPTURING":"BUBBLING";
+ if ( !target.uuid ) {
+ //console.log('event uuid %s %s', target, target.uuid);
+ target.uuid = $events.length+'';
+ }
+ if ( !$events[target.uuid] ) {
+ //console.log('creating listener for target: %s %s', target, target.uuid);
+ $events[target.uuid] = {};
+ }
+ if ( !$events[target.uuid][type] ){
+ //console.log('creating listener for type: %s %s %s', target, target.uuid, type);
+ $events[target.uuid][type] = {
+ CAPTURING:[],
+ BUBBLING:[]
+ };
+ }
+ if ( $events[target.uuid][type][phase].indexOf( fn ) < 0 ){
+ //console.log('adding event listener %s %s %s %s %s %s', target, target.uuid, type, phase,
+ // $events[target.uuid][type][phase].length, $events[target.uuid][type][phase].indexOf( fn ));
+ //console.log('creating listener for function: %s %s %s', target, target.uuid, phase);
+ $events[target.uuid][type][phase].push( fn );
+ //console.log('adding event listener %s %s %s %s %s %s', target, target.uuid, type, phase,
+ // $events[target.uuid][type][phase].length, $events[target.uuid][type][phase].indexOf( fn ));
+ }
+ //console.log('registered event listeners %s', $events.length);
+}
+
+function __removeEventListener__(target, type, fn, phase){
+
+ phase = !!phase?"CAPTURING":"BUBBLING";
+ if ( !target.uuid ) {
+ return;
+ }
+ if ( !$events[target.uuid] ) {
+ return;
+ }
+ if(type == '*'){
+ //used to clean all event listeners for a given node
+ //console.log('cleaning all event listeners for node %s %s',target, target.uuid);
+ delete $events[target.uuid];
+ return;
+ }else if ( !$events[target.uuid][type] ){
+ return;
+ }
+ $events[target.uuid][type][phase] =
+ $events[target.uuid][type][phase].filter(function(f){
+ //console.log('removing event listener %s %s %s %s', target, type, phase, fn);
+ return f != fn;
+ });
+}
+
+var __eventuuid__ = 0;
+function __dispatchEvent__(target, event, bubbles){
+
+ if (!event.uuid) {
+ event.uuid = __eventuuid__++;
+ }
+ //the window scope defines the $event object, for IE(^^^) compatibility;
+ //$event = event;
+ //console.log('dispatching event %s', event.uuid);
+ if (bubbles === undefined || bubbles === null) {
+ bubbles = true;
+ }
+
+ if (!event.target) {
+ event.target = target;
+ }
+
+ //console.log('dispatching? %s %s %s', target, event.type, bubbles);
+ if ( event.type && (target.nodeType || target === window )) {
+
+ //console.log('dispatching event %s %s %s', target, event.type, bubbles);
+ __captureEvent__(target, event);
+
+ event.eventPhase = Event.AT_TARGET;
+ if ( target.uuid && $events[target.uuid] && $events[target.uuid][event.type] ) {
+ event.currentTarget = target;
+ //console.log('dispatching %s %s %s %s', target, event.type,
+ // $events[target.uuid][event.type]['CAPTURING'].length);
+ $events[target.uuid][event.type].CAPTURING.forEach(function(fn){
+ //console.log('AT_TARGET (CAPTURING) event %s', fn);
+ var returnValue = fn( event );
+ //console.log('AT_TARGET (CAPTURING) return value %s', returnValue);
+ if(returnValue === false){
+ event.stopPropagation();
+ }
+ });
+ //console.log('dispatching %s %s %s %s', target, event.type,
+ // $events[target.uuid][event.type]['BUBBLING'].length);
+ $events[target.uuid][event.type].BUBBLING.forEach(function(fn){
+ //console.log('AT_TARGET (BUBBLING) event %s', fn);
+ var returnValue = fn( event );
+ //console.log('AT_TARGET (BUBBLING) return value %s', returnValue);
+ if(returnValue === false){
+ event.stopPropagation();
+ }
+ });
+ }
+ if (target["on" + event.type]) {
+ target["on" + event.type](event);
+ }
+ if (bubbles && !event.cancelled){
+ __bubbleEvent__(target, event);
+ }
+ if(!event._preventDefault){
+ //At this point I'm guessing that just HTMLEvents are concerned
+ //with default behavior being executed in a browser but I could be
+ //wrong as usual. The goal is much more to filter at this point
+ //what events have no need to be handled
+ //console.log('triggering default behavior for %s', event.type);
+ if(event.type in Envjs.defaultEventBehaviors){
+ Envjs.defaultEventBehaviors[event.type](event);
+ }
+ }
+ //console.log('deleting event %s', event.uuid);
+ event.target = null;
+ event = null;
+ }else{
+ throw new EventException(EventException.UNSPECIFIED_EVENT_TYPE_ERR);
+ }
+}
+
+function __captureEvent__(target, event){
+ var ancestorStack = [],
+ parent = target.parentNode;
+
+ event.eventPhase = Event.CAPTURING_PHASE;
+ while(parent){
+ if(parent.uuid && $events[parent.uuid] && $events[parent.uuid][event.type]){
+ ancestorStack.push(parent);
+ }
+ parent = parent.parentNode;
+ }
+ while(ancestorStack.length && !event.cancelled){
+ event.currentTarget = ancestorStack.pop();
+ if($events[event.currentTarget.uuid] && $events[event.currentTarget.uuid][event.type]){
+ $events[event.currentTarget.uuid][event.type].CAPTURING.forEach(function(fn){
+ var returnValue = fn( event );
+ if(returnValue === false){
+ event.stopPropagation();
+ }
+ });
+ }
+ }
+}
+
+function __bubbleEvent__(target, event){
+ var parent = target.parentNode;
+ event.eventPhase = Event.BUBBLING_PHASE;
+ while(parent){
+ if(parent.uuid && $events[parent.uuid] && $events[parent.uuid][event.type] ){
+ event.currentTarget = parent;
+ $events[event.currentTarget.uuid][event.type].BUBBLING.forEach(function(fn){
+ var returnValue = fn( event );
+ if(returnValue === false){
+ event.stopPropagation();
+ }
+ });
+ }
+ parent = parent.parentNode;
+ }
+}
+
+/**
+ * @class Event
+ */
+Event = function(options){
+ // event state is kept read-only by forcing
+ // a new object for each event. This may not
+ // be appropriate in the long run and we'll
+ // have to decide if we simply dont adhere to
+ // the read-only restriction of the specification
+ this._bubbles = true;
+ this._cancelable = true;
+ this._cancelled = false;
+ this._currentTarget = null;
+ this._target = null;
+ this._eventPhase = Event.AT_TARGET;
+ this._timeStamp = new Date().getTime();
+ this._preventDefault = false;
+ this._stopPropogation = false;
+};
+
+__extend__(Event.prototype,{
+ get bubbles(){return this._bubbles;},
+ get cancelable(){return this._cancelable;},
+ get currentTarget(){return this._currentTarget;},
+ set currentTarget(currentTarget){ this._currentTarget = currentTarget; },
+ get eventPhase(){return this._eventPhase;},
+ set eventPhase(eventPhase){this._eventPhase = eventPhase;},
+ get target(){return this._target;},
+ set target(target){ this._target = target;},
+ get timeStamp(){return this._timeStamp;},
+ get type(){return this._type;},
+ initEvent: function(type, bubbles, cancelable){
+ this._type=type?type:'';
+ this._bubbles=!!bubbles;
+ this._cancelable=!!cancelable;
+ },
+ preventDefault: function(){
+ this._preventDefault = true;
+ },
+ stopPropagation: function(){
+ if(this._cancelable){
+ this._cancelled = true;
+ this._bubbles = false;
+ }
+ },
+ get cancelled(){
+ return this._cancelled;
+ },
+ toString: function(){
+ return '[object Event]';
+ }
+});
+
+__extend__(Event,{
+ CAPTURING_PHASE : 1,
+ AT_TARGET : 2,
+ BUBBLING_PHASE : 3
+});
+
+
+
+/**
+ * @name UIEvent
+ * @param {Object} options
+ */
+UIEvent = function(options) {
+ this._view = null;
+ this._detail = 0;
+};
+
+UIEvent.prototype = new Event();
+__extend__(UIEvent.prototype,{
+ get view(){
+ return this._view;
+ },
+ get detail(){
+ return this._detail;
+ },
+ initUIEvent: function(type, bubbles, cancelable, windowObject, detail){
+ this.initEvent(type, bubbles, cancelable);
+ this._detail = 0;
+ this._view = windowObject;
+ }
+});
+
+var $onblur,
+ $onfocus,
+ $onresize;
+
+
+/**
+ * @name MouseEvent
+ * @w3c:domlevel 2
+ * @uri http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html
+ */
+MouseEvent = function(options) {
+ this._screenX= 0;
+ this._screenY= 0;
+ this._clientX= 0;
+ this._clientY= 0;
+ this._ctrlKey= false;
+ this._metaKey= false;
+ this._altKey= false;
+ this._button= null;
+ this._relatedTarget= null;
+};
+MouseEvent.prototype = new UIEvent();
+__extend__(MouseEvent.prototype,{
+ get screenX(){
+ return this._screenX;
+ },
+ get screenY(){
+ return this._screenY;
+ },
+ get clientX(){
+ return this._clientX;
+ },
+ get clientY(){
+ return this._clientY;
+ },
+ get ctrlKey(){
+ return this._ctrlKey;
+ },
+ get altKey(){
+ return this._altKey;
+ },
+ get shiftKey(){
+ return this._shiftKey;
+ },
+ get metaKey(){
+ return this._metaKey;
+ },
+ get button(){
+ return this._button;
+ },
+ get relatedTarget(){
+ return this._relatedTarget;
+ },
+ initMouseEvent: function(type, bubbles, cancelable, windowObject, detail,
+ screenX, screenY, clientX, clientY, ctrlKey, altKey, shiftKey,
+ metaKey, button, relatedTarget){
+ this.initUIEvent(type, bubbles, cancelable, windowObject, detail);
+ this._screenX = screenX;
+ this._screenY = screenY;
+ this._clientX = clientX;
+ this._clientY = clientY;
+ this._ctrlKey = ctrlKey;
+ this._altKey = altKey;
+ this._shiftKey = shiftKey;
+ this._metaKey = metaKey;
+ this._button = button;
+ this._relatedTarget = relatedTarget;
+ }
+});
+
+/**
+ * Interface KeyboardEvent (introduced in DOM Level 3)
+ */
+KeyboardEvent = function(options) {
+ this._keyIdentifier = 0;
+ this._keyLocation = 0;
+ this._ctrlKey = false;
+ this._metaKey = false;
+ this._altKey = false;
+ this._metaKey = false;
+};
+KeyboardEvent.prototype = new UIEvent();
+
+__extend__(KeyboardEvent.prototype,{
+
+ get ctrlKey(){
+ return this._ctrlKey;
+ },
+ get altKey(){
+ return this._altKey;
+ },
+ get shiftKey(){
+ return this._shiftKey;
+ },
+ get metaKey(){
+ return this._metaKey;
+ },
+ get button(){
+ return this._button;
+ },
+ get relatedTarget(){
+ return this._relatedTarget;
+ },
+ getModifiersState: function(keyIdentifier){
+
+ },
+ initMouseEvent: function(type, bubbles, cancelable, windowObject,
+ keyIdentifier, keyLocation, modifiersList, repeat){
+ this.initUIEvent(type, bubbles, cancelable, windowObject, 0);
+ this._keyIdentifier = keyIdentifier;
+ this._keyLocation = keyLocation;
+ this._modifiersList = modifiersList;
+ this._repeat = repeat;
+ }
+});
+
+KeyboardEvent.DOM_KEY_LOCATION_STANDARD = 0;
+KeyboardEvent.DOM_KEY_LOCATION_LEFT = 1;
+KeyboardEvent.DOM_KEY_LOCATION_RIGHT = 2;
+KeyboardEvent.DOM_KEY_LOCATION_NUMPAD = 3;
+KeyboardEvent.DOM_KEY_LOCATION_MOBILE = 4;
+KeyboardEvent.DOM_KEY_LOCATION_JOYSTICK = 5;
+
+
+
+//We dont fire mutation events until someone has registered for them
+var __supportedMutations__ = /DOMSubtreeModified|DOMNodeInserted|DOMNodeRemoved|DOMAttrModified|DOMCharacterDataModified/;
+
+var __fireMutationEvents__ = Aspect.before({
+ target: EventTarget,
+ method: 'addEventListener'
+}, function(target, type){
+ if(type && type.match(__supportedMutations__)){
+ //unweaving removes the __addEventListener__ aspect
+ __fireMutationEvents__.unweave();
+ // These two methods are enough to cover all dom 2 manipulations
+ Aspect.around({
+ target: Node,
+ method:"removeChild"
+ }, function(invocation){
+ var event,
+ node = invocation.arguments[0];
+ event = node.ownerDocument.createEvent('MutationEvents');
+ event.initEvent('DOMNodeRemoved', true, false, node.parentNode, null, null, null, null);
+ node.dispatchEvent(event, false);
+ return invocation.proceed();
+
+ });
+ Aspect.around({
+ target: Node,
+ method:"appendChild"
+ }, function(invocation) {
+ var event,
+ node = invocation.proceed();
+ event = node.ownerDocument.createEvent('MutationEvents');
+ event.initEvent('DOMNodeInserted', true, false, node.parentNode, null, null, null, null);
+ node.dispatchEvent(event, false);
+ return node;
+ });
+ }
+});
+
+/**
+ * @name MutationEvent
+ * @param {Object} options
+ */
+MutationEvent = function(options) {
+ this._cancelable = false;
+ this._timeStamp = 0;
+};
+
+MutationEvent.prototype = new Event();
+__extend__(MutationEvent.prototype,{
+ get relatedNode(){
+ return this._relatedNode;
+ },
+ get prevValue(){
+ return this._prevValue;
+ },
+ get newValue(){
+ return this._newValue;
+ },
+ get attrName(){
+ return this._attrName;
+ },
+ get attrChange(){
+ return this._attrChange;
+ },
+ initMutationEvent: function( type, bubbles, cancelable,
+ relatedNode, prevValue, newValue, attrName, attrChange ){
+ this._relatedNode = relatedNode;
+ this._prevValue = prevValue;
+ this._newValue = newValue;
+ this._attrName = attrName;
+ this._attrChange = attrChange;
+ switch(type){
+ case "DOMSubtreeModified":
+ this.initEvent(type, true, false);
+ break;
+ case "DOMNodeInserted":
+ this.initEvent(type, true, false);
+ break;
+ case "DOMNodeRemoved":
+ this.initEvent(type, true, false);
+ break;
+ case "DOMNodeRemovedFromDocument":
+ this.initEvent(type, false, false);
+ break;
+ case "DOMNodeInsertedIntoDocument":
+ this.initEvent(type, false, false);
+ break;
+ case "DOMAttrModified":
+ this.initEvent(type, true, false);
+ break;
+ case "DOMCharacterDataModified":
+ this.initEvent(type, true, false);
+ break;
+ default:
+ this.initEvent(type, bubbles, cancelable);
+ }
+ }
+});
+
+// constants
+MutationEvent.ADDITION = 0;
+MutationEvent.MODIFICATION = 1;
+MutationEvent.REMOVAL = 2;
+
+
+/**
+ * @name EventException
+ */
+EventException = function(code) {
+ this.code = code;
+};
+EventException.UNSPECIFIED_EVENT_TYPE_ERR = 0;
+/**
+ *
+ * DOM Level 2: http://www.w3.org/TR/DOM-Level-2-Events/events.html
+ * DOM Level 3: http://www.w3.org/TR/DOM-Level-3-Events/
+ *
+ * interface DocumentEvent {
+ * Event createEvent (in DOMString eventType)
+ * raises (DOMException);
+ * };
+ *
+ * Firefox (3.6) exposes DocumentEvent
+ * Safari (4) does NOT.
+ */
+
+/**
+ * TODO: Not sure we need a full prototype. We not just an regular object?
+ */
+DocumentEvent = function(){};
+DocumentEvent.prototype.__EventMap__ = {
+ // Safari4: singular and plural forms accepted
+ // Firefox3.6: singular and plural forms accepted
+ 'Event' : Event,
+ 'Events' : Event,
+ 'UIEvent' : UIEvent,
+ 'UIEvents' : UIEvent,
+ 'MouseEvent' : MouseEvent,
+ 'MouseEvents' : MouseEvent,
+ 'MutationEvent' : MutationEvent,
+ 'MutationEvents' : MutationEvent,
+
+ // Safari4: accepts HTMLEvents, but not HTMLEvent
+ // Firefox3.6: accepts HTMLEvents, but not HTMLEvent
+ 'HTMLEvent' : Event,
+ 'HTMLEvents' : Event,
+
+ // Safari4: both not accepted
+ // Firefox3.6, only KeyEvents is accepted
+ 'KeyEvent' : KeyboardEvent,
+ 'KeyEvents' : KeyboardEvent,
+
+ // Safari4: both accepted
+ // Firefox3.6: none accepted
+ 'KeyboardEvent' : KeyboardEvent,
+ 'KeyboardEvents' : KeyboardEvent
+};
+
+DocumentEvent.prototype.createEvent = function(eventType) {
+ var Clazz = this.__EventMap__[eventType];
+ if (Clazz) {
+ return new Clazz();
+ }
+ throw(new DOMException(DOMException.NOT_SUPPORTED_ERR));
+};
+
+__extend__(Document.prototype, DocumentEvent.prototype);
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+
+/*
+ * Envjs timer.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ *
+ * Parts of the implementation were originally written by:\
+ * Steven Parkes
+ *
+ * requires Envjs.wait, Envjs.sleep, Envjs.WAIT_INTERVAL
+ */
+var setTimeout,
+ clearTimeout,
+ setInterval,
+ clearInterval;
+
+/*
+ * Envjs timer.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+/*
+* timer.js
+* implementation provided by Steven Parkes
+*/
+
+//private
+var $timers = [],
+ EVENT_LOOP_RUNNING = false;
+
+$timers.lock = function(fn){
+ Envjs.sync(fn)();
+};
+
+//private internal class
+var Timer = function(fn, interval){
+ this.fn = fn;
+ this.interval = interval;
+ this.at = Date.now() + interval;
+ // allows for calling wait() from callbacks
+ this.running = false;
+};
+
+Timer.prototype.start = function(){};
+Timer.prototype.stop = function(){};
+
+//static
+Timer.normalize = function(time) {
+ time = time*1;
+ if ( isNaN(time) || time < 0 ) {
+ time = 0;
+ }
+
+ if ( EVENT_LOOP_RUNNING && time < Timer.MIN_TIME ) {
+ time = Timer.MIN_TIME;
+ }
+ return time;
+};
+// html5 says this should be at least 4, but the parser is using
+// a setTimeout for the SAX stuff which messes up the world
+Timer.MIN_TIME = /* 4 */ 0;
+
+/**
+ * @function setTimeout
+ * @param {Object} fn
+ * @param {Object} time
+ */
+setTimeout = function(fn, time){
+ var num;
+ time = Timer.normalize(time);
+ $timers.lock(function(){
+ num = $timers.length+1;
+ var tfn;
+ if (typeof fn == 'string') {
+ tfn = function() {
+ try {
+ // eval in global scope
+ eval(fn, null);
+ } catch (e) {
+ console.log('timer error %s %s', fn, e);
+ } finally {
+ clearInterval(num);
+ }
+ };
+ } else {
+ tfn = function() {
+ try {
+ fn();
+ } catch (e) {
+ console.log('timer error %s %s', fn, e);
+ } finally {
+ clearInterval(num);
+ }
+ };
+ }
+ //console.log("Creating timer number %s", num);
+ $timers[num] = new Timer(tfn, time);
+ $timers[num].start();
+ });
+ return num;
+};
+
+/**
+ * @function setInterval
+ * @param {Object} fn
+ * @param {Object} time
+ */
+setInterval = function(fn, time){
+ //console.log('setting interval %s %s', time, fn.toString().substring(0,64));
+ time = Timer.normalize(time);
+ if ( time < 10 ) {
+ time = 10;
+ }
+ if (typeof fn == 'string') {
+ var fnstr = fn;
+ fn = function() {
+ eval(fnstr);
+ };
+ }
+ var num;
+ $timers.lock(function(){
+ num = $timers.length+1;
+ //Envjs.debug("Creating timer number "+num);
+ $timers[num] = new Timer(fn, time);
+ $timers[num].start();
+ });
+ return num;
+};
+
+/**
+ * clearInterval
+ * @param {Object} num
+ */
+clearInterval = clearTimeout = function(num){
+ //console.log("clearing interval "+num);
+ $timers.lock(function(){
+ if ( $timers[num] ) {
+ $timers[num].stop();
+ delete $timers[num];
+ }
+ });
+};
+
+// wait === null/undefined: execute any timers as they fire,
+// waiting until there are none left
+// wait(n) (n > 0): execute any timers as they fire until there
+// are none left waiting at least n ms but no more, even if there
+// are future events/current threads
+// wait(0): execute any immediately runnable timers and return
+// wait(-n): keep sleeping until the next event is more than n ms
+// in the future
+//
+// TODO: make a priority queue ...
+
+Envjs.wait = function(wait) {
+ //console.log('wait %s', wait);
+ var delta_wait,
+ start = Date.now(),
+ was_running = EVENT_LOOP_RUNNING;
+
+ if (wait < 0) {
+ delta_wait = -wait;
+ wait = 0;
+ }
+ EVENT_LOOP_RUNNING = true;
+ if (wait !== 0 && wait !== null && wait !== undefined){
+ wait += Date.now();
+ }
+
+ var earliest,
+ timer,
+ sleep,
+ index,
+ goal,
+ now,
+ nextfn;
+
+ for (;;) {
+ //console.log('timer loop');
+ earliest = sleep = goal = now = nextfn = null;
+ $timers.lock(function(){
+ for(index in $timers){
+ if( isNaN(index*0) ) {
+ continue;
+ }
+ timer = $timers[index];
+ // determine timer with smallest run-at time that is
+ // not already running
+ if( !timer.running && ( !earliest || timer.at < earliest.at) ) {
+ earliest = timer;
+ }
+ }
+ });
+ //next sleep time
+ sleep = earliest && earliest.at - Date.now();
+ if ( earliest && sleep <= 0 ) {
+ nextfn = earliest.fn;
+ try {
+ //console.log('running stack %s', nextfn.toString().substring(0,64));
+ earliest.running = true;
+ nextfn();
+ } catch (e) {
+ console.log('timer error %s %s', nextfn, e);
+ } finally {
+ earliest.running = false;
+ }
+ goal = earliest.at + earliest.interval;
+ now = Date.now();
+ if ( goal < now ) {
+ earliest.at = now;
+ } else {
+ earliest.at = goal;
+ }
+ continue;
+ }
+
+ // bunch of subtle cases here ...
+ if ( !earliest ) {
+ // no events in the queue (but maybe XHR will bring in events, so ...
+ if ( !wait || wait < Date.now() ) {
+ // Loop ends if there are no events and a wait hasn't been
+ // requested or has expired
+ break;
+ }
+ // no events, but a wait requested: fall through to sleep
+ } else {
+ // there are events in the queue, but they aren't firable now
+ /*if ( delta_wait && sleep <= delta_wait ) {
+ //TODO: why waste a check on a tight
+ // loop if it just falls through?
+ // if they will happen within the next delta, fall through to sleep
+ } else */if ( wait === 0 || ( wait > 0 && wait < Date.now () ) ) {
+ // loop ends even if there are events but the user
+ // specifcally asked not to wait too long
+ break;
+ }
+ // there are events and the user wants to wait: fall through to sleep
+ }
+
+ // Related to ajax threads ... hopefully can go away ..
+ var interval = Envjs.WAIT_INTERVAL || 100;
+ if ( !sleep || sleep > interval ) {
+ sleep = interval;
+ }
+ //console.log('sleeping %s', sleep);
+ Envjs.sleep(sleep);
+
+ }
+ EVENT_LOOP_RUNNING = was_running;
+};
+
+
+/**
+ * @author john resig & the envjs team
+ * @uri http://www.envjs.com/
+ * @copyright 2008-2010
+ * @license MIT
+ */
+//CLOSURE_END
+}());
+/*
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ *
+ * This file simply provides the global definitions we need to
+ * be able to correctly implement to core browser DOM HTML interfaces.
+ */
+var HTMLDocument,
+ HTMLElement,
+ HTMLCollection,
+ HTMLAnchorElement,
+ HTMLAreaElement,
+ HTMLBaseElement,
+ HTMLQuoteElement,
+ HTMLBodyElement,
+ HTMLBRElement,
+ HTMLButtonElement,
+ HTMLCanvasElement,
+ HTMLTableColElement,
+ HTMLModElement,
+ HTMLDivElement,
+ HTMLDListElement,
+ HTMLFieldSetElement,
+ HTMLFormElement,
+ HTMLFrameElement,
+ HTMLFrameSetElement,
+ HTMLHeadElement,
+ HTMLHeadingElement,
+ HTMLHRElement,
+ HTMLHtmlElement,
+ HTMLIFrameElement,
+ HTMLImageElement,
+ HTMLInputElement,
+ HTMLLabelElement,
+ HTMLLegendElement,
+ HTMLLIElement,
+ HTMLLinkElement,
+ HTMLMapElement,
+ HTMLMetaElement,
+ HTMLObjectElement,
+ HTMLOListElement,
+ HTMLOptGroupElement,
+ HTMLOptionElement,
+ HTMLParagraphElement,
+ HTMLParamElement,
+ HTMLPreElement,
+ HTMLScriptElement,
+ HTMLSelectElement,
+ HTMLSpanElement,
+ HTMLStyleElement,
+ HTMLTableElement,
+ HTMLTableSectionElement,
+ HTMLTableCellElement,
+ HTMLTableDataCellElement,
+ HTMLTableHeaderCellElement,
+ HTMLTableRowElement,
+ HTMLTextAreaElement,
+ HTMLTitleElement,
+ HTMLUListElement,
+ HTMLUnknownElement,
+ Image,
+ Option,
+ __loadImage__,
+ __loadLink__;
+
+/*
+ * Envjs html.1.2.13
+ * Pure JavaScript Browser Environment
+ * By John Resig and the Envjs Team
+ * Copyright 2008-2010 John Resig, under the MIT License
+ */
+
+//CLOSURE_START
+(function(){
+
+
+
+
+
+/**
+ * @author ariel flesler
+ * http://flesler.blogspot.com/2008/11/fast-trim-function-for-javascript.html
+ * @param {Object} str
+ */
+function __trim__( str ){
+ return (str || "").replace( /^\s+|\s+$/g, "" );
+}
+
+
+/**
+ * @author john resig
+ */
+// Helper method for extending one object with another.
+function __extend__(a,b) {
+ for ( var i in b ) {
+ var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
+ if ( g || s ) {
+ if ( g ) { a.__defineGetter__(i, g); }
+ if ( s ) { a.__defineSetter__(i, s); }
+ } else {
+ a[i] = b[i];
+ }
+ } return a;
+}
+
+/**
+ * @author john resig
+ */
+//from jQuery
+function __setArray__( target, array ) {
+ // Resetting the length to 0, then using the native Array push
+ // is a super-fast way to populate an object with array-like properties
+ target.length = 0;
+ Array.prototype.push.apply( target, array );
+}
+
+/**
+ * @class HTMLDocument
+ * The Document interface represents the entire HTML or XML document.
+ * Conceptually, it is the root of the document tree, and provides
+ * the primary access to the document's data.
+ *
+ * @extends Document
+ */
+HTMLDocument = function(implementation, ownerWindow, referrer) {
+ Document.apply(this, arguments);
+ this.referrer = referrer || '';
+ this.baseURI = "about:blank";
+ this.ownerWindow = ownerWindow;
+};
+
+HTMLDocument.prototype = new Document();
+
+__extend__(HTMLDocument.prototype, {
+ createElement: function(tagName){
+ var node;
+ tagName = tagName.toUpperCase();
+ // create Element specifying 'this' as ownerDocument
+ // This is an html document so we need to use explicit interfaces per the
+ //TODO: would be much faster as a big switch
+ switch(tagName){
+ case "A":
+ node = new HTMLAnchorElement(this);break;
+ case "AREA":
+ node = new HTMLAreaElement(this);break;
+ case "BASE":
+ node = new HTMLBaseElement(this);break;
+ case "BLOCKQUOTE":
+ node = new HTMLQuoteElement(this);break;
+ case "CANVAS":
+ node = new HTMLCanvasElement(this);break;
+ case "Q":
+ node = new HTMLQuoteElement(this);break;
+ case "BODY":
+ node = new HTMLBodyElement(this);break;
+ case "BR":
+ node = new HTMLBRElement(this);break;
+ case "BUTTON":
+ node = new HTMLButtonElement(this);break;
+ case "CAPTION":
+ node = new HTMLElement(this);break;
+ case "COL":
+ node = new HTMLTableColElement(this);break;
+ case "COLGROUP":
+ node = new HTMLTableColElement(this);break;
+ case "DEL":
+ node = new HTMLModElement(this);break;
+ case "INS":
+ node = new HTMLModElement(this);break;
+ case "DIV":
+ node = new HTMLDivElement(this);break;
+ case "DL":
+ node = new HTMLDListElement(this);break;
+ case "DT":
+ node = new HTMLElement(this); break;
+ case "FIELDSET":
+ node = new HTMLFieldSetElement(this);break;
+ case "FORM":
+ node = new HTMLFormElement(this);break;
+ case "FRAME":
+ node = new HTMLFrameElement(this);break;
+ case "H1":
+ node = new HTMLHeadingElement(this);break;
+ case "H2":
+ node = new HTMLHeadingElement(this);break;
+ case "H3":
+ node = new HTMLHeadingElement(this);break;
+ case "H4":
+ node = new HTMLHeadingElement(this);break;
+ case "H5":
+ node = new HTMLHeadingElement(this);break;
+ case "H6":
+ node = new HTMLHeadingElement(this);break;
+ case "HEAD":
+ node = new HTMLHeadElement(this);break;
+ case "HR":
+ node = new HTMLHRElement(this);break;
+ case "HTML":
+ node = new HTMLHtmlElement(this);break;
+ case "IFRAME":
+ node = new HTMLIFrameElement(this);break;
+ case "IMG":
+ node = new HTMLImageElement(this);break;
+ case "INPUT":
+ node = new HTMLInputElement(this);break;
+ case "LABEL":
+ node = new HTMLLabelElement(this);break;
+ case "LEGEND":
+ node = new HTMLLegendElement(this);break;
+ case "LI":
+ node = new HTMLLIElement(this);break;
+ case "LINK":
+ node = new HTMLLinkElement(this);break;
+ case "MAP":
+ node = new HTMLMapElement(this);break;
+ case "META":
+ node = new HTMLMetaElement(this);break;
+ case "NOSCRIPT":
+ node = new HTMLElement(this);break;
+ case "OBJECT":
+ node = new HTMLObjectElement(this);break;
+ case "OPTGROUP":
+ node = new HTMLOptGroupElement(this);break;
+ case "OL":
+ node = new HTMLOListElement(this); break;
+ case "OPTION":
+ node = new HTMLOptionElement(this);break;
+ case "P":
+ node = new HTMLParagraphElement(this);break;
+ case "PARAM":
+ node = new HTMLParamElement(this);break;
+ case "PRE":
+ node = new HTMLPreElement(this);break;
+ case "SCRIPT":
+ node = new HTMLScriptElement(this);break;
+ case "SELECT":
+ node = new HTMLSelectElement(this);break;
+ case "SMALL":
+ node = new HTMLElement(this);break;
+ case "SPAN":
+ node = new HTMLSpanElement(this);break;
+ case "STRONG":
+ node = new HTMLElement(this);break;
+ case "STYLE":
+ node = new HTMLStyleElement(this);break;
+ case "TABLE":
+ node = new HTMLTableElement(this);break;
+ case "TBODY":
+ node = new HTMLTableSectionElement(this);break;
+ case "TFOOT":
+ node = new HTMLTableSectionElement(this);break;
+ case "THEAD":
+ node = new HTMLTableSectionElement(this);break;
+ case "TD":
+ node = new HTMLTableDataCellElement(this);break;
+ case "TH":
+ node = new HTMLTableHeaderCellElement(this);break;
+ case "TEXTAREA":
+ node = new HTMLTextAreaElement(this);break;
+ case "TITLE":
+ node = new HTMLTitleElement(this);break;
+ case "TR":
+ node = new HTMLTableRowElement(this);break;
+ case "UL":
+ node = new HTMLUListElement(this);break;
+ default:
+ node = new HTMLUnknownElement(this);
+ }
+ // assign values to properties (and aliases)
+ node.nodeName = tagName;
+ return node;
+ },
+ createElementNS : function (uri, local) {
+ //print('createElementNS :'+uri+" "+local);
+ if(!uri){
+ return this.createElement(local);
+ }else if ("http://www.w3.org/1999/xhtml" == uri) {
+ return this.createElement(local);
+ } else if ("http://www.w3.org/1998/Math/MathML" == uri) {
+ return this.createElement(local);
+ } else {
+ return Document.prototype.createElementNS.apply(this,[uri, local]);
+ }
+ },
+ get anchors(){
+ return new HTMLCollection(this.getElementsByTagName('a'));
+ },
+ get applets(){
+ return new HTMLCollection(this.getElementsByTagName('applet'));
+ },
+ get documentElement(){
+ var html = Document.prototype.__lookupGetter__('documentElement').apply(this,[]);
+ if( html === null){
+ html = this.createElement('html');
+ this.appendChild(html);
+ html.appendChild(this.createElement('head'));
+ html.appendChild(this.createElement('body'));
+ }
+ return html;
+ },
+ //document.head is non-standard
+ get head(){
+ //console.log('get head');
+ if (!this.documentElement) {
+ this.appendChild(this.createElement('html'));
+ }
+ var element = this.documentElement,
+ length = element.childNodes.length,
+ i;
+ //check for the presence of the head element in this html doc
+ for(i=0;i1?matches[1]:"";
+ },
+ set domain(value){
+ var i,
+ domainParts = this.domain.split('.').reverse(),
+ newDomainParts = value.split('.').reverse();
+ if(newDomainParts.length > 1){
+ for(i=0;i 0){
+ event = doc.createEvent('HTMLEvents');
+ event.initEvent( okay ? "load" : "error", false, false );
+ node.dispatchEvent( event, false );
+ }
+ }catch(e){
+ console.log('error loading html element %s %e', node, e.toString());
+ }
+ }
+ break;
+ case 'frame':
+ case 'iframe':
+ node.contentWindow = { };
+ node.contentDocument = new HTMLDocument(new DOMImplementation(), node.contentWindow);
+ node.contentWindow.document = node.contentDocument;
+ try{
+ Window;
+ }catch(e){
+ node.contentDocument.addEventListener('DOMContentLoaded', function(){
+ event = node.contentDocument.createEvent('HTMLEvents');
+ event.initEvent("load", false, false);
+ node.dispatchEvent( event, false );
+ });
+ }
+ try{
+ if (node.src && node.src.length > 0){
+ //console.log("getting content document for (i)frame from %s", node.src);
+ Envjs.loadFrame(node, Envjs.uri(node.src));
+ event = node.contentDocument.createEvent('HTMLEvents');
+ event.initEvent("load", false, false);
+ node.dispatchEvent( event, false );
+ }else{
+ //I dont like this being here:
+ //TODO: better mix-in strategy so the try/catch isnt required
+ try{
+ if(Window){
+ Envjs.loadFrame(node);
+ //console.log('src/html/document.js: triggering frame load');
+ event = node.contentDocument.createEvent('HTMLEvents');
+ event.initEvent("load", false, false);
+ node.dispatchEvent( event, false );
+ }
+ }catch(e){}
+ }
+ }catch(e){
+ console.log('error loading html element %s %e', node, e.toString());
+ }
+ break;
+
+ case 'link':
+ if (node.href && node.href.length > 0) {
+ __loadLink__(node, node.href);
+ }
+ break;
+ /*
+ case 'img':
+ if (node.src && node.src.length > 0){
+ // don't actually load anything, so we're "done" immediately:
+ event = doc.createEvent('HTMLEvents');
+ event.initEvent("load", false, false);
+ node.dispatchEvent( event, false );
+ }
+ break;
+ */
+ case 'option':
+ node._updateoptions();
+ break;
+ default:
+ if(node.getAttribute('onload')){
+ console.log('calling attribute onload %s | %s', node.onload, node.tagName);
+ node.onload();
+ }
+ break;
+ }//switch on name
+ default:
+ break;
+ }//switch on ns
+ break;
+ default:
+ // console.log('element appended: %s %s', node+'', node.namespaceURI);
+ }//switch on doc.parsing
+ return node;
+
+});
+
+Aspect.around({
+ target: Node,
+ method:"removeChild"
+}, function(invocation) {
+ var event,
+ okay,
+ node = invocation.proceed(),
+ doc = node.ownerDocument;
+ if((node.nodeType !== Node.ELEMENT_NODE)){
+ //for now we are only handling element insertions. probably we will need
+ //to handle text node changes to script tags and changes to src
+ //attributes
+ if(node.nodeType !== Node.DOCUMENT_NODE && node.uuid){
+ //console.log('removing event listeners, %s', node, node.uuid);
+ node.removeEventListener('*', null, null);
+ }
+ return node;
+ }
+ //console.log('appended html element %s %s %s', node.namespaceURI, node.nodeName, node);
+
+ switch(doc.parsing){
+ case true:
+ //handled by parser if included
+ break;
+ case false:
+ switch(node.namespaceURI){
+ case null:
+ //fall through
+ case "":
+ //fall through
+ case "http://www.w3.org/1999/xhtml":
+ //this is interesting dillema since our event engine is
+ //storing the registered events in an array accessed
+ //by the uuid property of the node. unforunately this
+ //means listeners hang out way after(forever ;)) the node
+ //has been removed and gone out of scope.
+ //console.log('removing event listeners, %s', node, node.uuid);
+ node.removeEventListener('*', null, null);
+ switch(node.tagName.toLowerCase()){
+ case 'frame':
+ case 'iframe':
+ try{
+ //console.log('removing iframe document');
+ try{
+ Envjs.unloadFrame(node);
+ }catch(e){
+ console.log('error freeing resources from frame %s', e);
+ }
+ node.contentWindow = null;
+ node.contentDocument = null;
+ }catch(e){
+ console.log('error unloading html element %s %e', node, e.toString());
+ }
+ break;
+ default:
+ break;
+ }//switch on name
+ default:
+ break;
+ }//switch on ns
+ break;
+ default:
+ console.log('element appended: %s %s', node+'', node.namespaceURI);
+ }//switch on doc.parsing
+ return node;
+
+});
+
+
+
+/**
+ * Named Element Support
+ *
+ *
+ */
+
+/*
+ *
+ * @returns 'name' if the node has a appropriate name
+ * null if node does not have a name
+ */
+
+var __isNamedElement__ = function(node) {
+ if (node.nodeType !== Node.ELEMENT_NODE) {
+ return null;
+ }
+ var tagName = node.tagName.toLowerCase();
+ var nodename = null;
+
+ switch (tagName) {
+ case 'embed':
+ case 'form':
+ case 'iframe':
+ nodename = node.getAttribute('name');
+ break;
+ case 'applet':
+ nodename = node.id;
+ break;
+ case 'object':
+ // TODO: object needs to be 'fallback free'
+ nodename = node.id;
+ break;
+ case 'img':
+ nodename = node.id;
+ if (!nodename || ! node.getAttribute('name')) {
+ nodename = null;
+ }
+ break;
+ }
+ return (nodename) ? nodename : null;
+};
+
+
+var __addNamedMap__ = function(target, node) {
+ var nodename = __isNamedElement__(node);
+ if (nodename) {
+ target.__defineGetter__(nodename, function() {
+ return node;
+ });
+ }
+};
+
+var __removeNamedMap__ = function(target, node) {
+ if (!node) {
+ return;
+ }
+ var nodename = __isNamedElement__(node);
+ if (nodename) {
+ delete target[nodename];
+ }
+};
+
+/**
+ * @name HTMLEvents
+ * @w3c:domlevel 2
+ * @uri http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html
+ */
+
+var __eval__ = function(script, node){
+ if (!script == ""){
+ // don't assemble environment if no script...
+ try{
+ eval(script);
+ }catch(e){
+ console.log('error evaluating %s', e);
+ }
+ }
+};
+
+var HTMLEvents= function(){};
+HTMLEvents.prototype = {
+ onload: function(event){
+ __eval__(this.getAttribute('onload')||'', this);
+ },
+ onunload: function(event){
+ __eval__(this.getAttribute('onunload')||'', this);
+ },
+ onabort: function(event){
+ __eval__(this.getAttribute('onabort')||'', this);
+ },
+ onerror: function(event){
+ __eval__(this.getAttribute('onerror')||'', this);
+ },
+ onselect: function(event){
+ __eval__(this.getAttribute('onselect')||'', this);
+ },
+ onchange: function(event){
+ __eval__(this.getAttribute('onchange')||'', this);
+ },
+ onsubmit: function(event){
+ if (__eval__(this.getAttribute('onsubmit')||'', this)) {
+ this.submit();
+ }
+ },
+ onreset: function(event){
+ __eval__(this.getAttribute('onreset')||'', this);
+ },
+ onfocus: function(event){
+ __eval__(this.getAttribute('onfocus')||'', this);
+ },
+ onblur: function(event){
+ __eval__(this.getAttribute('onblur')||'', this);
+ },
+ onresize: function(event){
+ __eval__(this.getAttribute('onresize')||'', this);
+ },
+ onscroll: function(event){
+ __eval__(this.getAttribute('onscroll')||'', this);
+ }
+};
+
+//HTMLDocument, HTMLFramesetElement, HTMLObjectElement
+var __load__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("load", false, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HTMLFramesetElement, HTMLBodyElement
+var __unload__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("unload", false, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HTMLObjectElement
+var __abort__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("abort", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HTMLFramesetElement, HTMLObjectElement, HTMLBodyElement
+var __error__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("error", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HTMLInputElement, HTMLTextAreaElement
+var __select__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("select", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement
+var __change__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("change", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HtmlFormElement
+var __submit__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("submit", true, true);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//HtmlFormElement
+var __reset__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("reset", false, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//LABEL, INPUT, SELECT, TEXTAREA, and BUTTON
+var __focus__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("focus", false, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//LABEL, INPUT, SELECT, TEXTAREA, and BUTTON
+var __blur__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("blur", false, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//Window
+var __resize__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("resize", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+//Window
+var __scroll__ = function(element){
+ var event = new Event('HTMLEvents');
+ event.initEvent("scroll", true, false);
+ element.dispatchEvent(event);
+ return event;
+};
+
+/**
+ * @name KeyboardEvents
+ * @w3c:domlevel 2
+ * @uri http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html
+ */
+var KeyboardEvents= function(){};
+KeyboardEvents.prototype = {
+ onkeydown: function(event){
+ __eval__(this.getAttribute('onkeydown')||'', this);
+ },
+ onkeypress: function(event){
+ __eval__(this.getAttribute('onkeypress')||'', this);
+ },
+ onkeyup: function(event){
+ __eval__(this.getAttribute('onkeyup')||'', this);
+ }
+};
+
+
+var __registerKeyboardEventAttrs__ = function(elm){
+ if(elm.hasAttribute('onkeydown')){
+ elm.addEventListener('keydown', elm.onkeydown, false);
+ }
+ if(elm.hasAttribute('onkeypress')){
+ elm.addEventListener('keypress', elm.onkeypress, false);
+ }
+ if(elm.hasAttribute('onkeyup')){
+ elm.addEventListener('keyup', elm.onkeyup, false);
+ }
+ return elm;
+};
+
+//HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement
+var __keydown__ = function(element){
+ var event = new Event('KeyboardEvents');
+ event.initEvent("keydown", false, false);
+ element.dispatchEvent(event);
+};
+
+//HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement
+var __keypress__ = function(element){
+ var event = new Event('KeyboardEvents');
+ event.initEvent("keypress", false, false);
+ element.dispatchEvent(event);
+};
+
+//HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement
+var __keyup__ = function(element){
+ var event = new Event('KeyboardEvents');
+ event.initEvent("keyup", false, false);
+ element.dispatchEvent(event);
+};
+
+/**
+ * @name MaouseEvents
+ * @w3c:domlevel 2
+ * @uri http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html
+ */
+var MouseEvents= function(){};
+MouseEvents.prototype = {
+ onclick: function(event){
+ __eval__(this.getAttribute('onclick')||'', this);
+ },
+ ondblclick: function(event){
+ __eval__(this.getAttribute('ondblclick')||'', this);
+ },
+ onmousedown: function(event){
+ __eval__(this.getAttribute('onmousedown')||'', this);
+ },
+ onmousemove: function(event){
+ __eval__(this.getAttribute('onmousemove')||'', this);
+ },
+ onmouseout: function(event){
+ __eval__(this.getAttribute('onmouseout')||'', this);
+ },
+ onmouseover: function(event){
+ __eval__(this.getAttribute('onmouseover')||'', this);
+ },
+ onmouseup: function(event){
+ __eval__(this.getAttribute('onmouseup')||'', this);
+ }
+};
+
+var __registerMouseEventAttrs__ = function(elm){
+ if(elm.hasAttribute('onclick')){
+ elm.addEventListener('click', elm.onclick, false);
+ }
+ if(elm.hasAttribute('ondblclick')){
+ elm.addEventListener('dblclick', elm.ondblclick, false);
+ }
+ if(elm.hasAttribute('onmousedown')){
+ elm.addEventListener('mousedown', elm.onmousedown, false);
+ }
+ if(elm.hasAttribute('onmousemove')){
+ elm.addEventListener('mousemove', elm.onmousemove, false);
+ }
+ if(elm.hasAttribute('onmouseout')){
+ elm.addEventListener('mouseout', elm.onmouseout, false);
+ }
+ if(elm.hasAttribute('onmouseover')){
+ elm.addEventListener('mouseover', elm.onmouseover, false);
+ }
+ if(elm.hasAttribute('onmouseup')){
+ elm.addEventListener('mouseup', elm.onmouseup, false);
+ }
+ return elm;
+};
+
+
+var __click__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("click", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+var __mousedown__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("mousedown", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+var __mouseup__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("mouseup", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+var __mouseover__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("mouseover", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+var __mousemove__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("mousemove", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+var __mouseout__ = function(element){
+ var event = new Event('MouseEvents');
+ event.initEvent("mouseout", true, true, null, 0,
+ 0, 0, 0, 0, false, false, false,
+ false, null, null);
+ element.dispatchEvent(event);
+};
+
+/**
+ * HTMLElement - DOM Level 2
+ */
+
+
+/* Hack for http://www.prototypejs.org/
+ *
+ * Prototype 1.6 (the library) creates a new global Element, which causes
+ * envjs to use the wrong Element.
+ *
+ * http://envjs.lighthouseapp.com/projects/21590/tickets/108-prototypejs-wont-load-due-it-clobbering-element
+ *
+ * Options:
+ * (1) Rename the dom/element to something else
+ * rejected: been done before. people want Element.
+ * (2) merge dom+html and not export Element to global namespace
+ * (meaning we would use a local var Element in a closure, so prototype
+ * can do what ever it wants)
+ * rejected: want dom and html separate
+ * (3) use global namespace (put everything under Envjs = {})
+ * rejected: massive change
+ * (4) use commonjs modules (similar to (3) in spirit)
+ * rejected: massive change
+ *
+ * or
+ *
+ * (5) take a reference to Element during initial loading ("compile
+ * time"), and use the reference instead of "Element". That's
+ * what the next line does. We use __DOMElement__ if we need to
+ * reference the parent class. Only this file explcity uses
+ * Element so this should work, and is the most minimal change I
+ * could think of with no external API changes.
+ *
+ */
+var __DOMElement__ = Element;
+
+HTMLElement = function(ownerDocument) {
+ __DOMElement__.apply(this, arguments);
+};
+
+HTMLElement.prototype = new Element();
+__extend__(HTMLElement.prototype, HTMLEvents.prototype);
+__extend__(HTMLElement.prototype, {
+ get className() {
+ return this.getAttribute("class")||'';
+ },
+ set className(value) {
+ return this.setAttribute("class",__trim__(value));
+ },
+ get dir() {
+ return this.getAttribute("dir")||"ltr";
+ },
+ set dir(val) {
+ return this.setAttribute("dir",val);
+ },
+ get id(){
+ return this.getAttribute('id');
+ },
+ set id(id){
+ this.setAttribute('id', id);
+ },
+ get innerHTML(){
+ var ret = "",
+ i;
+
+ // create string containing the concatenation of the string
+ // values of each child
+ for (i=0; i < this.childNodes.length; i++) {
+ if(this.childNodes[i]){
+ if(this.childNodes[i].nodeType === Node.ELEMENT_NODE){
+ ret += this.childNodes[i].xhtml;
+ } else if (this.childNodes[i].nodeType === Node.TEXT_NODE && i>0 &&
+ this.childNodes[i-1].nodeType === Node.TEXT_NODE){
+ //add a single space between adjacent text nodes
+ ret += " "+this.childNodes[i].xml;
+ }else{
+ ret += this.childNodes[i].xml;
+ }
+ }
+ }
+ return ret;
+ },
+ get lang() {
+ return this.getAttribute("lang");
+ },
+ set lang(val) {
+ return this.setAttribute("lang",val);
+ },
+ get offsetHeight(){
+ return Number((this.style.height || '').replace("px",""));
+ },
+ get offsetWidth(){
+ return Number((this.style.width || '').replace("px",""));
+ },
+ offsetLeft: 0,
+ offsetRight: 0,
+ get offsetParent(){
+ /* TODO */
+ return;
+ },
+ set offsetParent(element){
+ /* TODO */
+ return;
+ },
+ scrollHeight: 0,
+ scrollWidth: 0,
+ scrollLeft: 0,
+ scrollRight: 0,
+ get style(){
+ return this.getAttribute('style')||'';
+ },
+ get title() {
+ return this.getAttribute("title");
+ },
+ set title(value) {
+ return this.setAttribute("title", value);
+ },
+ get tabIndex(){
+ var tabindex = this.getAttribute('tabindex');
+ if(tabindex!==null){
+ return Number(tabindex);
+ } else {
+ return 0;
+ }
+ },
+ set tabIndex(value){
+ if (value === undefined || value === null) {
+ value = 0;
+ }
+ this.setAttribute('tabindex',Number(value));
+ },
+ get outerHTML(){
+ //Not in the specs but I'll leave it here for now.
+ return this.xhtml;
+ },
+ scrollIntoView: function(){
+ /*TODO*/
+ return;
+ },
+ toString: function(){
+ return '[object HTMLElement]';
+ },
+ get xhtml() {
+ // HTMLDocument.xhtml is non-standard
+ // This is exactly like Document.xml except the tagName has to be
+ // lower cased. I dont like to duplicate this but its really not
+ // a simple work around between xml and html serialization via
+ // XMLSerializer (which uppercases html tags) and innerHTML (which
+ // lowercases tags)
+
+ var ret = "",
+ ns = "",
+ name = (this.tagName+"").toLowerCase(),
+ attrs,
+ attrstring = "",
+ i;
+
+ // serialize namespace declarations
+ if (this.namespaceURI){
+ if((this === this.ownerDocument.documentElement) ||
+ (!this.parentNode) ||
+ (this.parentNode &&
+ (this.parentNode.namespaceURI !== this.namespaceURI))) {
+ ns = ' xmlns' + (this.prefix ? (':' + this.prefix) : '') +
+ '="' + this.namespaceURI + '"';
+ }
+ }
+
+ // serialize Attribute declarations
+ attrs = this.attributes;
+ for(i=0;i< attrs.length;i++){
+ attrstring += " "+attrs[i].name+'="'+attrs[i].xml+'"';
+ }
+
+ if(this.hasChildNodes()){
+ // serialize this Element
+ ret += "<" + name + ns + attrstring +">";
+ for(i=0;i< this.childNodes.length;i++){
+ ret += this.childNodes[i].xhtml ?
+ this.childNodes[i].xhtml :
+ this.childNodes[i].xml;
+ }
+ ret += "";
+ }else{
+ switch(name){
+ case 'script':
+ ret += "<" + name + ns + attrstring +">";
+ break;
+ default:
+ ret += "<" + name + ns + attrstring +"/>";
+ }
+ }
+
+ return ret;
+ },
+
+ /**
+ * setAttribute use a dispatch table that other tags can set to
+ * "listen" to various values being set. The dispatch table
+ * and registration functions are at the end of the file.
+ *
+ */
+
+ setAttribute: function(name, value) {
+ var result = __DOMElement__.prototype.setAttribute.apply(this, arguments);
+ __addNamedMap__(this.ownerDocument, this);
+ var tagname = this.tagName;
+ var callback = HTMLElement.getAttributeCallback('set', tagname, name);
+ if (callback) {
+ callback(this, value);
+ }
+ },
+ setAttributeNS: function(namespaceURI, name, value) {
+ var result = __DOMElement__.prototype.setAttributeNS.apply(this, arguments);
+ __addNamedMap__(this.ownerDocument, this);
+ var tagname = this.tagName;
+ var callback = HTMLElement.getAttributeCallback('set', tagname, name);
+ if (callback) {
+ callback(this, value);
+ }
+
+ return result;
+ },
+ setAttributeNode: function(newnode) {
+ var result = __DOMElement__.prototype.setAttributeNode.apply(this, arguments);
+ __addNamedMap__(this.ownerDocument, this);
+ var tagname = this.tagName;
+ var callback = HTMLElement.getAttributeCallback('set', tagname, newnode.name);
+ if (callback) {
+ callback(this, node.value);
+ }
+ return result;
+ },
+ setAttributeNodeNS: function(newnode) {
+ var result = __DOMElement__.prototype.setAttributeNodeNS.apply(this, arguments);
+ __addNamedMap__(this.ownerDocument, this);
+ var tagname = this.tagName;
+ var callback = HTMLElement.getAttributeCallback('set', tagname, newnode.name);
+ if (callback) {
+ callback(this, node.value);
+ }
+ return result;
+ },
+ removeAttribute: function(name) {
+ __removeNamedMap__(this.ownerDocument, this);
+ return __DOMElement__.prototype.removeAttribute.apply(this, arguments);
+ },
+ removeAttributeNS: function(namespace, localname) {
+ __removeNamedMap__(this.ownerDocument, this);
+ return __DOMElement__.prototype.removeAttributeNS.apply(this, arguments);
+ },
+ removeAttributeNode: function(name) {
+ __removeNamedMap__(this.ownerDocument, this);
+ return __DOMElement__.prototype.removeAttribute.apply(this, arguments);
+ },
+ removeChild: function(oldChild) {
+ __removeNamedMap__(this.ownerDocument, oldChild);
+ return __DOMElement__.prototype.removeChild.apply(this, arguments);
+ },
+ importNode: function(othernode, deep) {
+ var newnode = __DOMElement__.prototype.importNode.apply(this, arguments);
+ __addNamedMap__(this.ownerDocument, newnode);
+ return newnode;
+ },
+
+ // not actually sure if this is needed or not
+ replaceNode: function(newchild, oldchild) {
+ var newnode = __DOMElement__.prototype.replaceNode.apply(this, arguments);
+ __removeNamedMap__(this.ownerDocument, oldchild);
+ __addNamedMap__(this.ownerDocument, newnode);
+ return newnode;
+ }
+});
+
+
+HTMLElement.attributeCallbacks = {};
+HTMLElement.registerSetAttribute = function(tag, attrib, callbackfn) {
+ HTMLElement.attributeCallbacks[tag + ':set:' + attrib] = callbackfn;
+};
+HTMLElement.registerRemoveAttribute = function(tag, attrib, callbackfn) {
+ HTMLElement.attributeCallbacks[tag + ':remove:' + attrib] = callbackfn;
+};
+
+/**
+ * This is really only useful internally
+ *
+ */
+HTMLElement.getAttributeCallback = function(type, tag, attrib) {
+ return HTMLElement.attributeCallbacks[tag + ':' + type + ':' + attrib] || null;
+};
+/*
+ * HTMLCollection
+ *
+ * HTML5 -- 2.7.2.1 HTMLCollection
+ * http://dev.w3.org/html5/spec/Overview.html#htmlcollection
+ * http://dev.w3.org/html5/spec/Overview.html#collections
+ */
+HTMLCollection = function(nodelist, type) {
+
+ __setArray__(this, []);
+ var n;
+ for (var i=0; i= 0) && (idx < this.length)) ? this[idx] : null;
+ },
+
+ namedItem: function (name) {
+ return this[name] || null;
+ },
+
+ toString: function() {
+ return '[object HTMLCollection]';
+ }
+};
+/*
+ * a set of convenience classes to centralize implementation of
+ * properties and methods across multiple in-form elements
+ *
+ * the hierarchy of related HTML elements and their members is as follows:
+ *
+ * Condensed Version
+ *
+ * HTMLInputCommon
+ * * legent (no value attr)
+ * * fieldset (no value attr)
+ * * label (no value attr)
+ * * option (custom value)
+ * HTMLTypeValueInputs (extends InputCommon)
+ * * select (custom value)
+ * * button (just sets value)
+ * HTMLInputAreaCommon (extends TypeValueIput)
+ * * input (custom)
+ * * textarea (just sets value)
+ *
+ * -----------------------
+ * HTMLInputCommon: common to all elements
+ * .form
+ *
+ *