@galacean/engine-loader 1.2.0-beta.5 → 1.3.0-alpha.0

package/dist/main.js

@@ -524,12 +524,51 @@ function _construct(Parent, args, Class) {
     return _construct.apply(null, arguments);
 }
 
+exports.ParserType = void 0;
+(function(ParserType) {
+    ParserType[ParserType["Prefab"] = 0] = "Prefab";
+    ParserType[ParserType["Scene"] = 1] = "Scene";
+})(exports.ParserType || (exports.ParserType = {}));
+/**
+ * Parser context
+ * @export
+ * @class ParserContext
+ * @template T
+ * @template I
+ */ var ParserContext = /*#__PURE__*/ function() {
+    function ParserContext(engine, type, resource) {
+        if (type === void 0) type = 1;
+        this.engine = engine;
+        this.type = type;
+        this.resource = resource;
+        this.entityMap = new Map();
+        this.entityConfigMap = new Map();
+        this.components = new Map();
+        this.rootIds = [];
+        this.strippedIds = [];
+        this.resourceManager = engine.resourceManager;
+    }
+    var _proto = ParserContext.prototype;
+    /**
+   * Destroy the context.
+   * @memberof ParserContext
+   */ _proto.clear = function clear() {
+        this.entityMap.clear();
+        this.components.clear();
+        this.entityConfigMap.clear();
+        this.rootIds.length = 0;
+        this.strippedIds.length = 0;
+    };
+    return ParserContext;
+}();
+
 var ReflectionParser = /*#__PURE__*/ function() {
     function ReflectionParser(_context) {
         this._context = _context;
     }
     var _proto = ReflectionParser.prototype;
     _proto.parseEntity = function parseEntity(entityConfig) {
+        var _this = this;
         return this._getEntityByConfig(entityConfig).then(function(entity) {
             var _entityConfig_isActive;
             entity.isActive = (_entityConfig_isActive = entityConfig.isActive) != null ? _entityConfig_isActive : true;
@@ -539,6 +578,8 @@ var ReflectionParser = /*#__PURE__*/ function() {
             if (scale) entity.transform.scale.copyFrom(scale);
             var _entityConfig_layer;
             entity.layer = (_entityConfig_layer = entityConfig.layer) != null ? _entityConfig_layer : entity.layer;
+            // @ts-ignore
+            _this._context.type === exports.ParserType.Prefab && entity._markAsTemplate(_this._context.resource);
             return entity;
         });
     };
@@ -601,26 +642,33 @@ var ReflectionParser = /*#__PURE__*/ function() {
                 // class object
                 return this.parseClassObject(value);
             } else if (ReflectionParser._isAssetRef(value)) {
+                var _this1 = this, context = _this1._context;
                 // reference object
                 // @ts-ignore
-                return this._context.resourceManager.getResourceByRef(value);
+                return context.resourceManager.getResourceByRef(value).then(function(resource) {
+                    if (context.type === exports.ParserType.Prefab) {
+                        // @ts-ignore
+                        context.resource._addDependenceAsset(resource);
+                    }
+                    return resource;
+                });
             } else if (ReflectionParser._isEntityRef(value)) {
                 // entity reference
                 return Promise.resolve(this._context.entityMap.get(value.entityId));
             } else if (originValue) {
-                var _this1 = this, _loop = function(key) {
+                var _this2 = this, _loop = function(key) {
                     if (key === "methods") {
                         var methods = value[key];
                         for(var methodName in methods){
                             var methodParams = methods[methodName];
                             for(var i = 0, count = methodParams.length; i < count; i++){
                                 var params = methodParams[i];
-                                var promise = _this1.parseMethod(originValue, methodName, params);
+                                var promise = _this2.parseMethod(originValue, methodName, params);
                                 promises.push(promise);
                             }
                         }
                     } else {
-                        promises.push(_this1.parseBasicType(value[key], originValue[key]).then(function(v) {
+                        promises.push(_this2.parseBasicType(value[key], originValue[key]).then(function(v) {
                             return originValue[key] = v;
                         }));
                     }
@@ -636,15 +684,23 @@ var ReflectionParser = /*#__PURE__*/ function() {
         return Promise.resolve(value);
     };
     _proto._getEntityByConfig = function _getEntityByConfig(entityConfig) {
+        var _this = this;
         // @ts-ignore
         var assetRefId = entityConfig.assetRefId;
         var engine = this._context.engine;
         if (assetRefId) {
-            return engine.resourceManager.getResourceByRef({
+            return engine.resourceManager// @ts-ignore
+            .getResourceByRef({
                 refId: assetRefId,
                 key: entityConfig.key,
                 isClone: entityConfig.isClone
             }).then(function(entity) {
+                // @ts-ignore
+                var resource = engine.resourceManager._objectPool[assetRefId];
+                if (_this._context.type === exports.ParserType.Prefab) {
+                    // @ts-ignore
+                    _this._context.resource._addDependenceAsset(resource);
+                }
                 entity.name = entityConfig.name;
                 return entity;
             });
@@ -671,374 +727,6 @@ var ReflectionParser = /*#__PURE__*/ function() {
     ReflectionParser.customParseComponentHandles = new Map();
 })();
 
-/**
- * Parser context
- * @export
- * @abstract
- * @class ParserContext
- * @template T
- * @template I
- */ var ParserContext = /*#__PURE__*/ function() {
-    function ParserContext(originalData, engine, target) {
-        this.originalData = originalData;
-        this.engine = engine;
-        this.target = target;
-        this.entityMap = new Map();
-        this.components = new Map();
-        this.assets = new Map();
-        this.entityConfigMap = new Map();
-        this.rootIds = [];
-        this.strippedIds = [];
-        this.resourceManager = engine.resourceManager;
-    }
-    var _proto = ParserContext.prototype;
-    /**
-   * Destroy the context.
-   * @abstract
-   * @memberof ParserContext
-   */ _proto.destroy = function destroy() {
-        this.entityMap.clear();
-        this.components.clear();
-        this.assets.clear();
-        this.entityConfigMap.clear();
-        this.rootIds.length = 0;
-    };
-    return ParserContext;
-}();
-
-var PrefabParserContext = /*#__PURE__*/ function(ParserContext1) {
-    _inherits(PrefabParserContext, ParserContext1);
-    function PrefabParserContext() {
-        return ParserContext1.apply(this, arguments);
-    }
-    return PrefabParserContext;
-}(ParserContext);
-
-function _array_like_to_array(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-
-    for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
-
-    return arr2;
-}
-
-function _unsupported_iterable_to_array(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
-
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-}
-
-function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
-    var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
-
-    if (it) return (it = it.call(o)).next.bind(it);
-    // Fallback for engines without symbol support
-    if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
-        if (it) o = it;
-
-        var i = 0;
-
-        return function() {
-            if (i >= o.length) return { done: true };
-
-            return { done: false, value: o[i++] };
-        };
-    }
-
-    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-
-var HierarchyParser = /*#__PURE__*/ function() {
-    function HierarchyParser(context) {
-        var _this = this;
-        this.context = context;
-        this.prefabContextMap = new WeakMap();
-        this.prefabPromiseMap = new Map();
-        this._engine = this.context.engine;
-        this._organizeEntities = this._organizeEntities.bind(this);
-        this._parseComponents = this._parseComponents.bind(this);
-        this._parsePrefabModification = this._parsePrefabModification.bind(this);
-        this._parsePrefabRemovedEntities = this._parsePrefabRemovedEntities.bind(this);
-        this._parsePrefabRemovedComponents = this._parsePrefabRemovedComponents.bind(this);
-        this._clearAndResolve = this._clearAndResolve.bind(this);
-        this.promise = new Promise(function(resolve, reject) {
-            _this._reject = reject;
-            _this._resolve = resolve;
-        });
-        this._reflectionParser = new ReflectionParser(context);
-    }
-    var _proto = HierarchyParser.prototype;
-    /** start parse the scene or prefab or others */ _proto.start = function start() {
-        this._parseEntities().then(this._organizeEntities).then(this._parseComponents).then(this._parsePrefabModification).then(this._parsePrefabRemovedEntities).then(this._parsePrefabRemovedComponents).then(this._clearAndResolve).then(this._resolve).catch(this._reject);
-    };
-    _proto._parseEntities = function _parseEntities() {
-        var _this = this;
-        var entitiesConfig = this.context.originalData.entities;
-        var entityConfigMap = this.context.entityConfigMap;
-        var entityMap = this.context.entityMap;
-        var engine = this._engine;
-        var promises = entitiesConfig.map(function(entityConfig) {
-            var _entityConfig_strippedId;
-            var id = (_entityConfig_strippedId = entityConfig.strippedId) != null ? _entityConfig_strippedId : entityConfig.id;
-            entityConfig.id = id;
-            entityConfigMap.set(id, entityConfig);
-            return _this._getEntityByConfig(entityConfig, engine);
-        });
-        return Promise.all(promises).then(function(entities) {
-            for(var i = 0, l = entities.length; i < l; i++){
-                entityMap.set(entitiesConfig[i].id, entities[i]);
-            }
-            return entities;
-        });
-    };
-    _proto._parseComponents = function _parseComponents() {
-        var entitiesConfig = this.context.originalData.entities;
-        var entityMap = this.context.entityMap;
-        var components = this.context.components;
-        var promises = [];
-        for(var i = 0, l = entitiesConfig.length; i < l; i++){
-            var entityConfig = entitiesConfig[i];
-            var entity = entityMap.get(entityConfig.id);
-            for(var i1 = 0; i1 < entityConfig.components.length; i1++){
-                var componentConfig = entityConfig.components[i1];
-                var key = !componentConfig.refId ? componentConfig.class : componentConfig.refId;
-                var component = entity.addComponent(engineCore.Loader.getClass(key));
-                components.set(componentConfig.id, component);
-                var promise = this._reflectionParser.parsePropsAndMethods(component, componentConfig);
-                promises.push(promise);
-            }
-        }
-        return Promise.all(promises);
-    };
-    _proto._parsePrefabModification = function _parsePrefabModification() {
-        var _loop = function(i, l) {
-            var _modifications;
-            var entityConfig = entitiesConfig[i];
-            var id = entityConfig.id, modifications = entityConfig.modifications;
-            if ((_modifications = modifications) == null ? void 0 : _modifications.length) {
-                var _promises;
-                var rootEntity = entityMap.get(id);
-                (_promises = promises).push.apply(_promises, [].concat(modifications.map(function(modification) {
-                    var target = modification.target, props = modification.props, methods = modification.methods;
-                    var entityId = target.entityId, componentId = target.componentId;
-                    var context = _this.prefabContextMap.get(rootEntity);
-                    var targetEntity = context.entityMap.get(entityId);
-                    var targetComponent = context.components.get(componentId);
-                    if (targetComponent) {
-                        return _this._reflectionParser.parsePropsAndMethods(targetComponent, {
-                            props: props,
-                            methods: methods
-                        });
-                    } else if (targetEntity) {
-                        return Promise.resolve(_this._applyEntityData(targetEntity, props));
-                    }
-                })));
-            }
-        };
-        var _this = this;
-        var entitiesConfig = this.context.originalData.entities;
-        var entityMap = this.context.entityMap;
-        var promises = [];
-        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
-        return Promise.all(promises);
-    };
-    _proto._parsePrefabRemovedEntities = function _parsePrefabRemovedEntities() {
-        var _loop = function(i, l) {
-            var _removedEntities;
-            var entityConfig = entitiesConfig[i];
-            var id = entityConfig.id, removedEntities = entityConfig.removedEntities;
-            if ((_removedEntities = removedEntities) == null ? void 0 : _removedEntities.length) {
-                var _promises;
-                var rootEntity = entityMap.get(id);
-                (_promises = promises).push.apply(_promises, [].concat(removedEntities.map(function(target) {
-                    var entityId = target.entityId;
-                    var context = _this.prefabContextMap.get(rootEntity);
-                    var targetEntity = context.entityMap.get(entityId);
-                    if (targetEntity) {
-                        targetEntity.destroy();
-                    }
-                })));
-            }
-        };
-        var _this = this;
-        var entitiesConfig = this.context.originalData.entities;
-        var entityMap = this.context.entityMap;
-        var promises = [];
-        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
-        return Promise.all(promises);
-    };
-    _proto._parsePrefabRemovedComponents = function _parsePrefabRemovedComponents() {
-        var _loop = function(i, l) {
-            var _removedComponents;
-            var entityConfig = entitiesConfig[i];
-            var id = entityConfig.id, removedComponents = entityConfig.removedComponents;
-            if ((_removedComponents = removedComponents) == null ? void 0 : _removedComponents.length) {
-                var _promises;
-                var rootEntity = entityMap.get(id);
-                (_promises = promises).concat.apply(_promises, [].concat(removedComponents.map(function(target) {
-                    var componentId = target.componentId;
-                    var context = _this.prefabContextMap.get(rootEntity);
-                    var targetComponent = context.components.get(componentId);
-                    if (targetComponent) {
-                        targetComponent.destroy();
-                    }
-                })));
-            }
-        };
-        var _this = this;
-        var entitiesConfig = this.context.originalData.entities;
-        var entityMap = this.context.entityMap;
-        var promises = [];
-        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
-        return Promise.all(promises);
-    };
-    _proto._clearAndResolve = function _clearAndResolve() {
-        var target = this.context.target;
-        return target;
-    };
-    _proto._organizeEntities = function _organizeEntities() {
-        var _this_context = this.context, rootIds = _this_context.rootIds, strippedIds = _this_context.strippedIds;
-        var parentIds = rootIds.concat(strippedIds);
-        for(var _iterator = _create_for_of_iterator_helper_loose(parentIds), _step; !(_step = _iterator()).done;){
-            var parentId = _step.value;
-            this._parseChildren(parentId);
-        }
-        for(var i = 0; i < rootIds.length; i++){
-            this.handleRootEntity(rootIds[i]);
-        }
-    };
-    _proto._getEntityByConfig = function _getEntityByConfig(entityConfig, engine) {
-        var _this = this;
-        var entityPromise;
-        if (entityConfig.assetRefId) {
-            entityPromise = this._parseGLTF(entityConfig, engine);
-        } else if (entityConfig.strippedId) {
-            entityPromise = this._parseStrippedEntity(entityConfig);
-        } else {
-            entityPromise = this._parseEntity(entityConfig, engine);
-        }
-        return entityPromise.then(function(entity) {
-            return _this._applyEntityData(entity, entityConfig);
-        });
-    };
-    _proto._parseEntity = function _parseEntity(entityConfig, engine) {
-        var entity = new engineCore.Entity(engine, entityConfig.name);
-        if (!entityConfig.parent) this.context.rootIds.push(entityConfig.id);
-        return Promise.resolve(entity);
-    };
-    _proto._parseGLTF = function _parseGLTF(entityConfig, engine) {
-        var _this = this;
-        var assetRefId = entityConfig.assetRefId;
-        var context = new ParserContext(null, engine);
-        return engine.resourceManager// @ts-ignore
-        .getResourceByRef({
-            refId: assetRefId
-        }).then(function(glTFResource) {
-            var entity = glTFResource.instantiateSceneRoot();
-            if (!entityConfig.parent) _this.context.rootIds.push(entityConfig.id);
-            _this._traverseAddEntityToMap(entity, context, "");
-            _this.prefabContextMap.set(entity, context);
-            var cbArray = _this.prefabPromiseMap.get(entityConfig.id);
-            cbArray && cbArray.forEach(function(cb) {
-                cb.resolve(context);
-            });
-            return entity;
-        });
-    };
-    _proto._parseStrippedEntity = function _parseStrippedEntity(entityConfig) {
-        var _this = this;
-        this.context.strippedIds.push(entityConfig.id);
-        return new Promise(function(resolve, reject) {
-            var _this_prefabPromiseMap_get;
-            var cbArray = (_this_prefabPromiseMap_get = _this.prefabPromiseMap.get(entityConfig.prefabInstanceId)) != null ? _this_prefabPromiseMap_get : [];
-            cbArray.push({
-                resolve: resolve,
-                reject: reject
-            });
-            _this.prefabPromiseMap.set(entityConfig.prefabInstanceId, cbArray);
-        }).then(function(context) {
-            var entityId = entityConfig.prefabSource.entityId;
-            return context.entityMap.get(entityId);
-        });
-    };
-    _proto._parseChildren = function _parseChildren(parentId) {
-        var _this_context = this.context, entityConfigMap = _this_context.entityConfigMap, entityMap = _this_context.entityMap;
-        var children = entityConfigMap.get(parentId).children;
-        if (children && children.length > 0) {
-            var parent = entityMap.get(parentId);
-            for(var i = 0; i < children.length; i++){
-                var childId = children[i];
-                var entity = entityMap.get(childId);
-                parent.addChild(entity);
-                this._parseChildren(childId);
-            }
-        }
-    };
-    _proto._applyEntityData = function _applyEntityData(entity, entityConfig) {
-        if (entityConfig === void 0) entityConfig = {};
-        var _entityConfig_isActive;
-        entity.isActive = (_entityConfig_isActive = entityConfig.isActive) != null ? _entityConfig_isActive : entity.isActive;
-        var _entityConfig_name;
-        entity.name = (_entityConfig_name = entityConfig.name) != null ? _entityConfig_name : entity.name;
-        var position = entityConfig.position, rotation = entityConfig.rotation, scale = entityConfig.scale, layer = entityConfig.layer;
-        if (position) entity.transform.position.copyFrom(position);
-        if (rotation) entity.transform.rotation.copyFrom(rotation);
-        if (scale) entity.transform.scale.copyFrom(scale);
-        if (layer) entity.layer = layer;
-        return entity;
-    };
-    _proto._traverseAddEntityToMap = function _traverseAddEntityToMap(entity, context, path) {
-        var entityMap = context.entityMap, components = context.components;
-        var componentsMap = {};
-        var componentIndexMap = {};
-        entityMap.set(path, entity);
-        // @ts-ignore
-        entity._components.forEach(function(component) {
-            // @ts-ignore
-            var name = engineCore.Loader.getClassName(component.constructor);
-            if (!componentsMap[name]) {
-                componentsMap[name] = entity.getComponents(component.constructor, []);
-                componentIndexMap[name] = 0;
-            }
-            components.set(path + ":" + name + "/" + componentIndexMap[name]++, component);
-        });
-        for(var i = 0, n = entity.children.length; i < n; i++){
-            var child = entity.children[i];
-            var childPath = path ? path + "/" + i : "" + i;
-            this._traverseAddEntityToMap(child, context, childPath);
-        }
-    };
-    return HierarchyParser;
-}();
-
-var PrefabParser = /*#__PURE__*/ function(HierarchyParser1) {
-    _inherits(PrefabParser, HierarchyParser1);
-    function PrefabParser() {
-        return HierarchyParser1.apply(this, arguments);
-    }
-    var _proto = PrefabParser.prototype;
-    _proto.handleRootEntity = function handleRootEntity(id) {
-        this.context.target = this.context.entityMap.get(id);
-    };
-    /**
-   * Parse prefab data.
-   * @param engine - the engine of the parser context
-   * @param prefabData - prefab data which is exported by editor
-   * @returns a promise of prefab
-   */ PrefabParser.parse = function parse(engine, prefabData) {
-        var context = new PrefabParserContext(prefabData, engine);
-        var parser = new PrefabParser(context);
-        parser.start();
-        return parser;
-    };
-    return PrefabParser;
-}(HierarchyParser);
-
 exports.InterpolableValueType = void 0;
 (function(InterpolableValueType) {
     InterpolableValueType[InterpolableValueType["Float"] = 0] = "Float";
@@ -1233,45 +921,384 @@ exports.AnimationClipDecoder = /*#__PURE__*/ function() {
                             break;
                         }
                 }
-                clip.addCurveBinding(relativePath, componentType, property, getProperty, curve);
+                clip.addCurveBinding(relativePath, componentType, property, getProperty, curve);
+            }
+            resolve(clip);
+        });
+    };
+    return AnimationClipDecoder;
+}();
+exports.AnimationClipDecoder = __decorate([
+    decoder("AnimationClip")
+], exports.AnimationClipDecoder);
+
+exports.SpecularMode = void 0;
+(function(SpecularMode) {
+    SpecularMode["Sky"] = "Sky";
+    SpecularMode["Custom"] = "Custom";
+})(exports.SpecularMode || (exports.SpecularMode = {}));
+
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else return left instanceof right;
+}
+
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+
+    for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
+
+    return arr2;
+}
+
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+
+function _create_for_of_iterator_helper_loose(o, allowArrayLike) {
+    var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
+
+    if (it) return (it = it.call(o)).next.bind(it);
+    // Fallback for engines without symbol support
+    if (Array.isArray(o) || (it = _unsupported_iterable_to_array(o)) || allowArrayLike && o && typeof o.length === "number") {
+        if (it) o = it;
+
+        var i = 0;
+
+        return function() {
+            if (i >= o.length) return { done: true };
+
+            return { done: false, value: o[i++] };
+        };
+    }
+
+    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+
+/**
+ * The Prefab resource.
+ */ var PrefabResource = /*#__PURE__*/ function(ReferResource1) {
+    _inherits(PrefabResource, ReferResource1);
+    function PrefabResource(engine, url) {
+        var _this;
+        _this = ReferResource1.call(this, engine) || this;
+        _this.url = url;
+        _this._dependenceAssets = new Set();
+        return _this;
+    }
+    var _proto = PrefabResource.prototype;
+    /**
+   * Instantiate prefab.
+   * @returns prefab's root entity
+   */ _proto.instantiate = function instantiate() {
+        var _this__root;
+        return (_this__root = this._root) == null ? void 0 : _this__root.clone();
+    };
+    /**
+   * @internal
+   */ _proto._addDependenceAsset = function _addDependenceAsset(resource) {
+        this._dependenceAssets.add(resource);
+        // @ts-ignore
+        resource._associationSuperResource(this);
+    };
+    _proto._onDestroy = function _onDestroy() {
+        var _this = this;
+        ReferResource1.prototype._onDestroy.call(this);
+        this._root.destroy();
+        this._dependenceAssets.forEach(function(asset) {
+            // @ts-ignore
+            asset._disassociationSuperResource(_this);
+        });
+    };
+    return PrefabResource;
+}(engineCore.ReferResource);
+
+/** @Internal */ var HierarchyParser = /*#__PURE__*/ function() {
+    function HierarchyParser(data, context) {
+        var _this = this;
+        this.data = data;
+        this.context = context;
+        this._prefabContextMap = new WeakMap();
+        this._prefabPromiseMap = new Map();
+        this._engine = this.context.engine;
+        this._organizeEntities = this._organizeEntities.bind(this);
+        this._parseComponents = this._parseComponents.bind(this);
+        this._parsePrefabModification = this._parsePrefabModification.bind(this);
+        this._parsePrefabRemovedEntities = this._parsePrefabRemovedEntities.bind(this);
+        this._parsePrefabRemovedComponents = this._parsePrefabRemovedComponents.bind(this);
+        this._clearAndResolve = this._clearAndResolve.bind(this);
+        this.promise = new Promise(function(resolve, reject) {
+            _this._reject = reject;
+            _this._resolve = resolve;
+        });
+        this._reflectionParser = new ReflectionParser(context);
+    }
+    var _proto = HierarchyParser.prototype;
+    /** start parse the scene or prefab or others */ _proto.start = function start() {
+        this._parseEntities().then(this._organizeEntities).then(this._parseComponents).then(this._parsePrefabModification).then(this._parsePrefabRemovedEntities).then(this._parsePrefabRemovedComponents).then(this._clearAndResolve).then(this._resolve).catch(this._reject);
+    };
+    _proto._parseEntities = function _parseEntities() {
+        var _this = this;
+        var entitiesConfig = this.data.entities;
+        var entityConfigMap = this.context.entityConfigMap;
+        var entityMap = this.context.entityMap;
+        var engine = this._engine;
+        var promises = entitiesConfig.map(function(entityConfig) {
+            var _entityConfig_strippedId;
+            var id = (_entityConfig_strippedId = entityConfig.strippedId) != null ? _entityConfig_strippedId : entityConfig.id;
+            entityConfig.id = id;
+            entityConfigMap.set(id, entityConfig);
+            return _this._getEntityByConfig(entityConfig, engine);
+        });
+        return Promise.all(promises).then(function(entities) {
+            for(var i = 0, l = entities.length; i < l; i++){
+                entityMap.set(entitiesConfig[i].id, entities[i]);
+            }
+            return entities;
+        });
+    };
+    _proto._parseComponents = function _parseComponents() {
+        var entitiesConfig = this.data.entities;
+        var entityMap = this.context.entityMap;
+        var components = this.context.components;
+        var promises = [];
+        for(var i = 0, l = entitiesConfig.length; i < l; i++){
+            var entityConfig = entitiesConfig[i];
+            var entity = entityMap.get(entityConfig.id);
+            for(var i1 = 0; i1 < entityConfig.components.length; i1++){
+                var componentConfig = entityConfig.components[i1];
+                var key = !componentConfig.refId ? componentConfig.class : componentConfig.refId;
+                var component = entity.addComponent(engineCore.Loader.getClass(key));
+                components.set(componentConfig.id, component);
+                var promise = this._reflectionParser.parsePropsAndMethods(component, componentConfig);
+                promises.push(promise);
+            }
+        }
+        return Promise.all(promises);
+    };
+    _proto._parsePrefabModification = function _parsePrefabModification() {
+        var _loop = function(i, l) {
+            var _modifications;
+            var entityConfig = entitiesConfig[i];
+            var id = entityConfig.id, modifications = entityConfig.modifications;
+            if ((_modifications = modifications) == null ? void 0 : _modifications.length) {
+                var _promises;
+                var rootEntity = entityMap.get(id);
+                (_promises = promises).push.apply(_promises, [].concat(modifications.map(function(modification) {
+                    var target = modification.target, props = modification.props, methods = modification.methods;
+                    var entityId = target.entityId, componentId = target.componentId;
+                    var context = _this._prefabContextMap.get(rootEntity);
+                    var targetEntity = context.entityMap.get(entityId);
+                    var targetComponent = context.components.get(componentId);
+                    if (targetComponent) {
+                        return _this._reflectionParser.parsePropsAndMethods(targetComponent, {
+                            props: props,
+                            methods: methods
+                        });
+                    } else if (targetEntity) {
+                        return Promise.resolve(_this._applyEntityData(targetEntity, props));
+                    }
+                })));
+            }
+        };
+        var _this = this;
+        var entitiesConfig = this.data.entities;
+        var entityMap = this.context.entityMap;
+        var promises = [];
+        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+        return Promise.all(promises);
+    };
+    _proto._parsePrefabRemovedEntities = function _parsePrefabRemovedEntities() {
+        var _loop = function(i, l) {
+            var _removedEntities;
+            var entityConfig = entitiesConfig[i];
+            var id = entityConfig.id, removedEntities = entityConfig.removedEntities;
+            if ((_removedEntities = removedEntities) == null ? void 0 : _removedEntities.length) {
+                var _promises;
+                var rootEntity = entityMap.get(id);
+                (_promises = promises).push.apply(_promises, [].concat(removedEntities.map(function(target) {
+                    var entityId = target.entityId;
+                    var context = _this._prefabContextMap.get(rootEntity);
+                    var targetEntity = context.entityMap.get(entityId);
+                    if (targetEntity) {
+                        targetEntity.destroy();
+                    }
+                })));
+            }
+        };
+        var _this = this;
+        var entitiesConfig = this.data.entities;
+        var entityMap = this.context.entityMap;
+        var promises = [];
+        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+        return Promise.all(promises);
+    };
+    _proto._parsePrefabRemovedComponents = function _parsePrefabRemovedComponents() {
+        var _loop = function(i, l) {
+            var _removedComponents;
+            var entityConfig = entitiesConfig[i];
+            var id = entityConfig.id, removedComponents = entityConfig.removedComponents;
+            if ((_removedComponents = removedComponents) == null ? void 0 : _removedComponents.length) {
+                var _promises;
+                var rootEntity = entityMap.get(id);
+                (_promises = promises).concat.apply(_promises, [].concat(removedComponents.map(function(target) {
+                    var componentId = target.componentId;
+                    var context = _this._prefabContextMap.get(rootEntity);
+                    var targetComponent = context.components.get(componentId);
+                    if (targetComponent) {
+                        targetComponent.destroy();
+                    }
+                })));
+            }
+        };
+        var _this = this;
+        var entitiesConfig = this.data.entities;
+        var entityMap = this.context.entityMap;
+        var promises = [];
+        for(var i = 0, l = entitiesConfig.length; i < l; i++)_loop(i);
+        return Promise.all(promises);
+    };
+    _proto._organizeEntities = function _organizeEntities() {
+        var _this_context = this.context, rootIds = _this_context.rootIds, strippedIds = _this_context.strippedIds;
+        var parentIds = rootIds.concat(strippedIds);
+        for(var _iterator = _create_for_of_iterator_helper_loose(parentIds), _step; !(_step = _iterator()).done;){
+            var parentId = _step.value;
+            this._parseChildren(parentId);
+        }
+        for(var i = 0; i < rootIds.length; i++){
+            this._handleRootEntity(rootIds[i]);
+        }
+    };
+    _proto._getEntityByConfig = function _getEntityByConfig(entityConfig, engine) {
+        var _this = this;
+        var entityPromise;
+        if (entityConfig.assetRefId) {
+            entityPromise = this._parsePrefab(entityConfig, engine);
+        } else if (entityConfig.strippedId) {
+            entityPromise = this._parseStrippedEntity(entityConfig);
+        } else {
+            entityPromise = this._parseEntity(entityConfig, engine);
+        }
+        return entityPromise.then(function(entity) {
+            return _this._applyEntityData(entity, entityConfig);
+        });
+    };
+    _proto._parseEntity = function _parseEntity(entityConfig, engine) {
+        var entity = new engineCore.Entity(engine, entityConfig.name);
+        if (!entityConfig.parent) this.context.rootIds.push(entityConfig.id);
+        return Promise.resolve(entity);
+    };
+    _proto._parsePrefab = function _parsePrefab(entityConfig, engine) {
+        var _this = this;
+        var assetRefId = entityConfig.assetRefId;
+        return engine.resourceManager// @ts-ignore
+        .getResourceByRef({
+            refId: assetRefId
+        }).then(function(prefabResource) {
+            var entity = _instanceof(prefabResource, PrefabResource) ? prefabResource.instantiate() : prefabResource.instantiateSceneRoot();
+            var instanceContext = new ParserContext(engine, exports.ParserType.Prefab, null);
+            if (!entityConfig.parent) _this.context.rootIds.push(entityConfig.id);
+            _this._generateInstanceContext(entity, instanceContext, "");
+            _this._prefabContextMap.set(entity, instanceContext);
+            var cbArray = _this._prefabPromiseMap.get(entityConfig.id);
+            if (cbArray) {
+                for(var i = 0, n = cbArray.length; i < n; i++){
+                    cbArray[i].resolve(instanceContext);
+                }
             }
-            resolve(clip);
+            return entity;
         });
     };
-    return AnimationClipDecoder;
+    _proto._parseStrippedEntity = function _parseStrippedEntity(entityConfig) {
+        var _this = this;
+        this.context.strippedIds.push(entityConfig.id);
+        return new Promise(function(resolve, reject) {
+            var _this__prefabPromiseMap_get;
+            var cbArray = (_this__prefabPromiseMap_get = _this._prefabPromiseMap.get(entityConfig.prefabInstanceId)) != null ? _this__prefabPromiseMap_get : [];
+            cbArray.push({
+                resolve: resolve,
+                reject: reject
+            });
+            _this._prefabPromiseMap.set(entityConfig.prefabInstanceId, cbArray);
+        }).then(function(context) {
+            var entityId = entityConfig.prefabSource.entityId;
+            return context.entityMap.get(entityId);
+        });
+    };
+    _proto._parseChildren = function _parseChildren(parentId) {
+        var _this_context = this.context, entityConfigMap = _this_context.entityConfigMap, entityMap = _this_context.entityMap;
+        var children = entityConfigMap.get(parentId).children;
+        if (children && children.length > 0) {
+            var parent = entityMap.get(parentId);
+            for(var i = 0; i < children.length; i++){
+                var childId = children[i];
+                var entity = entityMap.get(childId);
+                parent.addChild(entity);
+                this._parseChildren(childId);
+            }
+        }
+    };
+    _proto._applyEntityData = function _applyEntityData(entity, entityConfig) {
+        if (entityConfig === void 0) entityConfig = {};
+        var _entityConfig_isActive;
+        entity.isActive = (_entityConfig_isActive = entityConfig.isActive) != null ? _entityConfig_isActive : entity.isActive;
+        var _entityConfig_name;
+        entity.name = (_entityConfig_name = entityConfig.name) != null ? _entityConfig_name : entity.name;
+        var position = entityConfig.position, rotation = entityConfig.rotation, scale = entityConfig.scale, layer = entityConfig.layer;
+        if (position) entity.transform.position.copyFrom(position);
+        if (rotation) entity.transform.rotation.copyFrom(rotation);
+        if (scale) entity.transform.scale.copyFrom(scale);
+        if (layer) entity.layer = layer;
+        return entity;
+    };
+    _proto._generateInstanceContext = function _generateInstanceContext(entity, context, path) {
+        var entityMap = context.entityMap, components = context.components;
+        var componentsMap = {};
+        var componentIndexMap = {};
+        entityMap.set(path, entity);
+        // @ts-ignore
+        entity._components.forEach(function(component) {
+            // @ts-ignore
+            var name = engineCore.Loader.getClassName(component.constructor);
+            if (!componentsMap[name]) {
+                componentsMap[name] = entity.getComponents(component.constructor, []);
+                componentIndexMap[name] = 0;
+            }
+            components.set(path + ":" + name + "/" + componentIndexMap[name]++, component);
+        });
+        for(var i = 0, n = entity.children.length; i < n; i++){
+            var child = entity.children[i];
+            var childPath = path ? path + "/" + i : "" + i;
+            this._generateInstanceContext(child, context, childPath);
+        }
+    };
+    return HierarchyParser;
 }();
-exports.AnimationClipDecoder = __decorate([
-    decoder("AnimationClip")
-], exports.AnimationClipDecoder);
-
-exports.SpecularMode = void 0;
-(function(SpecularMode) {
-    SpecularMode["Sky"] = "Sky";
-    SpecularMode["Custom"] = "Custom";
-})(exports.SpecularMode || (exports.SpecularMode = {}));
 
-var SceneParserContext = /*#__PURE__*/ function(ParserContext1) {
-    _inherits(SceneParserContext, ParserContext1);
-    function SceneParserContext(originalData, engine, scene) {
+/** @Internal */ var SceneParser = /*#__PURE__*/ function(HierarchyParser1) {
+    _inherits(SceneParser, HierarchyParser1);
+    function SceneParser(data, context, scene) {
         var _this;
-        _this = ParserContext1.call(this, originalData, engine, scene) || this;
-        _this.originalData = originalData;
-        _this.engine = engine;
+        _this = HierarchyParser1.call(this, data, context) || this;
         _this.scene = scene;
         return _this;
     }
-    return SceneParserContext;
-}(ParserContext);
-
-/** @Internal */ var SceneParser = /*#__PURE__*/ function(HierarchyParser1) {
-    _inherits(SceneParser, HierarchyParser1);
-    function SceneParser() {
-        return HierarchyParser1.apply(this, arguments);
-    }
     var _proto = SceneParser.prototype;
-    _proto.handleRootEntity = function handleRootEntity(id) {
-        var _this_context = this.context, target = _this_context.target, entityMap = _this_context.entityMap;
-        target.addRootEntity(entityMap.get(id));
+    _proto._handleRootEntity = function _handleRootEntity(id) {
+        var entityMap = this.context.entityMap;
+        this.scene.addRootEntity(entityMap.get(id));
+    };
+    _proto._clearAndResolve = function _clearAndResolve() {
+        this.context.clear();
+        return this.scene;
     };
     /**
    * Parse scene data.
@@ -1280,10 +1307,12 @@ var SceneParserContext = /*#__PURE__*/ function(ParserContext1) {
    * @returns a promise of scene
    */ SceneParser.parse = function parse(engine, sceneData) {
         var scene = new engineCore.Scene(engine);
-        var context = new SceneParserContext(sceneData, engine, scene);
-        var parser = new SceneParser(context);
+        var context = new ParserContext(engine, exports.ParserType.Scene, scene);
+        var parser = new SceneParser(sceneData, context, scene);
         parser.start();
-        return parser.promise;
+        return parser.promise.then(function() {
+            return scene;
+        });
     };
     return SceneParser;
 }(HierarchyParser);
@@ -1664,7 +1693,7 @@ FontLoader = __decorate([
 ], FontLoader);
 
 /**
- * Product after glTF parser, usually, `defaultSceneRoot` is only needed to use.
+ * The glTF resource.
  */ var GLTFResource = /*#__PURE__*/ function(ReferResource1) {
     _inherits(GLTFResource, ReferResource1);
     function GLTFResource(engine, url) {
@@ -4224,12 +4253,6 @@ exports.GLTFMaterialParser = __decorate([
     registerGLTFParser(exports.GLTFParserType.Material)
 ], exports.GLTFMaterialParser);
 
-function _instanceof(left, right) {
-    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
-        return !!right[Symbol.hasInstance](left);
-    } else return left instanceof right;
-}
-
 var _GLTFMeshParser;
 exports.GLTFMeshParser = (_GLTFMeshParser = /*#__PURE__*/ function(GLTFParser1) {
     _inherits(GLTFMeshParser1, GLTFParser1);
@@ -4452,7 +4475,7 @@ exports.GLTFSceneParser = /*#__PURE__*/ function(GLTFParser1) {
         var sceneExtensions = sceneInfo.extensions;
         var engine = glTFResource.engine;
         var isDefaultScene = scene === index;
-        var sceneNodes = sceneInfo.nodes;
+        var sceneNodes = sceneInfo.nodes || [];
         var sceneRoot;
         if (sceneNodes.length === 1) {
             sceneRoot = context.get(exports.GLTFParserType.Entity, sceneNodes[0]);
@@ -4542,7 +4565,8 @@ exports.GLTFSceneParser = /*#__PURE__*/ function(GLTFParser1) {
         var blendShapeWeights = entityInfo.weights || glTFMesh.weights;
         var materialPromises = new Array(rendererCount);
         for(var i = 0; i < rendererCount; i++){
-            materialPromises[i] = context.get(exports.GLTFParserType.Material, glTFMeshPrimitives[i].material);
+            var _glTFMeshPrimitives_i_material;
+            materialPromises[i] = context.get(exports.GLTFParserType.Material, (_glTFMeshPrimitives_i_material = glTFMeshPrimitives[i].material) != null ? _glTFMeshPrimitives_i_material : -1);
         }
         return Promise.all([
             context.get(exports.GLTFParserType.Mesh, meshID),
@@ -5104,6 +5128,59 @@ exports.GLTFLoader = __decorate([
     ])
 ], exports.GLTFLoader);
 
+var PrefabParser = /*#__PURE__*/ function(HierarchyParser1) {
+    _inherits(PrefabParser, HierarchyParser1);
+    function PrefabParser(data, context, prefabResource) {
+        var _this;
+        _this = HierarchyParser1.call(this, data, context) || this;
+        _this.prefabResource = prefabResource;
+        return _this;
+    }
+    var _proto = PrefabParser.prototype;
+    _proto._handleRootEntity = function _handleRootEntity(id) {
+        this.prefabResource._root = this.context.entityMap.get(id);
+    };
+    _proto._clearAndResolve = function _clearAndResolve() {
+        this.context.clear();
+        return this.prefabResource;
+    };
+    PrefabParser.parse = function parse(engine, url, data) {
+        var prefabResource = new PrefabResource(engine, url);
+        var context = new ParserContext(engine, exports.ParserType.Prefab, prefabResource);
+        var parser = new PrefabParser(data, context, prefabResource);
+        parser.start();
+        return parser.promise.then(function() {
+            return prefabResource;
+        });
+    };
+    return PrefabParser;
+}(HierarchyParser);
+
+exports.PrefabLoader = /*#__PURE__*/ function(Loader1) {
+    _inherits(PrefabLoader, Loader1);
+    function PrefabLoader() {
+        return Loader1.apply(this, arguments);
+    }
+    var _proto = PrefabLoader.prototype;
+    _proto.load = function load(item, resourceManager) {
+        var _this = this;
+        var engine = resourceManager.engine;
+        return new engineCore.AssetPromise(function(resolve, reject) {
+            _this.request(item.url, _extends({}, item, {
+                type: "json"
+            })).then(function(data) {
+                PrefabParser.parse(engine, item.url, data).then(resolve).catch(reject);
+            });
+        });
+    };
+    return PrefabLoader;
+}(engineCore.Loader);
+exports.PrefabLoader = __decorate([
+    engineCore.resourceLoader(engineCore.AssetType.Prefab, [
+        "prefab"
+    ])
+], exports.PrefabLoader);
+
 var _HDRLoader;
 var PI = Math.PI;
 var HDRLoader = (_HDRLoader = // referenece: https://www.flipcode.com/archives/HDR_Image_Reader.shtml
@@ -6302,6 +6379,8 @@ var SceneLoader = /*#__PURE__*/ function(Loader1) {
                                     scene.background.texture = texture;
                                 });
                                 promises.push(backgroundPromise);
+                                var _background_textureFillMode;
+                                scene.background.textureFillMode = (_background_textureFillMode = background.textureFillMode) != null ? _background_textureFillMode : scene.background.textureFillMode;
                             }
                             break;
                     }
@@ -6735,7 +6814,7 @@ exports.GLTFParserContext = GLTFParserContext;
 exports.GLTFResource = GLTFResource;
 exports.GLTFUtils = GLTFUtils;
 exports.ParserContext = ParserContext;
-exports.PrefabParser = PrefabParser;
+exports.PrefabResource = PrefabResource;
 exports.ReflectionParser = ReflectionParser;
 exports.SceneParser = SceneParser;
 exports.decode = decode;