@playcraft/build 0.0.48 → 0.0.50

package/dist/engines/playable-scripts-adapter.d.ts

@@ -15,8 +15,12 @@ export declare class PlayableScriptsAdapter {
     private projectDir;
     private options;
     private config?;
+    private projectBuildsConfig?;
     private static readonly DEFAULTS;
     constructor(projectDir: string, options: BaseBuildOptions, config?: PlayableScriptsConfig);
+    private loadProjectBuildsConfig;
+    private resolveObfuscateLevel;
+    private resolveFflateCompression;
     /**
      * 执行 playable-scripts 构建
      *
@@ -156,6 +160,11 @@ export declare class PlayableScriptsAdapter {
      */
     private getPlatformFilename;
     private runDevkitOutputValidation;
+    /**
+     * Devkit 产物会跳过 ViteBuilder，必须在这里补齐 PlayCraft 生命周期到渠道接口的桥接。
+     * 普通构建链由对应 PlatformAdapter 处理。
+     */
+    private applyChannelLifecycleBridges;
     private getValidationChannels;
     private isSupportedValidationChannel;
     private pickArtifactForChannel;

package/dist/engines/playable-scripts-adapter.js

@@ -3,6 +3,8 @@ import path from 'path';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { strFromU8, strToU8, unzipSync, zipSync } from 'fflate';
+import { injectBigoLifecycleBridge } from '../platforms/bigo-lifecycle.js';
 import { formatValidationSummary, hasBlockingValidationErrors, runPlayableValidation, saveValidationReport, } from '../validation/index.js';
 // ESM 兼容：获取当前模块的目录路径
 const __filename = fileURLToPath(import.meta.url);
@@ -20,7 +22,7 @@ const CHANNEL_MAP = {
 /**
  * PlayCraft 不支持的渠道（playable-scripts 不认识的 PlayCraft 平台）
  */
-const UNSUPPORTED_CHANNELS = new Set(['remerge', 'mintegral']);
+const UNSUPPORTED_CHANNELS = new Set(['remerge']);
 /**
  * 将 PlayCraft 平台名映射为 playable-scripts 渠道名
  */
@@ -49,6 +51,42 @@ export class PlayableScriptsAdapter {
             console.log(`[PlayableScriptsAdapter] 目标渠道: ${config.channels.join(', ')}`);
         }
     }
+    loadProjectBuildsConfig(configPath) {
+        try {
+            const resolvedPath = require.resolve(configPath);
+            delete require.cache[resolvedPath];
+            const loaded = require(resolvedPath);
+            if (loaded && typeof loaded === 'object' && !Array.isArray(loaded)) {
+                return loaded;
+            }
+        }
+        catch (error) {
+            console.warn(`[PlayableScriptsAdapter] Failed to read builds.config.js build params, using PlayCraft defaults: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return undefined;
+    }
+    resolveObfuscateLevel() {
+        const explicitValue = this.config?.obfuscateLevel;
+        if (typeof explicitValue === 'number' && Number.isFinite(explicitValue)) {
+            return explicitValue;
+        }
+        const projectValue = this.projectBuildsConfig?.obfuscateLevel;
+        if (typeof projectValue === 'number' && Number.isFinite(projectValue)) {
+            return projectValue;
+        }
+        return PlayableScriptsAdapter.DEFAULTS.obfuscateLevel;
+    }
+    resolveFflateCompression() {
+        const explicitValue = this.config?.fflateCompression;
+        if (typeof explicitValue === 'boolean') {
+            return explicitValue;
+        }
+        const projectValue = this.projectBuildsConfig?.fflateCompression;
+        if (typeof projectValue === 'boolean') {
+            return projectValue;
+        }
+        return PlayableScriptsAdapter.DEFAULTS.fflateCompression;
+    }
     /**
      * 执行 playable-scripts 构建
      *
@@ -93,6 +131,7 @@ export class PlayableScriptsAdapter {
         const outputs = await this.collectOutputs();
         // 7. 复制产物到 PlayCraft outputDir
         const files = await this.copyToOutputDir(outputs);
+        await this.applyChannelLifecycleBridges(files);
         await this.runDevkitOutputValidation(files);
         // 7. 构建元数据
         const metadata = {
@@ -149,10 +188,12 @@ export class PlayableScriptsAdapter {
         let configContent;
         try {
             configContent = await fs.readFile(configPath, 'utf-8');
+            this.projectBuildsConfig = this.loadProjectBuildsConfig(configPath);
             console.log('[PlayableScriptsAdapter] 读取现有 builds.config.js');
         }
         catch {
             configContent = 'module.exports = {};';
+            this.projectBuildsConfig = undefined;
             console.log('[PlayableScriptsAdapter] builds.config.js 不存在，将创建');
         }
         // 构建注入内容
@@ -225,11 +266,11 @@ export class PlayableScriptsAdapter {
     buildCLIArgs() {
         const config = this.config ?? {};
         const args = [];
-        // 混淆等级：config 指定 > PlayCraft 强制默认 4
-        const obfuscateLevel = config.obfuscateLevel ?? PlayableScriptsAdapter.DEFAULTS.obfuscateLevel;
+        // 混淆等级：config 指定 > 项目 builds.config.js > PlayCraft 默认 4
+        const obfuscateLevel = this.resolveObfuscateLevel();
         args.push('--obfuscate-level', `${obfuscateLevel}`);
-        // fflate 压缩：config 指定 > PlayCraft 强制默认 true
-        const fflate = config.fflateCompression ?? PlayableScriptsAdapter.DEFAULTS.fflateCompression;
+        // fflate 压缩：config 指定 > 项目 builds.config.js > PlayCraft 默认 true
+        const fflate = this.resolveFflateCompression();
         args.push('--fflate-compression', `${fflate}`);
         // 渠道列表
         if (config.channels && config.channels.length > 0) {
@@ -280,8 +321,8 @@ export class PlayableScriptsAdapter {
     // ==================== 3. 日志输出 ====================
     logBuildParams() {
         const config = this.config ?? {};
-        const obfuscateLevel = config.obfuscateLevel ?? PlayableScriptsAdapter.DEFAULTS.obfuscateLevel;
-        const fflate = config.fflateCompression ?? PlayableScriptsAdapter.DEFAULTS.fflateCompression;
+        const obfuscateLevel = this.resolveObfuscateLevel();
+        const fflate = this.resolveFflateCompression();
         const levelLabels = {
             1: 'minimum - 基础',
             2: 'medium - 中等',
@@ -1282,6 +1323,34 @@ export class PlayableScriptsAdapter {
             }
         }
     }
+    /**
+     * Devkit 产物会跳过 ViteBuilder，必须在这里补齐 PlayCraft 生命周期到渠道接口的桥接。
+     * 普通构建链由对应 PlatformAdapter 处理。
+     */
+    async applyChannelLifecycleBridges(files) {
+        const channels = this.getValidationChannels();
+        if (!channels.includes('bigo')) {
+            return;
+        }
+        const artifacts = files.assets.filter((file) => file.endsWith('.html') || file.endsWith('.zip'));
+        const artifact = this.pickArtifactForChannel('bigo', artifacts);
+        if (!artifact) {
+            return;
+        }
+        if (artifact.toLowerCase().endsWith('.html')) {
+            const html = await fs.readFile(artifact, 'utf8');
+            await fs.writeFile(artifact, injectBigoLifecycleBridge(html), 'utf8');
+            return;
+        }
+        const archive = unzipSync(await fs.readFile(artifact));
+        const htmlEntry = Object.keys(archive).find((entry) => /(?:^|\/)index\.html$/i.test(entry))
+            ?? Object.keys(archive).find((entry) => /\.html$/i.test(entry));
+        if (!htmlEntry) {
+            throw new Error(`[PlayableScriptsAdapter] BIGO ZIP artifact has no HTML entry: ${artifact}`);
+        }
+        archive[htmlEntry] = strToU8(injectBigoLifecycleBridge(strFromU8(archive[htmlEntry])));
+        await fs.writeFile(artifact, zipSync(archive, { level: 9 }));
+    }
     getValidationChannels() {
         if (this.options.validation?.channel) {
             return [this.options.validation.channel];
@@ -1313,9 +1382,13 @@ export class PlayableScriptsAdapter {
         if (artifacts.length === 1) {
             return artifacts[0];
         }
+        const mappedChannel = mapChannel(channel).toLowerCase();
         const direct = artifacts.find((artifact) => {
             const normalized = artifact.replace(/\\/g, '/').toLowerCase();
-            return normalized.includes(`/${channel}/`) || normalized.includes(`-${channel}.`);
+            return normalized.includes(`/${channel}/`)
+                || normalized.includes(`-${channel}.`)
+                || normalized.includes(`/${mappedChannel}/`)
+                || normalized.includes(`-${mappedChannel}.`);
         });
         return direct ?? artifacts[0];
     }

package/dist/platforms/bigo-lifecycle.d.ts

@@ -0,0 +1,6 @@
+export declare const BIGO_LIFECYCLE_BRIDGE_MARKER = "data-playcraft-bigo-lifecycle";
+/**
+ * 把 PlayCraft Ads SDK (Advertising Software Development Kit, 广告软件开发工具包)
+ * 的 playcraftFinish 事件桥接到 BIGO 渠道结束接口。通过 marker 保证多条构建链重复处理时幂等。
+ */
+export declare function injectBigoLifecycleBridge(html: string): string;

package/dist/platforms/bigo-lifecycle.js

@@ -0,0 +1,35 @@
+export const BIGO_LIFECYCLE_BRIDGE_MARKER = 'data-playcraft-bigo-lifecycle';
+const BIGO_LIFECYCLE_BRIDGE = `<script ${BIGO_LIFECYCLE_BRIDGE_MARKER}>(function(){
+  var gameEndSent=false;
+  var bindAttempts=0;
+  function notifyGameEnd(){
+    if(gameEndSent)return;
+    if(!window.BGY_MRAID||typeof window.BGY_MRAID.gameEnd!=="function")return;
+    gameEndSent=true;
+    window.BGY_MRAID.gameEnd();
+  }
+  function bindPlayableSdk(){
+    var playableSdk=window.PlayableSDK;
+    if(playableSdk&&typeof playableSdk.once==="function"){
+      if(playableSdk.isFinished===true){notifyGameEnd();return;}
+      playableSdk.once("playcraftFinish",notifyGameEnd);
+      return;
+    }
+    bindAttempts+=1;
+    if(bindAttempts<300)window.setTimeout(bindPlayableSdk,100);
+  }
+  bindPlayableSdk();
+})();</script>`;
+/**
+ * 把 PlayCraft Ads SDK (Advertising Software Development Kit, 广告软件开发工具包)
+ * 的 playcraftFinish 事件桥接到 BIGO 渠道结束接口。通过 marker 保证多条构建链重复处理时幂等。
+ */
+export function injectBigoLifecycleBridge(html) {
+    if (html.includes(BIGO_LIFECYCLE_BRIDGE_MARKER)) {
+        return html;
+    }
+    if (/<\/head>/i.test(html)) {
+        return html.replace(/<\/head>/i, `${BIGO_LIFECYCLE_BRIDGE}</head>`);
+    }
+    return `${BIGO_LIFECYCLE_BRIDGE}${html}`;
+}

package/dist/platforms/bigo.js

@@ -1,4 +1,5 @@
 import { PlatformAdapter } from './base.js';
+import { injectBigoLifecycleBridge } from './bigo-lifecycle.js';
 export class BigoAdapter extends PlatformAdapter {
     getName() {
         return 'BIGO Ads';
@@ -39,6 +40,7 @@ export class BigoAdapter extends PlatformAdapter {
         const comment = `<!-- BIGO: HTML/ZIP format, config.json includes orientation when present, use BGY_MRAID.open() -->`;
         // 在 </head> 之前插入
         html = html.replace('</head>', `${sdkScript}${fallbackScript}${comment}</head>`);
+        html = injectBigoLifecycleBridge(html);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
         html = await this.injectTrackingAdapterAsync(html);

package/dist/platforms/unity.js

@@ -1,4 +1,35 @@
 import { PlatformAdapter } from './base.js';
+const CHARSET_META_PATTERN = /<meta\b(?=[^>]*(?:\bcharset\s*=|\bhttp-equiv\s*=\s*(?:["']content-type["']|content-type)\b))[^>]*>/i;
+function maskHeadRawText(content) {
+    return content.replace(/<!--[\s\S]*?(?:-->|$)|<(script|style|template|noscript)\b[^>]*>[\s\S]*?(?:<\/\1\s*>|$)/gi, (match) => match.replace(/[^\r\n]/g, ' '));
+}
+function injectUnityGate(html, gateMarkup) {
+    const headMatch = /<head(?:\s[^>]*)?>/i.exec(html);
+    if (!headMatch) {
+        // 无 head 的非标准文档不做节点重排：优先在首个业务脚本前注入。
+        const firstScript = /<script\b/i.exec(html);
+        if (firstScript) {
+            return `${html.slice(0, firstScript.index)}${gateMarkup}${html.slice(firstScript.index)}`;
+        }
+        const bodyClose = /<\/body>/i.exec(html);
+        if (bodyClose) {
+            return `${html.slice(0, bodyClose.index)}${gateMarkup}${html.slice(bodyClose.index)}`;
+        }
+        return `${html}${gateMarkup}`;
+    }
+    const headEnd = headMatch.index + headMatch[0].length;
+    const headCloseMatch = /<\/head>/i.exec(html.slice(headEnd));
+    const headContentEnd = headCloseMatch ? headEnd + headCloseMatch.index : html.length;
+    const headContent = html.slice(headEnd, headContentEnd);
+    const charsetMatch = CHARSET_META_PATTERN.exec(maskHeadRawText(headContent));
+    if (!charsetMatch) {
+        return `${html.slice(0, headEnd)}${gateMarkup}${html.slice(headEnd)}`;
+    }
+    // charset 必须位于文档开头区域；移动到 head 首位后再注入门控，确保门控仍早于业务脚本。
+    const charsetStart = headEnd + charsetMatch.index;
+    const htmlWithoutCharset = html.slice(0, charsetStart) + html.slice(charsetStart + charsetMatch[0].length);
+    return `${htmlWithoutCharset.slice(0, headEnd)}${charsetMatch[0]}${gateMarkup}${htmlWithoutCharset.slice(headEnd)}`;
+}
 export class UnityAdapter extends PlatformAdapter {
     getName() {
         return 'Unity Ads';
@@ -11,10 +42,19 @@ export class UnityAdapter extends PlatformAdapter {
         return 'html';
     }
     async modifyHTML(html, assets) {
-        // Unity Ads 需要 MRAID 3.0 支持
-        const unityScriptCode = `
+        const unityScript = await this.minifyPlatformScript(this.getPlatformScript(), 'unity-mraid');
+        const comment = `<!-- Unity Ads: MRAID 2.0, 等待viewableChange, 使用mraid.open() -->`;
+        // 保留 charset 在文档开头，同时确保可见性门控早于首个业务脚本。
+        html = injectUnityGate(html, `${unityScript}${comment}`);
+        // 注入统一的 CTA 适配器
+        html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
+        return html;
+    }
+    getPlatformScript() {
+        return `
       window.mraid = window.mraid || {
-        getVersion: function() { return '3.0'; },
+        getVersion: function() { return '2.0'; },
         isReady: function() { return true; },
         open: function(url) { 
           console.log('Unity Ads CTA: opening store');
@@ -25,8 +65,10 @@ export class UnityAdapter extends PlatformAdapter {
         },
         close: function() { window.close(); },
         addEventListener: function(event, listener) {
-          if (event === 'ready' || event === 'viewableChange') {
-            setTimeout(function() { listener({ viewable: true }); }, 0);
+          if (event === 'ready') {
+            setTimeout(function() { listener(); }, 0);
+          } else if (event === 'viewableChange') {
+            setTimeout(function() { listener(true); }, 0);
           }
         },
         removeEventListener: function(event, listener) {},
@@ -37,29 +79,79 @@ export class UnityAdapter extends PlatformAdapter {
         getCurrentPosition: function() { return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight }; },
         getScreenSize: function() { return { width: screen.width, height: screen.height }; }
       };
-    `;
-        const unityScript = await this.minifyPlatformScript(unityScriptCode, 'unity-mraid');
-        const comment = `<!-- Unity Ads: MRAID 3.0, 等待viewableChange, 使用mraid.open() -->`;
-        // 在 </head> 之前插入
-        html = html.replace('</head>', `${unityScript}${comment}</head>`);
-        // 注入统一的 CTA 适配器
-        html = await this.injectCTAAdapterAsync(html);
-        html = await this.injectTrackingAdapterAsync(html);
-        return html;
-    }
-    getPlatformScript() {
-        return `
-      // Unity Ads Playable
-      // 等待 viewableChange 事件
-      
-      if (typeof mraid !== 'undefined') {
-        mraid.addEventListener('viewableChange', function(viewable) {
+
+      (function() {
+        var nativeRequestAnimationFrame = window.requestAnimationFrame
+          ? window.requestAnimationFrame.bind(window)
+          : function(callback) {
+              return window.setTimeout(function() { callback(Date.now()); }, 16);
+            };
+        var nativeCancelAnimationFrame = window.cancelAnimationFrame
+          ? window.cancelAnimationFrame.bind(window)
+          : window.clearTimeout.bind(window);
+        var queuedFrames = [];
+        var nextQueuedFrameId = -1;
+        var viewable = false;
+        var previousVisibility = document.documentElement.style.visibility;
+
+        window.__PLAYCRAFT_UNITY_VIEWABLE__ = false;
+        document.documentElement.style.visibility = 'hidden';
+
+        window.requestAnimationFrame = function(callback) {
           if (viewable) {
-            console.log('Unity Ads: playable is viewable, starting game');
-            // 这里启动游戏内容
+            return nativeRequestAnimationFrame(callback);
           }
-        });
-      }
+          var id = nextQueuedFrameId--;
+          queuedFrames.push({ id: id, callback: callback });
+          return id;
+        };
+
+        window.cancelAnimationFrame = function(id) {
+          if (id < 0) {
+            queuedFrames = queuedFrames.filter(function(frame) { return frame.id !== id; });
+            return;
+          }
+          nativeCancelAnimationFrame(id);
+        };
+
+        function dispatchLifecycleEvent(name) {
+          var event = document.createEvent('Event');
+          event.initEvent(name, false, false);
+          window.dispatchEvent(event);
+        }
+
+        function setViewable(nextViewable) {
+          var normalizedViewable = nextViewable === true;
+          if (viewable === normalizedViewable) {
+            return;
+          }
+          viewable = normalizedViewable;
+          window.__PLAYCRAFT_UNITY_VIEWABLE__ = viewable;
+          document.documentElement.style.visibility = viewable ? previousVisibility : 'hidden';
+
+          if (!viewable) {
+            dispatchLifecycleEvent('playcraft:unity-hidden');
+            return;
+          }
+
+          var pendingFrames = queuedFrames;
+          queuedFrames = [];
+          pendingFrames.forEach(function(frame) {
+            nativeRequestAnimationFrame(frame.callback);
+          });
+          dispatchLifecycleEvent('playcraft:unity-viewable');
+        }
+
+        function onSdkReady() {
+          mraid.addEventListener('viewableChange', setViewable);
+        }
+
+        if (typeof mraid.getState === 'function' && mraid.getState() === 'loading') {
+          mraid.addEventListener('ready', onSdkReady);
+        } else {
+          onSdkReady();
+        }
+      })();
     `;
     }
     validateOptions() {

package/dist/validation/profiles.js

@@ -160,13 +160,12 @@ export const CHANNEL_RULE_PROFILES = {
     ], { optionalStages: ['delivery-package', 'runtime-manual'], deliveryPackageFormat: 'mixed' }),
     tiktok: profile('tiktok', 'TikTok / Pangle', 'zip', [
         forbiddenPatternRule('tiktok', 'sdk.mraid-js.forbidden', 'TikTok/Pangle creatives should not include mraid.js.', 'mraid\\.js', 'Remove mraid.js; Pangle integration belongs to the channel SDK.'),
-        forbiddenPatternRule('tiktok', 'redirect.javascript.forbidden', 'TikTok/Pangle creatives should not contain JavaScript redirects.', '\\blocation\\.(href|assign|replace)\\b|window\\.open\\s*\\(', 'Remove automatic redirects and delegate store jumps to Pangle.'),
+        forbiddenPatternRule('tiktok', 'redirect.javascript.forbidden', 'TikTok/Pangle creatives should not contain direct location redirects.', '\\blocation\\.(href|assign|replace)\\b', 'Remove direct location redirects. CTA handling is injected by @playcraft/devkit and delegated to Pangle.'),
     ], { optionalStages: ['delivery-package'], deliveryPackageFormat: 'zip', devkitOwned: true, internalBuildFormat: 'delegated' }),
     unity: profile('unity', 'Unity Ads', 'single-html', [
-        sourcePresenceRule('unity', 'mraid.viewable-change.required', 'Unity requires MRAID viewableChange before gameplay starts.', 'Add a viewableChange listener before starting playable content.'),
         externalResourceRule('unity'),
         requiredPatternRule('unity', 'cta.mraid-open.required', 'Unity CTA should use mraid.open().', '\\bmraid\\.open\\s*\\(', 'Route the CTA directly to the store through mraid.open().'),
-        requiredPatternRule('unity', 'mraid.viewable-change.required', 'Unity playable should wait for MRAID viewableChange.', 'viewableChange', 'Wait for the MRAID viewableChange event before starting gameplay.'),
+        requiredPatternRule('unity', 'mraid.viewable-change.required', 'Unity playable should wait for MRAID viewableChange.', `mraid\\.addEventListener\\s*\\(\\s*['"]viewableChange['"]`, 'Wait for the MRAID viewableChange event before starting gameplay.'),
         manualRule('unity', 'runtime.orientation-and-start.manual', 'Orientation support and gameplay start timing need runtime review.', 'Verify portrait/landscape support and that gameplay waits for viewability.'),
     ], { optionalStages: ['runtime-manual'] }),
     ironsource: profile('ironsource', 'ironSource', 'mixed', [
@@ -184,7 +183,7 @@ export const CHANNEL_RULE_PROFILES = {
         manualRule('moloco', 'runtime.portrait-responsive.manual', 'Portrait responsive behavior needs runtime review.', 'Verify portrait layout and CTA visibility.'),
     ], { optionalStages: ['runtime-manual'] }),
     bigo: profile('bigo', 'BIGO', 'zip', [
-        sourcePresenceRule('bigo', 'lifecycle.game-end.required', 'BIGO requires window.BGY_MRAID.gameEnd() when gameplay ends.', 'Call window.BGY_MRAID.gameEnd() when gameplay ends.'),
+        sourcePresenceRule('bigo', 'lifecycle.game-end.required', 'BIGO requires a gameplay finish signal.', 'Call sdk.playcraftFinish() when gameplay ends; the BIGO channel build maps it to window.BGY_MRAID.gameEnd().'),
         externalResourceRule('bigo', ['static-web.likeevideo.com']),
         requiredPatternRule('bigo', 'cta.bgy-open.required', 'BIGO CTA should use window.BGY_MRAID.open().', 'window\\.BGY_MRAID\\.open\\s*\\(', 'Route CTA clicks through window.BGY_MRAID.open().'),
         requiredPatternRule('bigo', 'lifecycle.game-end.required', 'BIGO creatives should call window.BGY_MRAID.gameEnd().', 'window\\.BGY_MRAID\\.gameEnd\\s*\\(', 'Call gameEnd() when gameplay ends.'),
@@ -203,8 +202,8 @@ export const CHANNEL_RULE_PROFILES = {
         forbiddenPatternRule('remerge', 'redirect.auto.forbidden', 'Remerge creatives should not auto-redirect to the store.', '\\blocation\\.(href|assign|replace)\\b', 'Keep store jumps behind a user CTA.'),
     ]),
     mintegral: profile('mintegral', 'Mintegral', 'mixed', [
-        sourcePresenceRule('mintegral', 'lifecycle.sdk-finish.required', 'Mintegral requires sdk.finish() after gameplay ends.', 'Call sdk.finish() when gameplay reaches win or end state.'),
-        requiredPatternRule('mintegral', 'lifecycle.sdk-finish.required', 'Mintegral creatives should call sdk.finish() after win or end.', '\\bsdk\\.finish\\s*\\(', 'Call sdk.finish() at the end of gameplay.'),
+        sourcePresenceRule('mintegral', 'lifecycle.game-end.required', 'Mintegral requires a gameplay finish signal.', 'Call sdk.playcraftFinish() when gameplay reaches a win or end state.'),
+        requiredPatternRule('mintegral', 'lifecycle.game-end.required', 'Mintegral creatives should call window.gameEnd() after gameplay ends.', 'window\\.gameEnd\\s*\\(', 'Map the gameplay finish signal to window.gameEnd().'),
         forbiddenPatternRule('mintegral', 'redirect.auto.forbidden', 'Mintegral creatives should not auto-redirect to the store.', '\\blocation\\.(href|assign|replace)\\b', 'Keep store jumps behind a user CTA.'),
         externalValidatorRule('mintegral', 'Mindworks testing should be used before delivery.', 'Validate through the Mintegral/Mindworks testing entry.'),
     ], { optionalStages: ['external-validator'], deliveryPackageFormat: 'mixed' }),

package/dist/validation/source-scanner.js

@@ -54,22 +54,12 @@ const COMMON_SOURCE_PATTERNS = [
     },
 ];
 const CHANNEL_SOURCE_PATTERNS = {
-    unity: [
-        {
-            ruleId: 'unity.mraid.viewable-change.required',
-            pattern: /viewableChange/g,
-            message: 'Unity requires waiting for MRAID viewableChange before starting playable content.',
-            recommendation: 'Add a viewableChange listener and start gameplay only after the ad is viewable.',
-            severity: 'error',
-            confidence: 'high',
-        },
-    ],
     mintegral: [
         {
-            ruleId: 'mintegral.lifecycle.sdk-finish.required',
-            pattern: /\bsdk\.finish\s*\(/g,
-            message: 'Mintegral requires sdk.finish() after gameplay ends.',
-            recommendation: 'Call sdk.finish() when the win or end state is reached.',
+            ruleId: 'mintegral.lifecycle.game-end.required',
+            pattern: /(?:\b[\w$]+(?:\?\.|\.)playcraftFinish(?:\?\.)?|window(?:\?\.|\.)gameEnd(?:\?\.)?)\s*\(/g,
+            message: 'Mintegral requires a gameplay finish signal.',
+            recommendation: 'Call sdk.playcraftFinish() when the win or end state is reached; the channel build maps it to window.gameEnd().',
             severity: 'error',
             confidence: 'high',
         },
@@ -77,9 +67,9 @@ const CHANNEL_SOURCE_PATTERNS = {
     bigo: [
         {
             ruleId: 'bigo.lifecycle.game-end.required',
-            pattern: /window\.BGY_MRAID\.gameEnd\s*\(/g,
-            message: 'BIGO requires window.BGY_MRAID.gameEnd() when gameplay ends.',
-            recommendation: 'Call window.BGY_MRAID.gameEnd() at the end of gameplay.',
+            pattern: /(?:\b[\w$]+(?:\?\.|\.)playcraftFinish(?:\?\.)?|window(?:\?\.|\.)BGY_MRAID(?:\?\.|\.)gameEnd(?:\?\.)?)\s*\(/g,
+            message: 'BIGO requires a gameplay finish signal.',
+            recommendation: 'Call sdk.playcraftFinish() when gameplay ends; the BIGO channel build maps it to window.BGY_MRAID.gameEnd().',
             severity: 'error',
             confidence: 'high',
         },
@@ -130,7 +120,7 @@ async function scanSourceFilesForChannel(context, sourceFiles, includeCommonPatt
             if (matchedRequiredRuleIds.has(pattern.ruleId)) {
                 continue;
             }
-            const match = content.match(pattern.pattern);
+            const match = findExecutableSourcePattern(filePath, content, pattern.pattern);
             if (match) {
                 matchedRequiredRuleIds.add(pattern.ruleId);
                 results.push({
@@ -142,8 +132,8 @@ async function scanSourceFilesForChannel(context, sourceFiles, includeCommonPatt
                     message: `${pattern.message}: passed`,
                     recommendation: pattern.recommendation,
                     file: filePath,
-                    line: lineOfIndex(content, content.search(pattern.pattern)),
-                    evidence: trimEvidence(match[0]),
+                    line: lineOfIndex(content, match.index),
+                    evidence: trimEvidence(match.evidence),
                     owner: ownerForContext(context),
                     confidence: pattern.confidence,
                 });
@@ -153,6 +143,278 @@ async function scanSourceFilesForChannel(context, sourceFiles, includeCommonPatt
     results.push(...missingRequiredPatternResults(context, matchedRequiredRuleIds));
     return results;
 }
+function findExecutableSourcePattern(filePath, content, pattern) {
+    const executableSource = maskNonExecutableSource(filePath, content);
+    const expression = new RegExp(pattern.source, pattern.flags);
+    expression.lastIndex = 0;
+    const match = expression.exec(executableSource);
+    if (!match || match.index == null) {
+        return null;
+    }
+    return {
+        index: match.index,
+        evidence: content.slice(match.index, match.index + match[0].length),
+    };
+}
+function maskNonExecutableSource(filePath, content) {
+    const extension = path.extname(filePath).toLowerCase();
+    if (extension === '.css') {
+        return blankSource(content);
+    }
+    if (extension === '.html') {
+        return maskHtmlSource(content);
+    }
+    return maskJavaScriptLikeSource(content);
+}
+function maskHtmlSource(content) {
+    const masked = blankSource(content).split('');
+    const lowerContent = content.toLowerCase();
+    let cursor = 0;
+    while (cursor < content.length) {
+        const commentStart = lowerContent.indexOf('<!--', cursor);
+        const scriptStart = lowerContent.indexOf('<script', cursor);
+        if (scriptStart < 0) {
+            break;
+        }
+        if (commentStart >= 0 && commentStart < scriptStart) {
+            const commentEnd = lowerContent.indexOf('-->', commentStart + 4);
+            cursor = commentEnd < 0 ? content.length : commentEnd + 3;
+            continue;
+        }
+        const tagEnd = findHtmlTagEnd(content, scriptStart + 7);
+        if (tagEnd < 0) {
+            break;
+        }
+        const openTag = content.slice(scriptStart, tagEnd + 1);
+        const closeTagStart = lowerContent.indexOf('</script', tagEnd + 1);
+        const scriptEnd = closeTagStart < 0 ? content.length : closeTagStart;
+        if (isExecutableScriptTag(openTag)) {
+            const scriptSource = content.slice(tagEnd + 1, scriptEnd);
+            const maskedScript = maskJavaScriptLikeSource(scriptSource);
+            for (let index = 0; index < maskedScript.length; index += 1) {
+                masked[tagEnd + 1 + index] = maskedScript[index];
+            }
+        }
+        if (closeTagStart < 0) {
+            break;
+        }
+        const closeTagEnd = findHtmlTagEnd(content, closeTagStart + 8);
+        cursor = closeTagEnd < 0 ? content.length : closeTagEnd + 1;
+    }
+    return masked.join('');
+}
+function findHtmlTagEnd(content, start) {
+    let quote = null;
+    for (let index = start; index < content.length; index += 1) {
+        const character = content[index];
+        if (quote) {
+            if (character === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            continue;
+        }
+        if (character === '>') {
+            return index;
+        }
+    }
+    return -1;
+}
+function isExecutableScriptTag(openTag) {
+    const typeMatch = openTag.match(/\btype\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i);
+    if (!typeMatch) {
+        return true;
+    }
+    const type = (typeMatch[1] ?? typeMatch[2] ?? typeMatch[3] ?? '').trim().toLowerCase();
+    if (!type) {
+        return true;
+    }
+    const mimeType = type.split(';', 1)[0].trim();
+    return mimeType === 'module' || /^(?:text|application)\/(?:java|ecma)script$/.test(mimeType);
+}
+function maskJavaScriptLikeSource(content) {
+    const masked = content.split('');
+    const maskAt = (index) => {
+        if (content[index] !== '\n' && content[index] !== '\r') {
+            masked[index] = ' ';
+        }
+    };
+    const maskRange = (start, end) => {
+        for (let index = start; index < end; index += 1) {
+            maskAt(index);
+        }
+    };
+    const scanQuoted = (start, quote) => {
+        let index = start + 1;
+        while (index < content.length) {
+            if (content[index] === '\\') {
+                index = Math.min(content.length, index + 2);
+                continue;
+            }
+            if (content[index] === quote) {
+                index += 1;
+                break;
+            }
+            index += 1;
+        }
+        maskRange(start, index);
+        return index;
+    };
+    const scanLineComment = (start) => {
+        let index = start + 2;
+        while (index < content.length && content[index] !== '\n' && content[index] !== '\r') {
+            index += 1;
+        }
+        maskRange(start, index);
+        return index;
+    };
+    const scanBlockComment = (start, closingToken) => {
+        const closingIndex = content.indexOf(closingToken, start + 2);
+        const end = closingIndex < 0 ? content.length : closingIndex + closingToken.length;
+        maskRange(start, end);
+        return end;
+    };
+    const previousSignificantIndex = (start) => {
+        for (let index = start; index >= 0; index -= 1) {
+            if (!/\s/.test(masked[index])) {
+                return index;
+            }
+        }
+        return -1;
+    };
+    const isRegexStart = (index) => {
+        if (content[index + 1] === '=') {
+            return false;
+        }
+        const previousIndex = previousSignificantIndex(index - 1);
+        if (previousIndex < 0) {
+            return true;
+        }
+        if (/[([{,:;=!?&|+\-*%^~<>}]/.test(masked[previousIndex])) {
+            return true;
+        }
+        let wordStart = previousIndex;
+        while (wordStart >= 0 && /[\w$]/.test(masked[wordStart])) {
+            wordStart -= 1;
+        }
+        const previousWord = masked.slice(wordStart + 1, previousIndex + 1).join('');
+        return /^(?:await|case|delete|do|else|in|instanceof|new|of|return|throw|typeof|void|yield)$/.test(previousWord);
+    };
+    const scanRegex = (start) => {
+        let index = start + 1;
+        let inCharacterClass = false;
+        while (index < content.length) {
+            const character = content[index];
+            if (character === '\n' || character === '\r') {
+                break;
+            }
+            if (character === '\\') {
+                index = Math.min(content.length, index + 2);
+                continue;
+            }
+            if (character === '[') {
+                inCharacterClass = true;
+            }
+            else if (character === ']') {
+                inCharacterClass = false;
+            }
+            else if (character === '/' && !inCharacterClass) {
+                index += 1;
+                while (index < content.length && /[a-z]/i.test(content[index])) {
+                    index += 1;
+                }
+                break;
+            }
+            index += 1;
+        }
+        maskRange(start, index);
+        return index;
+    };
+    let scanCode;
+    const scanTemplate = (start) => {
+        maskAt(start);
+        let index = start + 1;
+        while (index < content.length) {
+            if (content[index] === '\\') {
+                maskAt(index);
+                if (index + 1 < content.length) {
+                    maskAt(index + 1);
+                }
+                index += 2;
+                continue;
+            }
+            if (content[index] === '`') {
+                maskAt(index);
+                return index + 1;
+            }
+            if (content[index] === '$' && content[index + 1] === '{') {
+                maskAt(index);
+                maskAt(index + 1);
+                index = scanCode(index + 2, true);
+                continue;
+            }
+            maskAt(index);
+            index += 1;
+        }
+        return index;
+    };
+    scanCode = (start, interpolation) => {
+        let index = start;
+        let braceDepth = interpolation ? 1 : 0;
+        while (index < content.length) {
+            const character = content[index];
+            const nextCharacter = content[index + 1];
+            if (interpolation && character === '{') {
+                braceDepth += 1;
+                index += 1;
+                continue;
+            }
+            if (interpolation && character === '}') {
+                braceDepth -= 1;
+                if (braceDepth === 0) {
+                    maskAt(index);
+                    return index + 1;
+                }
+                index += 1;
+                continue;
+            }
+            if (character === '"' || character === "'") {
+                index = scanQuoted(index, character);
+                continue;
+            }
+            if (character === '`') {
+                index = scanTemplate(index);
+                continue;
+            }
+            if (character === '/' && nextCharacter === '/') {
+                index = scanLineComment(index);
+                continue;
+            }
+            if (character === '/' && nextCharacter === '*') {
+                index = scanBlockComment(index, '*/');
+                continue;
+            }
+            if (character === '<' && content.startsWith('<!--', index)) {
+                index = scanBlockComment(index, '-->');
+                continue;
+            }
+            if (character === '/' && isRegexStart(index)) {
+                index = scanRegex(index);
+                continue;
+            }
+            index += 1;
+        }
+        return index;
+    };
+    scanCode(0, false);
+    return masked.join('');
+}
+function blankSource(content) {
+    return content.replace(/[^\r\n]/g, ' ');
+}
 function evaluateSourcePatternForChannel(context, channel, filePath, content, sourcePattern) {
     const matches = Array.from(content.matchAll(sourcePattern.pattern));
     return matches.slice(0, 10).map((match) => ({

package/dist/vite/platform-configs.js

@@ -218,7 +218,7 @@ export const PLATFORM_CONFIGS = {
         minifyJS: true,
         compressImages: false, // 禁用图片压缩，原图输出效果更好
         compressModels: true,
-        injectScripts: ['mraid3'],
+        injectScripts: ['mraid'],
         outputFileName: 'index.html',
         includeSourcemap: false,
         imageQuality: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.48",
+  "version": "0.0.50",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +42,7 @@
     "@vheemstra/vite-plugin-imagemin": "^2.2.1",
     "archiver": "^7.0.1",
     "draco3dgltf": "^1.5.7",
+    "fflate": "^0.8.2",
     "imagemin-mozjpeg": "^10.0.0",
     "imagemin-pngquant": "^10.0.0",
     "imagemin-webp": "^8.0.0",
@@ -59,7 +60,6 @@
     "@types/archiver": "^6.0.4",
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.19.8",
-    "fflate": "^0.8.2",
     "typescript": "^5.9.3"
   }
 }