@playcraft/build 0.0.2

package/dist/vite/plugin-source-builder.d.ts

@@ -0,0 +1,15 @@
+import type { Plugin } from 'vite';
+export interface SourceBuilderPluginOptions {
+    projectDir: string;
+    outputDir: string;
+}
+export interface UserScript {
+    id: string;
+    path: string;
+    code: string;
+    name: string;
+}
+/**
+ * Vite 插件：从源代码构建 PlayCanvas 项目
+ */
+export declare function viteSourceBuilderPlugin(options: SourceBuilderPluginOptions): Plugin;

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

@@ -0,0 +1,344 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import crypto from 'crypto';
+import { loadPlayCanvasProject } from '../loaders/playcanvas-loader.js';
+import { loadPlayCraftProject } from '../loaders/playcraft-loader.js';
+import { generateConfig } from '../generators/config-generator.js';
+import { generateSettings } from '../generators/settings-generator.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Vite 插件：从源代码构建 PlayCanvas 项目
+ */
+export function viteSourceBuilderPlugin(options) {
+    let projectFormat = null;
+    let projectConfig = null;
+    let userScripts = [];
+    return {
+        name: 'vite-plugin-source-builder',
+        enforce: 'pre',
+        async buildStart() {
+            console.log('[SourceBuilder] 开始构建源代码项目...');
+            // 1. 检测项目格式
+            projectFormat = await detectFormat(options.projectDir);
+            console.log(`[SourceBuilder] 检测到项目格式: ${projectFormat}`);
+            // 2. 读取项目配置
+            if (projectFormat === 'playcanvas') {
+                projectConfig = await loadPlayCanvasProject(options.projectDir);
+            }
+            else {
+                projectConfig = await loadPlayCraftProject(options.projectDir);
+            }
+            // 2.1 规范化资源文件 URL（补齐 file.url）
+            await normalizeAssetUrls(projectConfig, options.projectDir);
+            // 3. 收集用户脚本
+            userScripts = await collectUserScripts(projectConfig, options.projectDir);
+            console.log(`[SourceBuilder] 收集到 ${userScripts.length} 个用户脚本`);
+        },
+        // 处理虚拟模块（用户脚本）
+        resolveId(id) {
+            if (id === 'virtual:game-scripts') {
+                return '\0virtual:game-scripts';
+            }
+            return null;
+        },
+        load(id) {
+            if (id === '\0virtual:game-scripts') {
+                // 合并所有用户脚本
+                const scriptCode = userScripts.length > 0
+                    ? userScripts
+                        .map(s => wrapPlayCanvasScript(s.code, s.name, s))
+                        .join('\n\n')
+                    : '// No user scripts';
+                return scriptCode;
+            }
+            return null;
+        },
+        async closeBundle() {
+            if (!projectConfig) {
+                return;
+            }
+            // 确保输出目录存在
+            await fs.mkdir(options.outputDir, { recursive: true });
+            // 生成 config.json
+            const config = generateConfig(projectConfig);
+            // 为脚本资产补齐 __game-scripts.js 信息
+            await patchScriptAssets(config, options.outputDir);
+            await fs.writeFile(path.join(options.outputDir, 'config.json'), JSON.stringify(config, null, 2), 'utf-8');
+            console.log('[SourceBuilder] 生成 config.json');
+            // 生成 __settings__.js
+            const settings = generateSettings(projectConfig);
+            await fs.writeFile(path.join(options.outputDir, '__settings__.js'), settings, 'utf-8');
+            console.log('[SourceBuilder] 生成 __settings__.js');
+            // 复制模板文件
+            await copyTemplates(options.outputDir);
+            console.log('[SourceBuilder] 复制模板文件');
+            // 复制资源文件
+            await copyAssets(projectConfig, options.projectDir, options.outputDir, config.assets);
+            console.log('[SourceBuilder] 复制资源文件');
+            // 生成场景文件
+            await generateSceneFiles(projectConfig, options.projectDir, options.outputDir);
+            console.log('[SourceBuilder] 生成场景文件');
+        },
+    };
+}
+/**
+ * 检测项目格式
+ */
+async function detectFormat(projectDir) {
+    // 检查 manifest.json（PlayCraft）
+    const manifestPath = path.join(projectDir, 'manifest.json');
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(content);
+        if (manifest.format === 'playcraft' || Array.isArray(manifest.assets)) {
+            return 'playcraft';
+        }
+    }
+    catch (error) {
+        // manifest.json 不存在或格式不对
+    }
+    // 默认为 PlayCanvas
+    return 'playcanvas';
+}
+/**
+ * 收集用户脚本
+ */
+async function collectUserScripts(projectConfig, projectDir) {
+    const scripts = [];
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        const scriptIds = pcProject.project.settings?.scripts || [];
+        // 从 assets.json 读取脚本资产
+        for (const scriptId of scriptIds) {
+            const asset = pcProject.assets[String(scriptId)];
+            if (asset && asset.type === 'script') {
+                const assetData = asset;
+                if (assetData.file?.url && !assetData.file.url.startsWith('data:')) {
+                    const scriptPath = path.join(projectDir, assetData.file.url);
+                    try {
+                        const code = await fs.readFile(scriptPath, 'utf-8');
+                        scripts.push({
+                            id: String(scriptId),
+                            path: assetData.file.url,
+                            code,
+                            name: assetData.name || `script_${scriptId}`,
+                        });
+                    }
+                    catch (error) {
+                        console.warn(`警告: 无法读取脚本文件: ${scriptPath}`);
+                    }
+                }
+            }
+        }
+    }
+    else {
+        // PlayCraft 格式
+        const pcProject = projectConfig;
+        const scriptIds = pcProject.manifest.settings?.scripts || [];
+        for (const scriptId of scriptIds) {
+            const asset = pcProject.assets[String(scriptId)];
+            if (asset && asset.type === 'script') {
+                const assetData = asset;
+                if (assetData.file?.url && !assetData.file.url.startsWith('data:')) {
+                    const scriptPath = path.join(projectDir, assetData.file.url);
+                    try {
+                        const code = await fs.readFile(scriptPath, 'utf-8');
+                        scripts.push({
+                            id: String(scriptId),
+                            path: assetData.file.url,
+                            code,
+                            name: assetData.name || `script_${scriptId}`,
+                        });
+                    }
+                    catch (error) {
+                        console.warn(`警告: 无法读取脚本文件: ${scriptPath}`);
+                    }
+                }
+            }
+        }
+    }
+    return scripts;
+}
+/**
+ * 包装 PlayCanvas 脚本
+ */
+function wrapPlayCanvasScript(code, scriptName, script) {
+    // 清理脚本名称（移除特殊字符）
+    const cleanName = scriptName.replace(/[^a-zA-Z0-9_]/g, '_');
+    return `
+var ${cleanName} = pc.createScript('${cleanName}');
+${code}
+  `.trim();
+}
+/**
+ * 复制模板文件
+ */
+async function copyTemplates(outputDir) {
+    const templatesDir = path.resolve(__dirname, '../../templates');
+    const templateFiles = [
+        '__start__.js',
+        '__modules__.js',
+        '__loading__.js',
+        'playcanvas-stable.min.js',
+        'styles.css',
+        'logo.png',
+        'manifest.json',
+    ];
+    for (const file of templateFiles) {
+        const sourcePath = path.join(templatesDir, file);
+        const targetPath = path.join(outputDir, file);
+        try {
+            await fs.copyFile(sourcePath, targetPath);
+        }
+        catch (error) {
+            console.warn(`警告: 无法复制模板文件 ${file}:`, error);
+        }
+    }
+    // 生成 index.html
+    const projectName = 'PlayCanvas Project';
+    const htmlTemplate = await fs.readFile(path.join(templatesDir, 'index.html'), 'utf-8');
+    const htmlContent = htmlTemplate.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+    await fs.writeFile(path.join(outputDir, 'index.html'), htmlContent, 'utf-8');
+}
+/**
+ * 复制资源文件
+ */
+async function copyAssets(projectConfig, projectDir, outputDir, assetsOverride) {
+    const assetsOutputDir = path.join(outputDir, 'files');
+    await fs.mkdir(assetsOutputDir, { recursive: true });
+    const assets = assetsOverride || (projectConfig.format === 'playcanvas'
+        ? projectConfig.assets
+        : projectConfig.assets);
+    // 遍历 assets
+    for (const [assetId, asset] of Object.entries(assets)) {
+        const assetData = asset;
+        if (!assetData.file?.url || assetData.file.url.startsWith('data:')) {
+            continue;
+        }
+        const sourcePath = path.join(projectDir, assetData.file.url);
+        const targetPath = path.join(outputDir, assetData.file.url);
+        try {
+            // 检查源文件是否存在
+            await fs.access(sourcePath);
+            // 创建目标目录
+            const targetDir = path.dirname(targetPath);
+            await fs.mkdir(targetDir, { recursive: true });
+            // 复制文件
+            await fs.copyFile(sourcePath, targetPath);
+        }
+        catch (error) {
+            // 资源文件可能不存在（可能是内联的）
+            // console.warn(`警告: 无法复制资源文件 ${assetData.file.url}:`, error);
+        }
+    }
+}
+/**
+ * 生成场景文件
+ */
+async function generateSceneFiles(projectConfig, projectDir, outputDir) {
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        // PlayCanvas 格式：scenes.json 中已包含场景数据
+        if (pcProject.scenes) {
+            const scenes = Array.isArray(pcProject.scenes)
+                ? pcProject.scenes
+                : Object.entries(pcProject.scenes).map(([id, scene]) => ({ id, ...scene }));
+            for (const scene of scenes) {
+                const sceneData = scene;
+                const sceneId = sceneData.id || sceneData.name || 'scene';
+                const scenePath = path.join(outputDir, `${sceneId}.json`);
+                // 写入场景 JSON
+                await fs.writeFile(scenePath, JSON.stringify(sceneData, null, 2), 'utf-8');
+            }
+        }
+    }
+    else {
+        // PlayCraft 格式：从 scenes/ 目录读取
+        const pcProject = projectConfig;
+        for (const scene of pcProject.scenes) {
+            const sceneData = scene;
+            const sceneId = sceneData.id || sceneData.name || 'scene';
+            const scenePath = path.join(outputDir, `${sceneId}.json`);
+            // 写入场景 JSON
+            await fs.writeFile(scenePath, JSON.stringify(sceneData, null, 2), 'utf-8');
+        }
+    }
+}
+/**
+ * 规范化资源 URL（补齐 file.url）
+ */
+async function normalizeAssetUrls(projectConfig, projectDir) {
+    const assets = projectConfig.format === 'playcanvas'
+        ? projectConfig.assets
+        : projectConfig.assets;
+    for (const [assetId, asset] of Object.entries(assets)) {
+        const assetData = asset;
+        if (!assetData.file || assetData.file.url) {
+            continue;
+        }
+        const filename = assetData.file.filename;
+        if (!filename) {
+            continue;
+        }
+        const revision = assetData.revision ?? assetData.file.revision ?? 1;
+        const candidates = [
+            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),
+        ];
+        for (const rel of candidates) {
+            const abs = path.join(projectDir, rel);
+            try {
+                await fs.access(abs);
+                assetData.file.url = rel;
+                break;
+            }
+            catch (error) {
+                // 继续尝试下一个
+            }
+        }
+    }
+}
+/**
+ * 为脚本资产补齐 __game-scripts.js 信息
+ */
+async function patchScriptAssets(config, outputDir) {
+    if (!config?.assets) {
+        return;
+    }
+    const scriptIds = Array.isArray(config?.application_properties?.scripts)
+        ? config.application_properties.scripts.map((id) => String(id))
+        : [];
+    if (scriptIds.length === 0) {
+        return;
+    }
+    const gameScriptsPath = path.join(outputDir, '__game-scripts.js');
+    let stat = null;
+    let hash = null;
+    try {
+        const buffer = await fs.readFile(gameScriptsPath);
+        stat = { size: buffer.byteLength };
+        hash = crypto.createHash('md5').update(buffer).digest('hex');
+    }
+    catch (error) {
+        // __game-scripts.js 可能不存在
+    }
+    for (const [assetId, asset] of Object.entries(config.assets)) {
+        const assetData = asset;
+        if (!scriptIds.includes(String(assetId))) {
+            continue;
+        }
+        if (assetData.type !== 'script' || !assetData.file) {
+            continue;
+        }
+        assetData.file.url = '__game-scripts.js';
+        assetData.file.filename = '__game-scripts.js';
+        if (stat && hash) {
+            assetData.file.size = stat.size;
+            assetData.file.hash = hash;
+        }
+    }
+}

package/dist/vite-builder.d.ts

@@ -0,0 +1,51 @@
+import type { BuildOptions, SizeReport } from './types.js';
+export interface ViteBuildOutput {
+    outputPath: string;
+    size: number;
+    sizeLimit: number;
+    valid: boolean;
+}
+/**
+ * Vite 构建器 - 使用 Vite 构建 Playable Ads
+ *
+ * 职责：
+ * 1. 验证输入是有效的基础构建
+ * 2. 创建 Vite 配置
+ * 3. 执行 Vite 构建
+ * 4. 验证输出大小
+ * 5. 生成报告
+ */
+export declare class ViteBuilder {
+    private baseBuildDir;
+    private options;
+    private sizeReport;
+    constructor(baseBuildDir: string, options: BuildOptions);
+    /**
+     * 执行构建
+     */
+    build(): Promise<string>;
+    /**
+     * 验证基础构建
+     */
+    private validateBaseBuild;
+    /**
+     * 获取输出路径
+     */
+    private getOutputPath;
+    /**
+     * 验证输出大小
+     */
+    private validateSize;
+    /**
+     * 生成报告
+     */
+    private generateReport;
+    /**
+     * 获取大小报告
+     */
+    getSizeReport(): SizeReport;
+    /**
+     * 格式化字节数
+     */
+    private formatBytes;
+}

package/dist/vite-builder.js

@@ -0,0 +1,122 @@
+import { build as viteBuild } from 'vite';
+import fs from 'fs/promises';
+import path from 'path';
+import { ViteConfigBuilder } from './vite/config-builder.js';
+import { PLATFORM_CONFIGS } from './vite/platform-configs.js';
+/**
+ * Vite 构建器 - 使用 Vite 构建 Playable Ads
+ *
+ * 职责：
+ * 1. 验证输入是有效的基础构建
+ * 2. 创建 Vite 配置
+ * 3. 执行 Vite 构建
+ * 4. 验证输出大小
+ * 5. 生成报告
+ */
+export class ViteBuilder {
+    constructor(baseBuildDir, options) {
+        this.baseBuildDir = baseBuildDir;
+        this.options = options;
+        const platformConfig = PLATFORM_CONFIGS[options.platform];
+        this.sizeReport = {
+            engine: 0,
+            assets: {},
+            total: 0,
+            limit: platformConfig.sizeLimit,
+        };
+    }
+    /**
+     * 执行构建
+     */
+    async build() {
+        // 1. 验证输入
+        await this.validateBaseBuild();
+        // 2. 创建 Vite 配置
+        const configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        const viteConfig = configBuilder.create();
+        // 3. 执行 Vite 构建
+        await viteBuild(viteConfig);
+        // 4. 验证输出大小
+        const outputPath = this.getOutputPath();
+        await this.validateSize(outputPath);
+        // 5. 生成报告
+        this.generateReport(outputPath);
+        return outputPath;
+    }
+    /**
+     * 验证基础构建
+     */
+    async validateBaseBuild() {
+        const requiredFiles = [
+            '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) {
+            throw new Error(`基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
+                `请确保输入目录包含完整的多文件构建产物。`);
+        }
+    }
+    /**
+     * 获取输出路径
+     */
+    getOutputPath() {
+        const platformConfig = PLATFORM_CONFIGS[this.options.platform];
+        const outputDir = this.options.outputDir || './dist';
+        if (platformConfig.outputFormat === 'zip') {
+            return path.join(outputDir, 'playable.zip');
+        }
+        return path.join(outputDir, platformConfig.outputFileName);
+    }
+    /**
+     * 验证输出大小
+     */
+    async validateSize(outputPath) {
+        try {
+            const stats = await fs.stat(outputPath);
+            this.sizeReport.total = stats.size;
+            this.sizeReport.assets[path.basename(outputPath)] = stats.size;
+            if (stats.size > this.sizeReport.limit) {
+                const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+                const limitMB = (this.sizeReport.limit / 1024 / 1024).toFixed(2);
+                console.warn(`⚠️  警告: 文件大小 ${sizeMB} MB 超过限制 ${limitMB} MB`);
+            }
+        }
+        catch (error) {
+            console.warn(`警告: 无法读取输出文件: ${outputPath}`);
+        }
+    }
+    /**
+     * 生成报告
+     */
+    generateReport(outputPath) {
+        // 报告已在 validateSize 中生成
+        // 这里可以添加额外的报告逻辑
+    }
+    /**
+     * 获取大小报告
+     */
+    getSizeReport() {
+        return this.sizeReport;
+    }
+    /**
+     * 格式化字节数
+     */
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round(bytes / Math.pow(k, i) * 100) / 100 + ' ' + sizes[i];
+    }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@playcraft/build",
+  "version": "0.0.2",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsc -w",
+    "build": "tsc",
+    "release": "node scripts/release.js"
+  },
+  "dependencies": {
+    "@gltf-transform/core": "^4.0.0",
+    "@gltf-transform/extensions": "^4.0.0",
+    "@gltf-transform/functions": "^4.0.0",
+    "@vheemstra/vite-plugin-imagemin": "^2.0.0",
+    "archiver": "^7.0.1",
+    "draco3dgltf": "^1.5.7",
+    "imagemin-mozjpeg": "^10.0.0",
+    "imagemin-pngquant": "^10.0.0",
+    "imagemin-webp": "^8.0.0",
+    "lightningcss": "^1.27.0",
+    "mime-types": "^2.1.35",
+    "rollup-plugin-visualizer": "^6.0.5",
+    "terser": "^5.30.0",
+    "vite": "^6.0.0",
+    "vite-plugin-singlefile": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.4",
+    "@types/mime-types": "^2.1.4",
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.2"
+  }
+}

package/templates/__loading__.js

@@ -0,0 +1,100 @@
+pc.script.createLoadingScreen((app) => {
+    const createCss = () => {
+        const css = `
+            body {
+                background-color: #283538;
+            }
+
+            #application-splash-wrapper {
+                position: absolute;
+                top: 0;
+                left: 0;
+                height: 100%;
+                width: 100%;
+                background-color: #283538;
+            }
+
+            #application-splash {
+                position: absolute;
+                top: calc(50% - 28px);
+                width: 264px;
+                left: calc(50% - 132px);
+            }
+
+            #application-splash img {
+                width: 100%;
+            }
+
+            #progress-bar-container {
+                margin: 20px auto 0 auto;
+                height: 2px;
+                width: 100%;
+                background-color: #1d292c;
+            }
+
+            #progress-bar {
+                width: 0%;
+                height: 100%;
+                background-color: #f60;
+            }
+
+            @media (max-width: 480px) {
+                #application-splash {
+                    width: 170px;
+                    left: calc(50% - 85px);
+                }
+            }
+        `;
+
+        const style = document.createElement('style');
+        style.textContent = css;
+        document.head.appendChild(style);
+    };
+
+    const showSplash = () => {
+        const wrapper = document.createElement('div');
+        wrapper.id = 'application-splash-wrapper';
+        document.body.appendChild(wrapper);
+
+        const splash = document.createElement('div');
+        splash.id = 'application-splash';
+        wrapper.appendChild(splash);
+        splash.style.display = 'none';
+
+        const logo = document.createElement('img');
+        logo.src = `${ASSET_PREFIX}logo.png`;
+        splash.appendChild(logo);
+        logo.onload = () => {
+            splash.style.display = 'block';
+        };
+
+        const container = document.createElement('div');
+        container.id = 'progress-bar-container';
+        splash.appendChild(container);
+
+        const bar = document.createElement('div');
+        bar.id = 'progress-bar';
+        container.appendChild(bar);
+    };
+
+    const setProgress = (value) => {
+        const bar = document.getElementById('progress-bar');
+        if (bar) {
+            value = Math.min(1, Math.max(0, value));
+            bar.style.width = `${value * 100}%`;
+        }
+    };
+
+    const hideSplash = () => {
+        document.getElementById('application-splash-wrapper').remove();
+    };
+
+    createCss();
+    showSplash();
+
+    app.on('preload:end', () => {
+        app.off('preload:progress');
+    });
+    app.on('preload:progress', setProgress);
+    app.on('start', hideSplash);
+});