@mlightcad/common 1.0.0

package/lib/loader/AcCmFileLoader.js

@@ -0,0 +1,225 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { AcCmLoader } from './AcCmLoader';
+var loading = {};
+var HttpError = /** @class */ (function (_super) {
+    __extends(HttpError, _super);
+    function HttpError(message, response) {
+        var _this = _super.call(this, message) || this;
+        _this.response = response;
+        return _this;
+    }
+    return HttpError;
+}(Error));
+/**
+ * A low level class for loading resources with 'Fetch', used internally by most loaders. It can also
+ * be used directly to load any file type that does not have a loader.
+ */
+var AcCmFileLoader = /** @class */ (function (_super) {
+    __extends(AcCmFileLoader, _super);
+    /**
+     * Create a new AcCmFileLoader instance.
+     * @param manager The loadingManager for the loader to use. Default is DefaultLoadingManager.
+     */
+    function AcCmFileLoader(manager) {
+        return _super.call(this, manager) || this;
+    }
+    /**
+     * Load the URL and pass the response to the onLoad function.
+     * @param url The path or URL to the file. This can also be a Data URI.
+     * @param onLoad (optional) — Will be called when loading completes.
+     * @param onProgress (optional) — Will be called while load progresses.
+     * @param onError (optional) — Will be called if an error occurs.
+     */
+    AcCmFileLoader.prototype.load = function (url, onLoad, onProgress, onError) {
+        var _this = this;
+        if (url === undefined)
+            url = '';
+        if (this.path !== undefined)
+            url = this.path + url;
+        url = this.manager.resolveURL(url);
+        // Check if request is duplicate
+        if (loading[url] !== undefined) {
+            loading[url].push({
+                onLoad: onLoad,
+                onProgress: onProgress,
+                onError: onError
+            });
+            return;
+        }
+        // Initialise array for duplicate requests
+        loading[url] = [];
+        loading[url].push({
+            onLoad: onLoad,
+            onProgress: onProgress,
+            onError: onError
+        });
+        // create request
+        var req = new Request(url, {
+            headers: new Headers(this.requestHeader),
+            credentials: this.withCredentials ? 'include' : 'same-origin'
+            // An abort controller could be added within a future PR
+        });
+        // record states ( avoid data race )
+        var mimeType = this.mimeType;
+        var responseType = this.responseType;
+        // start the fetch
+        fetch(req)
+            .then(function (response) {
+            var _a;
+            if (response.status === 200 || response.status === 0) {
+                // Some browsers return HTTP Status 0 when using non-http protocol
+                // e.g. 'file://' or 'data://'. Handle as success.
+                if (response.status === 0) {
+                    console.warn('HTTP Status 0 received.');
+                }
+                // Workaround: Checking if response.body === undefined for Alipay browser #23548
+                if (typeof ReadableStream === 'undefined' ||
+                    response.body === undefined ||
+                    ((_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader) === undefined) {
+                    return response;
+                }
+                var callbacks_1 = loading[url];
+                var reader_1 = response.body.getReader();
+                // Nginx needs X-File-Size check
+                // https://serverfault.com/questions/482875/why-does-nginx-remove-content-length-header-for-chunked-content
+                var contentLength = response.headers.get('X-File-Size') ||
+                    response.headers.get('Content-Length');
+                var total_1 = contentLength ? parseInt(contentLength) : 0;
+                var lengthComputable_1 = total_1 !== 0;
+                var loaded_1 = 0;
+                // periodically read data into the new stream tracking while download progress
+                var stream = new ReadableStream({
+                    start: function (controller) {
+                        readData();
+                        function readData() {
+                            reader_1.read().then(function (_a) {
+                                var done = _a.done, value = _a.value;
+                                if (done) {
+                                    controller.close();
+                                }
+                                else {
+                                    loaded_1 += value.byteLength;
+                                    var event_1 = new ProgressEvent('progress', {
+                                        lengthComputable: lengthComputable_1,
+                                        loaded: loaded_1,
+                                        total: total_1
+                                    });
+                                    for (var i = 0, il = callbacks_1.length; i < il; i++) {
+                                        var callback = callbacks_1[i];
+                                        if (callback.onProgress)
+                                            callback.onProgress(event_1);
+                                    }
+                                    controller.enqueue(value);
+                                    readData();
+                                }
+                            }, function (e) {
+                                controller.error(e);
+                            });
+                        }
+                    }
+                });
+                return new Response(stream);
+            }
+            else {
+                throw new HttpError("fetch for \"".concat(response.url, "\" responded with ").concat(response.status, ": ").concat(response.statusText), response);
+            }
+        })
+            .then(function (response) {
+            switch (responseType) {
+                case 'arraybuffer':
+                    return response.arrayBuffer();
+                case 'blob':
+                    return response.blob();
+                case 'document':
+                    return response.text().then(function (text) {
+                        var parser = new DOMParser();
+                        return parser.parseFromString(text, mimeType);
+                    });
+                case 'json':
+                    return response.json();
+                default:
+                    if (mimeType === undefined) {
+                        return response.text();
+                    }
+                    else {
+                        // sniff encoding
+                        var re = /charset="?([^;"\s]*)"?/i;
+                        var exec = re.exec(mimeType);
+                        var label = exec && exec[1] ? exec[1].toLowerCase() : undefined;
+                        var decoder_1 = new TextDecoder(label);
+                        return response.arrayBuffer().then(function (ab) { return decoder_1.decode(ab); });
+                    }
+            }
+        })
+            .then(function (data) {
+            var callbacks = loading[url];
+            delete loading[url];
+            for (var i = 0, il = callbacks.length; i < il; i++) {
+                var callback = callbacks[i];
+                if (callback.onLoad)
+                    callback.onLoad(data);
+            }
+        })
+            .catch(function (err) {
+            // Abort errors and other errors are handled the same
+            var callbacks = loading[url];
+            if (callbacks === undefined) {
+                // When onLoad was called and url was deleted in `loading`
+                _this.manager.itemError(url);
+                throw err;
+            }
+            delete loading[url];
+            for (var i = 0, il = callbacks.length; i < il; i++) {
+                var callback = callbacks[i];
+                if (callback.onError)
+                    callback.onError(err);
+            }
+            _this.manager.itemError(url);
+        })
+            .finally(function () {
+            _this.manager.itemEnd(url);
+        });
+        this.manager.itemStart(url);
+    };
+    /**
+     * Change the response type. Valid values are:
+     * - text or empty string (default) - returns the data as String.
+     * - arraybuffer - loads the data into a ArrayBuffer and returns that.
+     * - blob - returns the data as a Blob.
+     * - document - parses the file using the DOMParser.
+     * - json - parses the file using JSON.parse.
+     * @param value
+     * @returns Return this object
+     */
+    AcCmFileLoader.prototype.setResponseType = function (value) {
+        this.responseType = value;
+        return this;
+    };
+    /**
+     * Set the expected mimeType of the file being loaded. Note that in many cases this will be determined
+     * automatically, so by default it is undefined.
+     * @param value The expected mimeType of the file being loaded.
+     * @returns Return this object.
+     */
+    AcCmFileLoader.prototype.setMimeType = function (value) {
+        this.mimeType = value;
+        return this;
+    };
+    return AcCmFileLoader;
+}(AcCmLoader));
+export { AcCmFileLoader };
+//# sourceMappingURL=AcCmFileLoader.js.map

package/lib/loader/AcCmFileLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcCmFileLoader.js","sourceRoot":"","sources":["../../src/loader/AcCmFileLoader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAA8B,MAAM,cAAc,CAAA;AAOrE,IAAM,OAAO,GAOT,EAAE,CAAA;AAEN;IAAwB,6BAAK;IAE3B,mBAAY,OAAe,EAAE,QAAkB;QAC7C,YAAA,MAAK,YAAC,OAAO,CAAC,SAAA;QACd,KAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;;IAC1B,CAAC;IACH,gBAAC;AAAD,CAAC,AAND,CAAwB,KAAK,GAM5B;AAkBD;;;GAGG;AACH;IAAoC,kCAAU;IAU5C;;;OAGG;IACH,wBAAY,OAA4B;QACtC,OAAA,MAAK,YAAC,OAAO,CAAC,SAAA;IAChB,CAAC;IAED;;;;;;OAMG;IACH,6BAAI,GAAJ,UACE,GAAW,EACX,MAA0B,EAC1B,UAAsC,EACtC,OAA4B;QAJ9B,iBAqLC;QA/KC,IAAI,GAAG,KAAK,SAAS;YAAE,GAAG,GAAG,EAAE,CAAA;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QAClD,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAElC,gCAAgC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAChB,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,UAAU;gBACtB,OAAO,EAAE,OAAO;aACjB,CAAC,CAAA;YAEF,OAAM;QACR,CAAC;QAED,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QAEjB,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAChB,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,UAAU;YACtB,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QAEF,iBAAiB;QACjB,IAAM,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;YACxC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa;YAC7D,wDAAwD;SACzD,CAAC,CAAA;QAEF,oCAAoC;QACpC,IAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,IAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;QAEtC,kBAAkB;QAClB,KAAK,CAAC,GAAG,CAAC;aACP,IAAI,CAAC,UAAA,QAAQ;;YACZ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,kEAAkE;gBAClE,kDAAkD;gBAElD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;gBACzC,CAAC;gBAED,gFAAgF;gBAEhF,IACE,OAAO,cAAc,KAAK,WAAW;oBACrC,QAAQ,CAAC,IAAI,KAAK,SAAS;oBAC3B,CAAA,MAAA,QAAQ,CAAC,IAAI,0CAAE,SAAS,MAAK,SAAS,EACtC,CAAC;oBACD,OAAO,QAAQ,CAAA;gBACjB,CAAC;gBAED,IAAM,WAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;gBAC9B,IAAM,QAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;gBAExC,gCAAgC;gBAChC,2GAA2G;gBAC3G,IAAM,aAAa,GACjB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;oBACnC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;gBACxC,IAAM,OAAK,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACzD,IAAM,kBAAgB,GAAG,OAAK,KAAK,CAAC,CAAA;gBACpC,IAAI,QAAM,GAAG,CAAC,CAAA;gBAEd,8EAA8E;gBAC9E,IAAM,MAAM,GAAG,IAAI,cAAc,CAAC;oBAChC,KAAK,YAAC,UAAU;wBACd,QAAQ,EAAE,CAAA;wBAEV,SAAS,QAAQ;4BACf,QAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAChB,UAAC,EAAe;oCAAb,IAAI,UAAA,EAAE,KAAK,WAAA;gCACZ,IAAI,IAAI,EAAE,CAAC;oCACT,UAAU,CAAC,KAAK,EAAE,CAAA;gCACpB,CAAC;qCAAM,CAAC;oCACN,QAAM,IAAI,KAAK,CAAC,UAAU,CAAA;oCAE1B,IAAM,OAAK,GAAG,IAAI,aAAa,CAAC,UAAU,EAAE;wCAC1C,gBAAgB,oBAAA;wCAChB,MAAM,UAAA;wCACN,KAAK,SAAA;qCACN,CAAC,CAAA;oCACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,WAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;wCACnD,IAAM,QAAQ,GAAG,WAAS,CAAC,CAAC,CAAC,CAAA;wCAC7B,IAAI,QAAQ,CAAC,UAAU;4CAAE,QAAQ,CAAC,UAAU,CAAC,OAAK,CAAC,CAAA;oCACrD,CAAC;oCAED,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;oCACzB,QAAQ,EAAE,CAAA;gCACZ,CAAC;4BACH,CAAC,EACD,UAAA,CAAC;gCACC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;4BACrB,CAAC,CACF,CAAA;wBACH,CAAC;oBACH,CAAC;iBACF,CAAC,CAAA;gBAEF,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,SAAS,CACjB,sBAAc,QAAQ,CAAC,GAAG,+BAAoB,QAAQ,CAAC,MAAM,eAAK,QAAQ,CAAC,UAAU,CAAE,EACvF,QAAQ,CACT,CAAA;YACH,CAAC;QACH,CAAC,CAAC;aACD,IAAI,CAAC,UAAA,QAAQ;YACZ,QAAQ,YAAY,EAAE,CAAC;gBACrB,KAAK,aAAa;oBAChB,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAA;gBAE/B,KAAK,MAAM;oBACT,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;gBAExB,KAAK,UAAU;oBACb,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAA,IAAI;wBAC9B,IAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAA;wBAC9B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,QAAS,CAAC,CAAA;oBAChD,CAAC,CAAC,CAAA;gBAEJ,KAAK,MAAM;oBACT,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;gBAExB;oBACE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAC3B,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;oBACxB,CAAC;yBAAM,CAAC;wBACN,iBAAiB;wBACjB,IAAM,EAAE,GAAG,yBAAyB,CAAA;wBACpC,IAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;wBAC9B,IAAM,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;wBACjE,IAAM,SAAO,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;wBACtC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,UAAA,EAAE,IAAI,OAAA,SAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAlB,CAAkB,CAAC,CAAA;oBAC9D,CAAC;YACL,CAAC;QACH,CAAC,CAAC;aACD,IAAI,CAAC,UAAA,IAAI;YACR,IAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAA;YAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,IAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;gBAC7B,IAAI,QAAQ,CAAC,MAAM;oBAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC5C,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,UAAA,GAAG;YACR,qDAAqD;YAErD,IAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YAE9B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,0DAA0D;gBAC1D,KAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;gBAC3B,MAAM,GAAG,CAAA;YACX,CAAC;YAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAA;YAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,IAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;gBAC7B,IAAI,QAAQ,CAAC,OAAO;oBAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC7C,CAAC;YAED,KAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC7B,CAAC,CAAC;aACD,OAAO,CAAC;YACP,KAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEJ,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;;;;;OASG;IACH,wCAAe,GAAf,UAAgB,KAAuB;QACrC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,oCAAW,GAAX,UAAY,KAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IACH,qBAAC;AAAD,CAAC,AAzOD,CAAoC,UAAU,GAyO7C"}

package/lib/loader/AcCmLoader.d.ts

@@ -0,0 +1,92 @@
+import { AcCmLoadingManager, AcCmOnErrorCallback } from './AcCmLoadingManager';
+export type AcCmLoaderProgressCallback = (progress: ProgressEvent) => void;
+/**
+ * Base class for implementing loaders.
+ */
+export declare abstract class AcCmLoader {
+    manager: AcCmLoadingManager;
+    /**
+     * The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.
+     * Default is anonymous.
+     */
+    crossOrigin: string;
+    /**
+     * Whether the XMLHttpRequest uses credentials. Default is false.
+     */
+    withCredentials: boolean;
+    /**
+     * The base path from which the asset will be loaded. Default is the empty string.
+     */
+    path: string;
+    /**
+     * The base path from which additional resources like textures will be loaded.
+     * Default is the empty string.
+     */
+    resourcePath: string;
+    /**
+     * The request header used in HTTP request.
+     */
+    requestHeader: HeadersInit;
+    /**
+     * Creates a new AcCmLoader instance.
+     * @param manager The loadingManager for the loader to use. Default is DefaultLoadingManager.
+     */
+    constructor(manager?: AcCmLoadingManager);
+    /**
+     * This method needs to be implement by all concrete loaders. It holds the logic for loading
+     * the asset from the backend.
+     * @param url The path or URL to the file. This can also be a Data URI.
+     * @param onLoad (optional) — Will be called when loading completes.
+     * @param onProgress (optional) — Will be called while load progresses.
+     * @param onError (optional) — Will be called if an error occurs.
+     */
+    abstract load(url: string, onLoad?: (data: unknown) => void, onProgress?: AcCmLoaderProgressCallback, onError?: AcCmOnErrorCallback): void;
+    /**
+     * This method is equivalent to 'load', but returns a Promise.
+     * @param url A string containing the path/URL of the file to be loaded.
+     * @param onProgress (optional) — A function to be called while the loading is in progress.
+     * The argument will be the ProgressEvent instance, which contains .lengthComputable, .total
+     * and .loaded. If the server does not set the Content-Length header; .total will be 0.
+     * @returns Return a promise.
+     */
+    loadAsync(url: string, onProgress: AcCmLoaderProgressCallback): Promise<unknown>;
+    /**
+     * This method needs to be implement by all concrete loaders. It holds the logic for parsing the asset.
+     */
+    parse(_data: unknown): void;
+    /**
+     * Set the crossOrigin string to implement CORS for loading the url from a different domain that allows
+     * CORS.
+     * @param crossOrigin The crossOrigin string
+     * @returns Return this object
+     */
+    setCrossOrigin(crossOrigin: string): this;
+    /**
+     * Set whether the XMLHttpRequest uses credentials such as cookies, authorization headers or TLS
+     * client certificates.
+     * Note that this has no effect if you are loading files locally or from the same domain.
+     * @param value The flag whether the XMLHttpRequest uses credentials.
+     * @returns Return this object
+     */
+    setWithCredentials(value: boolean): this;
+    /**
+     * Set the base path for the asset.
+     * @param path The base path for the asset.
+     * @returns Return this object
+     */
+    setPath(path: string): this;
+    /**
+     * Set the base path for dependent resources like textures.
+     * @param resourcePath The base path for dependent resources like textures.
+     * @returns Return this object
+     */
+    setResourcePath(resourcePath: string): this;
+    /**
+     * Set the request header used in HTTP request.
+     * @param requestHeader  key: The name of the header whose value is to be set. value: The value
+     * to set as the body of the header.
+     * @returns Return this object
+     */
+    setRequestHeader(requestHeader: HeadersInit): this;
+}
+//# sourceMappingURL=AcCmLoader.d.ts.map

package/lib/loader/AcCmLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcCmLoader.d.ts","sourceRoot":"","sources":["../../src/loader/AcCmLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAA;AAE1E;;GAEG;AACH,8BAAsB,UAAU;IAC9B,OAAO,EAAE,kBAAkB,CAAA;IAC3B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,aAAa,EAAE,WAAW,CAAA;IAE1B;;;OAGG;gBACS,OAAO,CAAC,EAAE,kBAAkB;IASxC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAChC,UAAU,CAAC,EAAE,0BAA0B,EACvC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI;IAEP;;;;;;;OAOG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,0BAA0B;IAM7D;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO;IAEpB;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM;IAKlC;;;;;;OAMG;IACH,kBAAkB,CAAC,KAAK,EAAE,OAAO;IAKjC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM;IAKpB;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM;IAKpC;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,WAAW;CAI5C"}

package/lib/loader/AcCmLoader.js

@@ -0,0 +1,88 @@
+import { DefaultLoadingManager } from './AcCmLoadingManager';
+/**
+ * Base class for implementing loaders.
+ */
+var AcCmLoader = /** @class */ (function () {
+    /**
+     * Creates a new AcCmLoader instance.
+     * @param manager The loadingManager for the loader to use. Default is DefaultLoadingManager.
+     */
+    function AcCmLoader(manager) {
+        this.manager = manager !== undefined ? manager : DefaultLoadingManager;
+        this.crossOrigin = 'anonymous';
+        this.withCredentials = false;
+        this.path = '';
+        this.resourcePath = '';
+        this.requestHeader = {};
+    }
+    /**
+     * This method is equivalent to 'load', but returns a Promise.
+     * @param url A string containing the path/URL of the file to be loaded.
+     * @param onProgress (optional) — A function to be called while the loading is in progress.
+     * The argument will be the ProgressEvent instance, which contains .lengthComputable, .total
+     * and .loaded. If the server does not set the Content-Length header; .total will be 0.
+     * @returns Return a promise.
+     */
+    AcCmLoader.prototype.loadAsync = function (url, onProgress) {
+        var _this = this;
+        return new Promise(function (resolve, reject) {
+            _this.load(url, resolve, onProgress, reject);
+        });
+    };
+    /**
+     * This method needs to be implement by all concrete loaders. It holds the logic for parsing the asset.
+     */
+    AcCmLoader.prototype.parse = function (_data) { };
+    /**
+     * Set the crossOrigin string to implement CORS for loading the url from a different domain that allows
+     * CORS.
+     * @param crossOrigin The crossOrigin string
+     * @returns Return this object
+     */
+    AcCmLoader.prototype.setCrossOrigin = function (crossOrigin) {
+        this.crossOrigin = crossOrigin;
+        return this;
+    };
+    /**
+     * Set whether the XMLHttpRequest uses credentials such as cookies, authorization headers or TLS
+     * client certificates.
+     * Note that this has no effect if you are loading files locally or from the same domain.
+     * @param value The flag whether the XMLHttpRequest uses credentials.
+     * @returns Return this object
+     */
+    AcCmLoader.prototype.setWithCredentials = function (value) {
+        this.withCredentials = value;
+        return this;
+    };
+    /**
+     * Set the base path for the asset.
+     * @param path The base path for the asset.
+     * @returns Return this object
+     */
+    AcCmLoader.prototype.setPath = function (path) {
+        this.path = path;
+        return this;
+    };
+    /**
+     * Set the base path for dependent resources like textures.
+     * @param resourcePath The base path for dependent resources like textures.
+     * @returns Return this object
+     */
+    AcCmLoader.prototype.setResourcePath = function (resourcePath) {
+        this.resourcePath = resourcePath;
+        return this;
+    };
+    /**
+     * Set the request header used in HTTP request.
+     * @param requestHeader  key: The name of the header whose value is to be set. value: The value
+     * to set as the body of the header.
+     * @returns Return this object
+     */
+    AcCmLoader.prototype.setRequestHeader = function (requestHeader) {
+        this.requestHeader = requestHeader;
+        return this;
+    };
+    return AcCmLoader;
+}());
+export { AcCmLoader };
+//# sourceMappingURL=AcCmLoader.js.map

package/lib/loader/AcCmLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcCmLoader.js","sourceRoot":"","sources":["../../src/loader/AcCmLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAI7B;;GAEG;AACH;IAyBE;;;OAGG;IACH,oBAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAA;QACtE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;QACd,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;IACzB,CAAC;IAiBD;;;;;;;OAOG;IACH,8BAAS,GAAT,UAAU,GAAW,EAAE,UAAsC;QAA7D,iBAIC;QAHC,OAAO,IAAI,OAAO,CAAC,UAAC,OAAO,EAAE,MAAM;YACjC,KAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,0BAAK,GAAL,UAAM,KAAc,IAAG,CAAC;IAExB;;;;;OAKG;IACH,mCAAc,GAAd,UAAe,WAAmB;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACH,uCAAkB,GAAlB,UAAmB,KAAc;QAC/B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,4BAAO,GAAP,UAAQ,IAAY;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,oCAAe,GAAf,UAAgB,YAAoB;QAClC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,qCAAgB,GAAhB,UAAiB,aAA0B;QACzC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IACH,iBAAC;AAAD,CAAC,AA7HD,IA6HC"}

package/lib/loader/AcCmLoadingManager.d.ts

@@ -0,0 +1,119 @@
+import { AcCmLoader } from './AcCmLoader';
+/**
+ * This function will be called when loading starts. The arguments are:
+ * - url: The url of the item just loaded.
+ * - itemsLoaded: the number of items already loaded so far.
+ * - itemsTotal: the total amount of items to be loaded.
+ */
+export type AcCmOnStartCallback = (url: string, itemsLoaded: number, itemsTotal: number) => void;
+/**
+ * This function will be called when all loading is completed.
+ */
+export type AcCmOnLoadCallback = () => void;
+/**
+ * This function will be called when an item is complete. The arguments are:
+ * - url: The url of the item just loaded.
+ * - itemsLoaded: the number of items already loaded so far.
+ * - itemsTotal: the total amount of items to be loaded.
+ */
+export type AcCmOnProgressCallback = (url: string, itemsLoaded: number, itemsTotal: number) => void;
+/**
+ * This function will be called when any item errors, with the argument:
+ * - url: The url of the item that errored.
+ */
+export type AcCmOnErrorCallback = (url: string) => void;
+/**
+ * The callback called before a request is sent. It may return the original URL, or a new URL to override
+ * loading behavior.
+ */
+export type AcCmUrlModifier = (url: string) => string;
+/**
+ * Handles and keeps track of loaded and pending data. A default global instance of this class is
+ * created and used by loaders if not supplied manually. In general that should be sufficient,
+ * however there are times when it can be useful to have separate loaders - for example if you want
+ * to show separate loading bars for objects and textures.
+ */
+export declare class AcCmLoadingManager {
+    /**
+     * This function will be called when loading starts.
+     */
+    onStart?: AcCmOnStartCallback;
+    /**
+     * This function will be called when all loading is completed. By default this is undefined, unless
+     * passed in the constructor.
+     */
+    onLoad?: AcCmOnLoadCallback;
+    /**
+     * This function will be called when an item is complete.
+     */
+    onProgress?: AcCmOnProgressCallback;
+    /**
+     * This function will be called when any item errors.
+     */
+    onError?: AcCmOnErrorCallback;
+    private isLoading;
+    private itemsLoaded;
+    private itemsTotal;
+    private handlers;
+    private urlModifier?;
+    /**
+     * Create a new AcCmLoadingManager instance
+     * @param onLoad this function will be called when all loaders are done.
+     * @param onProgress this function will be called when an item is complete.
+     * @param onError this function will be called a loader encounters errors.
+     */
+    constructor(onLoad?: AcCmOnLoadCallback, onProgress?: AcCmOnProgressCallback, onError?: AcCmOnErrorCallback);
+    /**
+     * This should be called by any loader using the manager when the loader starts loading an url.
+     * @param url The loaded url
+     */
+    itemStart(url: string): void;
+    /**
+     * This should be called by any loader using the manager when the loader ended loading an url.
+     * @param url The loaded url
+     */
+    itemEnd(url: string): void;
+    /**
+     * This should be called by any loader using the manager when the loader errors loading an url.
+     * @param url The loaded url
+     */
+    itemError(url: string): void;
+    /**
+     * Given a URL, uses the URL modifier callback (if any) and returns a resolved URL. If no URL
+     * modifier is set, returns the original URL.
+     * @param url The url to load
+     * @returns Return resolved URL
+     */
+    resolveURL(url: string): string;
+    /**
+     * If provided, the callback will be passed each resource URL before a request is sent. The callback
+     * may return the original URL, or a new URL to override loading behavior. This behavior can be used
+     * to load assets from .ZIP files, drag-and-drop APIs, and Data URIs.
+     * @param transform URL modifier callback. Called with url argument, and must return resolvedURL.
+     * @returns Return this object
+     */
+    setURLModifier(transform: AcCmUrlModifier): this;
+    /**
+     * Register a loader with the given regular expression. Can be used to define what loader should
+     * be used in order to load specific files. A typical use case is to overwrite the default loader
+     * for textures.
+     * @param regex A regular expression.
+     * @param loader The loader.
+     * @returns Return this object
+     */
+    addHandler(regex: RegExp, loader: AcCmLoader): this;
+    /**
+     * Remove the loader for the given regular expression.
+     * @param regex A regular expression.
+     * @returns Return this object
+     */
+    removeHandler(regex: RegExp): this;
+    /**
+     * Retrieve the registered loader for the given file path.
+     * @param file The file path.
+     * @returns Return the registered loader for the given file path.
+     */
+    getHandler(file: string): RegExp | AcCmLoader | null;
+}
+export declare const DefaultLoadingManager: AcCmLoadingManager;
+//# sourceMappingURL=AcCmLoadingManager.d.ts.map

package/lib/loader/AcCmLoadingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcCmLoadingManager.d.ts","sourceRoot":"","sources":["../../src/loader/AcCmLoadingManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,KACf,IAAI,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,KACf,IAAI,CAAA;AAET;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;AAEvD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;AAErD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACI,OAAO,CAAC,EAAE,mBAAmB,CAAA;IACpC;;;OAGG;IACI,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAClC;;OAEG;IACI,UAAU,CAAC,EAAE,sBAAsB,CAAA;IAC1C;;OAEG;IACI,OAAO,CAAC,EAAE,mBAAmB,CAAA;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAC,CAAiB;IAErC;;;;;OAKG;gBAED,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,mBAAmB;IAiB/B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM;IAYrB;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM;IAgBnB;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM;IAMrB;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM;IAQtB;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,eAAe;IAMzC;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;IAK5C;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM;IAU3B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM;CAcxB;AAED,eAAO,MAAM,qBAAqB,oBAAyC,CAAA"}