Doc and lib updates

Author: lannymcnie

docs/preloadjs_docs-NEXT.zip

@@ -56,7 +56,7 @@ this.createjs = this.createjs || {};
 	 * @type {String}
 	 * @static
 	 **/
-	s.buildDate = /*=date*/"Wed, 11 Jan 2017 23:28:23 GMT"; // injected by build process
+	s.buildDate = /*=date*/"Thu, 01 Jun 2017 19:45:23 GMT"; // injected by build process
 
 })();
 
@@ -885,17 +885,15 @@ this.createjs = this.createjs||{};
 // private methods:
 	/**
 	 * @method _dispatchEvent
-	 * @param {Object | String | Event} eventObj
+	 * @param {Object | Event} eventObj
 	 * @param {Object} eventPhase
 	 * @protected
 	 **/
 	p._dispatchEvent = function(eventObj, eventPhase) {
-		var l, listeners = (eventPhase==1) ? this._captureListeners : this._listeners;
-		if (eventObj && listeners) {
-			var arr = listeners[eventObj.type];
-			if (!arr||!(l=arr.length)) { return; }
+		var l, arr, listeners = (eventPhase <= 2) ? this._captureListeners : this._listeners;
+		if (eventObj && listeners && (arr = listeners[eventObj.type]) && (l=arr.length)) {
 			try { eventObj.currentTarget = this; } catch (e) {}
-			try { eventObj.eventPhase = eventPhase; } catch (e) {}
+			try { eventObj.eventPhase = eventPhase|0; } catch (e) {}
 			eventObj.removed = false;
 
 			arr = arr.slice(); // to avoid issues with items being removed or added during the dispatch
@@ -909,6 +907,7 @@ this.createjs = this.createjs||{};
 				}
 			}
 		}
+		if (eventPhase === 2) { this._dispatchEvent(eventObj, 2.1); }
 	};
 
 
@@ -3492,11 +3491,13 @@ this.createjs = this.createjs || {};
 			case "complete":
 				this._rawResult = event.target._response;
 				var result = this.resultFormatter && this.resultFormatter(this);
+				// The resultFormatter is asynchronous
 				if (result instanceof Function) {
 					result.call(this,
 							createjs.proxy(this._resultFormatSuccess, this),
 							createjs.proxy(this._resultFormatFailed, this)
 					);
+				// The result formatter is synchronous
 				} else {
 					this._result =  result || this._rawResult;
 					this._sendComplete();
@@ -4273,6 +4274,9 @@ this.createjs = this.createjs || {};
 	/**
 	 * The XHR request has completed. This is called by the XHR request directly, or by a readyStateChange that has
 	 * <code>request.readyState == 4</code>. Only the first call to this method will be processed.
+	 *
+	 * Note that This method uses {{#crossLink "_checkError"}}{{/crossLink}} to determine if the server has returned an
+	 * error code.
 	 * @method _handleLoad
 	 * @param {Object} event The XHR load event.
 	 * @private
@@ -4324,16 +4328,25 @@ this.createjs = this.createjs || {};
 
 // Protected
 	/**
-	 * Determine if there is an error in the current load. This checks the status of the request for problem codes. Note
-	 * that this does not check for an actual response. Currently, it only checks for error codes between 400 and 599
+	 * Determine if there is an error in the current load.
+	 * Currently this checks the status of the request for problem codes, and not actual response content:
+	 * <ul>
+	 *     <li>Status codes between 400 and 599 (HTTP error range)</li>
+	 *     <li>A status of 0, but *only when the application is running on a server*. If the application is running
+	 *     on `file:`, then it may incorrectly treat an error on local (or embedded applications) as a successful
+	 *     load.</li>
+	 * </ul>
 	 * @method _checkError
-	 * @return {int} If the request status returns an error code.
+	 * @return {Error} An error with the status code in the `message` argument.
 	 * @private
 	 */
 	p._checkError = function () {
 		var status = parseInt(this._request.status);
 		if (status >= 400 && status <= 599) {
 			return new Error(status);
+		} else if (status == 0) {
+			if ((/^https?:/).test(location.protocol)) { return new Error(0); }
+			return null; // Likely an embedded app.
 		} else {
 			return null;
 		}
@@ -5224,7 +5237,7 @@ this.createjs = this.createjs || {};
 	/**
 	 * This event is fired when an individual file starts to load.
 	 * @event filestart
-	 * @param {Object} The object that dispatched the event.
+	 * @param {Object} target The object that dispatched the event.
 	 * @param {String} type The event type.
 	 * @param {Object} item The file item which was specified in the {{#crossLink "LoadQueue/loadFile"}}{{/crossLink}}
 	 * or {{#crossLink "LoadQueue/loadManifest"}}{{/crossLink}} call. If only a string path or tag was specified, the
@@ -6781,7 +6794,7 @@ this.createjs = this.createjs || {};
 	 */
 	p._handleTimeout = function () {
 		this._stopWatching();
-		this.dispatchEvent(new createjs.ErrorEvent("PRELOAD_TIMEOUT", null, event));
+		this.dispatchEvent(new createjs.ErrorEvent("PRELOAD_TIMEOUT"));
 	};
 
 	// WatchCSS does the work for us, and provides a modified src.
@@ -7249,10 +7262,12 @@ this.createjs = this.createjs || {};
 		} else {
             tag.onload = createjs.proxy(function() {
                 successCallback(this._tag);
+                tag.onload = tag.onerror = null;
             }, this);
 
-            tag.onerror = createjs.proxy(function() {
-                errorCallback(this._tag);
+            tag.onerror = createjs.proxy(function(event) {
+                errorCallback(new createjs.ErrorEvent('IMAGE_FORMAT', null, event));
+                tag.onload = tag.onerror = null;
             }, this);
 		}
 	};
@@ -7446,9 +7461,12 @@ this.createjs = this.createjs || {};
 	 * 			console.log(json.obj.bool); // true
 	 * 		}
 	 *
-	 * Note that JSONP files loaded concurrently require a <em>unique</em> callback. To ensure JSONP files are loaded
-	 * in order, either use the {{#crossLink "LoadQueue/setMaxConnections"}}{{/crossLink}} method (set to 1),
-	 * or set {{#crossLink "LoadItem/maintainOrder:property"}}{{/crossLink}} on items with the same callback.
+	 * JSONP files loaded concurrently require a <em>unique</em> callback. To ensure JSONP files are loaded in order,
+	 * either use the {{#crossLink "LoadQueue/setMaxConnections"}}{{/crossLink}} method (set to 1), or set
+	 * {{#crossLink "LoadItem/maintainOrder:property"}}{{/crossLink}} on items with the same callback.
+	 *
+	 * Important note: Some browsers will prevent JSONP from firing the callback if the file was loaded as JSON, and not
+	 * JavaScript. You may have to have your server give you a JavaScript mime-type for this to work.
 	 *
 	 * @class JSONPLoader
 	 * @param {LoadItem|Object} loadItem
@@ -7590,13 +7608,16 @@ this.createjs = this.createjs || {};
 	 * Note that the {{#crossLink "JSONLoader"}}{{/crossLink}} and {{#crossLink "JSONPLoader"}}{{/crossLink}} are
 	 * higher priority loaders, so manifests <strong>must</strong> set the {{#crossLink "LoadItem"}}{{/crossLink}}
 	 * {{#crossLink "LoadItem/type:property"}}{{/crossLink}} property to {{#crossLink "AbstractLoader/MANIFEST:property"}}{{/crossLink}}.
+	 *
+	 * Additionally, some browsers require the server to serve a JavaScript mime-type for JSONP, so it may not work in
+	 * some conditions.
 	 * @class ManifestLoader
 	 * @param {LoadItem|Object} loadItem
 	 * @extends AbstractLoader
 	 * @constructor
 	 */
-	function ManifestLoader(loadItem) {
-		this.AbstractLoader_constructor(loadItem, null, createjs.AbstractLoader.MANIFEST);
+	function ManifestLoader(loadItem, preferXHR) {
+		this.AbstractLoader_constructor(loadItem, preferXHR, createjs.AbstractLoader.MANIFEST);
 
 	// Public Properties
 		/**
@@ -7693,7 +7714,7 @@ this.createjs = this.createjs || {};
 	 */
 	p._loadManifest = function (json) {
 		if (json && json.manifest) {
-			var queue = this._manifestQueue = new createjs.LoadQueue();
+			var queue = this._manifestQueue = new createjs.LoadQueue(this._preferXHR);
 			queue.on("fileload", this._handleManifestFileLoad, this);
 			queue.on("progress", this._handleManifestProgress, this);
 			queue.on("complete", this._handleManifestComplete, this, true);
@@ -8134,7 +8155,12 @@ this.createjs = this.createjs || {};
 		}
 
 		if (xml.documentElement != null) {
-			tag.appendChild(xml.documentElement);
+			var element = xml.documentElement;
+			// Support loading an SVG from a different domain in ID
+			if (document.importNode) {
+				element = document.importNode(element, true);
+			}
+			tag.appendChild(element);
 			return tag;
 		} else { // For browsers that don't support SVG, just give them the XML. (IE 9-8)
 			return xml;