@playcraft/build 0.0.13 → 0.0.14

package/dist/vite/plugin-playcanvas.js

@@ -2,6 +2,7 @@ import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { minifyPatchCode } from '../utils/minify.js';
 /**
  * PlayCanvas Vite 插件
  * 处理 PlayCanvas 特定的资源转换和内联
@@ -302,42 +303,7 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
             sceneDataUrl = sceneUrl || '';
         }
     }
-    // 7. 内联 logo.png
-    // index.esm.mjs 中使用 `${ASSET_PREFIX}logo.png` 引用 logo
-    // 需要将 ASSET_PREFIX 替换为 data URL 或直接替换 logo 引用
-    if (options.convertDataUrls) {
-        const logoPath = path.join(baseBuildDir, 'logo.png');
-        try {
-            const logoBuffer = await fs.readFile(logoPath);
-            const logoDataUrl = `data:image/png;base64,${logoBuffer.toString('base64')}`;
-            // 替换 `${ASSET_PREFIX}logo.png` 模式
-            // 由于代码被打包为 IIFE，模板字符串可能被转换为字符串拼接
-            // 格式1: `${ASSET_PREFIX}logo.png`
-            // 格式2: ASSET_PREFIX + "logo.png"
-            // 格式3: "".concat(ASSET_PREFIX, "logo.png")  (Vite 打包后)
-            const escapedLogoDataUrl = logoDataUrl.replace(/\$/g, '$$$$');
-            // 替换模板字符串格式（原始格式）
-            html = html.replace(/\$\{ASSET_PREFIX\}logo\.png/g, escapedLogoDataUrl);
-            // 替换字符串拼接格式
-            html = html.replace(/ASSET_PREFIX\s*\+\s*["']logo\.png["']/g, `"${escapedLogoDataUrl}"`);
-            // 替换 concat 格式 (Vite/Rollup 打包后常见格式)
-            html = html.replace(/["']?["']?\.concat\(ASSET_PREFIX,\s*["']logo\.png["']\)/g, `"${escapedLogoDataUrl}"`);
-            // 替换反引号模板字符串在 IIFE 中的编译结果
-            // `${ASSET_PREFIX}logo.png` 可能被编译为 ASSET_PREFIX+"logo.png"
-            html = html.replace(/`\$\{ASSET_PREFIX\}logo\.png`/g, `"${escapedLogoDataUrl}"`);
-            // ⚠️ 重要：Vite 压缩后，直接查找 "logo.png" 字符串
-            // 格式: .src="logo.png" 或 src:"logo.png" 或 ="logo.png"
-            const logoReplaceCount = (html.match(/["']logo\.png["']/g) || []).length;
-            if (logoReplaceCount > 0) {
-                html = html.replace(/["']logo\.png["']/g, `"${escapedLogoDataUrl}"`);
-                console.log(`[PlayCanvasPlugin] ESM Bundle: 替换了 ${logoReplaceCount} 处 "logo.png" 字符串`);
-            }
-            console.log(`[PlayCanvasPlugin] ESM Bundle: logo.png 已内联`);
-        }
-        catch (error) {
-            console.warn(`[PlayCanvasPlugin] ESM Bundle: logo.png 不存在，跳过内联`);
-        }
-    }
+    // 7. (Logo removed - no longer needed)
     // 8. 在 HTML 中查找并替换 ESM Bundle IIFE 代码中的配置值
     // 方案1+3：直接将 CONFIG_FILENAME = "config.json" 替换为 data URL
     // 8.1 替换 CONFIG_FILENAME
@@ -425,28 +391,22 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
     // 这个补丁覆盖 pc.ScriptHandler.prototype._loadScript，使其能够：
     // 1. 正确处理 data URL 格式的脚本
     // 2. 对于空脚本（已打包到 IIFE 中的），直接跳过执行
-    const scriptHandlerPatch = `
-<script>
-// ScriptHandler patch for one-page build (empty scripts are already bundled in IIFE)
+    const scriptHandlerPatchCode = `
 (function() {
     if (typeof pc === 'undefined' || !pc.ScriptHandler) return;
     
     var originalLoadScript = pc.ScriptHandler.prototype._loadScript;
     pc.ScriptHandler.prototype._loadScript = function(url, callback) {
-        // Check if this is a data URL
         if (url && url.startsWith('data:text/javascript;base64,')) {
             var head = document.head;
             var element = document.createElement('script');
             this._cache[url] = element;
             element.async = false;
             
-            // Decode base64 content
             var index = url.indexOf(',');
             var base64 = url.slice(index + 1);
             
-            // If empty content (scripts already bundled), skip execution
             if (!base64 || base64.length === 0) {
-                // Still create the element for cache consistency
                 callback(null, url, element);
                 return;
             }
@@ -463,14 +423,13 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
             return;
         }
         
-        // Fall back to original implementation for non-data URLs
         return originalLoadScript.call(this, url, callback);
     };
-})();
-</script>`;
+})();`;
+    const minifiedScriptHandlerPatch = await minifyPatchCode(scriptHandlerPatchCode, 'scriptHandlerPatch');
     // 将补丁注入到 </head> 之前，确保在引擎之后、脚本加载之前执行
     if (html.includes('</head>')) {
-        html = html.replace('</head>', `${scriptHandlerPatch}\n</head>`);
+        html = html.replace('</head>', `<script>${minifiedScriptHandlerPatch}</script>\n</head>`);
     }
     console.log('[PlayCanvasPlugin] ESM Bundle 模式：资源内联完成');
     return html;
@@ -759,9 +718,6 @@ async function inlineGameScripts(html, baseBuildDir) {
 async function inlineStartScript(html, baseBuildDir, options) {
     const startPath = path.join(baseBuildDir, '__start__.js');
     let startCode = await fs.readFile(startPath, 'utf-8');
-    if (options.convertDataUrls) {
-        startCode = await inlineLogoInStartScript(startCode, baseBuildDir);
-    }
     // 替换 script 标签
     const scriptPattern = /<script[^>]*src=["']__start__\.js["'][^>]*><\/script>/i;
     if (scriptPattern.test(html)) {
@@ -783,9 +739,6 @@ async function inlineLoadingScript(html, baseBuildDir) {
         await fs.access(loadingPath);
         // 文件存在，内联它
         let loadingCode = await fs.readFile(loadingPath, 'utf-8');
-        if (loadingCode.includes('${ASSET_PREFIX}logo.png')) {
-            loadingCode = await inlineLogoInStartScript(loadingCode, baseBuildDir);
-        }
         if (scriptPattern.test(html)) {
             html = html.replace(scriptPattern, `<script>${loadingCode}</script>`);
         }
@@ -1177,17 +1130,6 @@ async function inlineConfigAssetUrls(configJson, baseBuildDir, pluginContext) {
     }
     return configJson;
 }
-async function inlineLogoInStartScript(startCode, baseBuildDir) {
-    const logoPath = path.join(baseBuildDir, 'logo.png');
-    try {
-        const buffer = await fs.readFile(logoPath);
-        const dataUrl = `data:image/png;base64,${buffer.toString('base64')}`;
-        return startCode.replace(/\$\{ASSET_PREFIX\}logo\.png/g, dataUrl);
-    }
-    catch (error) {
-        return startCode;
-    }
-}
 /**
  * 为跳过的资源生成有效的占位符 data URL
  */
@@ -1387,19 +1329,30 @@ async function getEnginePatchScripts(options) {
     const scripts = [];
     if (options.patchXhrOut) {
         const patchCode = await readPatchFile('playcraft-no-xhr.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'playcraft-no-xhr.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     else if (options.configJsonInline) {
         const patchCode = await readPatchFile('one-page-http-get.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-http-get.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     if (options.inlineGameScripts) {
         const patchCode = await readPatchFile('one-page-inline-game-scripts.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-inline-game-scripts.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     if (options.mraidSupport) {
         const patchCode = await readPatchFile('one-page-mraid-resize-canvas.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-mraid-resize-canvas.js');
+        scripts.push(`<script>${minified}</script>`);
+    }
+    // 注入 Scene applySettings 补丁：确保 settings.physics/render 存在，避免 "Cannot read properties of undefined (reading 'gravity')" 报错
+    // 场景：ammoReplacement 或部分场景 JSON 缺少 physics 配置
+    const scenePhysicsPatch = await readPatchFile('scene-physics-defaults.js');
+    if (scenePhysicsPatch) {
+        const minified = await minifyPatchCode(scenePhysicsPatch, 'scene-physics-defaults.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     // 如果启用了 config.json 压缩，需要注入 LZ4 解压运行时代码
     // 注意：必须在 compressEngine 之前检查，因为 compressEngine 也会注入 lz4.js

package/dist/vite/plugin-source-builder.js

@@ -52,6 +52,39 @@ export function viteSourceBuilderPlugin(options) {
             if (scriptPathMap.has(id)) {
                 return scriptPathMap.get(id);
             }
+            // 通过 Import Map 解析裸模块说明符（如 gameRule、planck 等）
+            // Import Map 中的路径是相对于 assets/ 目录的（Import Map 文件本身在 assets/Import Map.json 中）
+            if (options.importMap?.content?.imports && !id.startsWith('./') && !id.startsWith('../') && !id.startsWith('/') && !id.startsWith('\0')) {
+                const imports = options.importMap.content.imports;
+                const assetsDir = path.join(options.projectDir, 'assets');
+                // 精确匹配（如 "gameRule" -> "./Generated/GameRule/BreakshotPoolRule.mjs"）
+                if (imports[id]) {
+                    let resolved = imports[id];
+                    // 去掉开头的 ./
+                    if (resolved.startsWith('./')) {
+                        resolved = resolved.slice(2);
+                    }
+                    const absPath = path.join(assetsDir, resolved);
+                    console.log(`[SourceBuilder] Import Map 解析: ${id} -> ${absPath}`);
+                    return absPath;
+                }
+                // 前缀匹配（如 "Gameplay/" -> "./LiteCreator/Gameplay/"）
+                for (const [prefix, target] of Object.entries(imports)) {
+                    if (prefix.endsWith('/') && id.startsWith(prefix)) {
+                        const remainder = id.slice(prefix.length);
+                        let targetBase = target;
+                        if (targetBase.startsWith('./')) {
+                            targetBase = targetBase.slice(2);
+                        }
+                        if (targetBase.endsWith('/')) {
+                            targetBase = targetBase.slice(0, -1);
+                        }
+                        const absPath = path.join(assetsDir, targetBase, remainder);
+                        console.log(`[SourceBuilder] Import Map 前缀解析: ${id} -> ${absPath}`);
+                        return absPath;
+                    }
+                }
+            }
             // 处理相对导入（../xxx 或 ./xxx）
             if (importer && (id.startsWith('./') || id.startsWith('../'))) {
                 // 获取导入者的模块路径
@@ -277,7 +310,6 @@ async function copyTemplates(outputDir) {
         '__loading__.js',
         'playcanvas-stable.min.js',
         'styles.css',
-        'logo.png',
         'manifest.json',
     ];
     for (const file of templateFiles) {
@@ -373,11 +405,21 @@ function collectRegisteredScriptNames(assets) {
         if (scriptName) {
             scriptNames.add(scriptName);
         }
-        // 如果脚本资产有 data.scripts 数组（Classic 格式），也收集这些名称
-        if (asset.data?.scripts && Array.isArray(asset.data.scripts)) {
-            for (const s of asset.data.scripts) {
-                if (s?.name)
-                    scriptNames.add(s.name);
+        // Classic 格式的 data.scripts 可能是对象或数组
+        if (asset.data?.scripts) {
+            if (Array.isArray(asset.data.scripts)) {
+                // 数组格式: [{ name: 'xxx' }, ...]
+                for (const s of asset.data.scripts) {
+                    if (s?.name)
+                        scriptNames.add(s.name);
+                }
+            }
+            else if (typeof asset.data.scripts === 'object') {
+                // 对象格式: { "followCamera": { attributes: {...} }, ... }
+                // 这是 PlayCanvas/PlayCraft 中 Classic 脚本的标准格式
+                for (const scriptKey of Object.keys(asset.data.scripts)) {
+                    scriptNames.add(scriptKey);
+                }
             }
         }
     }
@@ -542,8 +584,28 @@ async function normalizeAssetUrls(projectConfig, projectDir) {
     let notFoundCount = 0;
     for (const [assetId, asset] of Object.entries(assets)) {
         const assetData = asset;
-        // 跳过已有 url 或没有 file 的资源
-        if (!assetData.file || assetData.file.url) {
+        // 跳过没有 file 的资源
+        if (!assetData.file) {
+            continue;
+        }
+        // 如果已有有效的本地 url（非 API URL），验证文件是否存在
+        if (assetData.file.url && !assetData.file.url.startsWith('/api/') && !assetData.file.url.startsWith('http')) {
+            // 已有有效的本地 url，验证文件存在性
+            try {
+                await fs.access(path.join(projectDir, assetData.file.url));
+                continue; // 文件存在，跳过
+            }
+            catch {
+                // 文件不存在，清除 url 继续搜索
+                delete assetData.file.url;
+            }
+        }
+        // 如果 url 是 API URL（PlayCraft 格式残留），清除它
+        if (assetData.file.url && (assetData.file.url.startsWith('/api/') || assetData.file.url.startsWith('http'))) {
+            delete assetData.file.url;
+        }
+        // 如果已经有有效 url 了（由之前的 loader 设置的），跳过
+        if (assetData.file.url) {
             continue;
         }
         const filename = assetData.file.filename;
@@ -552,11 +614,19 @@ async function normalizeAssetUrls(projectConfig, projectDir) {
         }
         const revision = assetData.revision ?? assetData.file.revision ?? 1;
         const candidates = [
+            // PlayCanvas 标准结构
             path.join('files', 'assets', String(assetId), String(revision), filename),
             path.join('files', 'assets', String(assetId), '1', filename),
             path.join('files', 'assets', String(assetId), filename),
             path.join('files', filename),
         ];
+        // PlayCraft 结构：使用 treePath 或 path 字段推断文件位置
+        if (assetData.treePath) {
+            candidates.push(path.join(assetData.treePath, filename));
+        }
+        if (assetData.path && typeof assetData.path === 'string') {
+            candidates.push(assetData.path);
+        }
         let found = false;
         for (const rel of candidates) {
             const abs = path.join(projectDir, rel);
@@ -699,7 +769,6 @@ async function generateESMTemplate(projectConfig, options, config) {
         '__modules__.js',
         '__loading__.js',
         'styles.css',
-        'logo.png',
         'manifest.json',
     ];
     for (const file of templateFiles) {
@@ -737,12 +806,19 @@ function fixImportMapPaths(importMap) {
  * 收集 ESM 脚本的导入路径
  */
 async function collectESMScriptImports(projectConfig, options) {
-    if (projectConfig.format !== 'playcanvas') {
-        return [];
+    // 获取脚本 ID 列表和资产（支持 PlayCanvas 和 PlayCraft 两种格式）
+    let scriptIds;
+    let assets;
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.project.settings?.scripts || [];
+        assets = pcProject.assets;
+    }
+    else {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.manifest.settings?.scripts || [];
+        assets = pcProject.assets;
     }
-    const pcProject = projectConfig;
-    const scriptIds = pcProject.project.settings?.scripts || [];
-    const assets = pcProject.assets;
     const importPaths = [];
     // 构建文件夹 ID 到名称的映射
     const folderMap = new Map();
@@ -868,14 +944,19 @@ async function generateESMEntry(projectConfig, outputDir, scriptImportPaths = []
 async function copyUserScriptsForESM(projectConfig, projectDir, outputDir, importMap) {
     const scriptUrlMap = new Map();
     console.log(`[copyUserScriptsForESM] 项目格式: ${projectConfig.format}`);
-    if (projectConfig.format !== 'playcanvas') {
-        // PlayCraft 格式暂不支持
-        console.log('[copyUserScriptsForESM] 跳过：非 PlayCanvas 格式');
-        return scriptUrlMap;
+    // 获取脚本 ID 列表和资产（支持 PlayCanvas 和 PlayCraft 两种格式）
+    let scriptIds;
+    let assets;
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.project.settings?.scripts || [];
+        assets = pcProject.assets;
+    }
+    else {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.manifest.settings?.scripts || [];
+        assets = pcProject.assets;
     }
-    const pcProject = projectConfig;
-    const scriptIds = pcProject.project.settings?.scripts || [];
-    const assets = pcProject.assets;
     console.log(`[copyUserScriptsForESM] 脚本数量: ${scriptIds.length}`);
     // 构建文件夹 ID 到名称的映射
     const folderMap = new Map();

package/dist/vite-builder.d.ts

@@ -10,37 +10,55 @@ export interface ViteBuildOutput {
  *
  * 职责：
  * 1. 验证输入是有效的基础构建
- * 2. 创建 Vite 配置
+ * 2. 根据引擎类型创建对应的 Vite 配置
  * 3. 执行 Vite 构建
  * 4. 将输出复制到最终目录
  * 5. 验证输出大小
  * 6. 生成报告
+ *
+ * 引擎路由：
+ * - PlayCanvas：使用 ViteConfigBuilder（处理 config.json、__start__.js 等）
+ * - 其他引擎：使用 GenericViteConfigBuilder（通用 HTML 内联 + 平台 SDK 注入）
  */
 export declare class ViteBuilder {
     private baseBuildDir;
     private options;
     private sizeReport;
+    private engine;
     constructor(baseBuildDir: string, options: BuildOptions);
     /**
      * 执行构建
      */
     build(): Promise<string>;
     /**
-     * 将 Vite 输出复制到最终目录
+     * 读取构建元数据
      */
-    private copyOutputToFinalDir;
+    private readBuildMetadata;
     /**
-     * 递归复制所有文件
+     * 验证基础构建
+     * 根据引擎类型使用不同的验证规则
      */
-    private copyAllFiles;
+    private validateBaseBuild;
+    /**
+     * 验证 PlayCanvas 构建
+     */
+    private validatePlayCanvasBuild;
+    /**
+     * 验证通用构建（外部引擎）
+     */
+    private validateGenericBuild;
     /**
      * 检测是否为 ESM 格式
      */
     private detectESMFormat;
     /**
-     * 验证基础构建
+     * 将 Vite 输出复制到最终目录
      */
-    private validateBaseBuild;
+    private copyOutputToFinalDir;
+    /**
+     * 递归复制所有文件
+     */
+    private copyAllFiles;
     /**
      * 获取输出路径
      */

package/dist/vite-builder.js

@@ -2,20 +2,26 @@ import { build as viteBuild } from 'vite';
 import fs from 'fs/promises';
 import path from 'path';
 import { ViteConfigBuilder } from './vite/config-builder.js';
+import { GenericViteConfigBuilder } from './vite/config-builder-generic.js';
 import { PLATFORM_CONFIGS } from './vite/platform-configs.js';
 /**
  * Vite 构建器 - 使用 Vite 构建 Playable Ads
  *
  * 职责：
  * 1. 验证输入是有效的基础构建
- * 2. 创建 Vite 配置
+ * 2. 根据引擎类型创建对应的 Vite 配置
  * 3. 执行 Vite 构建
  * 4. 将输出复制到最终目录
  * 5. 验证输出大小
  * 6. 生成报告
+ *
+ * 引擎路由：
+ * - PlayCanvas：使用 ViteConfigBuilder（处理 config.json、__start__.js 等）
+ * - 其他引擎：使用 GenericViteConfigBuilder（通用 HTML 内联 + 平台 SDK 注入）
  */
 export class ViteBuilder {
     constructor(baseBuildDir, options) {
+        this.engine = 'playcanvas';
         this.baseBuildDir = baseBuildDir;
         this.options = options;
         const platformConfig = PLATFORM_CONFIGS[options.platform];
@@ -30,26 +36,151 @@ export class ViteBuilder {
      * 执行构建
      */
     async build() {
-        // 1. 验证输入
-        await this.validateBaseBuild();
-        // 2. 创建 Vite 配置
-        const configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        // 1. 读取构建元数据获取引擎类型
+        const metadata = await this.readBuildMetadata();
+        this.engine = this.options.engine ?? metadata?.engine ?? 'playcanvas';
+        console.log(`[ViteBuilder] 使用引擎: ${this.engine}`);
+        // 2. 验证输入
+        await this.validateBaseBuild(metadata);
+        // 3. 根据引擎类型创建对应的配置构建器
+        let configBuilder;
+        if (this.engine === 'playcanvas') {
+            console.log('[ViteBuilder] 使用 PlayCanvas 配置构建器');
+            configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        }
+        else {
+            console.log('[ViteBuilder] 使用通用配置构建器（外部引擎）');
+            configBuilder = new GenericViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options, metadata);
+        }
         const viteConfig = await configBuilder.create();
-        // 3. 执行 Vite 构建
-        await viteBuild(viteConfig);
-        // 4. 将输出从临时目录复制到最终目录
+        // 4. 执行 Vite 构建
+        try {
+            await viteBuild(viteConfig);
+        }
+        catch (error) {
+            // 打印完整的 Vite/Rollup 错误信息，便于定位构建失败原因
+            console.error('[ViteBuilder] Vite 构建失败:');
+            if (error.id) {
+                console.error(`  - 问题文件: ${error.id}`);
+            }
+            if (error.loc) {
+                console.error(`  - 位置: 行 ${error.loc.line}, 列 ${error.loc.column}`);
+            }
+            if (error.frame) {
+                console.error(`  - 代码片段:\n${error.frame}`);
+            }
+            if (error.plugin) {
+                console.error(`  - 插件: ${error.plugin}`);
+            }
+            if (error.pluginCode) {
+                console.error(`  - 插件错误码: ${error.pluginCode}`);
+            }
+            if (error.cause) {
+                console.error(`  - 原因:`, error.cause);
+            }
+            console.error(`  - 完整错误:`, error.stack || error.message || error);
+            throw error;
+        }
+        // 5. 将输出从临时目录复制到最终目录
         const viteOutputDir = configBuilder.getViteOutputDir();
         const finalOutputDir = configBuilder.getFinalOutputDir();
         if (viteOutputDir && finalOutputDir && viteOutputDir !== finalOutputDir) {
             await this.copyOutputToFinalDir(viteOutputDir, finalOutputDir);
         }
-        // 5. 验证输出大小
+        // 6. 验证输出大小
         const outputPath = this.getOutputPath();
         await this.validateSize(outputPath);
-        // 6. 生成报告
+        // 7. 生成报告
         this.generateReport(outputPath);
         return outputPath;
     }
+    /**
+     * 读取构建元数据
+     */
+    async readBuildMetadata() {
+        const metadataPath = path.join(this.baseBuildDir, '.build-metadata.json');
+        try {
+            const content = await fs.readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            console.log(`[ViteBuilder] 读取构建元数据: engine=${metadata.engine}, mode=${metadata.mode}`);
+            return metadata;
+        }
+        catch (error) {
+            console.warn('[ViteBuilder] 无法读取构建元数据，假设为 PlayCanvas');
+            return null;
+        }
+    }
+    /**
+     * 验证基础构建
+     * 根据引擎类型使用不同的验证规则
+     */
+    async validateBaseBuild(metadata) {
+        const engine = this.options.engine ?? metadata?.engine ?? 'playcanvas';
+        if (engine === 'playcanvas') {
+            await this.validatePlayCanvasBuild();
+        }
+        else {
+            await this.validateGenericBuild();
+        }
+    }
+    /**
+     * 验证 PlayCanvas 构建
+     */
+    async validatePlayCanvasBuild() {
+        const isESM = await this.detectESMFormat();
+        const requiredFiles = isESM
+            ? ['index.html', 'config.json']
+            : ['index.html', 'config.json', '__start__.js'];
+        const missingFiles = [];
+        for (const file of requiredFiles) {
+            try {
+                await fs.access(path.join(this.baseBuildDir, file));
+            }
+            catch {
+                missingFiles.push(file);
+            }
+        }
+        if (missingFiles.length > 0) {
+            const formatType = isESM ? 'ESM' : 'Classic';
+            throw new Error(`PlayCanvas 基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
+                `检测到 ${formatType} 格式，请确保输入目录包含完整的构建产物。`);
+        }
+        console.log('[ViteBuilder] PlayCanvas 构建验证通过');
+    }
+    /**
+     * 验证通用构建（外部引擎）
+     */
+    async validateGenericBuild() {
+        // 外部引擎只需要 index.html
+        try {
+            await fs.access(path.join(this.baseBuildDir, 'index.html'));
+        }
+        catch {
+            throw new Error(`外部引擎构建产物缺少 index.html\n` +
+                `构建目录: ${this.baseBuildDir}\n` +
+                `请确保 Base Build 成功生成了有效的 HTML 入口文件。`);
+        }
+        console.log('[ViteBuilder] 外部引擎构建验证通过');
+    }
+    /**
+     * 检测是否为 ESM 格式
+     */
+    async detectESMFormat() {
+        const esmIndicators = [
+            path.join(this.baseBuildDir, 'js/index.mjs'),
+            path.join(this.baseBuildDir, 'esm-scripts'),
+        ];
+        for (const indicator of esmIndicators) {
+            try {
+                await fs.access(indicator);
+                return true;
+            }
+            catch {
+                // 继续检查
+            }
+        }
+        return false;
+    }
     /**
      * 将 Vite 输出复制到最终目录
      */
@@ -116,48 +247,6 @@ export class ViteBuilder {
         }
         console.log(`[ViteBuilder] 已将输出复制到: ${destDir}`);
     }
-    /**
-     * 检测是否为 ESM 格式
-     */
-    async detectESMFormat() {
-        const esmIndicators = [
-            path.join(this.baseBuildDir, 'js/index.mjs'),
-            path.join(this.baseBuildDir, 'esm-scripts'),
-        ];
-        for (const indicator of esmIndicators) {
-            try {
-                await fs.access(indicator);
-                return true;
-            }
-            catch {
-                // 继续检查
-            }
-        }
-        return false;
-    }
-    /**
-     * 验证基础构建
-     */
-    async validateBaseBuild() {
-        const isESM = await this.detectESMFormat();
-        const requiredFiles = isESM
-            ? ['index.html', 'config.json']
-            : ['index.html', 'config.json', '__start__.js'];
-        const missingFiles = [];
-        for (const file of requiredFiles) {
-            try {
-                await fs.access(path.join(this.baseBuildDir, file));
-            }
-            catch (error) {
-                missingFiles.push(file);
-            }
-        }
-        if (missingFiles.length > 0) {
-            const formatType = isESM ? 'ESM' : 'Classic';
-            throw new Error(`基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
-                `检测到 ${formatType} 格式，请确保输入目录包含完整的构建产物。`);
-        }
-    }
     /**
      * 获取输出路径
      */