@playcraft/cli 0.0.18 → 0.0.21

package/dist/commands/build.js

@@ -5,6 +5,23 @@ import ora from 'ora';
 import { BaseBuilder, ViteBuilder, PlayableBuilder, PlayableAnalyzer, EngineDetector, detectAmmoUsage } from '@playcraft/build';
 import { loadBuildConfig } from '../build-config.js';
 import inquirer from 'inquirer';
+/**
+ * 类型守卫：检查对象是否符合 PlayableScriptsConfig 类型
+ */
+function isPlayableScriptsConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    // 检查关键可选字段的类型（如果存在）
+    const config = obj;
+    if (config.channels !== undefined && !Array.isArray(config.channels)) {
+        return false;
+    }
+    if (config.themes !== undefined && (typeof config.themes !== 'object' || config.themes === null)) {
+        return false;
+    }
+    return true;
+}
 /**
  * 检测是否是基础构建产物（多文件版本）
  */
@@ -32,6 +49,40 @@ async function detectBaseBuild(dir) {
         return false;
     }
 }
+/**
+ * 构建 PlayableScriptsConfig，合并 CLI 选择的参数和文件配置
+ */
+function buildPlayableScriptsConfig(fileConfigPlayableScripts, options) {
+    // 使用类型守卫检查 playableScripts 是否符合 PlayableScriptsConfig 类型
+    let config = fileConfigPlayableScripts && isPlayableScriptsConfig(fileConfigPlayableScripts)
+        ? { ...fileConfigPlayableScripts }
+        : undefined;
+    // 将 CLI 选择的 platform 转换为 channels
+    if (options.platform) {
+        if (!config) {
+            config = {};
+        }
+        config.channels = [options.platform];
+    }
+    // 将 CLI 选择的 storeUrls 合并到配置
+    if (options.storeUrls) {
+        if (!config) {
+            config = {};
+        }
+        config.storeUrls = options.storeUrls;
+    }
+    // 将选择的主题合并到配置
+    if (options.selectedThemes && options.selectedThemes.length > 0) {
+        if (!config) {
+            config = {};
+        }
+        config.themes = {
+            enabled: true,
+            whitelist: options.selectedThemes,
+        };
+    }
+    return config;
+}
 /**
  * 检测项目场景列表（支持 PlayCanvas 和 PlayCraft 两种格式）
  */
@@ -43,7 +94,6 @@ async function detectProjectScenes(projectPath) {
             const manifestContent = await fs.readFile(manifestJsonPath, 'utf-8');
             const manifestData = JSON.parse(manifestContent);
             if (manifestData.scenes && Array.isArray(manifestData.scenes)) {
-                // PlayCraft manifest.json 中的场景列表
                 const scenes = manifestData.scenes.map((scene) => ({
                     id: String(scene.id || scene.name),
                     name: scene.name || `Scene ${scene.id}`,
@@ -201,25 +251,43 @@ export async function buildCommand(projectPath, options) {
     // 清理选项（默认为 false，使用覆盖模式）
     const shouldClean = options.clean === true;
     try {
-        // ====== 引擎检测 ======
+        // ====== 引擎 + 构建工具检测 ======
         spinner.text = pc.cyan('检测项目引擎类型...');
         let detectedEngine;
-        if (options.engine) {
+        let detectionResult;
+        if (options.usePlayableScripts) {
+            // 用户显式指定 --use-playable-scripts
+            detectionResult = { engine: 'generic', buildTool: 'playable-scripts' };
+            detectedEngine = 'generic';
+            console.log(pc.cyan(`\n🔧 使用 @playcraft/devkit 构建工具（用户显式指定）`));
+        }
+        else if (options.engine) {
             // 用户指定了引擎类型
             detectedEngine = options.engine;
+            detectionResult = {
+                engine: detectedEngine,
+                buildTool: detectedEngine === 'playcanvas' ? 'playcanvas-native' : 'generic',
+            };
             console.log(pc.dim(`\nℹ️  使用指定引擎: ${detectedEngine}`));
         }
         else {
-            // 自动检测引擎类型
-            detectedEngine = await EngineDetector.detect(resolvedProjectPath);
-            console.log(pc.dim(`\nℹ️  检测到引擎: ${detectedEngine}`));
-            // 对于外部引擎，显示提示
-            if (detectedEngine !== 'playcanvas') {
+            // 自动检测引擎类型 + 构建工具
+            detectionResult = await EngineDetector.detectFull(resolvedProjectPath);
+            detectedEngine = detectionResult.engine;
+            console.log(pc.dim(`\nℹ️  检测到引擎: ${detectedEngine}, 构建工具: ${detectionResult.buildTool}`));
+            // 对于 playable-scripts 项目，显示专用提示
+            if (detectionResult.buildTool === 'playable-scripts') {
+                console.log(pc.cyan(`\n🔧 检测到 @playcraft/devkit 构建工具`));
+                console.log(pc.dim('   将使用 playable-scripts 进行构建（产物已含渠道适配和混淆压缩）'));
+            }
+            else if (detectedEngine !== 'playcanvas') {
+                // 对于外部引擎（非 playable-scripts），显示普通提示
                 console.log(pc.cyan(`\n🎮 检测到 ${detectedEngine} 项目`));
                 console.log(pc.dim('   将使用 npm install + npm run build 进行构建'));
                 console.log(pc.yellow('   ⚠️ 构建时间可能较长（约 2-5 分钟）\n'));
             }
         }
+        const isPlayableScripts = detectionResult.buildTool === 'playable-scripts';
         const isPlayCanvas = detectedEngine === 'playcanvas';
         const requiresNpmBuild = detectedEngine !== 'playcanvas';
         if (!options.baseOnly && !options.mode) {
@@ -262,12 +330,37 @@ export async function buildCommand(projectPath, options) {
         }
         // 解析场景选择参数（支持 PlayCanvas 和 PlayCraft 项目）
         let selectedScenes;
+        // 主题选择（仅用于 playable-scripts 项目）
+        let selectedThemes;
         if (isPlayCanvas) {
             if (options.scenes) {
                 // 命令行指定了场景参数
-                selectedScenes = options.scenes.split(',').map(s => s.trim()).filter(s => s);
-                if (selectedScenes.length > 0) {
-                    console.log(`\n🎬 选中场景: ${selectedScenes.join(', ')}`);
+                const scenesInput = options.scenes.trim().toLowerCase();
+                // 检查特殊关键字
+                if (scenesInput === 'all') {
+                    // 打包所有场景
+                    selectedScenes = undefined; // undefined 表示所有场景
+                    console.log(`\n🎬 选中场景: 全部场景`);
+                }
+                else if (scenesInput === 'default') {
+                    // 打包默认场景
+                    const projectScenes = await detectProjectScenes(resolvedProjectPath);
+                    const defaultScene = projectScenes.find(s => s.isMain === true) || projectScenes[0];
+                    if (defaultScene) {
+                        selectedScenes = [defaultScene.name || String(defaultScene.id)];
+                        console.log(`\n🎬 选中场景: ${defaultScene.name || defaultScene.id}${defaultScene.isMain ? ' (默认场景)' : ' (第一个场景)'}`);
+                    }
+                    else {
+                        console.log(`\n⚠️  未找到默认场景，将打包所有场景`);
+                        selectedScenes = undefined;
+                    }
+                }
+                else {
+                    // 普通场景名称列表
+                    selectedScenes = options.scenes.split(',').map(s => s.trim()).filter(s => s);
+                    if (selectedScenes.length > 0) {
+                        console.log(`\n🎬 选中场景: ${selectedScenes.join(', ')}`);
+                    }
                 }
             }
             else if (options.mode !== 'playable') {
@@ -287,7 +380,7 @@ export async function buildCommand(projectPath, options) {
                             choices: projectScenes.map(scene => ({
                                 name: scene.isMain ? `${scene.name} (主场景)` : scene.name,
                                 value: scene.name,
-                                checked: scene.isMain === true || !projectScenes.some(s => s.isMain) // 有 isMain 标记则只默认选主场景，否则全选
+                                checked: scene.isMain === true || !projectScenes.some(s => s.isMain)
                             })),
                             validate: (answer) => {
                                 if (answer.length === 0) {
@@ -329,12 +422,21 @@ export async function buildCommand(projectPath, options) {
                 console.log(pc.dim(`\nℹ️  使用覆盖模式，新文件将覆盖旧文件（使用 --clean 可清理旧目录）`));
             }
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
+            // 构建 playableScriptsConfig，合并 CLI 选择的参数
+            const playableScriptsConfig = buildPlayableScriptsConfig(fileConfig?.playableScripts, {
+                platform: options.platform,
+                storeUrls: options.storeUrls,
+                selectedThemes,
+            });
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
                 outputDir: baseBuildOutputDir,
                 selectedScenes,
                 clean: shouldClean && !isSameAsInput, // 清理逻辑由 BaseBuilder 内部处理
                 analyze: options.analyze, // 传递 analyze 参数
                 engine: detectedEngine, // 传递引擎类型
+            }, {
+                usePlayableScripts: isPlayableScripts,
+                playableScriptsConfig,
             });
             const baseBuild = await baseBuilder.build();
             spinner.succeed(pc.green('✅ 基础构建完成！'));
@@ -363,8 +465,8 @@ export async function buildCommand(projectPath, options) {
         ];
         // 渠道输出格式配置（根据各渠道Playable规格对照表）
         // 只支持 HTML: applovin, ironsource, unity, moloco, adikteev, remerge
-        // 只支持 ZIP: google, tiktok, liftoff, bigo, snapchat, inmobi
-        // 支持两种: facebook
+        // 只支持 ZIP: tiktok, liftoff, bigo, snapchat, inmobi
+        // 支持两种: facebook, google
         const platformFormatConfig = {
             facebook: {
                 formats: ['html', 'zip'],
@@ -377,7 +479,11 @@ export async function buildCommand(projectPath, options) {
             moloco: { formats: ['html'], default: 'html' },
             adikteev: { formats: ['html'], default: 'html' },
             remerge: { formats: ['html'], default: 'html' },
-            google: { formats: ['zip'], default: 'zip' },
+            google: {
+                formats: ['html', 'zip'],
+                default: 'html',
+                description: 'Google Ads 支持两种格式'
+            },
             tiktok: { formats: ['zip'], default: 'zip' },
             liftoff: { formats: ['zip'], default: 'zip' },
             bigo: { formats: ['zip'], default: 'zip' },
@@ -421,10 +527,10 @@ export async function buildCommand(projectPath, options) {
                             : '选择输出格式:',
                         choices: formatConfig.formats.map(f => ({
                             name: f === 'html'
-                                ? (selectedPlatform === 'facebook'
+                                ? (selectedPlatform === 'facebook' || selectedPlatform === 'google'
                                     ? 'HTML（单文件，最大 5MB，所有资源内联）'
                                     : 'HTML（单文件）')
-                                : (selectedPlatform === 'facebook'
+                                : (selectedPlatform === 'facebook' || selectedPlatform === 'google'
                                     ? 'ZIP（多文件，最大 5MB，HTML 文件需 < 2MB）'
                                     : 'ZIP（多文件）'),
                             value: f,
@@ -434,6 +540,47 @@ export async function buildCommand(projectPath, options) {
                 ]);
                 selectedFormat = formatAnswer.format;
             }
+            // 如果是 playable-scripts 项目，交互式选择主题
+            if (isPlayableScripts) {
+                const themeDir = path.join(resolvedProjectPath, 'src', 'theme');
+                try {
+                    const themeEntries = await fs.readdir(themeDir, { withFileTypes: true });
+                    const availableThemes = themeEntries
+                        .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith('tiles-'))
+                        .map(e => e.name)
+                        .sort();
+                    if (availableThemes.length > 1) {
+                        console.log(pc.cyan('\n🎨 选择要构建的主题:'));
+                        const themeAnswer = await inquirer.prompt([
+                            {
+                                type: 'list',
+                                name: 'theme',
+                                message: '选择主题:',
+                                choices: [
+                                    { name: '📌 使用当前默认主题 (src/theme/index.ts)', value: '__default__' },
+                                    ...availableThemes.map(t => ({ name: `🎨 ${t}`, value: t })),
+                                ],
+                                default: '__default__',
+                            },
+                        ]);
+                        // 如果用户选择了具体主题（而非默认）
+                        if (themeAnswer.theme !== '__default__') {
+                            selectedThemes = [themeAnswer.theme];
+                            console.log(pc.green(`✅ 已选择主题: ${themeAnswer.theme}`));
+                        }
+                        else {
+                            console.log(pc.dim('   使用当前默认主题'));
+                        }
+                    }
+                    else if (availableThemes.length === 1) {
+                        console.log(pc.dim(`\n🎨 检测到 1 个主题: ${availableThemes[0]}`));
+                    }
+                }
+                catch (error) {
+                    // 无主题目录，跳过
+                    console.log(pc.dim('   无主题目录，跳过主题选择'));
+                }
+            }
             // 输入商店跳转地址（CTA）- 如果配置文件中没有则必填
             if (!options.storeUrls) {
                 console.log(pc.cyan('\n🔗 商店跳转地址（CTA 按钮目标）'));
@@ -587,15 +734,68 @@ export async function buildCommand(projectPath, options) {
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
             // 将临时目录放在项目所在目录下，避免跨盘符路径问题（Windows 上 C:\Temp 和 D:\project 会导致 Vite 路径计算错误）
             const tempDir = path.join(resolvedProjectPath, '.playcraft-temp', `base-build-${Date.now()}`);
+            // 构建 playableScriptsConfig，合并 CLI 选择的参数
+            const playableScriptsConfig = buildPlayableScriptsConfig(fileConfig?.playableScripts, {
+                platform: options.platform,
+                storeUrls: options.storeUrls,
+                selectedThemes,
+            });
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
                 outputDir: tempDir,
                 selectedScenes,
                 analyze: buildOptions.analyze,
                 analyzeReportPath: buildOptions.analyze ? 'base-bundle-report.html' : undefined,
                 engine: detectedEngine, // 传递引擎类型
+            }, {
+                usePlayableScripts: isPlayableScripts,
+                playableScriptsConfig,
             });
             const baseBuild = await baseBuilder.build();
             baseBuildDir = baseBuild.outputDir;
+            // 如果是 playable-scripts 构建，产物已是最终格式，跳过阶段2
+            if (baseBuild.metadata.skipChannelBuild) {
+                spinner.succeed(pc.green('📦 @playcraft/devkit 构建完成！'));
+                // 将产物从临时目录复制到用户指定的输出目录
+                const finalOutputDir = buildOptions.outputDir || path.resolve(options.output || './dist');
+                await fs.mkdir(finalOutputDir, { recursive: true });
+                // 复制所有产物到最终输出目录，保留相对目录结构
+                for (const asset of baseBuild.files.assets) {
+                    // 计算相对于基础构建输出目录的相对路径，保留目录结构
+                    const relativePath = path.relative(baseBuildDir, asset);
+                    const destPath = path.join(finalOutputDir, relativePath);
+                    // 确保目标目录存在
+                    await fs.mkdir(path.dirname(destPath), { recursive: true });
+                    await fs.copyFile(asset, destPath);
+                }
+                // 显示产物信息
+                console.log('\n' + pc.bold('构建产物:'));
+                for (const asset of baseBuild.files.assets) {
+                    // 使用相对路径显示，保持目录结构可见
+                    const relativePath = path.relative(baseBuildDir, asset);
+                    const finalPath = path.join(finalOutputDir, relativePath);
+                    try {
+                        const stat = await fs.stat(finalPath);
+                        const sizeMB = (stat.size / 1024 / 1024).toFixed(2);
+                        console.log(`  - ${relativePath}: ${sizeMB} MB`);
+                    }
+                    catch {
+                        console.log(`  - ${relativePath}`);
+                    }
+                }
+                console.log('\n' + pc.green(`输出目录: ${finalOutputDir}`));
+                console.log(pc.dim('💡 产物已包含渠道适配、MRAID 注入、代码混淆和 fflate 压缩'));
+                // 清理临时目录
+                try {
+                    const tempBaseDir = path.join(resolvedProjectPath, '.playcraft-temp');
+                    await fs.rm(tempBaseDir, { recursive: true, force: true });
+                    console.log(pc.dim(`\n🗑️  已清理临时目录`));
+                }
+                catch (error) {
+                    // 记录清理错误信息
+                    console.log(pc.dim(`\n⚠️  清理临时目录失败: ${error instanceof Error ? error.message : String(error)}`));
+                }
+                return;
+            }
             spinner.text = pc.cyan('✅ 阶段1完成，开始阶段2...');
         }
         // Ammo 检测和替换（仅 PlayCanvas 项目）