@playcraft/build 0.0.44 → 0.0.46

package/dist/vite-builder.js

@@ -4,6 +4,7 @@ import path from 'path';
 import { ViteConfigBuilder } from './vite/config-builder.js';
 import { GenericViteConfigBuilder } from './vite/config-builder-generic.js';
 import { PLATFORM_CONFIGS } from './vite/platform-configs.js';
+import { formatValidationSummary, hasBlockingValidationErrors, runPlayableValidation, saveValidationReport, } from './validation/index.js';
 /**
  * Vite 构建器 - 使用 Vite 构建 Playable Ads
  *
@@ -90,6 +91,7 @@ export class ViteBuilder {
         // 6. 验证输出大小
         const outputPath = this.getOutputPath();
         await this.validateSize(outputPath);
+        await this.runComplianceValidation(outputPath, metadata);
         // 7. 生成报告
         this.generateReport(outputPath);
         return outputPath;
@@ -350,6 +352,47 @@ export class ViteBuilder {
     /**
      * 格式化字节数
      */
+    async runComplianceValidation(outputPath, metadata) {
+        const validationOptions = this.options.validation;
+        if (validationOptions?.enabled === false) {
+            return;
+        }
+        if (this.engine !== 'phaser') {
+            return;
+        }
+        const isZip = outputPath.toLowerCase().endsWith('.zip');
+        const stages = validationOptions?.stages
+            ?? (isZip ? ['delivery-package'] : ['html-artifact']);
+        const report = await runPlayableValidation({
+            projectRoot: this.baseBuildDir,
+            channel: this.options.platform,
+            engine: this.engine,
+            buildTool: metadata?.buildTool,
+            buildChain: metadata?.buildTool === 'playable-scripts'
+                ? 'devkit'
+                : metadata?.buildTool === 'playcanvas-native'
+                    ? 'playcanvas-native'
+                    : 'generic',
+            htmlPath: isZip ? undefined : outputPath,
+            packagePath: isZip ? outputPath : undefined,
+            outputDir: this.options.outputDir,
+            sourceGlobs: validationOptions?.sourceGlobs,
+            metadata: metadata ? { ...metadata } : undefined,
+        }, stages);
+        const summary = formatValidationSummary(report);
+        if (report.summary.status === 'pass') {
+            console.log(summary);
+        }
+        else {
+            console.warn(summary);
+        }
+        if (validationOptions?.reportPath) {
+            await saveValidationReport(report, validationOptions.reportPath);
+        }
+        if (validationOptions?.failOnError && hasBlockingValidationErrors(report)) {
+            throw new Error(`Playable validation failed for ${this.options.platform}`);
+        }
+    }
     formatBytes(bytes) {
         if (bytes === 0)
             return '0 Bytes';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -32,7 +32,7 @@
   "scripts": {
     "dev": "tsc -w",
     "build": "tsc",
-    "release": "node scripts/release.js"
+    "release": "node ../../scripts/release-npm.mjs --packages=build --skip-install --skip-tests --skip-git-push"
   },
   "dependencies": {
     "@playcraft/ads-tracking": "^1.0.0",

package/dist/analyzers/__tests__/optimization-analyzer.test.js

@@ -1,169 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { OptimizationAnalyzer } from '../optimization-analyzer.js';
-describe('OptimizationAnalyzer', () => {
-    it('should detect large uncompressed files', () => {
-        const state = {
-            version: '1.0.0',
-            buildTime: Date.now(),
-            assets: {
-                'large-file': {
-                    id: 'large-file',
-                    originalName: 'large-file.js',
-                    originalPath: '/path/to/large-file.js',
-                    originalSize: 200 * 1024, // 200KB
-                    finalSize: 195 * 1024, // 只压缩了 5KB
-                    totalCompressionRatio: 0.025, // 2.5% 压缩率
-                    type: 'script',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'large-file.js',
-                            size: 195 * 1024,
-                            optimizations: [],
-                        },
-                    ],
-                },
-            },
-            stages: [],
-        };
-        const analyzer = new OptimizationAnalyzer(state);
-        const result = analyzer.analyze();
-        expect(result.totalSuggestions).toBeGreaterThan(0);
-        expect(result.suggestions.some(s => s.type === 'large-uncompressed')).toBe(true);
-    });
-    it('should detect PNG images that can be converted to WebP', () => {
-        const state = {
-            version: '1.0.0',
-            buildTime: Date.now(),
-            assets: {
-                'image': {
-                    id: 'image',
-                    originalName: 'image.png',
-                    originalPath: '/path/to/image.png',
-                    originalSize: 100 * 1024, // 100KB
-                    finalSize: 100 * 1024,
-                    totalCompressionRatio: 0,
-                    type: 'texture',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'image.png',
-                            size: 100 * 1024,
-                            optimizations: [],
-                        },
-                    ],
-                },
-            },
-            stages: [],
-        };
-        const analyzer = new OptimizationAnalyzer(state);
-        const result = analyzer.analyze();
-        expect(result.suggestions.some(s => s.type === 'format-conversion')).toBe(true);
-    });
-    it('should detect missing minification', () => {
-        const state = {
-            version: '1.0.0',
-            buildTime: Date.now(),
-            assets: {
-                'script': {
-                    id: 'script',
-                    originalName: 'script.js',
-                    originalPath: '/path/to/script.js',
-                    originalSize: 50 * 1024, // 50KB
-                    finalSize: 50 * 1024,
-                    totalCompressionRatio: 0,
-                    type: 'script',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'script.js',
-                            size: 50 * 1024,
-                            optimizations: [], // 没有 minify
-                        },
-                    ],
-                },
-            },
-            stages: [],
-        };
-        const analyzer = new OptimizationAnalyzer(state);
-        const result = analyzer.analyze();
-        expect(result.suggestions.some(s => s.type === 'enable-minify')).toBe(true);
-    });
-    it('should group suggestions by severity', () => {
-        const state = {
-            version: '1.0.0',
-            buildTime: Date.now(),
-            assets: {
-                'large-uncompressed': {
-                    id: 'large-uncompressed',
-                    originalName: 'large.js',
-                    originalPath: '/path/to/large.js',
-                    originalSize: 200 * 1024,
-                    finalSize: 195 * 1024,
-                    totalCompressionRatio: 0.025,
-                    type: 'script',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'large.js',
-                            size: 195 * 1024,
-                            optimizations: [],
-                        },
-                    ],
-                },
-                'png-image': {
-                    id: 'png-image',
-                    originalName: 'image.png',
-                    originalPath: '/path/to/image.png',
-                    originalSize: 100 * 1024,
-                    finalSize: 100 * 1024,
-                    totalCompressionRatio: 0,
-                    type: 'texture',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'image.png',
-                            size: 100 * 1024,
-                            optimizations: [],
-                        },
-                    ],
-                },
-            },
-            stages: [],
-        };
-        const analyzer = new OptimizationAnalyzer(state);
-        const result = analyzer.analyze();
-        expect(result.bySeverity.high.length).toBeGreaterThan(0);
-        expect(result.bySeverity.medium.length).toBeGreaterThan(0);
-    });
-    it('should calculate total estimated savings', () => {
-        const state = {
-            version: '1.0.0',
-            buildTime: Date.now(),
-            assets: {
-                'large-file': {
-                    id: 'large-file',
-                    originalName: 'large-file.js',
-                    originalPath: '/path/to/large-file.js',
-                    originalSize: 200 * 1024,
-                    finalSize: 195 * 1024,
-                    totalCompressionRatio: 0.025,
-                    type: 'script',
-                    processingHistory: [
-                        {
-                            stage: 'base-build',
-                            name: 'large-file.js',
-                            size: 195 * 1024,
-                            optimizations: [],
-                        },
-                    ],
-                },
-            },
-            stages: [],
-        };
-        const analyzer = new OptimizationAnalyzer(state);
-        const result = analyzer.analyze();
-        expect(result.totalEstimatedSavings).toBeGreaterThan(0);
-        expect(result.estimatedOptimizationRate).toBeGreaterThan(0);
-    });
-});

package/dist/templates/__loading__.js

@@ -1,100 +0,0 @@
-pc.script.createLoadingScreen((app) => {
-    const createCss = () => {
-        const css = `
-            body {
-                background-color: #283538;
-            }
-
-            #application-splash-wrapper {
-                position: absolute;
-                top: 0;
-                left: 0;
-                height: 100%;
-                width: 100%;
-                background-color: #283538;
-            }
-
-            #application-splash {
-                position: absolute;
-                top: calc(50% - 28px);
-                width: 264px;
-                left: calc(50% - 132px);
-            }
-
-            #application-splash img {
-                width: 100%;
-            }
-
-            #progress-bar-container {
-                margin: 20px auto 0 auto;
-                height: 2px;
-                width: 100%;
-                background-color: #1d292c;
-            }
-
-            #progress-bar {
-                width: 0%;
-                height: 100%;
-                background-color: #f60;
-            }
-
-            @media (max-width: 480px) {
-                #application-splash {
-                    width: 170px;
-                    left: calc(50% - 85px);
-                }
-            }
-        `;
-
-        const style = document.createElement('style');
-        style.textContent = css;
-        document.head.appendChild(style);
-    };
-
-    const showSplash = () => {
-        const wrapper = document.createElement('div');
-        wrapper.id = 'application-splash-wrapper';
-        document.body.appendChild(wrapper);
-
-        const splash = document.createElement('div');
-        splash.id = 'application-splash';
-        wrapper.appendChild(splash);
-        splash.style.display = 'none';
-
-        const logo = document.createElement('img');
-        logo.src = `${ASSET_PREFIX}logo.png`;
-        splash.appendChild(logo);
-        logo.onload = () => {
-            splash.style.display = 'block';
-        };
-
-        const container = document.createElement('div');
-        container.id = 'progress-bar-container';
-        splash.appendChild(container);
-
-        const bar = document.createElement('div');
-        bar.id = 'progress-bar';
-        container.appendChild(bar);
-    };
-
-    const setProgress = (value) => {
-        const bar = document.getElementById('progress-bar');
-        if (bar) {
-            value = Math.min(1, Math.max(0, value));
-            bar.style.width = `${value * 100}%`;
-        }
-    };
-
-    const hideSplash = () => {
-        document.getElementById('application-splash-wrapper').remove();
-    };
-
-    createCss();
-    showSplash();
-
-    app.on('preload:end', () => {
-        app.off('preload:progress');
-    });
-    app.on('preload:progress', setProgress);
-    app.on('start', hideSplash);
-});

package/dist/templates/__modules__.js

@@ -1,47 +0,0 @@
-var loadModules = function (modules, urlPrefix, doneCallback) { // eslint-disable-line no-unused-vars
-
-    if (typeof modules === "undefined" || modules.length === 0) {
-        // caller may depend on callback behaviour being async
-        setTimeout(doneCallback);
-    } else {
-        let remaining = modules.length;
-        const moduleLoaded = () => {
-            if (--remaining === 0) {
-                doneCallback();
-            }
-        };
-
-        modules.forEach(function (m) {
-            pc.WasmModule.setConfig(m.moduleName, {
-                glueUrl: urlPrefix + m.glueUrl,
-                wasmUrl: urlPrefix + m.wasmUrl,
-                fallbackUrl: urlPrefix + m.fallbackUrl
-            });
-
-            if (!m.hasOwnProperty('preload') || m.preload) {
-                if (m.moduleName === 'BASIS') {
-                    // preload basis transcoder
-                    pc.basisInitialize();
-                    moduleLoaded();
-                } else if (m.moduleName === 'DracoDecoderModule') {
-                    // preload draco decoder
-                    if (pc.dracoInitialize) {
-                        // 1.63 onwards
-                        pc.dracoInitialize();
-                        moduleLoaded();
-                    } else {
-                        // 1.62 and earlier
-                        pc.WasmModule.getInstance(m.moduleName, () => { moduleLoaded(); });
-                    }
-                } else {
-                    // load remaining modules in global scope
-                    pc.WasmModule.getInstance(m.moduleName, () => { moduleLoaded(); });
-                }
-            } else {
-                moduleLoaded();
-            }
-        });
-    }
-};
-
-window.loadModules = loadModules;

package/dist/templates/__settings__.template.js

@@ -1,20 +0,0 @@
-window.ASSET_PREFIX = "";
-window.SCRIPT_PREFIX = "";
-window.SCENE_PATH = "{{SCENE_PATH}}";
-window.CONTEXT_OPTIONS = {
-    'antialias': {{ANTIALIAS}},
-    'alpha': false,
-    'preserveDrawingBuffer': {{PRESERVE_DRAWING_BUFFER}},
-    'deviceTypes': [`webgl2`, `webgl1`],
-    'powerPreference': "{{POWER_PREFERENCE}}"
-};
-window.SCRIPTS = {{SCRIPTS}};
-window.CONFIG_FILENAME = "config.json";
-window.INPUT_SETTINGS = {
-    useKeyboard: {{USE_KEYBOARD}},
-    useMouse: {{USE_MOUSE}},
-    useGamepads: {{USE_GAMEPAD}},
-    useTouch: {{USE_TOUCH}}
-};
-pc.script.legacy = {{USE_LEGACY_SCRIPTS}};
-window.PRELOAD_MODULES = {{PRELOAD_MODULES}};