@playcraft/build 0.0.11 → 0.0.14

package/dist/vite/config-builder-generic.js

@@ -0,0 +1,251 @@
+import { createLogger, defineConfig } from 'vite';
+import path from 'path';
+import fs from 'fs';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+import viteImagemin from '@vheemstra/vite-plugin-imagemin';
+import imageminMozjpeg from 'imagemin-mozjpeg';
+import imageminPngquant from 'imagemin-pngquant';
+import imageminWebp from 'imagemin-webp';
+import { PLATFORM_CONFIGS } from './platform-configs.js';
+import { vitePlatformPlugin } from './plugin-platform.js';
+import { createPlatformAdapter } from '../platforms/index.js';
+/**
+ * 通用 Vite 配置构建器（外部引擎专用）
+ *
+ * 与 PlayCanvas 专用配置构建器不同，通用版本：
+ * - 不使用 vitePlayCanvasPlugin（不需要处理 config.json 等专有格式）
+ * - 不使用 viteESMBundlePlugin 和 viteModelCompressionPlugin（Draco/Meshopt 是 PlayCanvas 特有的）
+ * - 仅使用通用的插件：
+ *   - viteSingleFile：HTML 内联
+ *   - vitePlatformPlugin：平台 SDK 注入
+ *   - viteImagemin：图片压缩
+ */
+export class GenericViteConfigBuilder {
+    constructor(baseBuildDir, platform, options, baseBuildMetadata) {
+        this.baseBuildDir = baseBuildDir;
+        this.platform = platform;
+        this.options = options;
+        this.baseBuildMetadata = baseBuildMetadata;
+        this.finalOutputDir = '';
+        this.viteOutputDir = '';
+        // 统一规范化 baseBuildDir（与 ViteConfigBuilder 一致）
+        // realpathSync.native 能在 Windows 上正确解析 8.3 短路径名（如 HOMKER~1 → homkerliu）
+        // macOS 上解析符号链接。Vite 内部也使用 native realpath，必须对齐。
+        this.baseBuildDir = fs.realpathSync.native(baseBuildDir).replace(/\\/g, '/');
+    }
+    /**
+     * 创建 Vite 配置
+     */
+    async create() {
+        console.log('[GenericViteConfigBuilder] 创建通用配置...');
+        console.log(`  - 引擎: ${this.baseBuildMetadata.engine}`);
+        const platformConfig = this.getPlatformConfig();
+        const outputDir = this.options.outputDir || './dist';
+        const playableOptions = this.getPlayableOptions(platformConfig);
+        const rootDir = this.baseBuildDir;
+        const viteOutputDir = '__dist__';
+        const viteOutputDirAbsolute = path.join(rootDir, viteOutputDir);
+        const finalOutputDir = path.isAbsolute(outputDir)
+            ? outputDir
+            : path.resolve(process.cwd(), outputDir);
+        this.finalOutputDir = finalOutputDir;
+        this.viteOutputDir = viteOutputDirAbsolute;
+        console.log(`[GenericViteConfigBuilder] 路径配置:`);
+        console.log(`  - root: ${rootDir}`);
+        console.log(`  - viteOutputDir: ${viteOutputDirAbsolute}`);
+        console.log(`  - finalOutputDir: ${finalOutputDir}`);
+        return this.createConfig(platformConfig, viteOutputDir, playableOptions, rootDir);
+    }
+    /**
+     * 获取 Vite 的临时输出目录
+     */
+    getViteOutputDir() {
+        return this.viteOutputDir || '';
+    }
+    /**
+     * 获取最终输出目录
+     */
+    getFinalOutputDir() {
+        return this.finalOutputDir || '';
+    }
+    /**
+     * 创建通用配置
+     */
+    createConfig(platformConfig, outputDir, playableOptions, rootDir) {
+        const logger = this.createLogger();
+        return defineConfig({
+            root: rootDir,
+            base: './',
+            customLogger: logger,
+            build: {
+                outDir: outputDir,
+                emptyOutDir: true,
+                cssMinify: this.shouldMinifyCSS(platformConfig) ? 'lightningcss' : false,
+                minify: this.shouldMinifyJS(platformConfig) ? 'terser' : false,
+                terserOptions: {
+                    compress: {
+                        drop_console: true,
+                        drop_debugger: true,
+                    },
+                },
+                // 所有资源内联（生成单文件 HTML）
+                assetsInlineLimit: Infinity,
+                sourcemap: platformConfig.includeSourcemap,
+                rollupOptions: {
+                    onwarn: this.createRollupWarnHandler(),
+                },
+            },
+            plugins: this.createPlugins(platformConfig, playableOptions),
+        });
+    }
+    /**
+     * 创建插件列表
+     */
+    createPlugins(platformConfig, playableOptions) {
+        const plugins = [];
+        // 1. 平台特定插件（注入平台 SDK：MRAID、CTA 等）
+        const platformAdapter = createPlatformAdapter(this.options);
+        const absoluteOutputDir = this.viteOutputDir || path.resolve(this.baseBuildDir, '__dist__');
+        plugins.push(vitePlatformPlugin({
+            platform: this.platform,
+            adapter: platformAdapter,
+            outputDir: absoluteOutputDir,
+            baseBuildDir: this.baseBuildDir,
+            outputFormat: platformConfig.outputFormat,
+            externFiles: playableOptions.externFiles,
+            mraidSupport: playableOptions.mraidSupport,
+        }));
+        // 2. 图片压缩插件
+        if (platformConfig.compressImages) {
+            const imageQuality = platformConfig.imageQuality || {
+                jpg: 75,
+                png: [0.7, 0.8],
+                webp: 75,
+            };
+            const jpegQuality = this.options.imageQuality ?? imageQuality.jpg ?? 75;
+            const pngQuality = Array.isArray(imageQuality.png) && imageQuality.png.length >= 2
+                ? [imageQuality.png[0], imageQuality.png[1]]
+                : [0.7, 0.8];
+            const webpQuality = imageQuality.webp ?? 75;
+            const imageminPlugin = viteImagemin({
+                plugins: {
+                    jpg: [imageminMozjpeg({ quality: jpegQuality })],
+                    jpeg: [imageminMozjpeg({ quality: jpegQuality })],
+                    png: [imageminPngquant({ quality: pngQuality })],
+                },
+                makeWebp: this.options.convertToWebP !== false
+                    ? {
+                        plugins: {
+                            jpg: [imageminWebp({ quality: webpQuality })],
+                            jpeg: [imageminWebp({ quality: webpQuality })],
+                            png: [imageminWebp({ quality: webpQuality })],
+                        },
+                    }
+                    : undefined,
+            });
+            if (imageminPlugin) {
+                plugins.push(imageminPlugin);
+            }
+        }
+        // 3. 单文件输出插件（仅 HTML 格式）
+        if (platformConfig.outputFormat === 'html') {
+            plugins.push(viteSingleFile({
+                removeViteModuleLoader: true,
+            }));
+        }
+        return plugins.filter(Boolean);
+    }
+    /**
+     * 获取平台配置
+     */
+    getPlatformConfig() {
+        const baseConfig = PLATFORM_CONFIGS[this.platform];
+        const resolvedOutputFormat = this.options.format ?? baseConfig.outputFormat;
+        return {
+            ...baseConfig,
+            outputFormat: resolvedOutputFormat,
+            minifyCSS: this.options.cssMinify ?? baseConfig.minifyCSS,
+            minifyJS: this.options.jsMinify ?? baseConfig.minifyJS,
+            compressImages: this.options.compressImages ?? baseConfig.compressImages,
+            // 外部引擎不支持模型压缩
+            compressModels: false,
+        };
+    }
+    /**
+     * 获取 Playable 选项
+     */
+    getPlayableOptions(config) {
+        const playable = config.playable ?? {};
+        const externFiles = this.resolveExternFiles(playable.externFiles);
+        return {
+            outputFormat: config.outputFormat,
+            patchXhrOut: this.options.patchXhrOut ?? playable.patchXhrOut ?? false,
+            inlineGameScripts: false, // 外部引擎不使用此选项
+            compressEngine: false, // 外部引擎不支持引擎压缩
+            compressConfigJson: false, // 外部引擎没有 config.json
+            configJsonInline: false,
+            externFiles,
+            mraidSupport: this.options.mraidSupport ?? playable.mraidSupport ?? false,
+            snapchatCta: this.options.snapchatCta ?? playable.snapchatCta ?? false,
+        };
+    }
+    /**
+     * 解析外部文件配置
+     */
+    resolveExternFiles(defaultValue) {
+        const optionValue = this.options.externFiles;
+        const raw = optionValue ?? defaultValue;
+        if (!raw) {
+            return undefined;
+        }
+        if (typeof raw === 'object') {
+            return raw;
+        }
+        const folderName = this.options.snapchat?.folderName;
+        const externalUrlPrefix = this.options.snapchat?.externalUrlPrefix;
+        return {
+            enabled: true,
+            folderName,
+            externalUrlPrefix,
+        };
+    }
+    /**
+     * 是否应该压缩 CSS
+     */
+    shouldMinifyCSS(config) {
+        return config.minifyCSS;
+    }
+    /**
+     * 是否应该压缩 JS
+     */
+    shouldMinifyJS(config) {
+        return config.minifyJS;
+    }
+    /**
+     * 创建自定义 Logger
+     */
+    createLogger() {
+        const logger = createLogger();
+        return {
+            ...logger,
+            warn(msg, options) {
+                if (typeof msg === 'string' && msg.includes('can\'t be bundled without type="module"')) {
+                    return;
+                }
+                logger.warn(msg, options);
+            },
+        };
+    }
+    /**
+     * 创建 Rollup 警告处理器
+     */
+    createRollupWarnHandler() {
+        return (warning, warn) => {
+            const message = typeof warning === 'string' ? warning : warning.message;
+            if (message && message.includes('can\'t be bundled without type="module"')) {
+                return;
+            }
+            warn(warning);
+        };
+    }
+}

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

@@ -37,6 +37,14 @@ export declare class ViteConfigBuilder {
     private getPlatformConfig;
     private shouldMinifyCSS;
     private shouldMinifyJS;
+    /**
+     * 统一的 Terser 混淆配置
+     * 方案：开启顶层变量混淆 + 多轮压缩（不做属性混淆，避免破坏引擎运行时）
+     *
+     * 注意：当 compressJS 启用时，javascript-obfuscator 会做深度混淆，
+     * Terser 仍然负责基础的压缩和变量名混淆。
+     */
+    private getTerserOptions;
     private createPlugins;
     private getPlayableOptions;
     private resolveExternFiles;

package/dist/vite/config-builder.js

@@ -12,6 +12,7 @@ import { vitePlatformPlugin } from './plugin-platform.js';
 import { viteModelCompressionPlugin } from './plugin-model-compression.js';
 import { viteESMBundlePlugin, bundleESMToIIFE } from './plugin-esm-html-generator.js';
 import { viteBuildStatePlugin } from './plugin-build-state.js';
+import { viteCompressJSPlugin } from './plugin-compress-js.js';
 import { createPlatformAdapter } from '../platforms/index.js';
 import { detectBuildMode, importMapToAlias } from '../utils/build-mode-detector.js';
 export class ViteConfigBuilder {
@@ -22,6 +23,11 @@ export class ViteConfigBuilder {
         this.esmBundledScript = ''; // 预先打包的 ESM 脚本
         this.finalOutputDir = ''; // 用户指定的最终输出目录
         this.viteOutputDir = ''; // Vite 的临时输出目录（在 root 下）
+        // 统一规范化 baseBuildDir：解析符号链接（macOS）和 Windows 8.3 短路径名
+        // 必须使用 realpathSync.native —— 只有它能在 Windows 上将 HOMKER~1 → homkerliu
+        // （fs.realpathSync 在 Windows 上不会解析 8.3 短路径）
+        // Vite 内部也使用 native realpath，所以这里必须对齐，否则 path.relative 会算错
+        this.baseBuildDir = fs.realpathSync.native(baseBuildDir).replace(/\\/g, '/');
     }
     async create() {
         // 1. 检测 Base Build 模式
@@ -33,7 +39,8 @@ export class ViteConfigBuilder {
         const platformConfig = this.getPlatformConfig();
         const outputDir = this.options.outputDir || './dist';
         const playableOptions = this.getPlayableOptions(platformConfig);
-        const rootDir = fs.realpathSync(this.baseBuildDir);
+        // baseBuildDir 已在构造函数中通过 realpathSync 规范化
+        const rootDir = this.baseBuildDir;
         // 为了避免 Vite build-html 插件的路径问题，使用相对于 root 的输出目录
         // 注意：必须使用相对路径字符串，不能用绝对路径
         const viteOutputDir = '__dist__'; // 相对于 root 的路径
@@ -131,12 +138,7 @@ export class ViteConfigBuilder {
                 emptyOutDir: true,
                 cssMinify: this.shouldMinifyCSS(platformConfig) ? 'lightningcss' : false,
                 minify: this.shouldMinifyJS(platformConfig) ? 'terser' : false,
-                terserOptions: {
-                    compress: {
-                        drop_console: true,
-                        drop_debugger: true,
-                    },
-                },
+                terserOptions: this.getTerserOptions(),
                 assetsInlineLimit: Infinity,
                 sourcemap: platformConfig.includeSourcemap,
                 rollupOptions: {
@@ -166,12 +168,7 @@ export class ViteConfigBuilder {
                 cssMinify: this.shouldMinifyCSS(platformConfig) ? 'lightningcss' : false,
                 // JS 压缩
                 minify: this.shouldMinifyJS(platformConfig) ? 'terser' : false,
-                terserOptions: {
-                    compress: {
-                        drop_console: true,
-                        drop_debugger: true,
-                    },
-                },
+                terserOptions: this.getTerserOptions(),
                 // 资源内联阈值（所有资源都内联）
                 assetsInlineLimit: Infinity,
                 // 不生成 sourcemap（Playable Ads 不需要）
@@ -228,6 +225,28 @@ export class ViteConfigBuilder {
     shouldMinifyJS(config) {
         return config.minifyJS;
     }
+    /**
+     * 统一的 Terser 混淆配置
+     * 方案：开启顶层变量混淆 + 多轮压缩（不做属性混淆，避免破坏引擎运行时）
+     *
+     * 注意：当 compressJS 启用时，javascript-obfuscator 会做深度混淆，
+     * Terser 仍然负责基础的压缩和变量名混淆。
+     */
+    getTerserOptions() {
+        return {
+            compress: {
+                drop_console: true,
+                drop_debugger: true,
+                passes: 3,
+            },
+            mangle: {
+                toplevel: true,
+            },
+            format: {
+                comments: false,
+            },
+        };
+    }
     createPlugins(platformConfig, outputDir, playableOptions, isESMBundle = false) {
         const plugins = [];
         // 0. ESM Bundle 插件（如果是 ESM 模式且需要转换为 IIFE）
@@ -246,6 +265,7 @@ export class ViteConfigBuilder {
             patchXhrOut: playableOptions.patchXhrOut,
             inlineGameScripts: playableOptions.inlineGameScripts,
             compressEngine: playableOptions.compressEngine,
+            compressConfigJson: playableOptions.compressConfigJson,
             configJsonInline: playableOptions.configJsonInline,
             mraidSupport: playableOptions.mraidSupport,
             ammoReplacement: this.options.ammoReplacement,
@@ -262,6 +282,12 @@ export class ViteConfigBuilder {
             outputFormat: platformConfig.outputFormat,
             externFiles: playableOptions.externFiles,
             mraidSupport: playableOptions.mraidSupport,
+            // Google Ads ZIP 验证器只允许 .css/.js/.html/.gif/.png/.jpeg/.svg
+            // 将不受支持的文件类型（如 .glb）内联为 base64 到 config.json 中
+            inlineUnsupportedAssets: this.platform === 'google',
+            // ZIP 格式输出时，对复制的 JS 文件进行 Terser 压缩混淆
+            minifyJSInZip: platformConfig.outputFormat === 'zip' && platformConfig.minifyJS,
+            ammoReplacement: this.options.ammoReplacement,
         }));
         // 3. 图片压缩插件
         if (platformConfig.compressImages) {
@@ -306,6 +332,7 @@ export class ViteConfigBuilder {
             baseBuildDir: this.baseBuildDir,
             outputDir: absoluteOutputDir,
             platform: this.platform,
+            analyze: this.options.analyze,
         }));
         // 6. 单文件输出插件（仅HTML格式）
         if (platformConfig.outputFormat === 'html') {
@@ -313,18 +340,31 @@ export class ViteConfigBuilder {
                 removeViteModuleLoader: true,
             }));
         }
+        // 7. JS 压缩保护插件（在单文件输出之后，对最终 HTML 中的所有 JS 进行 LZ4 压缩）
+        if (playableOptions.compressJS) {
+            plugins.push(viteCompressJSPlugin({
+                enabled: true,
+            }));
+        }
         return plugins.filter(Boolean);
     }
     getPlayableOptions(config) {
         const playable = config.playable ?? {};
         const externFiles = this.resolveExternFiles(playable.externFiles);
+        // 当输出格式为 HTML 时（尤其是平台默认 ZIP 但用户选了 HTML），
+        // 需要自动启用 HTML 单文件所必需的选项
+        const isHtmlOutput = config.outputFormat === 'html';
+        // HTML 单文件格式必须内联游戏脚本，否则脚本 URL 无法加载
+        const htmlRequiresInlineScripts = isHtmlOutput;
         return {
             outputFormat: config.outputFormat,
             patchXhrOut: this.options.patchXhrOut ?? playable.patchXhrOut ?? false,
-            inlineGameScripts: this.options.inlineGameScripts ?? playable.inlineGameScripts ?? false,
+            inlineGameScripts: this.options.inlineGameScripts ?? (htmlRequiresInlineScripts || (playable.inlineGameScripts ?? false)),
             compressEngine: this.options.compressEngine ?? playable.compressEngine ?? false,
-            configJsonInline: playable.configJsonInline ?? (config.outputFormat === 'html'),
-            externFiles,
+            compressConfigJson: this.options.compressConfigJson ?? playable.compressConfigJson ?? false,
+            compressJS: this.options.compressJS ?? false,
+            configJsonInline: playable.configJsonInline ?? isHtmlOutput,
+            externFiles: isHtmlOutput ? undefined : externFiles,
             mraidSupport: this.options.mraidSupport ?? playable.mraidSupport ?? false,
             snapchatCta: this.options.snapchatCta ?? playable.snapchatCta ?? false,
         };

package/dist/vite/platform-configs.d.ts

@@ -30,6 +30,7 @@ export interface PlatformViteConfig {
         patchXhrOut?: boolean;
         inlineGameScripts?: boolean;
         compressEngine?: boolean;
+        compressConfigJson?: boolean;
         configJsonInline?: boolean;
         externFiles?: boolean | ExternFilesConfig;
         mraidSupport?: boolean;

package/dist/vite/platform-configs.js

@@ -22,12 +22,13 @@ export const PLATFORM_CONFIGS = {
         },
         esmSupport: {
             enabled: true,
-            preferIIFE: false, // 通用构建支持现代 ESM
+            preferIIFE: true, // 使用 IIFE 确保 pc 全局可用，避免 ESM 模块作用域问题
         },
         playable: {
             patchXhrOut: false,
             inlineGameScripts: false,
             compressEngine: false,
+            compressConfigJson: false,
             configJsonInline: false,
             externFiles: true, // 允许外部文件
             mraidSupport: false,
@@ -414,4 +415,32 @@ export const PLATFORM_CONFIGS = {
             configJsonInline: true,
         },
     },
+    mintegral: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB (ZIP)
+        outputFormat: 'zip',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: false, // 禁用图片压缩，原图输出效果更好
+        compressModels: true,
+        injectScripts: ['mintegralSdk'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 80,
+            png: [0.75, 0.85],
+            webp: 80,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.85,
+        },
+        esmSupport: {
+            enabled: true,
+            preferIIFE: true, // Mintegral 推荐 IIFE 确保兼容性
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true, // Mintegral ZIP 支持外部文件（但非 JS/HTML 资源需 base64）
+        },
+    },
 };

package/dist/vite/plugin-build-state.d.ts

@@ -3,6 +3,8 @@ export interface BuildStatePluginOptions {
     baseBuildDir: string;
     outputDir: string;
     platform: string;
+    /** 是否启用分析模式（只在分析模式下保存状态文件） */
+    analyze?: boolean;
 }
 /**
  * Vite 插件：记录 Playable Build 状态

package/dist/vite/plugin-build-state.js

@@ -128,11 +128,13 @@ export function viteBuildStatePlugin(options) {
             }
         },
         async closeBundle() {
-            console.log('[BuildState] 保存构建状态...');
             // 结束 Playable 构建阶段
             stateManager.endStage();
-            // 保存状态
-            await stateManager.saveState();
+            // 只在分析模式下保存状态文件（分析报告需要用到）
+            if (options.analyze) {
+                console.log('[BuildState] 保存构建状态...');
+                await stateManager.saveState();
+            }
             // 输出统计信息
             const stats = stateManager.getStatistics();
             console.log(`[BuildState] 构建统计:`);

package/dist/vite/plugin-compress-js.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from 'vite';
+export interface CompressJSPluginOptions {
+    /** 是否启用 JS 代码混淆保护 */
+    enabled: boolean;
+}
+/**
+ * JS 代码混淆保护插件
+ *
+ * 使用 javascript-obfuscator 对 HTML 中所有内联 <script> 标签的 JS 代码
+ * 进行深度混淆，包括：
+ * - 变量名混淆
+ * - 字符串混淆（字面量转为十六进制/unicode 编码）
+ * - 控制流平坦化
+ * - 死代码注入
+ *
+ * 混淆后的代码在浏览器中无法直接阅读理解。
+ *
+ * 注意：这个插件必须在 vite-plugin-singlefile 之后执行，
+ * 确保所有资源已内联到 HTML 中。
+ */
+export declare function viteCompressJSPlugin(options: CompressJSPluginOptions): Plugin | null;