@playcraft/build 0.0.11 → 0.0.14

package/dist/templates/styles.css

@@ -0,0 +1,43 @@
+html {
+    height: 100%;
+    width: 100%;
+    background-color: #1d292c;
+}
+body {
+    margin: 0;
+    max-height: 100%;
+    height: 100%;
+    overflow: hidden;
+    background-color: #1d292c;
+    font-family: Helvetica, arial, sans-serif;
+    position: relative;
+    width: 100%;
+
+    -webkit-tap-highlight-color: transparent;
+}
+
+#application-canvas {
+    display: block;
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+}
+#application-canvas.fill-mode-NONE {
+    margin: auto;
+}
+#application-canvas.fill-mode-KEEP_ASPECT {
+    width: 100%;
+    height: auto;
+    margin: 0;
+}
+#application-canvas.fill-mode-FILL_WINDOW {
+    width: 100%;
+    height: 100%;
+    margin: 0;
+}
+
+canvas:focus {
+    outline: none;
+}

package/dist/types.d.ts

@@ -1,5 +1,12 @@
-export type Platform = 'playcraft' | 'facebook' | 'snapchat' | 'ironsource' | 'applovin' | 'google' | 'tiktok' | 'unity' | 'liftoff' | 'moloco' | 'bigo' | 'inmobi' | 'adikteev' | 'remerge';
+export type Platform = 'playcraft' | 'facebook' | 'snapchat' | 'ironsource' | 'applovin' | 'google' | 'tiktok' | 'unity' | 'liftoff' | 'moloco' | 'bigo' | 'inmobi' | 'adikteev' | 'remerge' | 'mintegral';
 export type OutputFormat = 'html' | 'zip';
+/**
+ * 商店跳转地址（CTA 按钮目标）
+ */
+export interface StoreUrls {
+    ios?: string;
+    android?: string;
+}
 export type BuildMode = 'classic' | 'esm';
 export type ESMMode = 'auto' | 'enabled' | 'disabled';
 export interface BuildOptions {
@@ -7,6 +14,8 @@ export interface BuildOptions {
     format?: OutputFormat;
     outputDir?: string;
     compressEngine?: boolean;
+    compressConfigJson?: boolean;
+    compressJS?: boolean;
     analyze?: boolean;
     analyzeReportPath?: string;
     patchXhrOut?: boolean;
@@ -38,6 +47,7 @@ export interface BuildOptions {
     esmMode?: ESMMode;
     preserveESM?: boolean;
     forceIIFE?: boolean;
+    storeUrls?: StoreUrls;
 }
 export interface BaseBuildMetadata {
     mode: BuildMode;
@@ -102,3 +112,106 @@ export interface SizeReport {
     total: number;
     limit: number;
 }
+/**
+ * 支持的引擎类型
+ */
+export type EngineType = 'playcanvas' | 'phaser' | 'pixijs' | 'threejs' | 'cocos' | 'babylonjs' | 'layaair' | 'egret' | 'generic';
+/**
+ * 引擎能力集，驱动前端 UI 和 CLI 的条件逻辑
+ */
+export interface EngineCapabilities {
+    supportsSceneSelection: boolean;
+    supportsESMMode: boolean;
+    supportsEngineCompression: boolean;
+    supportsAmmoReplacement: boolean;
+    supportsModelCompression: boolean;
+    requiresNpmBuild: boolean;
+}
+/**
+ * 各引擎的能力定义
+ */
+export declare const ENGINE_CAPABILITIES: Record<EngineType, EngineCapabilities>;
+/**
+ * 基础构建选项
+ */
+export interface BaseBuildOptions {
+    outputDir: string;
+    selectedScenes?: string[];
+    analyze?: boolean;
+    analyzeReportPath?: string;
+    clean?: boolean;
+    engine?: EngineType;
+}
+/**
+ * 基础构建输出
+ */
+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[];
+    };
+}
+/**
+ * 扩展 BaseBuildMetadata，增加引擎类型
+ */
+export interface BaseBuildMetadata {
+    mode: BuildMode;
+    engine: EngineType;
+    importMap?: {
+        id: string;
+        imports: Record<string, string>;
+    };
+    entryPoint?: string;
+    buildOutputDir?: string;
+}
+/**
+ * 扩展 BuildOptions，增加引擎类型
+ */
+export interface BuildOptions {
+    platform: Platform;
+    format?: OutputFormat;
+    outputDir?: string;
+    compressEngine?: boolean;
+    compressConfigJson?: boolean;
+    analyze?: boolean;
+    analyzeReportPath?: string;
+    patchXhrOut?: boolean;
+    inlineGameScripts?: boolean;
+    externFiles?: boolean | ExternFilesConfig;
+    mraidSupport?: boolean;
+    snapchatCta?: boolean;
+    ammoReplacement?: 'p2' | 'cannon';
+    snapchat?: {
+        folderName?: string;
+        externalUrlPrefix?: string;
+    };
+    engineVersion?: string;
+    engineUrl?: string;
+    enginePath?: string;
+    useGitHubEngine?: boolean;
+    autoBuild?: boolean;
+    skipBuild?: boolean;
+    buildOptions?: LocalBuildOptions;
+    useVite?: boolean;
+    selectedScenes?: string[];
+    cssMinify?: boolean;
+    jsMinify?: boolean;
+    compressImages?: boolean;
+    imageQuality?: number;
+    convertToWebP?: boolean;
+    compressModels?: boolean;
+    modelCompression?: 'draco' | 'meshopt';
+    esmMode?: ESMMode;
+    preserveESM?: boolean;
+    forceIIFE?: boolean;
+    engine?: EngineType;
+    storeUrls?: StoreUrls;
+}

package/dist/types.js

@@ -1 +1,77 @@
-export {};
+/**
+ * 各引擎的能力定义
+ */
+export const ENGINE_CAPABILITIES = {
+    playcanvas: {
+        supportsSceneSelection: true,
+        supportsESMMode: true,
+        supportsEngineCompression: true,
+        supportsAmmoReplacement: true,
+        supportsModelCompression: true,
+        requiresNpmBuild: false,
+    },
+    phaser: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+    pixijs: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+    threejs: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: true, // Three.js 支持 3D 模型
+        requiresNpmBuild: true,
+    },
+    cocos: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+    babylonjs: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: true, // Babylon.js 支持 3D 模型
+        requiresNpmBuild: true,
+    },
+    layaair: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+    egret: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+    generic: {
+        supportsSceneSelection: false,
+        supportsESMMode: false,
+        supportsEngineCompression: false,
+        supportsAmmoReplacement: false,
+        supportsModelCompression: false,
+        requiresNpmBuild: true,
+    },
+};

package/dist/utils/ammo-detector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检测 Base Build 是否使用 Ammo.js 及建议的替换引擎
+ * 与 CLI 的 detectAmmoUsage 逻辑一致
+ */
+export declare function detectAmmoUsage(baseBuildDir: string): Promise<{
+    hasAmmo: boolean;
+    suggestedEngine: 'p2' | 'cannon';
+    use3dPhysics: boolean;
+}>;

package/dist/utils/ammo-detector.js

@@ -0,0 +1,76 @@
+import fs from 'fs/promises';
+import path from 'path';
+function resolveSuggestedPhysicsEngine(use3dPhysics) {
+    return use3dPhysics ? 'cannon' : 'p2';
+}
+/**
+ * 检测 Base Build 是否使用 Ammo.js 及建议的替换引擎
+ * 与 CLI 的 detectAmmoUsage 逻辑一致
+ */
+export async function detectAmmoUsage(baseBuildDir) {
+    const configPath = path.join(baseBuildDir, 'config.json');
+    let hasAmmo = false;
+    let use3dPhysics = false;
+    try {
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const configJson = JSON.parse(configContent);
+        // 检查 application_properties.use3dPhysics
+        use3dPhysics = Boolean(configJson.application_properties?.use3dPhysics);
+        // 如果 use3dPhysics 未设置，通过检查场景内容来推断
+        if (!use3dPhysics) {
+            try {
+                const files = await fs.readdir(baseBuildDir);
+                for (const file of files) {
+                    if (file.endsWith('.json') && !['config.json', 'manifest.json'].includes(file)) {
+                        try {
+                            const sceneContent = await fs.readFile(path.join(baseBuildDir, file), 'utf-8');
+                            if (sceneContent.includes('"rigidbody"') ||
+                                sceneContent.includes('"collision"') ||
+                                sceneContent.includes('"joint"')) {
+                                use3dPhysics = true;
+                                break;
+                            }
+                        }
+                        catch {
+                            /* 忽略 */
+                        }
+                    }
+                }
+            }
+            catch {
+                /* 忽略 */
+            }
+        }
+        if (configJson.assets) {
+            for (const asset of Object.values(configJson.assets)) {
+                const assetData = asset;
+                const moduleName = String(assetData?.data?.moduleName ?? '').toLowerCase();
+                const fileUrl = String(assetData?.file?.url ?? '').toLowerCase();
+                if (moduleName.includes('ammo') || fileUrl.includes('ammo')) {
+                    hasAmmo = true;
+                    break;
+                }
+            }
+        }
+    }
+    catch {
+        /* 忽略解析失败 */
+    }
+    if (!hasAmmo) {
+        try {
+            const settingsPath = path.join(baseBuildDir, '__settings__.js');
+            const settingsContent = await fs.readFile(settingsPath, 'utf-8');
+            if (settingsContent.toLowerCase().includes('ammo')) {
+                hasAmmo = true;
+            }
+        }
+        catch {
+            /* 忽略读取失败 */
+        }
+    }
+    return {
+        hasAmmo,
+        suggestedEngine: resolveSuggestedPhysicsEngine(use3dPhysics),
+        use3dPhysics,
+    };
+}

package/dist/utils/build-mode-detector.js

@@ -15,6 +15,7 @@ export async function detectBuildMode(baseBuildDir) {
         const importMapContent = importMapMatch ? JSON.parse(importMapMatch[1]) : { imports: {} };
         return {
             mode: 'esm',
+            engine: 'playcanvas', // 默认 PlayCanvas，从元数据文件读取时会覆盖
             importMap: {
                 id: 'detected',
                 imports: importMapContent.imports || {},
@@ -25,6 +26,7 @@ export async function detectBuildMode(baseBuildDir) {
     // Classic 模式
     return {
         mode: 'classic',
+        engine: 'playcanvas', // 默认 PlayCanvas，从元数据文件读取时会覆盖
     };
 }
 /**

package/dist/utils/minify.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 压缩 JavaScript 代码
+ * @param code - 原始 JavaScript 代码
+ * @param options - 压缩选项
+ * @returns 压缩后的代码
+ */
+export declare function minifyJS(code: string, options?: {
+    /** 是否移除注释，默认 true */
+    removeComments?: boolean;
+    /** 是否混淆变量名，默认 true */
+    mangle?: boolean;
+    /** 是否进行代码压缩优化，默认 true */
+    compress?: boolean;
+    /** 是否为 ESM 模块（含 import/export），默认 false */
+    module?: boolean;
+}): Promise<string>;
+/**
+ * 同步版本的压缩（使用预压缩的代码）
+ * 注意：这个函数用于需要同步返回的场景，实际压缩应在构建时完成
+ */
+export declare function minifyJSSync(code: string): string;
+/**
+ * 读取并压缩 patch 文件（带缓存）
+ * @param patchCode - patch 文件内容
+ * @param cacheKey - 缓存键（通常是文件名）
+ * @returns 压缩后的代码
+ */
+export declare function minifyPatchCode(patchCode: string, cacheKey?: string): Promise<string>;
+/**
+ * 清除压缩缓存
+ */
+export declare function clearMinifyCache(): void;

package/dist/utils/minify.js

@@ -0,0 +1,82 @@
+/**
+ * JavaScript 代码压缩工具
+ * 用于压缩 patch 脚本和内联代码
+ */
+import { minify as terserMinify } from 'terser';
+/**
+ * 压缩 JavaScript 代码
+ * @param code - 原始 JavaScript 代码
+ * @param options - 压缩选项
+ * @returns 压缩后的代码
+ */
+export async function minifyJS(code, options) {
+    const { removeComments = true, mangle = true, compress = true, module: isModule = false, } = options || {};
+    try {
+        const result = await terserMinify(code, {
+            module: isModule,
+            compress: compress ? {
+                dead_code: true,
+                drop_console: false,
+                drop_debugger: true,
+                passes: 3,
+            } : false,
+            mangle: mangle ? {
+                toplevel: true,
+            } : false,
+            format: {
+                comments: removeComments ? false : 'some',
+            },
+        });
+        return result.code || code;
+    }
+    catch (error) {
+        console.warn('[minifyJS] 压缩失败，返回原始代码:', error);
+        return code;
+    }
+}
+/**
+ * 同步版本的压缩（使用预压缩的代码）
+ * 注意：这个函数用于需要同步返回的场景，实际压缩应在构建时完成
+ */
+export function minifyJSSync(code) {
+    // 简单的压缩：移除多余空白和注释
+    return code
+        // 移除单行注释（但保留 URL 中的 //）
+        .replace(/(?<!:)\/\/.*$/gm, '')
+        // 移除多行注释
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        // 压缩空白
+        .replace(/\s+/g, ' ')
+        // 移除语句间多余空格
+        .replace(/\s*([{};,:])\s*/g, '$1')
+        // 移除括号周围空格
+        .replace(/\s*([()])\s*/g, '$1')
+        // 修复一些被过度压缩的地方
+        .replace(/}([a-zA-Z])/g, '} $1')
+        .replace(/;([a-zA-Z])/g, ';$1')
+        .trim();
+}
+// 缓存已压缩的 patch 文件
+const minifiedCache = new Map();
+/**
+ * 读取并压缩 patch 文件（带缓存）
+ * @param patchCode - patch 文件内容
+ * @param cacheKey - 缓存键（通常是文件名）
+ * @returns 压缩后的代码
+ */
+export async function minifyPatchCode(patchCode, cacheKey) {
+    if (cacheKey && minifiedCache.has(cacheKey)) {
+        return minifiedCache.get(cacheKey);
+    }
+    const minified = await minifyJS(patchCode);
+    if (cacheKey) {
+        minifiedCache.set(cacheKey, minified);
+    }
+    return minified;
+}
+/**
+ * 清除压缩缓存
+ */
+export function clearMinifyCache() {
+    minifiedCache.clear();
+}

package/dist/vite/config-builder-generic.d.ts

@@ -0,0 +1,70 @@
+import { type UserConfig } from 'vite';
+import type { Platform, BuildOptions, BaseBuildMetadata } from '../types.js';
+/**
+ * 通用 Vite 配置构建器（外部引擎专用）
+ *
+ * 与 PlayCanvas 专用配置构建器不同，通用版本：
+ * - 不使用 vitePlayCanvasPlugin（不需要处理 config.json 等专有格式）
+ * - 不使用 viteESMBundlePlugin 和 viteModelCompressionPlugin（Draco/Meshopt 是 PlayCanvas 特有的）
+ * - 仅使用通用的插件：
+ *   - viteSingleFile：HTML 内联
+ *   - vitePlatformPlugin：平台 SDK 注入
+ *   - viteImagemin：图片压缩
+ */
+export declare class GenericViteConfigBuilder {
+    private baseBuildDir;
+    private platform;
+    private options;
+    private baseBuildMetadata;
+    private finalOutputDir;
+    private viteOutputDir;
+    constructor(baseBuildDir: string, platform: Platform, options: BuildOptions, baseBuildMetadata: BaseBuildMetadata);
+    /**
+     * 创建 Vite 配置
+     */
+    create(): Promise<UserConfig>;
+    /**
+     * 获取 Vite 的临时输出目录
+     */
+    getViteOutputDir(): string;
+    /**
+     * 获取最终输出目录
+     */
+    getFinalOutputDir(): string;
+    /**
+     * 创建通用配置
+     */
+    private createConfig;
+    /**
+     * 创建插件列表
+     */
+    private createPlugins;
+    /**
+     * 获取平台配置
+     */
+    private getPlatformConfig;
+    /**
+     * 获取 Playable 选项
+     */
+    private getPlayableOptions;
+    /**
+     * 解析外部文件配置
+     */
+    private resolveExternFiles;
+    /**
+     * 是否应该压缩 CSS
+     */
+    private shouldMinifyCSS;
+    /**
+     * 是否应该压缩 JS
+     */
+    private shouldMinifyJS;
+    /**
+     * 创建自定义 Logger
+     */
+    private createLogger;
+    /**
+     * 创建 Rollup 警告处理器
+     */
+    private createRollupWarnHandler;
+}