@playcraft/build 0.0.13 → 0.0.15

package/dist/playable-builder.d.ts

@@ -71,6 +71,7 @@ export declare class PlayableBuilder {
     private extractPreloadModules;
     private stripAmmoAssets;
     private injectPhysicsLibrary;
+    private injectScenePhysicsPatch;
     private isAmmoModule;
     private readPatchFile;
     /**

package/dist/playable-builder.js

@@ -2,6 +2,7 @@ import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { createPlatformAdapter } from './platforms/index.js';
+import { minifyPatchCode } from './utils/minify.js';
 /**
  * Playable Ads 打包器 - 将多文件版本转换为单HTML
  *
@@ -31,8 +32,8 @@ export class PlayableBuilder {
         await this.validateBaseBuild();
         // 2. 转换为单HTML
         const html = await this.convertToSingleHTML();
-        // 3. 应用渠道配置
-        const finalHtml = this.platformAdapter.modifyHTML(html, []);
+        // 3. 应用渠道配置（现在是异步的）
+        const finalHtml = await this.platformAdapter.modifyHTML(html, []);
         // 4. 验证大小限制
         const htmlSize = Buffer.from(finalHtml, 'utf-8').length;
         this.sizeReport.total = htmlSize;
@@ -87,6 +88,8 @@ export class PlayableBuilder {
         if (this.options.ammoReplacement) {
             html = await this.injectPhysicsLibrary(html);
         }
+        // 4.2 注入 Scene applySettings 补丁，避免 settings.physics 缺失导致 gravity 报错
+        html = await this.injectScenePhysicsPatch(html);
         // 5. 内联 __settings__.js，并转换资源URL为data URLs
         html = await this.inlineSettings(html);
         // 6. 内联 __modules__.js
@@ -478,6 +481,17 @@ window.PRELOAD_MODULES = ${JSON.stringify(preloadModules)};
         }
         return `${tag}\n${html}`;
     }
+    async injectScenePhysicsPatch(html) {
+        const patchCode = await this.readPatchFile('scene-physics-defaults.js');
+        if (!patchCode)
+            return html;
+        const minified = await minifyPatchCode(patchCode, 'scene-physics-defaults.js');
+        const tag = `<script>${minified}</script>`;
+        if (html.includes('</head>')) {
+            return html.replace('</head>', `${tag}\n</head>`);
+        }
+        return `${tag}\n${html}`;
+    }
     isAmmoModule(module) {
         const moduleName = module.moduleName?.toLowerCase() ?? '';
         const glueUrl = module.glueUrl?.toLowerCase() ?? '';

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 {
@@ -8,6 +15,7 @@ export interface BuildOptions {
     outputDir?: string;
     compressEngine?: boolean;
     compressConfigJson?: boolean;
+    compressJS?: boolean;
     analyze?: boolean;
     analyzeReportPath?: string;
     patchXhrOut?: boolean;
@@ -39,6 +47,7 @@ export interface BuildOptions {
     esmMode?: ESMMode;
     preserveESM?: boolean;
     forceIIFE?: boolean;
+    storeUrls?: StoreUrls;
 }
 export interface BaseBuildMetadata {
     mode: BuildMode;
@@ -103,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/utils/obfuscate.d.ts

@@ -0,0 +1,42 @@
+export type ObfuscateLevel = 'light' | 'medium' | 'heavy';
+export declare function getFflateInflateRuntime(): string;
+/**
+ * 对 JS 代码进行混淆 + fflate 压缩，生成自解压 bootstrap
+ */
+export declare function obfuscateAndCompress(jsCode: string, level?: ObfuscateLevel): Promise<{
+    /** fflate inflate 运行时脚本（<script>标签） */
+    runtime: string;
+    /** 自解压 bootstrap 脚本（<script>标签） */
+    bootstrap: string;
+    /** 原始代码大小 */
+    originalSize: number;
+    /** 混淆后大小 */
+    obfuscatedSize: number;
+    /** 压缩后大小（binary） */
+    compressedSize: number;
+    /** 最终大小（base64 + bootstrap） */
+    finalSize: number;
+}>;
+/**
+ * 使用 fflate 压缩引擎代码（替换 LZ4）
+ * 不做混淆，只做压缩
+ */
+export declare function compressWithFflate(code: string): {
+    runtime: string;
+    compressed: string;
+    originalSize: number;
+    compressedSize: number;
+};
+/**
+ * 使用 fflate 压缩 config.json（替换 LZ4）
+ */
+export declare function compressConfigJsonWithFflate(jsonString: string): {
+    dataUrl: string;
+    originalSize: number;
+    compressedSize: number;
+};
+/**
+ * 构建 config.json 解压 patch（fflate 版本）
+ * 拦截 pc.Http.prototype.get，检测 fflate 压缩的 JSON 并解压
+ */
+export declare function buildFflateConfigDecompressPatch(): string;