Class PrefabLoader

packages/asset-system/src/loaders/PrefabLoader.ts:20–156

 * Prefab loader implementation
 */
export class PrefabLoader implements IAssetLoader<IPrefabAsset> {
    readonly supportedType = AssetType.Prefab;
    readonly supportedExtensions = ['.prefab'];
    readonly contentType: AssetContentType = 'text';

    /**
     * 从文本内容解析预制体
     * Parse prefab from text content
     */
    async parse(content: IAssetContent, context: IAssetParseContext): Promise<IPrefabAsset> {
        if (!content.text) {
            throw new Error('Prefab content is empty');
        }

        let prefabData: IPrefabData;
        try {
            prefabData = JSON.parse(content.text) as IPrefabData;
        } catch (error) {
            throw new Error(`Failed to parse prefab JSON: ${(error as Error).message}`);
        }

        // 验证预制体格式 | Validate prefab format
        this.validatePrefabData(prefabData);

        // 版本兼容性检查 | Version compatibility check
        if (prefabData.version > PREFAB_FORMAT_VERSION) {
            console.warn(
                `Prefab version ${prefabData.version} is newer than supported version ${PREFAB_FORMAT_VERSION}. ` +
                `Some features may not work correctly.`
            );
        }

        // 构建资产对象 | Build asset object
        const prefabAsset: IPrefabAsset = {
            data: prefabData,
            guid: context.metadata.guid,
            path: context.metadata.path,

            // 快捷访问属性 | Quick access properties
            get root(): SerializedPrefabEntity {
                return prefabData.root;
            },
            get componentTypes(): string[] {
                return prefabData.metadata.componentTypes;
            },
            get referencedAssets(): string[] {
                return prefabData.metadata.referencedAssets;
            }
        };

        return prefabAsset;
    }

    /**
     * 释放已加载的资产
     * Dispose loaded asset
     */
    dispose(asset: IPrefabAsset): void {