@playcraft/build 0.0.2

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

@@ -0,0 +1,15 @@
+import { type UserConfig } from 'vite';
+import type { Platform, BuildOptions } from '../types.js';
+export declare class ViteConfigBuilder {
+    private baseBuildDir;
+    private platform;
+    private options;
+    constructor(baseBuildDir: string, platform: Platform, options: BuildOptions);
+    create(): UserConfig;
+    private getPlatformConfig;
+    private shouldMinifyCSS;
+    private shouldMinifyJS;
+    private createPlugins;
+    private getPlayableOptions;
+    private resolveExternFiles;
+}

package/dist/vite/config-builder.js

@@ -0,0 +1,212 @@
+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 { visualizer } from 'rollup-plugin-visualizer';
+import { PLATFORM_CONFIGS } from './platform-configs.js';
+import { vitePlayCanvasPlugin } from './plugin-playcanvas.js';
+import { vitePlatformPlugin } from './plugin-platform.js';
+import { viteModelCompressionPlugin } from './plugin-model-compression.js';
+import { createPlatformAdapter } from '../platforms/index.js';
+export class ViteConfigBuilder {
+    constructor(baseBuildDir, platform, options) {
+        this.baseBuildDir = baseBuildDir;
+        this.platform = platform;
+        this.options = options;
+    }
+    create() {
+        const platformConfig = this.getPlatformConfig();
+        const outputDir = this.options.outputDir || './dist';
+        const playableOptions = this.getPlayableOptions(platformConfig);
+        const rootDir = fs.realpathSync(this.baseBuildDir);
+        const logger = createLogger();
+        const customLogger = {
+            ...logger,
+            warn(msg, options) {
+                if (typeof msg === 'string' && msg.includes('can\'t be bundled without type="module"')) {
+                    return;
+                }
+                logger.warn(msg, options);
+            },
+        };
+        return defineConfig({
+            root: rootDir,
+            base: './',
+            customLogger,
+            build: {
+                outDir: outputDir,
+                emptyOutDir: true,
+                // CSS 压缩
+                cssMinify: this.shouldMinifyCSS(platformConfig) ? 'lightningcss' : false,
+                // JS 压缩
+                minify: this.shouldMinifyJS(platformConfig) ? 'terser' : false,
+                terserOptions: {
+                    compress: {
+                        drop_console: true,
+                        drop_debugger: true,
+                    },
+                },
+                // 资源内联阈值（所有资源都内联）
+                assetsInlineLimit: Infinity,
+                // 不生成 sourcemap（Playable Ads 不需要）
+                sourcemap: platformConfig.includeSourcemap,
+                rollupOptions: {
+                    input: {
+                        main: path.join(rootDir, 'index.html'),
+                    },
+                    onwarn(warning, warn) {
+                        const message = typeof warning === 'string' ? warning : warning.message;
+                        if (message && message.includes('can\'t be bundled without type="module"')) {
+                            return;
+                        }
+                        warn(warning);
+                    },
+                },
+            },
+            plugins: this.createPlugins(platformConfig, outputDir, playableOptions),
+        });
+    }
+    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: this.options.compressModels ?? baseConfig.compressModels,
+            modelCompression: {
+                method: this.options.modelCompression ?? baseConfig.modelCompression?.method ?? 'draco',
+                quality: baseConfig.modelCompression?.quality ?? 0.8,
+            },
+        };
+    }
+    shouldMinifyCSS(config) {
+        return config.minifyCSS;
+    }
+    shouldMinifyJS(config) {
+        return config.minifyJS;
+    }
+    createPlugins(platformConfig, outputDir, playableOptions) {
+        const plugins = [];
+        // 1. PlayCanvas 资源转换插件（最先执行）
+        plugins.push(vitePlayCanvasPlugin({
+            baseBuildDir: this.baseBuildDir,
+            inlineScripts: true,
+            convertDataUrls: platformConfig.outputFormat === 'html',
+            outputFormat: playableOptions.outputFormat,
+            patchXhrOut: playableOptions.patchXhrOut,
+            inlineGameScripts: playableOptions.inlineGameScripts,
+            compressEngine: playableOptions.compressEngine,
+            configJsonInline: playableOptions.configJsonInline,
+            mraidSupport: playableOptions.mraidSupport,
+            ammoReplacement: this.options.ammoReplacement,
+        }));
+        // 2. 平台特定插件
+        const platformAdapter = createPlatformAdapter(this.options);
+        plugins.push(vitePlatformPlugin({
+            platform: this.platform,
+            adapter: platformAdapter,
+            outputDir: outputDir,
+            baseBuildDir: this.baseBuildDir,
+            outputFormat: platformConfig.outputFormat,
+            externFiles: playableOptions.externFiles,
+            mraidSupport: playableOptions.mraidSupport,
+        }));
+        // 3. 图片压缩插件
+        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);
+            }
+        }
+        // 4. 模型压缩插件
+        if (platformConfig.compressModels) {
+            plugins.push(viteModelCompressionPlugin({
+                quality: platformConfig.modelCompression?.quality ?? 0.8,
+                method: platformConfig.modelCompression?.method ?? 'draco',
+                enabled: true,
+            }));
+        }
+        // 5. 单文件输出插件（仅HTML格式）
+        if (platformConfig.outputFormat === 'html') {
+            plugins.push(viteSingleFile({
+                removeViteModuleLoader: true,
+            }));
+        }
+        // 6. 打包分析报告
+        if (this.options.analyze) {
+            const reportPath = this.options.analyzeReportPath
+                ? this.options.analyzeReportPath
+                : path.join(outputDir, 'bundle-report.html');
+            plugins.push(visualizer({
+                filename: reportPath,
+                template: 'treemap',
+                gzipSize: true,
+                brotliSize: true,
+                open: false,
+            }));
+        }
+        return plugins.filter(Boolean);
+    }
+    getPlayableOptions(config) {
+        const playable = config.playable ?? {};
+        const externFiles = this.resolveExternFiles(playable.externFiles);
+        return {
+            outputFormat: config.outputFormat,
+            patchXhrOut: this.options.patchXhrOut ?? playable.patchXhrOut ?? false,
+            inlineGameScripts: this.options.inlineGameScripts ?? playable.inlineGameScripts ?? false,
+            compressEngine: this.options.compressEngine ?? playable.compressEngine ?? false,
+            configJsonInline: playable.configJsonInline ?? (config.outputFormat === 'html'),
+            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,
+        };
+    }
+}

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

@@ -0,0 +1,38 @@
+import type { Platform, ExternFilesConfig } from '../types.js';
+/**
+ * 平台 Vite 配置接口
+ */
+export interface PlatformViteConfig {
+    sizeLimit: number;
+    outputFormat: 'html' | 'zip';
+    minifyCSS: boolean;
+    minifyJS: boolean;
+    compressImages: boolean;
+    compressModels: boolean;
+    injectScripts?: string[];
+    htmlTransforms?: Array<(html: string) => string>;
+    outputFileName: string;
+    includeSourcemap: boolean;
+    imageQuality?: {
+        jpg?: number;
+        png?: [number, number];
+        webp?: number;
+    };
+    modelCompression?: {
+        method?: 'draco' | 'meshopt';
+        quality?: number;
+    };
+    playable?: {
+        patchXhrOut?: boolean;
+        inlineGameScripts?: boolean;
+        compressEngine?: boolean;
+        configJsonInline?: boolean;
+        externFiles?: boolean | ExternFilesConfig;
+        mraidSupport?: boolean;
+        snapchatCta?: boolean;
+    };
+}
+/**
+ * 平台配置映射
+ */
+export declare const PLATFORM_CONFIGS: Record<Platform, PlatformViteConfig>;

package/dist/vite/platform-configs.js

@@ -0,0 +1,257 @@
+/**
+ * 平台配置映射
+ */
+export const PLATFORM_CONFIGS = {
+    facebook: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB（HTML/ZIP 总包体）
+        outputFormat: 'html',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['fbPlayableAd'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            patchXhrOut: true,
+            inlineGameScripts: true,
+            compressEngine: true,
+            configJsonInline: true,
+        },
+    },
+    snapchat: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'zip',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['mraid', 'snapchatCta'],
+        outputFileName: 'ad.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 80,
+            png: [0.75, 0.85],
+            webp: 80,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.85,
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true,
+            mraidSupport: true,
+            snapchatCta: true,
+        },
+    },
+    ironsource: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB（修正）
+        outputFormat: 'html',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['mraid', 'dapi'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            patchXhrOut: true,
+            inlineGameScripts: true,
+            configJsonInline: true,
+            mraidSupport: true,
+        },
+    },
+    applovin: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB（修正）
+        outputFormat: 'html',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['mraid'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            patchXhrOut: true,
+            inlineGameScripts: true,
+            configJsonInline: true,
+            mraidSupport: true,
+        },
+    },
+    google: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB（修正）
+        outputFormat: 'zip', // ZIP格式（修正）
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['exitApi'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true,
+        },
+    },
+    tiktok: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'zip',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['pangleSdk'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 80,
+            png: [0.75, 0.85],
+            webp: 80,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.85,
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true,
+        },
+    },
+    unity: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'html',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['mraid3'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            patchXhrOut: true,
+            inlineGameScripts: true,
+            configJsonInline: true,
+            mraidSupport: true,
+        },
+    },
+    liftoff: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'zip',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['mraid'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true,
+            mraidSupport: true,
+        },
+    },
+    moloco: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'html',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['fbPlayableAd'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 75,
+            png: [0.7, 0.8],
+            webp: 75,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.8,
+        },
+        playable: {
+            patchXhrOut: true,
+            inlineGameScripts: true,
+            configJsonInline: true,
+        },
+    },
+    bigo: {
+        sizeLimit: 5 * 1024 * 1024, // 5MB
+        outputFormat: 'zip',
+        minifyCSS: true,
+        minifyJS: true,
+        compressImages: true,
+        compressModels: true,
+        injectScripts: ['bigoSdk'],
+        outputFileName: 'index.html',
+        includeSourcemap: false,
+        imageQuality: {
+            jpg: 80,
+            png: [0.75, 0.85],
+            webp: 80,
+        },
+        modelCompression: {
+            method: 'draco',
+            quality: 0.85,
+        },
+        playable: {
+            inlineGameScripts: true,
+            externFiles: true,
+        },
+    },
+};

package/dist/vite/plugin-model-compression.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'vite';
+export interface ModelCompressionPluginOptions {
+    quality?: number;
+    method?: 'draco' | 'meshopt';
+    enabled?: boolean;
+}
+/**
+ * 3D 模型压缩 Vite 插件
+ * 使用 gltf-transform 压缩 GLB/GLTF 模型
+ */
+export declare function viteModelCompressionPlugin(options?: ModelCompressionPluginOptions): Plugin;

package/dist/vite/plugin-model-compression.js

@@ -0,0 +1,63 @@
+import { NodeIO } from '@gltf-transform/core';
+import { ALL_EXTENSIONS } from '@gltf-transform/extensions';
+import { draco, textureCompress } from '@gltf-transform/functions';
+import draco3d from 'draco3dgltf';
+/**
+ * 3D 模型压缩 Vite 插件
+ * 使用 gltf-transform 压缩 GLB/GLTF 模型
+ */
+export function viteModelCompressionPlugin(options = {}) {
+    const { quality = 0.8, method = 'draco', enabled = true } = options;
+    if (!enabled) {
+        return {
+            name: 'vite-plugin-model-compression',
+            // 返回空插件
+        };
+    }
+    return {
+        name: 'vite-plugin-model-compression',
+        async transform(code, id) {
+            // 只处理 GLB/GLTF 文件
+            if (!id.match(/\.(glb|gltf)$/i)) {
+                return null;
+            }
+            try {
+                // 初始化 gltf-transform
+                const io = new NodeIO()
+                    .registerExtensions(ALL_EXTENSIONS)
+                    .registerDependencies({
+                    'draco3d.decoder': await draco3d.createDecoderModule(),
+                    'draco3d.encoder': await draco3d.createEncoderModule(),
+                });
+                // 读取模型
+                const document = await io.read(id);
+                // 应用压缩
+                if (method === 'draco') {
+                    await document.transform(draco({
+                        quantizePosition: 14,
+                        quantizeNormal: 10,
+                        quantizeTexcoord: 12,
+                        quantizeColor: 8,
+                    }));
+                }
+                // 纹理压缩
+                await document.transform(textureCompress({
+                    targetFormat: 'webp',
+                    quality: quality,
+                }));
+                // 转换为 Base64 data URL
+                const glb = await io.writeBinary(document);
+                const base64 = Buffer.from(glb).toString('base64');
+                return {
+                    code: `export default "data:model/gltf-binary;base64,${base64}"`,
+                    map: null,
+                };
+            }
+            catch (error) {
+                console.warn(`警告: 无法压缩模型文件 ${id}: ${error instanceof Error ? error.message : String(error)}`);
+                // 如果压缩失败，返回原始内容
+                return null;
+            }
+        },
+    };
+}

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

@@ -0,0 +1,17 @@
+import type { Plugin } from 'vite';
+import type { PlatformAdapter } from '../platforms/base.js';
+import type { Platform } from '../types.js';
+export interface PlatformPluginOptions {
+    platform: Platform;
+    adapter: PlatformAdapter;
+    outputDir: string;
+    baseBuildDir: string;
+    outputFormat: 'html' | 'zip';
+    externFiles?: import('../types.js').ExternFilesConfig;
+    mraidSupport?: boolean;
+}
+/**
+ * 平台 Vite 插件
+ * 注入平台特定代码和处理输出格式
+ */
+export declare function vitePlatformPlugin(options: PlatformPluginOptions): Plugin;