@galacean/engine-loader 2.0.0-alpha.43 → 2.0.0-alpha.45

package/dist/module.js

@@ -1,4 +1,4 @@
-import { Utils, AssetPromise, AnimationClip, AnimationEvent, Loader, AnimationStringCurve, Keyframe, AnimationBoolCurve, AnimationRefCurve, AnimationQuaternionCurve, AnimationColorCurve, AnimationVector4Curve, AnimationVector3Curve, AnimationVector2Curve, AnimationFloatArrayCurve, AnimationArrayCurve, AnimationFloatCurve, ModelMesh, BlendShape, TextureFormat, Texture2D, TextureCube, TextureCubeFace, ReferResource, Entity, resourceLoader, AssetType, AnimatorController, AnimatorControllerLayer, AnimatorStateTransition, BufferAsset, GLCapabilityType, Logger, ContentRestorer, AmbientLight, DiffuseMode, TextureFilterMode, Font, SystemInfo, Animator, IndexFormat, VertexElementFormat, request, InterpolationType, SkinnedMeshRenderer, Transform, PBRMaterial, TextureCoordinate, RenderFace, VertexElement, Buffer, BufferBindFlag, BufferUsage, Camera, MeshRenderer, Skin, TextureWrapMode as TextureWrapMode$1, TextureUtils, AnimatorStateMachine, JSONAsset, Shader, Material, PrimitiveMesh, SpriteAtlas, Sprite, TextAsset, AudioClip, PhysicsMaterial, RenderTarget, Scene, BackgroundMode, DirectLight, PointLight, SpotLight, UnlitMaterial } from '@galacean/engine-core';
+import { Utils, AssetPromise, AnimationClip, AnimationEvent, Loader, AnimationStringCurve, Keyframe, AnimationBoolCurve, AnimationRefCurve, AnimationQuaternionCurve, AnimationColorCurve, AnimationVector4Curve, AnimationVector3Curve, AnimationVector2Curve, AnimationFloatArrayCurve, AnimationArrayCurve, AnimationFloatCurve, ModelMesh, BlendShape, TextureFormat, Texture2D, TextureCube, TextureCubeFace, ReferResource, Entity, resourceLoader, AssetType, AnimatorController, AnimatorControllerLayer, AnimatorStateTransition, BufferAsset, GLCapabilityType, Logger, ContentRestorer, AmbientLight, DiffuseMode, TextureFilterMode, Font, SystemInfo, Animator, IndexFormat, VertexElementFormat, request, InterpolationType, SkinnedMeshRenderer, Transform, PBRMaterial, TextureCoordinate, RenderFace, VertexElement, Buffer, BufferBindFlag, BufferUsage, Camera, MeshRenderer, Skin, TextureWrapMode as TextureWrapMode$1, TextureUtils, AnimatorStateMachine, JSONAsset, Shader, Material, Texture, PrimitiveMesh, SpriteAtlas, Sprite, TextAsset, AudioClip, PhysicsMaterial, RenderTarget, Scene, BackgroundMode, DirectLight, PointLight, SpotLight, UnlitMaterial } from '@galacean/engine-core';
 import { Quaternion, Vector4, Color, Vector3, Vector2, MathUtil, SphericalHarmonics3, Matrix, BoundingBox, Rect } from '@galacean/engine-math';
 import { GLCompressedTextureInternalFormat } from '@galacean/engine-rhi-webgl';
 
@@ -894,7 +894,6 @@ var ReflectionParser = /*#__PURE__*/ function() {
             } catch (error) {
                 return Promise.reject(error);
             }
-            // @ts-ignore
             return context.resourceManager.getResourceByRef(refItem).then(function(resource) {
                 if (resource && context.type === ParserType.Prefab) {
                     // @ts-ignore
@@ -1342,7 +1341,6 @@ function _instanceof(left, right) {
         // ReferResource requires the engine to be passed as a parameter, which prevents cross-engine reuse.
         // A refactor of ReferResource will be needed in the future.
         if (_instanceof(resource, ReferResource)) {
-            // @ts-ignore
             resource._associationSuperResource(this);
         }
     };
@@ -1353,7 +1351,6 @@ function _instanceof(left, right) {
         (_this__root = this._root) == null ? void 0 : _this__root.destroy();
         this._dependenceAssets.forEach(function(asset) {
             if (_instanceof(asset, ReferResource)) {
-                // @ts-ignore
                 asset._disassociationSuperResource(_this);
             }
         });
@@ -1571,8 +1568,7 @@ function _instanceof(left, right) {
         } catch (error) {
             return Promise.reject(error);
         }
-        return engine.resourceManager// @ts-ignore
-        .getResourceByRef(refItem).then(function(prefabResource) {
+        return engine.resourceManager.getResourceByRef(refItem).then(function(prefabResource) {
             var entity = _instanceof(prefabResource, PrefabResource) ? prefabResource.instantiate() : prefabResource.instantiateSceneRoot();
             _this._onEntityCreated(entity);
             return entity;
@@ -1635,7 +1631,6 @@ function _instanceof(left, right) {
         var resourceManager = context.resourceManager;
         var refs = data.refs;
         for(var i = 0, n = refs.length; i < n; i++){
-            // @ts-ignore
             context._addDependentAsset(resourceManager.getResourceByRef(refs[i]));
         }
     };
@@ -1700,8 +1695,7 @@ var AnimationClipLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var _this = this;
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "arraybuffer"
             })).then(function(data) {
                 return decode(data, resourceManager.engine).then(function(clip) {
@@ -1725,8 +1719,7 @@ var AnimationClipLoader = /*#__PURE__*/ function(Loader) {
         var value = keyframe.value;
         if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === "object" && (value == null ? void 0 : value.url)) {
             return new Promise(function(resolve) {
-                resourceManager// @ts-ignore
-                .getResourceByRef(value).then(function(asset) {
+                resourceManager.getResourceByRef(value).then(function(asset) {
                     keyframe.value = asset;
                     resolve(keyframe.value);
                 });
@@ -1752,8 +1745,7 @@ var AnimatorControllerLoader = /*#__PURE__*/ function(Loader1) {
     _proto.load = function load(item, resourceManager) {
         var _this = this;
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             })).then(function(data) {
                 var animatorController = new AnimatorController(resourceManager.engine);
@@ -1782,7 +1774,6 @@ var AnimatorControllerLoader = /*#__PURE__*/ function(Loader1) {
                             statesMap[id] = state;
                             if (clipData) {
                                 promises.push(new Promise(function(resolve) {
-                                    //@ts-ignore
                                     resourceManager.getResourceByRef(clipData).then(function(clip) {
                                         resolve({
                                             layerIndex: layerIndex,
@@ -1839,7 +1830,6 @@ var AnimatorControllerLoader = /*#__PURE__*/ function(Loader1) {
         transition.exitTime = transitionData.exitTime;
         transition.solo = transitionData.solo;
         transition.mute = transitionData.mute;
-        // @ts-ignore
         transition._isExit = transitionData.isExit;
         transition.destinationState = destinationState;
         transitionData.conditions.forEach(function(conditionData) {
@@ -2484,14 +2474,12 @@ var KTX2Loader = /*#__PURE__*/ function(Loader) {
     /**
    * @internal
    */ _proto.load = function load(item, resourceManager) {
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteUrl = resourceManager._getRemoteUrl(item.url);
         return new AssetPromise(function(resolve, reject, setTaskCompleteProgress, setTaskDetailProgress) {
             var requestConfig = _extends({}, item, {
                 type: "arraybuffer"
             });
-            resourceManager// @ts-ignore
-            ._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(setTaskCompleteProgress, setTaskDetailProgress).then(function(buffer) {
+            resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(setTaskCompleteProgress, setTaskDetailProgress).then(function(buffer) {
                 return KTX2Loader._parseBuffer(new Uint8Array(buffer), resourceManager.engine, item.params).then(function(param) {
                     var ktx2Container = param.ktx2Container, engine = param.engine, result = param.result, targetFormat = param.targetFormat, params = param.params;
                     return KTX2Loader._createTextureByBuffer(engine, ktx2Container.isSRGB, result, targetFormat, params);
@@ -2691,8 +2679,7 @@ var KTX2ContentRestorer = /*#__PURE__*/ function(ContentRestorer) {
         var _this1 = this, resource = _this1.resource, requestConfig = _this1.requestConfig;
         var engine = resource.engine;
         return new AssetPromise(function(resolve, reject) {
-            engine.resourceManager// @ts-ignore
-            ._requestByRemoteUrl(_this.remoteUrl, requestConfig).then(function(buffer) {
+            engine.resourceManager._requestByRemoteUrl(_this.remoteUrl, requestConfig).then(function(buffer) {
                 return KTX2Loader._parseBuffer(new Uint8Array(buffer), engine, requestConfig.params).then(function(param) {
                     var ktx2Container = param.ktx2Container, engine = param.engine, result = param.result, targetFormat = param.targetFormat, params = param.params;
                     return KTX2Loader._createTextureByBuffer(engine, ktx2Container.isSRGB, result, targetFormat, params, resource);
@@ -2710,15 +2697,13 @@ var AmbientLightLoader = /*#__PURE__*/ function(Loader) {
     }
     var _proto = AmbientLightLoader.prototype;
     _proto.load = function load(item, resourceManager) {
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteUrl = resourceManager._getRemoteUrl(item.url);
         return new AssetPromise(function(resolve, reject) {
             var requestConfig = _extends({}, item, {
                 type: "arraybuffer"
             });
             var engine = resourceManager.engine;
-            resourceManager// @ts-ignore
-            ._requestByRemoteUrl(remoteUrl, requestConfig).then(function(buffer) {
+            resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).then(function(buffer) {
                 var header = FileHeader.decode(buffer);
                 var dataOffset = header.headerLength;
                 var sh = new SphericalHarmonics3();
@@ -2785,8 +2770,7 @@ AmbientLightLoader = __decorate([
         return new AssetPromise(function(resolve, reject) {
             var resource = _this.resource;
             var engine = resource.engine;
-            engine.resourceManager// @ts-ignore
-            ._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(buffer) {
+            engine.resourceManager._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(buffer) {
                 var header = FileHeader.decode(buffer);
                 var dataOffset = header.headerLength;
                 var textureOffset = dataOffset + AmbientLightLoader._shByteLength;
@@ -2837,14 +2821,12 @@ var FontLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var _this = this;
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             })).then(function(data) {
                 var fontName = data.fontName, fontUrl = data.fontUrl;
                 if (fontUrl) {
                     var absoluteUrl = Utils.resolveAbsoluteUrl(item.url, fontUrl);
-                    // @ts-ignore
                     var remoteUrl = resourceManager._getRemoteUrl(absoluteUrl);
                     _this._registerFont(fontName, remoteUrl).then(function() {
                         var font = new Font(resourceManager.engine, fontName);
@@ -2958,7 +2940,6 @@ function getMeshoptDecoder() {
         73,
         115
     ]);
-    // @ts-ignore
     var wasm = SystemInfo._detectSIMDSupported() ? wasm_simd : wasm_base;
     var instance;
     ready = WebAssembly.instantiate(unpack(wasm)).then(function(result) {
@@ -3109,19 +3090,18 @@ function getMeshoptDecoder() {
     _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         var _this = this, textures = _this.textures, materials = _this.materials, meshes = _this.meshes;
-        textures && this._disassociationSuperResource(textures);
-        materials && this._disassociationSuperResource(materials);
+        textures && this._disassociateResources(textures);
+        materials && this._disassociateResources(materials);
         if (meshes) {
             for(var i = 0, n = meshes.length; i < n; i++){
                 var meshArr = meshes[i];
-                meshArr && this._disassociationSuperResource(meshArr);
+                meshArr && this._disassociateResources(meshArr);
             }
         }
     };
-    _proto._disassociationSuperResource = function _disassociationSuperResource(resources) {
+    _proto._disassociateResources = function _disassociateResources(resources) {
         for(var i = 0, n = resources.length; i < n; i++){
-            var // @ts-ignore
-            _resources_i;
+            var _resources_i;
             (_resources_i = resources[i]) == null ? void 0 : _resources_i._disassociationSuperResource(this);
         }
     };
@@ -3340,7 +3320,6 @@ function getMeshoptDecoder() {
             detail.total = total;
             _this._setTaskDetailProgress(url, loaded, total);
         };
-        // @ts-expect-error -- internal method is omitted from public declarations
         this._remoteAssetBaseURL = resourceManager._getRemoteUrl(glTFResource.url);
         this.contentRestorer = new GLTFContentRestorer(glTFResource);
     }
@@ -3443,15 +3422,12 @@ function getMeshoptDecoder() {
                 if (type === 7) {
                     for(var i = 0, length = item.length; i < length; i++){
                         var mesh = item[i];
-                        // @ts-ignore
                         _this.resourceManager._onSubAssetSuccess(remoteAssetBaseURL, glTFResourceKey + "[" + index + "][" + i + "]", mesh);
                     }
                 } else {
-                    // @ts-ignore
                     _this.resourceManager._onSubAssetSuccess(remoteAssetBaseURL, "" + glTFResourceKey + (index === undefined ? "" : "[" + index + "]"), item);
                     var _this_glTF_scene;
                     if (type === 2 && ((_this_glTF_scene = _this.glTF.scene) != null ? _this_glTF_scene : 0) === index) {
-                        // @ts-ignore
                         _this.resourceManager._onSubAssetSuccess(remoteAssetBaseURL, "defaultSceneRoot", item);
                     }
                 }
@@ -4255,10 +4231,8 @@ var GLTFSchemaParser = /*#__PURE__*/ function(GLTFParser) {
         var requestConfig = {
             type: "arraybuffer"
         };
-        // @ts-ignore
         var remoteUrl = resourceManager._getRemoteUrl(url);
-        return resourceManager// @ts-ignore
-        ._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(undefined, context._onTaskDetail).then(function(buffer) {
+        return resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(undefined, context._onTaskDetail).then(function(buffer) {
             var parseResult = GLTFUtils.parseGLB(context, buffer);
             // If the buffer is a GLB file, we need to restore the buffer data
             if (parseResult == null ? void 0 : parseResult.glTF) {
@@ -4491,15 +4465,13 @@ var GLTFBufferParser = /*#__PURE__*/ function(GLTFParser) {
         var glTFResource = context.glTFResource, contentRestorer = context.contentRestorer, resourceManager = context.resourceManager;
         var url = glTFResource.url;
         var absoluteUrl = Utils.resolveAbsoluteUrl(url, bufferInfo.uri);
-        // @ts-ignore
         var remoteUrl = resourceManager._getRemoteUrl(absoluteUrl);
         var restoreBufferRequests = contentRestorer.bufferRequests;
         var requestConfig = {
             type: "arraybuffer"
         };
         restoreBufferRequests.push(new BufferRequestInfo(remoteUrl, requestConfig));
-        var promise = resourceManager// @ts-ignore
-        ._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(undefined, context._onTaskDetail);
+        var promise = resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(undefined, context._onTaskDetail);
         context._addTaskCompletePromise(promise);
         return promise;
     };
@@ -4521,7 +4493,6 @@ var GLTFEntityParser = /*#__PURE__*/ function(GLTFParser1) {
         var engine = glTFResource.engine;
         var matrix = entityInfo.matrix, translation = entityInfo.translation, rotation = entityInfo.rotation, scale = entityInfo.scale, extensions = entityInfo.extensions;
         var entity = new Entity(engine, entityInfo.name || "_GLTF_ENTITY_" + index);
-        // @ts-ignore
         entity._markAsTemplate(glTFResource);
         var transform = entity.transform;
         if (matrix) {
@@ -4581,10 +4552,8 @@ var GLTFMaterialParser = /*#__PURE__*/ function(GLTFParser1) {
             GLTFMaterialParser._parseStandardProperty(context, material, materialInfo);
         }
         return AssetPromise.resolve(material).then(function(material) {
-            // @ts-ignore
             material || (material = engine._basicResources._getBlinnPhongMaterial());
             GLTFParser.executeExtensionsAdditiveAndParse(extensions, context, material, materialInfo);
-            // @ts-ignore
             material._associationSuperResource(glTFResource);
             return material;
         });
@@ -4705,19 +4674,16 @@ var GLTFMeshParser = /*#__PURE__*/ function(GLTFParser1) {
                 var mesh = GLTFParser.executeExtensionsCreateAndParse(gltfPrimitive.extensions, context, gltfPrimitive, meshInfo);
                 if (mesh) {
                     if (_instanceof(mesh, ModelMesh)) {
-                        // @ts-ignore
                         mesh._associationSuperResource(glTFResource);
                         resolve(mesh);
                     } else {
                         mesh.then(function(mesh) {
-                            // @ts-ignore
                             mesh._associationSuperResource(glTFResource);
                             resolve(mesh);
                         });
                     }
                 } else {
                     var mesh1 = new ModelMesh(engine, meshInfo.name || i + "");
-                    // @ts-ignore
                     mesh1._associationSuperResource(glTFResource);
                     var meshRestoreInfo = new ModelMeshRestoreInfo();
                     meshRestoreInfo.mesh = mesh1;
@@ -4914,7 +4880,6 @@ var GLTFSceneParser = /*#__PURE__*/ function(GLTFParser1) {
         var sceneNodes = sceneInfo.nodes || [];
         var sceneRoot;
         sceneRoot = new Entity(engine, "GLTF_ROOT");
-        // @ts-ignore
         sceneRoot._markAsTemplate(glTFResource);
         for(var i = 0; i < sceneNodes.length; i++){
             sceneRoot.addChild(context.get(GLTFParserType.Entity, sceneNodes[i]));
@@ -5036,7 +5001,6 @@ var GLTFSceneParser = /*#__PURE__*/ function(GLTFParser1) {
                 GLTFParser.executeExtensionsAdditiveAndParse(glTFPrimitive.extensions, context, renderer, glTFPrimitive);
             };
             var meshes = param[0], skin = param[1], materials = param[2];
-            // @ts-ignore
             var basicResources = context.glTFResource.engine._basicResources;
             for(var i = 0; i < rendererCount; i++)_loop(i);
         }).catch(function(e) {
@@ -5164,7 +5128,6 @@ var GLTFTextureParser = /*#__PURE__*/ function(GLTFParser1) {
         }
         return AssetPromise.resolve(texture).then(function(texture) {
             GLTFParser.executeExtensionsAdditiveAndParse(extensions, context, texture, textureInfo);
-            // @ts-ignore
             texture._associationSuperResource(glTFResource);
             return texture;
         });
@@ -5448,8 +5411,7 @@ var PrefabLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var engine = resourceManager.engine;
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             })).then(function(data) {
                 PrefabParser.parse(engine, item.url, data).then(resolve).catch(reject);
@@ -5471,7 +5433,6 @@ var JSONLoader = /*#__PURE__*/ function(Loader) {
     }
     var _proto = JSONLoader.prototype;
     _proto.load = function load(item, resourceManager) {
-        // @ts-ignore
         return resourceManager._request(item.url, _extends({}, item, {
             type: "json"
         })).then(function(data) {
@@ -5682,10 +5643,9 @@ var KTXCubeLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         return new AssetPromise(function(resolve, reject) {
             Promise.all(item.urls.map(function(url) {
-                return(// @ts-ignore
-                resourceManager._request(url, _extends({}, item, {
+                return resourceManager._request(url, _extends({}, item, {
                     type: "arraybuffer"
-                })));
+                }));
             })).then(function(data) {
                 var parsedData = parseCubeKTX(data);
                 var width = parsedData.width, mipmapsFaces = parsedData.mipmapsFaces, engineFormat = parsedData.engineFormat;
@@ -5717,14 +5677,12 @@ var KTXLoader = /*#__PURE__*/ function(Loader) {
     }
     var _proto = KTXLoader.prototype;
     _proto.load = function load(item, resourceManager) {
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteUrl = resourceManager._getRemoteUrl(item.url);
         var requestConfig = _extends({}, item, {
             type: "arraybuffer"
         });
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._requestByRemoteUrl(remoteUrl, requestConfig).then(function(bin) {
+            resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).then(function(bin) {
                 var parsedData = parseSingleKTX(bin);
                 var width = parsedData.width, height = parsedData.height, mipmaps = parsedData.mipmaps, engineFormat = parsedData.engineFormat;
                 var mipmap = mipmaps.length > 1;
@@ -5760,8 +5718,7 @@ var KTXContentRestorer = /*#__PURE__*/ function(ContentRestorer) {
         var resource = this.resource;
         var engine = resource.engine;
         return new AssetPromise(function(resolve, reject) {
-            engine.resourceManager// @ts-ignore
-            ._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(bin) {
+            engine.resourceManager._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(bin) {
                 var mipmaps = parseSingleKTX(bin).mipmaps;
                 for(var miplevel = 0; miplevel < mipmaps.length; miplevel++){
                     var _mipmaps_miplevel = mipmaps[miplevel], width = _mipmaps_miplevel.width, height = _mipmaps_miplevel.height, data = _mipmaps_miplevel.data;
@@ -5776,6 +5733,7 @@ var KTXContentRestorer = /*#__PURE__*/ function(ContentRestorer) {
     return KTXContentRestorer;
 }(ContentRestorer);
 
+var materialLoaderTypes = new Set(Object.values(MaterialLoaderType));
 var MaterialLoader = /*#__PURE__*/ function(Loader) {
     _inherits(MaterialLoader, Loader);
     function MaterialLoader() {
@@ -5784,23 +5742,30 @@ var MaterialLoader = /*#__PURE__*/ function(Loader) {
     var _proto = MaterialLoader.prototype;
     _proto.load = function load(item, resourceManager) {
         var _this = this;
-        return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
-                type: "json"
-            })).then(function(materialSchema) {
-                var engine = resourceManager.engine;
-                var shaderRef = materialSchema.shaderRef, shaderName = materialSchema.shader;
-                var shader = Shader.find(shaderName);
-                if (shader) {
-                    resolve(_this._getMaterialByShader(materialSchema, shader, engine));
-                } else if (shaderRef) {
-                    resolve(resourceManager// @ts-ignore
-                    .getResourceByRef(shaderRef).then(function(shader) {
-                        return _this._getMaterialByShader(materialSchema, shader, engine);
-                    }));
+        return resourceManager._request(item.url, _extends({}, item, {
+            type: "json"
+        })).then(function(materialSchema) {
+            var shaderData = materialSchema.shaderData, shaderRef = materialSchema.shaderRef, shaderName = materialSchema.shader;
+            for(var key in shaderData){
+                var type = shaderData[key].type;
+                if (!materialLoaderTypes.has(type)) {
+                    throw new Error('MaterialLoader: unsupported shader data type "' + type + '".');
                 }
-            }).catch(reject);
+            }
+            var engine = resourceManager.engine;
+            var shader = Shader.find(shaderName);
+            if (shader) {
+                return _this._getMaterialByShader(materialSchema, shader, engine);
+            }
+            if (!shaderRef) {
+                throw new Error('MaterialLoader: shader "' + shaderName + '" not found.');
+            }
+            return resourceManager.getResourceByRef(shaderRef).then(function(shader) {
+                if (!_instanceof(shader, Shader)) {
+                    throw new Error('MaterialLoader: shader reference "' + shaderRef.url + '" did not resolve to a Shader.');
+                }
+                return _this._getMaterialByShader(materialSchema, shader, engine);
+            });
         });
     };
     _proto._getMaterialByShader = function _getMaterialByShader(materialSchema, shader, engine) {
@@ -5823,8 +5788,10 @@ var MaterialLoader = /*#__PURE__*/ function(Loader) {
                     materialShaderData.setFloat(key, value);
                     break;
                 case MaterialLoaderType.Texture:
-                    texturePromises.push(// @ts-ignore
-                    engine.resourceManager.getResourceByRef(value).then(function(texture) {
+                    texturePromises.push(engine.resourceManager.getResourceByRef(value).then(function(texture) {
+                        if (!_instanceof(texture, Texture)) {
+                            throw new Error('MaterialLoader: texture reference "' + value.url + '" did not resolve to a Texture.');
+                        }
                         materialShaderData.setTexture(key, texture);
                     }));
                     break;
@@ -5834,6 +5801,8 @@ var MaterialLoader = /*#__PURE__*/ function(Loader) {
                 case MaterialLoaderType.Integer:
                     materialShaderData.setInt(key, Number(value));
                     break;
+                default:
+                    throw new Error('MaterialLoader: unsupported shader data type "' + type + '".');
             }
         };
         var name = materialSchema.name, shaderData = materialSchema.shaderData, macros = materialSchema.macros;
@@ -5852,6 +5821,9 @@ var MaterialLoader = /*#__PURE__*/ function(Loader) {
         }
         return Promise.all(texturePromises).then(function() {
             return material;
+        }, function(error) {
+            material.destroy();
+            throw error;
         });
     };
     return MaterialLoader;
@@ -5872,11 +5844,9 @@ var MeshLoader = /*#__PURE__*/ function(Loader) {
         var requestConfig = _extends({}, item, {
             type: "arraybuffer"
         });
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteUrl = resourceManager._getRemoteUrl(item.url);
         return new AssetPromise(function(resolve, reject) {
-            resourceManager// @ts-ignore
-            ._requestByRemoteUrl(remoteUrl, requestConfig).then(function(data) {
+            resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).then(function(data) {
                 return decode(data, resourceManager.engine);
             }).then(function(mesh) {
                 resourceManager.addContentRestorer(new MeshContentRestorer(mesh, remoteUrl, requestConfig));
@@ -5904,8 +5874,7 @@ var MeshContentRestorer = /*#__PURE__*/ function(ContentRestorer) {
         var resource = this.resource;
         var engine = resource.engine;
         return new AssetPromise(function(resolve, reject) {
-            engine.resourceManager// @ts-ignore
-            ._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(data) {
+            engine.resourceManager._requestByRemoteUrl(_this.remoteUrl, _this.requestConfig).then(function(data) {
                 return decode(data, engine, resource);
             }).then(function(mesh) {
                 resolve(mesh);
@@ -5923,8 +5892,7 @@ var PrimitiveMeshLoader = /*#__PURE__*/ function(Loader) {
     var _proto = PrimitiveMeshLoader.prototype;
     _proto.load = function load(item, resourceManager) {
         var engine = resourceManager.engine;
-        return resourceManager// @ts-ignore
-        ._request(item.url, _extends({}, item, {
+        return resourceManager._request(item.url, _extends({}, item, {
             type: "json"
         })).then(function(data) {
             switch(data.type){
@@ -5962,8 +5930,7 @@ var ProjectLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var engine = resourceManager.engine;
         return new AssetPromise(function(resolve, reject, onTaskCompeteProgress) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             })).then(function(data) {
                 engine.resourceManager.registerVirtualResources(data.files);
@@ -5994,7 +5961,6 @@ var SourceFontLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var _this = this;
         return new AssetPromise(function(resolve, reject) {
-            // @ts-ignore
             var url = resourceManager._getRemoteUrl(item.url);
             _this._registerFont(url, url).then(function() {
                 var font = new Font(resourceManager.engine, url);
@@ -6052,7 +6018,6 @@ var SpriteAtlasLoader = /*#__PURE__*/ function(Loader) {
                     chainPromises[i].cancel();
                 }
             });
-            // @ts-ignore
             var configPromise = resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             }));
@@ -6075,13 +6040,11 @@ var SpriteAtlasLoader = /*#__PURE__*/ function(Loader) {
                             wrapModeU !== undefined && (texture.wrapModeU = wrapModeU);
                             wrapModeV !== undefined && (texture.wrapModeV = wrapModeV);
                             for(var i = 0; i < atlasItem.sprites.length; i++){
-                                // @ts-ignore
                                 spriteAtlas._addSprite(_this._makeSprite(engine, atlasItem.sprites[i], texture));
                             }
                         }).catch(reject));
                     } else {
                         for(var i1 = 0; i1 < atlasItem.sprites.length; i1++){
-                            // @ts-ignore
                             spriteAtlas._addSprite(_this._makeSprite(engine, atlasItem.sprites[i1]));
                         }
                     }
@@ -6136,8 +6099,7 @@ var SpriteLoader = /*#__PURE__*/ function(Loader) {
     var _proto = SpriteLoader.prototype;
     _proto.load = function load(item, resourceManager) {
         var _this = this;
-        return resourceManager// @ts-ignore
-        ._request(item.url, _extends({}, item, {
+        return resourceManager._request(item.url, _extends({}, item, {
             type: "json"
         })).then(function(data) {
             return data.belongToAtlas ? _this._loadFromAtlas(resourceManager, data) : _this._loadFromTexture(resourceManager, data);
@@ -6145,15 +6107,13 @@ var SpriteLoader = /*#__PURE__*/ function(Loader) {
     };
     _proto._loadFromAtlas = function _loadFromAtlas(resourceManager, data) {
         var _this = this;
-        return resourceManager// @ts-ignore
-        .getResourceByRef(data.belongToAtlas).then(function(atlas) {
+        return resourceManager.getResourceByRef(data.belongToAtlas).then(function(atlas) {
             return atlas.getSprite(data.fullPath) || _this._loadFromTexture(resourceManager, data);
         });
     };
     _proto._loadFromTexture = function _loadFromTexture(resourceManager, data) {
         if (data.texture) {
-            return resourceManager// @ts-ignore
-            .getResourceByRef(data.texture).then(function(texture) {
+            return resourceManager.getResourceByRef(data.texture).then(function(texture) {
                 var sprite = new Sprite(resourceManager.engine, texture, data.region, data.pivot, data.border);
                 var width = data.width, height = data.height;
                 width === undefined || (sprite.width = width);
@@ -6185,7 +6145,6 @@ var TextLoader = /*#__PURE__*/ function(Loader) {
     }
     var _proto = TextLoader.prototype;
     _proto.load = function load(item, resourceManager) {
-        // @ts-ignore
         return resourceManager._request(item.url, _extends({}, item, {
             type: "text"
         })).then(function(text) {
@@ -6211,14 +6170,12 @@ var TextureLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var _this = this;
         var url = item.url;
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteUrl = resourceManager._getRemoteUrl(url);
         var requestConfig = _extends({}, item, {
             type: "arraybuffer"
         });
         return new AssetPromise(function(resolve, reject, setTaskCompleteProgress, setTaskDetailProgress) {
-            resourceManager// @ts-ignore
-            ._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(setTaskCompleteProgress, setTaskDetailProgress).then(function(buffer) {
+            resourceManager._requestByRemoteUrl(remoteUrl, requestConfig).onProgress(setTaskCompleteProgress, setTaskDetailProgress).then(function(buffer) {
                 _this._decode(buffer, item, resourceManager).then(function(texture) {
                     resourceManager.addContentRestorer(new TextureContentRestorer(texture, url, remoteUrl, requestConfig));
                     resolve(texture);
@@ -6304,8 +6261,7 @@ var TextureContentRestorer = /*#__PURE__*/ function(ContentRestorer) {
     var _proto = TextureContentRestorer.prototype;
     _proto.restoreContent = function restoreContent() {
         var _this = this;
-        return this.resource.engine.resourceManager// @ts-ignore
-        ._requestByRemoteUrl(this.remoteUrl, this.requestConfig).then(function(buffer) {
+        return this.resource.engine.resourceManager._requestByRemoteUrl(this.remoteUrl, this.requestConfig).then(function(buffer) {
             if (FileHeader.checkMagic(buffer)) {
                 return decode(buffer, _this.resource.engine, _this.resource);
             }
@@ -6359,11 +6315,9 @@ var AudioLoader = /*#__PURE__*/ function(Loader) {
             var requestConfig = _extends({}, item, {
                 type: "arraybuffer"
             });
-            resourceManager// @ts-ignore
-            ._request(url, requestConfig).then(function(arrayBuffer) {
+            resourceManager._request(url, requestConfig).then(function(arrayBuffer) {
                 var audioClip = new AudioClip(resourceManager.engine);
                 AudioLoader._getDecodeContext().decodeAudioData(arrayBuffer).then(function(result) {
-                    // @ts-ignore
                     audioClip._setAudioSource(result);
                     if (url.indexOf("data:") !== 0) {
                         var index = url.lastIndexOf("/");
@@ -6405,16 +6359,15 @@ var ShaderLoader = /*#__PURE__*/ function(Loader) {
     var _proto = ShaderLoader.prototype;
     _proto.load = function load(item, resourceManager) {
         var url = item.url;
-        // @ts-expect-error _request is @internal
         return resourceManager._request(url, _extends({}, item, {
             type: "text"
         })).then(function(code) {
             var source = code.trimStart();
-            if (source.startsWith("{")) {
-                // @ts-expect-error _createFromPrecompiled is @internal
-                return Shader._createFromPrecompiled(JSON.parse(source));
+            var shader = source.startsWith("{") ? Shader._createFromPrecompiled(JSON.parse(source)) : Shader.create(code, undefined, url);
+            if (!shader) {
+                throw new Error('ShaderLoader: failed to create shader "' + url + '".');
             }
-            return Shader.create(code, undefined, url);
+            return shader;
         });
     };
     return ShaderLoader;
@@ -6433,8 +6386,7 @@ var PhysicsMaterialLoader = /*#__PURE__*/ function(Loader) {
     }
     var _proto = PhysicsMaterialLoader.prototype;
     _proto.load = function load(item, resourceManager) {
-        return resourceManager// @ts-ignore
-        ._request(item.url, _extends({}, item, {
+        return resourceManager._request(item.url, _extends({}, item, {
             type: "json"
         })).then(function(data) {
             var physicsMaterial = new PhysicsMaterial();
@@ -6462,10 +6414,8 @@ var RenderTargetLoader = /*#__PURE__*/ function(Loader) {
     var _proto = RenderTargetLoader.prototype;
     _proto.load = function load(item, resourceManager) {
         var engine = resourceManager.engine;
-        // @ts-expect-error -- internal method is omitted from public declarations
         var remoteAssetBaseURL = resourceManager._getRemoteUrl(item.url);
-        return resourceManager// @ts-ignore
-        ._requestByRemoteUrl(remoteAssetBaseURL, _extends({}, item, {
+        return resourceManager._requestByRemoteUrl(remoteAssetBaseURL, _extends({}, item, {
             type: "json"
         })).then(function(data) {
             var width = data.width, height = data.height, colorFormats = data.colorFormats, depthFormat = data.depthFormat, antiAliasing = data.antiAliasing, autoGenerateMipmaps = data.autoGenerateMipmaps;
@@ -6490,7 +6440,6 @@ var RenderTargetLoader = /*#__PURE__*/ function(Loader) {
             if (autoGenerateMipmaps != null) rt.autoGenerateMipmaps = autoGenerateMipmaps;
             // Notify pending sub-asset requests for colorTextures
             for(var i = 0, n = colorTextures.length; i < n; i++){
-                // @ts-ignore
                 resourceManager._onSubAssetSuccess(remoteAssetBaseURL, "colorTextures[" + i + "]", colorTextures[i]);
             }
             return rt;
@@ -6506,7 +6455,6 @@ RenderTargetLoader = __decorate([
 
 function loadRef(refs, index, resourceManager, label) {
     var ref = resolveRefItem(refs, index, "SceneLoader", label);
-    // @ts-ignore
     return resourceManager.getResourceByRef(ref);
 }
 /**
@@ -6629,8 +6577,7 @@ var SceneLoader = /*#__PURE__*/ function(Loader) {
     _proto.load = function load(item, resourceManager) {
         var engine = resourceManager.engine;
         return new AssetPromise(function(resolve, reject, setTaskCompleteProgress) {
-            resourceManager// @ts-ignore
-            ._request(item.url, _extends({}, item, {
+            resourceManager._request(item.url, _extends({}, item, {
                 type: "json"
             })).then(function(data) {
                 var _data_scene_name;
@@ -6998,7 +6945,6 @@ var GALACEAN_materials_remap = /*#__PURE__*/ function(GLTFExtensionParser) {
     var _proto = GALACEAN_materials_remap.prototype;
     _proto.createAndParse = function createAndParse(context, schema) {
         var engine = context.glTFResource.engine;
-        // @ts-ignore
         var promise = engine.resourceManager.getResourceByRef(schema);
         context._addTaskCompletePromise(promise);
         return promise;