@playcraft/build 0.0.13 → 0.0.15

package/dist/analyzers/scene-asset-collector.js

@@ -3,6 +3,35 @@
  *
  * 分析 PlayCanvas 场景文件，收集所有依赖的资源 ID
  */
+/**
+ * 构建脚本名 → 资源 ID 的映射表
+ * 遍历所有 script 类型的资源，从 data.scripts 中提取脚本名
+ */
+function buildScriptNameIndex(assets) {
+    const index = new Map();
+    for (const [assetId, asset] of Object.entries(assets)) {
+        if (asset.type !== 'script')
+            continue;
+        const scripts = asset.data?.scripts;
+        if (scripts && typeof scripts === 'object' && !Array.isArray(scripts)) {
+            // ESM format: data.scripts is { scriptName: { attributes: ... } }
+            for (const scriptName of Object.keys(scripts)) {
+                if (!index.has(scriptName)) {
+                    index.set(scriptName, assetId);
+                }
+            }
+        }
+        else if (Array.isArray(scripts)) {
+            // Classic format: data.scripts is [{ name: '...' }, ...]
+            for (const s of scripts) {
+                if (s?.name && !index.has(s.name)) {
+                    index.set(s.name, assetId);
+                }
+            }
+        }
+    }
+    return index;
+}
 /**
  * 分析场景的资源依赖
  * @param sceneData 场景数据对象
@@ -22,10 +51,12 @@ export async function analyzeSceneDependencies(sceneData, assets) {
     const entityCount = hasEntities ? Object.keys(sceneData.entities).length : 0;
     console.log(`  [SceneAnalyzer] 场景 "${deps.sceneName}" (ID: ${deps.sceneId})`);
     console.log(`    - 有 entities: ${hasEntities}, 实体数量: ${entityCount}`);
+    // 构建脚本名 → 资源 ID 映射（用于解析 script 组件引用）
+    const scriptNameIndex = buildScriptNameIndex(assets);
     // 1. 遍历所有实体
     if (sceneData.entities) {
         for (const [entityId, entity] of Object.entries(sceneData.entities)) {
-            collectEntityAssets(entity, deps, assets);
+            collectEntityAssets(entity, deps, assets, scriptNameIndex);
         }
     }
     else {
@@ -109,7 +140,7 @@ function collectSettingsAssets(settings, deps, assets) {
 /**
  * 收集实体的资源引用
  */
-function collectEntityAssets(entity, deps, assets) {
+function collectEntityAssets(entity, deps, assets, scriptNameIndex) {
     if (!entity || typeof entity !== 'object')
         return;
     // 检查实体是否引用了 template（template_id 字段）
@@ -124,7 +155,11 @@ function collectEntityAssets(entity, deps, assets) {
     if (entity.components) {
         for (const [componentName, componentData] of Object.entries(entity.components)) {
             if (componentData && typeof componentData === 'object') {
-                // 递归扫描组件数据，查找资源 ID
+                // 特殊处理 script 组件：通过脚本名解析资源 ID
+                if (componentName === 'script') {
+                    collectScriptComponentAssets(componentData, deps, assets, scriptNameIndex, entity.name);
+                }
+                // 递归扫描组件数据，查找资源 ID（对所有组件都做，包括 script）
                 findAssetIds(componentData, deps, assets);
             }
         }
@@ -137,6 +172,45 @@ function collectEntityAssets(entity, deps, assets) {
         }
     }
 }
+/**
+ * 处理 script 组件，将脚本名解析为资源 ID
+ * PlayCanvas script 组件结构:
+ *   { order: ["scriptName1", "scriptName2"], scripts: { scriptName1: {...}, scriptName2: {...} } }
+ * 脚本名不是资源 ID，需要通过 scriptNameIndex 映射到对应的 script 资产
+ */
+function collectScriptComponentAssets(scriptComponent, deps, assets, scriptNameIndex, entityName) {
+    // 从 order 数组或 scripts 对象键中收集脚本名
+    const scriptNames = new Set();
+    if (Array.isArray(scriptComponent.order)) {
+        for (const name of scriptComponent.order) {
+            if (typeof name === 'string') {
+                scriptNames.add(name);
+            }
+        }
+    }
+    if (scriptComponent.scripts && typeof scriptComponent.scripts === 'object') {
+        for (const name of Object.keys(scriptComponent.scripts)) {
+            scriptNames.add(name);
+        }
+    }
+    // 将脚本名映射到资源 ID
+    for (const scriptName of scriptNames) {
+        const assetId = scriptNameIndex.get(scriptName);
+        if (assetId && assets[assetId]) {
+            deps.directAssets.add(assetId);
+            deps.scripts.add(assetId);
+            console.log(`    [Script] 实体 "${entityName || 'unnamed'}": 脚本 "${scriptName}" → 资源 ${assetId}`);
+        }
+    }
+    // 同时扫描 script 属性值中可能引用的其他资源（如 asset 类型的属性）
+    if (scriptComponent.scripts && typeof scriptComponent.scripts === 'object') {
+        for (const [scriptName, scriptConfig] of Object.entries(scriptComponent.scripts)) {
+            if (scriptConfig?.attributes && typeof scriptConfig.attributes === 'object') {
+                findAssetIds(scriptConfig.attributes, deps, assets);
+            }
+        }
+    }
+}
 /**
  * 递归查找 JSON 中的资源 ID
  * PlayCanvas 中资源 ID 通常是数字或数字字符串
@@ -337,8 +411,8 @@ export async function collectScenesAssets(scenes, assets, globalScriptIds) {
             allAssetIds.add(id);
         }
     }
-    // 收集所有 template 资源及其依赖
-    // template 通常是运行时通过 assets.find() 动态实例化的，需要包含所有 preload 的模板
+    // 收集所有 template 资源及其依赖（含 preload=false 的插件模板如 _Guide、_ExplodeBall）
+    // template 通常由 GameplaySystem 等运行时通过 assets.find(name) 按名称动态加载
     console.log(`\n📦 收集 Template 资源依赖...`);
     const templateDeps = collectAllTemplatesDependencies(assets);
     let templateAssetsCount = 0;
@@ -349,19 +423,35 @@ export async function collectScenesAssets(scenes, assets, globalScriptIds) {
         }
     }
     console.log(`  - 从 Template 添加了 ${templateAssetsCount} 个额外资源`);
+    // 当场景有脚本时，包含所有 audio 资产
+    // 脚本常通过 app.assets.find("sfx_xxx") 按名称查找音频，静态分析无法识别
+    const hasScripts = allAssetIds.size > 0 && (Array.from(allAssetIds).some(id => assets[id]?.type === 'script') ||
+        (globalScriptIds && globalScriptIds.size > 0));
+    if (hasScripts) {
+        let audioCount = 0;
+        for (const [assetId, asset] of Object.entries(assets)) {
+            if (asset.type === 'audio' && !allAssetIds.has(assetId)) {
+                allAssetIds.add(assetId);
+                audioCount++;
+            }
+        }
+        if (audioCount > 0) {
+            console.log(`  - 场景有脚本，添加了 ${audioCount} 个 audio 资产（按名称动态引用）`);
+        }
+    }
     return allAssetIds;
 }
 /**
- * 收集所有 preload=true 的 template 资源及其依赖
- * 因为 template 通常是运行时动态实例化的，不一定在场景中直接引用
+ * 收集所有 template 资源及其依赖（含 preload=false 的插件模板）
+ * 插件模板（如 _Guide、_ExplodeBall）常由 GameplaySystem 按名称动态加载，preload 可能为 false
  */
 function collectAllTemplatesDependencies(assets) {
     const result = new Set();
     const visited = new Set();
     const queue = [];
-    // 首先收集所有 preload=true 的 template
+    // 收集所有 template（不再限制 preload=true，修复 "Failed to find plugin template" 错误）
     for (const [assetId, asset] of Object.entries(assets)) {
-        if (asset.type === 'template' && asset.preload !== false) {
+        if (asset.type === 'template') {
             result.add(assetId);
             queue.push(assetId);
         }

package/dist/base-builder.d.ts

@@ -1,93 +1,30 @@
-import type { BaseBuildMetadata } from './types.js';
-export interface BaseBuildOptions {
-    outputDir: string;
-    selectedScenes?: string[];
-    analyze?: boolean;
-    analyzeReportPath?: string;
-    clean?: boolean;
-}
-export interface BaseBuildOutput {
-    outputDir: string;
-    metadata: BaseBuildMetadata;
-    files: {
-        html: string;
-        engine: string | null;
-        config: string;
-        settings: string | null;
-        modules: string | null;
-        start: string;
-        scenes: string[];
-        assets: string[];
-    };
-}
+import type { BaseBuildOptions, BaseBuildOutput } from './types.js';
 /**
- * 基础构建器 - 生成可运行的多文件构建产物
+ * 基础构建器 - 路由到不同引擎适配器
  *
  * 职责：
- * 1. 从源代码或构建产物加载项目
- * 2. 确保所有必需文件存在且格式正确
- * 3. 输出可直接运行的多文件版本
- * 4. 不做任何内联或压缩
+ * 1. 确定引擎类型（从 options 或自动检测）
+ * 2. 路由到对应适配器执行 Base Build
+ *
+ * 适配器：
+ * - PlayCanvasAdapter：处理 PlayCanvas 项目（官方构建产物或源代码）
+ * - GenericAdapter：处理外部引擎（npm install + npm run build）
  */
 export declare class BaseBuilder {
     private projectDir;
     private options;
-    private stateManager;
     constructor(projectDir: string, options: BaseBuildOptions);
     /**
      * 执行基础构建
+     * 根据引擎类型路由到对应适配器
      */
     build(): Promise<BaseBuildOutput>;
     /**
-     * 保存构建元数据到输出目录
-     */
-    private saveBuildMetadata;
-    /**
-     * 检测项目类型
-     */
-    private detectProjectType;
-    /**
-     * 从官方构建产物构建
-     */
-    private buildFromOfficial;
-    /**
-     * 从输出目录检测构建模式
-     */
-    private detectBuildModeFromOutput;
-    /**
-     * 检测是否为 ESM 格式项目
-     */
-    private detectESMFormat;
-    /**
-     * 验证官方构建产物
-     */
-    private validateOfficialBuild;
-    /**
-     * 复制构建文件到输出目录
-     */
-    private copyBuildFiles;
-    /**
-     * 递归复制目录
-     */
-    private copyDirectory;
-    /**
-     * 从源代码构建（使用 Vite）
-     */
-    private buildFromSource;
-    /**
-     * 扫描输出文件
-     */
-    private scanOutputFiles;
-    /**
-     * 递归扫描目录
-     */
-    private scanDirectory;
-    /**
-     * 记录构建产物信息到状态管理器
-     */
-    private recordBuildOutput;
-    /**
-     * 生成构建分析报告
+     * 解析引擎类型
+     * 优先级：
+     * 1. options.engine（用户显式指定）
+     * 2. 自动检测
      */
-    private generateAnalysisReport;
+    private resolveEngine;
 }
+export type { BaseBuildOptions, BaseBuildOutput } from './types.js';