@playcraft/build 0.0.2

package/README.md

@@ -0,0 +1,96 @@
+# @playcraft/build
+
+PlayCraft 核心构建模块。将 PlayCanvas/PlayCraft 项目打包为 Playable Ads。
+
+## 功能
+
+- 两阶段构建（Base Build → Channel Build）
+- 支持 10 个广告平台
+- 使用 Vite 进行资源内联与压缩
+- 平台特定适配与 SDK 注入
+
+## 支持的平台
+
+- Facebook
+- Snapchat
+- ironSource
+- AppLovin
+- Google Ads
+- TikTok/Pangle
+- Unity Ads
+- Liftoff
+- Moloco
+- BIGO Ads
+
+## 使用
+
+### 基础用法
+
+```typescript
+import { BaseBuilder, ViteBuilder, type BuildOptions } from '@playcraft/build';
+
+// 阶段1：Base Build
+const baseBuilder = new BaseBuilder('/path/to/project', {
+  outputDir: './build',
+});
+const baseBuildResult = await baseBuilder.build();
+
+// 阶段2：Channel Build
+const buildOptions: BuildOptions = {
+  platform: 'facebook',
+  format: 'html',
+  outputDir: './dist',
+};
+
+const viteBuilder = new ViteBuilder(baseBuildResult.outputDir, buildOptions);
+const outputPath = await viteBuilder.build();
+const sizeReport = viteBuilder.getSizeReport();
+
+console.log('输出:', outputPath);
+console.log('大小报告:', sizeReport);
+```
+
+### 平台适配器
+
+```typescript
+import { createPlatformAdapter } from '@playcraft/build';
+
+const adapter = createPlatformAdapter({
+  platform: 'facebook',
+  format: 'html',
+});
+
+console.log(adapter.getName());          // "Facebook"
+console.log(adapter.getSizeLimit());     // 2097152 (2MB)
+console.log(adapter.getDefaultFormat()); // "html"
+```
+
+## 架构
+
+```
+@playcraft/build
+├── BaseBuilder       # 阶段1：生成多文件构建产物
+├── ViteBuilder       # 阶段2：Vite 单文件打包
+├── PlayableBuilder   # 阶段2：旧构建器（兼容）
+├── platforms/        # 平台适配器
+│   ├── FacebookAdapter
+│   ├── SnapchatAdapter
+│   ├── IronSourceAdapter
+│   ├── AppLovinAdapter
+│   ├── GoogleAdapter
+│   ├── TikTokAdapter
+│   ├── UnityAdapter
+│   ├── LiftoffAdapter
+│   ├── MolocoAdapter
+│   └── BigoAdapter
+└── vite/             # Vite 插件
+    ├── plugin-playcanvas
+    ├── plugin-platform
+    └── plugin-model-compression
+```
+
+## 依赖方
+
+- `@playcraft/cli`：CLI 工具
+- `@playcraft/worker`：队列消费与异步构建
+- `@playcraft/backend`：类型定义用于参数校验

package/dist/base-builder.d.ts

@@ -0,0 +1,66 @@
+export interface BaseBuildOptions {
+    outputDir: string;
+}
+export interface BaseBuildOutput {
+    outputDir: string;
+    files: {
+        html: string;
+        engine: string | null;
+        config: string;
+        settings: string | null;
+        modules: string | null;
+        start: string;
+        scenes: string[];
+        assets: string[];
+    };
+}
+/**
+ * 基础构建器 - 生成可运行的多文件构建产物
+ *
+ * 职责：
+ * 1. 从源代码或构建产物加载项目
+ * 2. 确保所有必需文件存在且格式正确
+ * 3. 输出可直接运行的多文件版本
+ * 4. 不做任何内联或压缩
+ */
+export declare class BaseBuilder {
+    private projectDir;
+    private options;
+    constructor(projectDir: string, options: BaseBuildOptions);
+    /**
+     * 执行基础构建
+     */
+    build(): Promise<BaseBuildOutput>;
+    /**
+     * 检测项目类型
+     */
+    private detectProjectType;
+    /**
+     * 从官方构建产物构建
+     */
+    private buildFromOfficial;
+    /**
+     * 验证官方构建产物
+     */
+    private validateOfficialBuild;
+    /**
+     * 复制构建文件到输出目录
+     */
+    private copyBuildFiles;
+    /**
+     * 递归复制目录
+     */
+    private copyDirectory;
+    /**
+     * 从源代码构建（使用 Vite）
+     */
+    private buildFromSource;
+    /**
+     * 扫描输出文件
+     */
+    private scanOutputFiles;
+    /**
+     * 递归扫描目录
+     */
+    private scanDirectory;
+}

package/dist/base-builder.js

@@ -0,0 +1,415 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { build as viteBuild } from 'vite';
+import { viteSourceBuilderPlugin } from './vite/plugin-source-builder.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * 基础构建器 - 生成可运行的多文件构建产物
+ *
+ * 职责：
+ * 1. 从源代码或构建产物加载项目
+ * 2. 确保所有必需文件存在且格式正确
+ * 3. 输出可直接运行的多文件版本
+ * 4. 不做任何内联或压缩
+ */
+export class BaseBuilder {
+    constructor(projectDir, options) {
+        this.projectDir = projectDir;
+        this.options = options;
+    }
+    /**
+     * 执行基础构建
+     */
+    async build() {
+        // 1. 检测项目类型
+        const projectType = await this.detectProjectType();
+        if (projectType === 'official-build') {
+            // 官方构建产物 - 直接复制并验证
+            return await this.buildFromOfficial();
+        }
+        else {
+            // 源代码格式（PlayCanvas 或 PlayCraft）- 使用 Vite 生成构建产物
+            const formatName = projectType === 'playcraft' ? 'PlayCraft' : 'PlayCanvas';
+            console.log(`[BaseBuilder] 检测到 ${formatName} 源代码格式，使用 Vite 构建...`);
+            return await this.buildFromSource();
+        }
+    }
+    /**
+     * 检测项目类型
+     */
+    async detectProjectType() {
+        // 1. 检查是否是官方构建产物
+        const buildIndicators = [
+            path.join(this.projectDir, 'index.html'),
+            path.join(this.projectDir, 'config.json'),
+        ];
+        try {
+            await fs.access(buildIndicators[0]);
+            await fs.access(buildIndicators[1]);
+            return 'official-build';
+        }
+        catch (error) {
+            // 2. 检查是否是 PlayCraft 项目格式
+            const manifestPath = path.join(this.projectDir, 'manifest.json');
+            try {
+                await fs.access(manifestPath);
+                const manifestContent = await fs.readFile(manifestPath, 'utf-8');
+                const manifest = JSON.parse(manifestContent);
+                if (manifest.format === 'playcraft' || Array.isArray(manifest.assets)) {
+                    return 'playcraft';
+                }
+            }
+            catch (error) {
+                // manifest.json 不存在或格式不对
+            }
+            // 3. 默认视为源代码项目
+            return 'source';
+        }
+    }
+    /**
+     * 从官方构建产物构建
+     */
+    async buildFromOfficial() {
+        // 验证必需文件存在
+        await this.validateOfficialBuild();
+        // 创建输出目录
+        await fs.mkdir(this.options.outputDir, { recursive: true });
+        // 复制所有文件到输出目录
+        const files = await this.copyBuildFiles();
+        return {
+            outputDir: this.options.outputDir,
+            files,
+        };
+    }
+    /**
+     * 验证官方构建产物
+     */
+    async validateOfficialBuild() {
+        const requiredFiles = [
+            'index.html',
+            'config.json',
+            '__start__.js',
+        ];
+        const missingFiles = [];
+        for (const file of requiredFiles) {
+            try {
+                await fs.access(path.join(this.projectDir, file));
+            }
+            catch (error) {
+                missingFiles.push(file);
+            }
+        }
+        if (missingFiles.length > 0) {
+            throw new Error(`官方构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
+                `请确保项目目录包含完整的构建产物。`);
+        }
+    }
+    /**
+     * 复制构建文件到输出目录
+     */
+    async copyBuildFiles() {
+        const files = {
+            html: '',
+            engine: null,
+            config: '',
+            settings: null,
+            modules: null,
+            start: '',
+            scenes: [],
+            assets: [],
+        };
+        // 复制 index.html
+        const htmlPath = path.join(this.projectDir, 'index.html');
+        const outputHtmlPath = path.join(this.options.outputDir, 'index.html');
+        await fs.copyFile(htmlPath, outputHtmlPath);
+        files.html = outputHtmlPath;
+        // 复制 config.json
+        const configPath = path.join(this.projectDir, 'config.json');
+        const outputConfigPath = path.join(this.options.outputDir, 'config.json');
+        await fs.copyFile(configPath, outputConfigPath);
+        files.config = outputConfigPath;
+        // 读取 config.json 以获取场景信息
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const configJson = JSON.parse(configContent);
+        // 复制 __start__.js
+        const startPath = path.join(this.projectDir, '__start__.js');
+        const outputStartPath = path.join(this.options.outputDir, '__start__.js');
+        await fs.copyFile(startPath, outputStartPath);
+        files.start = outputStartPath;
+        // 复制 __settings__.js（如果存在）
+        const settingsPath = path.join(this.projectDir, '__settings__.js');
+        try {
+            await fs.access(settingsPath);
+            const outputSettingsPath = path.join(this.options.outputDir, '__settings__.js');
+            await fs.copyFile(settingsPath, outputSettingsPath);
+            files.settings = outputSettingsPath;
+        }
+        catch (error) {
+            // __settings__.js 不是必需的
+        }
+        // 复制 __modules__.js（如果存在）
+        const modulesPath = path.join(this.projectDir, '__modules__.js');
+        try {
+            await fs.access(modulesPath);
+            const outputModulesPath = path.join(this.options.outputDir, '__modules__.js');
+            await fs.copyFile(modulesPath, outputModulesPath);
+            files.modules = outputModulesPath;
+        }
+        catch (error) {
+            // __modules__.js 不是必需的
+        }
+        // 复制 PlayCanvas Engine（查找可能的文件名）
+        const engineNames = [
+            'playcanvas-stable.min.js',
+            'playcanvas.min.js',
+            '__lib__.js',
+        ];
+        for (const engineName of engineNames) {
+            const enginePath = path.join(this.projectDir, engineName);
+            try {
+                await fs.access(enginePath);
+                const outputEnginePath = path.join(this.options.outputDir, engineName);
+                await fs.copyFile(enginePath, outputEnginePath);
+                files.engine = outputEnginePath;
+                break;
+            }
+            catch (error) {
+                // 继续尝试下一个
+            }
+        }
+        // 复制场景文件
+        if (configJson.scenes && Array.isArray(configJson.scenes)) {
+            for (const scene of configJson.scenes) {
+                if (scene.url && !scene.url.startsWith('data:')) {
+                    const scenePath = path.join(this.projectDir, scene.url);
+                    try {
+                        await fs.access(scenePath);
+                        const sceneDir = path.dirname(scene.url);
+                        if (sceneDir && sceneDir !== '.') {
+                            const outputSceneDir = path.join(this.options.outputDir, sceneDir);
+                            await fs.mkdir(outputSceneDir, { recursive: true });
+                        }
+                        const outputScenePath = path.join(this.options.outputDir, scene.url);
+                        await fs.copyFile(scenePath, outputScenePath);
+                        files.scenes.push(outputScenePath);
+                    }
+                    catch (error) {
+                        console.warn(`警告: 场景文件不存在: ${scene.url}`);
+                    }
+                }
+            }
+        }
+        // 复制资产文件（从 config.json 中的 assets）
+        if (configJson.assets) {
+            const assetsDir = path.join(this.options.outputDir, 'files');
+            await fs.mkdir(assetsDir, { recursive: true });
+            for (const [assetId, assetData] of Object.entries(configJson.assets)) {
+                const asset = assetData;
+                if (asset.file && asset.file.url && !asset.file.url.startsWith('data:')) {
+                    const assetPath = path.join(this.projectDir, asset.file.url);
+                    try {
+                        await fs.access(assetPath);
+                        const assetDir = path.dirname(asset.file.url);
+                        if (assetDir && assetDir !== '.') {
+                            const outputAssetDir = path.join(this.options.outputDir, assetDir);
+                            await fs.mkdir(outputAssetDir, { recursive: true });
+                        }
+                        const outputAssetPath = path.join(this.options.outputDir, asset.file.url);
+                        await fs.copyFile(assetPath, outputAssetPath);
+                        files.assets.push(outputAssetPath);
+                    }
+                    catch (error) {
+                        // 资产文件可能不存在（可能是内联的）
+                    }
+                }
+            }
+        }
+        // 复制 files/ 目录（如果存在）
+        const filesDir = path.join(this.projectDir, 'files');
+        try {
+            const filesDirStat = await fs.stat(filesDir);
+            if (filesDirStat.isDirectory()) {
+                const outputFilesDir = path.join(this.options.outputDir, 'files');
+                await this.copyDirectory(filesDir, outputFilesDir);
+            }
+        }
+        catch (error) {
+            // files/ 目录可能不存在
+        }
+        // 复制 styles.css（如果存在）
+        const stylesPath = path.join(this.projectDir, 'styles.css');
+        try {
+            await fs.access(stylesPath);
+            const outputStylesPath = path.join(this.options.outputDir, 'styles.css');
+            await fs.copyFile(stylesPath, outputStylesPath);
+        }
+        catch (error) {
+            // styles.css 可能不存在
+        }
+        // 复制 manifest.json（如果存在）
+        const manifestPath = path.join(this.projectDir, 'manifest.json');
+        try {
+            await fs.access(manifestPath);
+            const outputManifestPath = path.join(this.options.outputDir, 'manifest.json');
+            await fs.copyFile(manifestPath, outputManifestPath);
+        }
+        catch (error) {
+            // manifest.json 可能不存在
+        }
+        return files;
+    }
+    /**
+     * 递归复制目录
+     */
+    async copyDirectory(src, dest) {
+        await fs.mkdir(dest, { recursive: true });
+        const entries = await fs.readdir(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                await this.copyDirectory(srcPath, destPath);
+            }
+            else {
+                await fs.copyFile(srcPath, destPath);
+            }
+        }
+    }
+    /**
+     * 从源代码构建（使用 Vite）
+     */
+    async buildFromSource() {
+        console.log('[BaseBuilder] 使用 Vite 从源代码构建...');
+        // 1. 创建 Vite 配置
+        const viteConfig = {
+            root: this.projectDir,
+            base: './',
+            build: {
+                outDir: this.options.outputDir,
+                emptyOutDir: true,
+                // 多文件输出（不内联资源）
+                assetsInlineLimit: 0,
+                // Base Build 不压缩（保持可读性和调试性）
+                minify: false,
+                cssMinify: false,
+                sourcemap: false,
+                rollupOptions: {
+                    input: {
+                        // 虚拟模块：用户脚本入口
+                        'game-scripts': 'virtual:game-scripts',
+                    },
+                    output: {
+                        entryFileNames: '__[name].js',
+                        chunkFileNames: '__[name]-[hash].js',
+                        assetFileNames: 'files/assets/[name].[ext]',
+                    },
+                    // 外部化 PlayCanvas Engine（不打包）
+                    external: ['pc', 'playcanvas'],
+                    // 仅对用户脚本模块启用 tree-shake（引擎已外部化）
+                    treeshake: true,
+                },
+            },
+            plugins: [
+                // 源代码构建插件
+                viteSourceBuilderPlugin({
+                    projectDir: this.projectDir,
+                    outputDir: this.options.outputDir,
+                }),
+            ],
+        };
+        // 2. 执行 Vite 构建
+        await viteBuild(viteConfig);
+        // 3. 扫描生成的文件
+        const files = await this.scanOutputFiles();
+        // 4. 返回构建结果
+        return {
+            outputDir: this.options.outputDir,
+            files,
+        };
+    }
+    /**
+     * 扫描输出文件
+     */
+    async scanOutputFiles() {
+        const files = {
+            html: path.join(this.options.outputDir, 'index.html'),
+            engine: null,
+            config: path.join(this.options.outputDir, 'config.json'),
+            settings: path.join(this.options.outputDir, '__settings__.js'),
+            modules: null,
+            start: path.join(this.options.outputDir, '__start__.js'),
+            scenes: [],
+            assets: [],
+        };
+        // 检查 engine
+        const enginePath = path.join(this.options.outputDir, 'playcanvas-stable.min.js');
+        try {
+            await fs.access(enginePath);
+            files.engine = enginePath;
+        }
+        catch (error) {
+            // engine 可能不存在
+        }
+        // 检查 modules
+        const modulesPath = path.join(this.options.outputDir, '__modules__.js');
+        try {
+            await fs.access(modulesPath);
+            files.modules = modulesPath;
+        }
+        catch (error) {
+            // modules 可能不存在
+        }
+        // 读取 config.json 以获取场景信息
+        try {
+            const configContent = await fs.readFile(files.config, 'utf-8');
+            const configJson = JSON.parse(configContent);
+            // 扫描场景文件
+            if (configJson.scenes && Array.isArray(configJson.scenes)) {
+                for (const scene of configJson.scenes) {
+                    if (scene.url && !scene.url.startsWith('data:')) {
+                        const scenePath = path.join(this.options.outputDir, scene.url);
+                        try {
+                            await fs.access(scenePath);
+                            files.scenes.push(scenePath);
+                        }
+                        catch (error) {
+                            // 场景文件可能不存在
+                        }
+                    }
+                }
+            }
+            // 扫描资产文件（从 files/ 目录）
+            const filesDir = path.join(this.options.outputDir, 'files');
+            try {
+                const filesDirStat = await fs.stat(filesDir);
+                if (filesDirStat.isDirectory()) {
+                    await this.scanDirectory(filesDir, files.assets);
+                }
+            }
+            catch (error) {
+                // files/ 目录可能不存在
+            }
+        }
+        catch (error) {
+            console.warn('警告: 无法读取 config.json:', error);
+        }
+        return files;
+    }
+    /**
+     * 递归扫描目录
+     */
+    async scanDirectory(dir, files) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await this.scanDirectory(fullPath, files);
+            }
+            else {
+                files.push(fullPath);
+            }
+        }
+    }
+}

package/dist/converter.d.ts

@@ -0,0 +1,35 @@
+import type { AssetInfo, BuildOptions } from './types.js';
+export declare class OnePageConverter {
+    private projectDir;
+    private options;
+    private assets;
+    constructor(projectDir: string, options: BuildOptions);
+    /**
+     * 添加资产到转换列表
+     */
+    addAsset(assetPath: string, type: string): void;
+    /**
+     * 编码所有资产为 Base64
+     */
+    encodeAssets(): Promise<void>;
+    /**
+     * 获取资产的 Base64 数据 URL
+     */
+    getDataUrl(assetPath: string): string | null;
+    /**
+     * 替换 HTML 中的 URL 为 Base64 数据 URL
+     */
+    replaceUrlsWithBase64(html: string, urlMap: Map<string, string>): string;
+    /**
+     * 内联脚本到 HTML
+     */
+    inlineScripts(html: string): Promise<string>;
+    /**
+     * 获取所有资产信息
+     */
+    getAssets(): AssetInfo[];
+    /**
+     * 获取总大小
+     */
+    getTotalSize(): number;
+}