@mlightcad/common 1.2.3 → 1.2.4

package/lib/loader/AcCmFileLoader.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview HTTP-based file loader implementation for the AutoCAD Common library.
+ *
+ * This module provides a concrete implementation of the loader interface using
+ * the Fetch API for loading files over HTTP. Supports various response types
+ * and provides comprehensive error handling.
+ *
+ * @module AcCmFileLoader
+ * @version 1.0.0
+ */
+import { AcCmLoader, AcCmLoaderProgressCallback } from './AcCmLoader';
+import { AcCmLoadingManager, AcCmOnErrorCallback, AcCmOnLoadCallback } from './AcCmLoadingManager';
+/**
+ * The supported response types for file loading operations.
+ *
+ * - `''` or `'text'` - Returns the data as a string (default).
+ * - `'arraybuffer'` - Loads the data into an ArrayBuffer.
+ * - `'blob'` - Returns the data as a Blob.
+ * - `'document'` - Parses the file using the DOMParser.
+ * - `'json'` - Parses the file using JSON.parse.
+ */
+type AcCmResponseType = '' | 'text' | 'arraybuffer' | 'blob' | 'document' | 'json';
+/**
+ * HTTP-based file loader using the Fetch API.
+ *
+ * A low-level class for loading resources over HTTP, used internally by most loaders.
+ * It can also be used directly to load any file type that does not have a specialized loader.
+ *
+ * Supports various response types, custom MIME types, and provides comprehensive error handling
+ * with automatic retry mechanisms for failed requests.
+ *
+ * @example
+ * ```typescript
+ * import { AcCmFileLoader } from './AcCmFileLoader'
+ *
+ * const loader = new AcCmFileLoader()
+ *
+ * // Load a text file
+ * loader.load(
+ *   'data.txt',
+ *   (data) => console.log('Loaded:', data),
+ *   (progress) => console.log('Progress:', progress.loaded / progress.total),
+ *   (error) => console.error('Error:', error)
+ * )
+ *
+ * // Load binary data
+ * loader.setResponseType('arraybuffer')
+ * loader.load('file.dwg', (arrayBuffer) => {
+ *   // Process binary data
+ * })
+ * ```
+ */
+export declare class AcCmFileLoader extends AcCmLoader {
+    /**
+     * The expected mimeType. Default is undefined.
+     */
+    mimeType?: DOMParserSupportedType;
+    /**
+     * The expected response type. Default is undefined.
+     */
+    responseType?: AcCmResponseType;
+    /**
+     * Create a new AcCmFileLoader instance.
+     * @param manager The loadingManager for the loader to use. Default is DefaultLoadingManager.
+     */
+    constructor(manager?: AcCmLoadingManager);
+    /**
+     * 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.
+     */
+    load(url: string, onLoad: AcCmOnLoadCallback, onProgress: AcCmLoaderProgressCallback, onError: AcCmOnErrorCallback): void;
+    /**
+     * 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
+     */
+    setResponseType(value: AcCmResponseType): 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.
+     */
+    setMimeType(value: DOMParserSupportedType): this;
+}
+export {};
+//# sourceMappingURL=AcCmFileLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcCmFileLoader.d.ts","sourceRoot":"","sources":["../../src/loader/AcCmFileLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,sBAAsB,CAAA;AAmC7B;;;;;;;;GAQG;AACH,KAAK,gBAAgB,GACjB,EAAE,GACF,MAAM,GACN,aAAa,GACb,MAAM,GACN,UAAU,GACV,MAAM,CAAA;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C;;OAEG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAA;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B;;;OAGG;gBACS,OAAO,CAAC,EAAE,kBAAkB;IAIxC;;;;;;OAMG;IACH,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,0BAA0B,EACtC,OAAO,EAAE,mBAAmB;IAmL9B;;;;;;;;;OASG;IACH,eAAe,CAAC,KAAK,EAAE,gBAAgB;IAKvC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,sBAAsB;CAI1C"}

package/lib/loader/AcCmFileLoader.js

@@ -0,0 +1,275 @@
+/**
+ * @fileoverview HTTP-based file loader implementation for the AutoCAD Common library.
+ *
+ * This module provides a concrete implementation of the loader interface using
+ * the Fetch API for loading files over HTTP. Supports various response types
+ * and provides comprehensive error handling.
+ *
+ * @module AcCmFileLoader
+ * @version 1.0.0
+ */
+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';
+/**
+ * @internal
+ */
+var loading = {};
+/**
+ * Custom error class for HTTP-related failures.
+ *
+ * @internal
+ */
+var HttpError = /** @class */ (function (_super) {
+    __extends(HttpError, _super);
+    /**
+     * Creates a new HttpError.
+     *
+     * @param {string} message - The error message.
+     * @param {Response} response - The HTTP response that caused the error.
+     */
+    function HttpError(message, response) {
+        var _this = _super.call(this, message) || this;
+        _this.response = response;
+        return _this;
+    }
+    return HttpError;
+}(Error));
+/**
+ * HTTP-based file loader using the Fetch API.
+ *
+ * A low-level class for loading resources over HTTP, used internally by most loaders.
+ * It can also be used directly to load any file type that does not have a specialized loader.
+ *
+ * Supports various response types, custom MIME types, and provides comprehensive error handling
+ * with automatic retry mechanisms for failed requests.
+ *
+ * @example
+ * ```typescript
+ * import { AcCmFileLoader } from './AcCmFileLoader'
+ *
+ * const loader = new AcCmFileLoader()
+ *
+ * // Load a text file
+ * loader.load(
+ *   'data.txt',
+ *   (data) => console.log('Loaded:', data),
+ *   (progress) => console.log('Progress:', progress.loaded / progress.total),
+ *   (error) => console.error('Error:', error)
+ * )
+ *
+ * // Load binary data
+ * loader.setResponseType('arraybuffer')
+ * loader.load('file.dwg', (arrayBuffer) => {
+ *   // Process binary data
+ * })
+ * ```
+ */
+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":"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"}

package/lib/loader/AcCmLoader.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Base loader implementation for the AutoCAD Common library.
+ *
+ * This module provides the abstract base class for all loaders in the system,
+ * defining the common interface and shared functionality for loading various
+ * types of resources.
+ *
+ * @module AcCmLoader
+ * @version 1.0.0
+ */
+import { AcCmLoadingManager, AcCmOnErrorCallback } from './AcCmLoadingManager';
+/**
+ * Callback function for reporting loading progress.
+ *
+ * @param {ProgressEvent} progress - The progress event containing loading information.
+ */
+export type AcCmLoaderProgressCallback = (progress: ProgressEvent) => void;
+/**
+ * Abstract base class for implementing resource loaders.
+ *
+ * This class provides the common functionality and interface that all loaders
+ * must implement, including loading manager integration, path handling, and
+ * configuration options for cross-origin requests.
+ *
+ * @abstract
+ *
+ * @example
+ * ```typescript
+ * class MyCustomLoader extends AcCmLoader {
+ *   load(url: string, onLoad: (data: MyDataType) => void, onProgress?: AcCmLoaderProgressCallback, onError?: AcCmOnErrorCallback): void {
+ *     // Implementation specific loading logic
+ *     const fullUrl = this.resolveURL(url)
+ *     // ... fetch and process data
+ *     onLoad(processedData)
+ *   }
+ * }
+ * ```
+ */
+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;;;;;;;;;GASG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,sBAAsB,CAAA;AAE7B;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;GAoBG;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,116 @@
+/**
+ * @fileoverview Base loader implementation for the AutoCAD Common library.
+ *
+ * This module provides the abstract base class for all loaders in the system,
+ * defining the common interface and shared functionality for loading various
+ * types of resources.
+ *
+ * @module AcCmLoader
+ * @version 1.0.0
+ */
+import { DefaultLoadingManager } from './AcCmLoadingManager';
+/**
+ * Abstract base class for implementing resource loaders.
+ *
+ * This class provides the common functionality and interface that all loaders
+ * must implement, including loading manager integration, path handling, and
+ * configuration options for cross-origin requests.
+ *
+ * @abstract
+ *
+ * @example
+ * ```typescript
+ * class MyCustomLoader extends AcCmLoader {
+ *   load(url: string, onLoad: (data: MyDataType) => void, onProgress?: AcCmLoaderProgressCallback, onError?: AcCmOnErrorCallback): void {
+ *     // Implementation specific loading logic
+ *     const fullUrl = this.resolveURL(url)
+ *     // ... fetch and process data
+ *     onLoad(processedData)
+ *   }
+ * }
+ * ```
+ */
+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;;;;;;;;;GASG;AAEH,OAAO,EAGL,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAS7B;;;;;;;;;;;;;;;;;;;;GAoBG;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"}