@playcraft/build 0.0.13 → 0.0.15

package/dist/utils/obfuscate.js

@@ -0,0 +1,216 @@
+/**
+ * 代码混淆 + fflate 压缩工具
+ *
+ * 流程：
+ * 1. javascript-obfuscator 混淆（字符串加密、控制流扁平化等）
+ * 2. fflate deflate 压缩
+ * 3. base64 编码
+ * 4. 包装为自解压 bootstrap 脚本
+ */
+import JavaScriptObfuscator from 'javascript-obfuscator';
+import { deflateSync } from 'fflate';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * 混淆级别预设配置
+ */
+const ObfuscatorPresets = {
+    // 轻量级：仅字符串加密 + 标识符混淆，体积膨胀 ~30%
+    light: {
+        compact: true,
+        controlFlowFlattening: false,
+        deadCodeInjection: false,
+        stringArray: true,
+        stringArrayEncoding: ['base64'],
+        stringArrayThreshold: 0.5,
+        stringArrayCallsTransform: true,
+        identifierNamesGenerator: 'hexadecimal',
+        renameGlobals: false,
+        selfDefending: false,
+        splitStrings: false,
+        transformObjectKeys: false,
+    },
+    // 中等：字符串加密 + 控制流扁平化，体积膨胀 ~60%
+    medium: {
+        compact: true,
+        controlFlowFlattening: true,
+        controlFlowFlatteningThreshold: 0.5,
+        deadCodeInjection: false,
+        stringArray: true,
+        stringArrayEncoding: ['base64'],
+        stringArrayThreshold: 0.75,
+        stringArrayCallsTransform: true,
+        identifierNamesGenerator: 'hexadecimal',
+        renameGlobals: false,
+        selfDefending: false,
+        splitStrings: true,
+        splitStringsChunkLength: 10,
+        transformObjectKeys: true,
+    },
+    // 重度：全部开启，体积膨胀 ~100%+
+    heavy: {
+        compact: true,
+        controlFlowFlattening: true,
+        controlFlowFlatteningThreshold: 0.75,
+        deadCodeInjection: true,
+        deadCodeInjectionThreshold: 0.3,
+        stringArray: true,
+        stringArrayEncoding: ['rc4'],
+        stringArrayThreshold: 1,
+        stringArrayCallsTransform: true,
+        identifierNamesGenerator: 'hexadecimal',
+        renameGlobals: false,
+        selfDefending: false,
+        splitStrings: true,
+        splitStringsChunkLength: 5,
+        transformObjectKeys: true,
+        unicodeEscapeSequence: true,
+    },
+};
+/**
+ * fflate inflate 运行时代码（浏览器端）
+ * 从 fflate 库的 UMD 构建中动态加载，确保与 Node 端使用的 fflate 版本一致
+ * 运行后在 window 上暴露 __fflate_inflate 函数
+ */
+let _fflateRuntimeCache = null;
+export function getFflateInflateRuntime() {
+    if (_fflateRuntimeCache)
+        return _fflateRuntimeCache;
+    // 找到 fflate 包的 UMD 构建文件
+    // 从当前文件位置向上查找 node_modules/fflate/umd/index.js
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    // 向上查找 node_modules 目录（支持 pnpm 的嵌套 node_modules 结构）
+    let searchDir = currentDir;
+    let fflateUmdPath = '';
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(searchDir, 'node_modules', 'fflate', 'umd', 'index.js');
+        if (fs.existsSync(candidate)) {
+            fflateUmdPath = candidate;
+            break;
+        }
+        const parent = path.dirname(searchDir);
+        if (parent === searchDir)
+            break;
+        searchDir = parent;
+    }
+    if (!fflateUmdPath) {
+        throw new Error('[fflate] 无法找到 fflate UMD 构建文件，请确保 fflate 已安装');
+    }
+    const fflateUmd = fs.readFileSync(fflateUmdPath, 'utf-8');
+    // 包装 UMD 使其在浏览器环境中执行，并将 inflateSync 暴露为 window.__fflate_inflate
+    // UMD 的外层包装会检测环境：typeof self !== 'undefined' ? self : this
+    // 通过 var self=window 确保 fflate 挂载到 window.fflate
+    _fflateRuntimeCache = `!function(){var self=window;${fflateUmd};window.__fflate_inflate=window.fflate.inflateSync}();`;
+    return _fflateRuntimeCache;
+}
+/**
+ * 对 JS 代码进行混淆 + fflate 压缩，生成自解压 bootstrap
+ */
+export async function obfuscateAndCompress(jsCode, level = 'medium') {
+    const originalSize = Buffer.from(jsCode).length;
+    console.log(`[Obfuscator] 开始混淆... 级别: ${level}, 原始大小: ${formatBytes(originalSize)}`);
+    console.log(`[Obfuscator] 混淆中（这可能需要较长时间）...`);
+    const startTime = Date.now();
+    // ① javascript-obfuscator 混淆
+    const obfuscated = JavaScriptObfuscator.obfuscate(jsCode, {
+        ...ObfuscatorPresets[level],
+        target: 'browser',
+        seed: Date.now(),
+        // 不使用 sourceMap
+        sourceMap: false,
+        // 禁用 console 输出
+        disableConsoleOutput: false,
+        // 不使用 domain lock
+        domainLock: [],
+        domainLockRedirectUrl: 'about:blank',
+        // 排除一些 PlayCanvas 关键标识符不被混淆
+        reservedNames: [
+            'pc', 'PlayCanvasESMBundle', 'PRELOAD_MODULES',
+            '__fflate_inflate',
+        ],
+        reservedStrings: [],
+    }).getObfuscatedCode();
+    const obfuscatedSize = Buffer.from(obfuscated).length;
+    const obfuscateTime = ((Date.now() - startTime) / 1000).toFixed(1);
+    console.log(`[Obfuscator] 混淆完成 (${obfuscateTime}s), 大小: ${formatBytes(obfuscatedSize)} (膨胀 ${((obfuscatedSize / originalSize - 1) * 100).toFixed(0)}%)`);
+    // ② fflate deflate 压缩
+    const textEncoder = new TextEncoder();
+    const codeBytes = textEncoder.encode(obfuscated);
+    const compressed = deflateSync(codeBytes, { level: 9 });
+    const compressedSize = compressed.length;
+    console.log(`[Obfuscator] fflate 压缩完成, 大小: ${formatBytes(compressedSize)} (压缩率 ${((1 - compressedSize / obfuscatedSize) * 100).toFixed(0)}%)`);
+    // ③ 转 base64
+    const base64 = Buffer.from(compressed).toString('base64');
+    // ④ 生成 bootstrap 自解压脚本
+    // 运行时：base64 解码 → fflate inflate 解压 → 创建 <script> 执行
+    const bootstrapCode = `!function(){var b=atob("${base64}"),a=new Uint8Array(b.length);for(var i=0;i<b.length;i++)a[i]=b.charCodeAt(i);var d=__fflate_inflate(a),s="";for(var i=0;i<d.length;i+=8192)s+=String.fromCharCode.apply(null,d.subarray(i,i+8192));var e=document.createElement("script");e.textContent=decodeURIComponent(escape(s));document.currentScript.parentNode.insertBefore(e,document.currentScript)}();`;
+    const runtime = `<script>${getFflateInflateRuntime()}</script>`;
+    const bootstrap = `<script>${bootstrapCode}</script>`;
+    const finalSize = runtime.length + bootstrap.length;
+    console.log(`[Obfuscator] 最终大小: ${formatBytes(finalSize)} (原始 ${formatBytes(originalSize)} → 节省 ${((1 - finalSize / originalSize) * 100).toFixed(0)}%)`);
+    return {
+        runtime,
+        bootstrap,
+        originalSize,
+        obfuscatedSize,
+        compressedSize,
+        finalSize,
+    };
+}
+/**
+ * 使用 fflate 压缩引擎代码（替换 LZ4）
+ * 不做混淆，只做压缩
+ */
+export function compressWithFflate(code) {
+    const originalSize = Buffer.from(code).length;
+    // fflate deflate 压缩
+    const textEncoder = new TextEncoder();
+    const codeBytes = textEncoder.encode(code);
+    const compressed = deflateSync(codeBytes, { level: 9 });
+    const compressedSize = compressed.length;
+    // 转 base64
+    const base64 = Buffer.from(compressed).toString('base64');
+    // 生成自解压脚本
+    const wrapper = `!function(){var b=atob("${base64}"),a=new Uint8Array(b.length);for(var i=0;i<b.length;i++)a[i]=b.charCodeAt(i);var d=__fflate_inflate(a),s="";for(var i=0;i<d.length;i+=8192)s+=String.fromCharCode.apply(null,d.subarray(i,i+8192));var e=document.createElement("script");e.textContent=decodeURIComponent(escape(s));document.currentScript.parentNode.insertBefore(e,document.currentScript)}();`;
+    const runtime = `<script>${getFflateInflateRuntime()}</script>`;
+    const compressedScript = `<script>${wrapper}</script>`;
+    console.log(`[fflate] 引擎压缩: ${formatBytes(originalSize)} → ${formatBytes(compressedSize)} (压缩率 ${((1 - compressedSize / originalSize) * 100).toFixed(0)}%)`);
+    return {
+        runtime,
+        compressed: compressedScript,
+        originalSize,
+        compressedSize,
+    };
+}
+/**
+ * 使用 fflate 压缩 config.json（替换 LZ4）
+ */
+export function compressConfigJsonWithFflate(jsonString) {
+    const originalSize = Buffer.from(jsonString).length;
+    const textEncoder = new TextEncoder();
+    const jsonBytes = textEncoder.encode(jsonString);
+    const compressed = deflateSync(jsonBytes, { level: 9 });
+    const compressedSize = compressed.length;
+    const compressedBase64 = Buffer.from(compressed).toString('base64');
+    // 使用 fflate-json 前缀标识格式
+    const dataUrl = `data:application/x-fflate-json;base64,${compressedBase64}`;
+    const ratio = ((1 - compressedSize / originalSize) * 100).toFixed(1);
+    console.log(`[fflate] config.json 压缩: ${formatBytes(originalSize)} → ${formatBytes(compressedSize)} (减少 ${ratio}%)`);
+    return { dataUrl, originalSize, compressedSize };
+}
+/**
+ * 构建 config.json 解压 patch（fflate 版本）
+ * 拦截 pc.Http.prototype.get，检测 fflate 压缩的 JSON 并解压
+ */
+export function buildFflateConfigDecompressPatch() {
+    return `!function(){function p(){if(!window.pc||!pc.Http)return!1;var o=pc.Http.prototype.get;return pc.Http.prototype.get=function(e,t,n){"function"==typeof t&&(n=t,t={});if("string"==typeof e&&e.startsWith("data:application/x-fflate-json;base64,")){try{var r=e.replace("data:application/x-fflate-json;base64,",""),b=atob(r),a=new Uint8Array(b.length);for(var i=0;i<b.length;i++)a[i]=b.charCodeAt(i);var d=__fflate_inflate(a),s="";for(var i=0;i<d.length;i+=8192)s+=String.fromCharCode.apply(null,d.subarray(i,i+8192));s=decodeURIComponent(escape(s));var j=JSON.parse(s);n(null,j)}catch(x){console.error("[fflate Config] Decompression error:",x);n(x)}return}o.call(this,e,t,n)},!0}if(!p()){var c=0,i=setInterval(function(){(p()||++c>100)&&clearInterval(i)},10)}}();`;
+}
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}

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;
+}

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）
@@ -263,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) {
@@ -315,19 +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,
             compressConfigJson: this.options.compressConfigJson ?? playable.compressConfigJson ?? false,
-            configJsonInline: playable.configJsonInline ?? (config.outputFormat === 'html'),
-            externFiles,
+            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,
         };