@playcraft/build 0.0.2

package/dist/platforms/bigo.js

@@ -0,0 +1,77 @@
+import { PlatformAdapter } from './base.js';
+export class BigoAdapter extends PlatformAdapter {
+    getName() {
+        return 'BIGO Ads';
+    }
+    getSizeLimit() {
+        // BIGO Ads: 5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'zip';
+    }
+    modifyHTML(html, assets) {
+        // BIGO Ads 需要 BIGO JS-SDK
+        const bigoScript = `
+      <script src="https://static-web.likeevideo.com/oss/material-ad/playable-ad-demo/bgy-mraid-sdk.js"></script>
+      <script>
+        // BIGO JS-SDK 桥接（如果 SDK 加载失败）
+        window.BGY_MRAID = window.BGY_MRAID || {
+          open: function(url) {
+            console.log('BIGO CTA: opening store');
+            window.open(url);
+          },
+          gameReady: function() {
+            console.log('BIGO: game ready');
+          },
+          gameEnd: function() {
+            console.log('BIGO: game end');
+          }
+        };
+      </script>
+      <!-- 
+        注意：
+        - BIGO Ads 要求 ZIP 格式，含 config.json
+        - config.json 需包含 orientation 字段：0=横或竖/1=仅竖/2=仅横
+        - 接入 BIGO JS-SDK
+        - CTA 使用 window.BGY_MRAID.open()
+        - 游戏结束调用 window.BGY_MRAID.gameEnd()
+        - 可选调用 gameReady()
+        - 素材不得为 mraid.js 格式
+      -->
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${bigoScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // BIGO Ads Playable
+      // 使用 BGY_MRAID SDK
+      
+      if (typeof BGY_MRAID !== 'undefined') {
+        // 游戏准备就绪
+        BGY_MRAID.gameReady();
+        
+        // CTA 跳转
+        // BGY_MRAID.open('https://play.google.com/store');
+        
+        // 游戏结束
+        // BGY_MRAID.gameEnd();
+      }
+    `;
+    }
+    /**
+     * 生成 config.json（BIGO 要求）
+     * @param orientation 0=横或竖, 1=仅竖屏, 2=仅横屏
+     */
+    generateConfigJson(orientation = 0) {
+        return {
+            orientation: orientation,
+        };
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'zip') {
+            console.warn('警告: BIGO Ads 要求 ZIP 格式');
+        }
+    }
+}

package/dist/platforms/facebook.d.ts

@@ -0,0 +1,9 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class FacebookAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+}

package/dist/platforms/facebook.js

@@ -0,0 +1,37 @@
+import { PlatformAdapter } from './base.js';
+export class FacebookAdapter extends PlatformAdapter {
+    getName() {
+        return 'Facebook';
+    }
+    getSizeLimit() {
+        // Facebook: HTML 5MB, ZIP 5MB（HTML 文件需 < 2MB 由校验处理）
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'html';
+    }
+    modifyHTML(html, assets) {
+        // Facebook 需要 FbPlayableAd API
+        const fbScript = `
+      <script>
+        window.FbPlayableAd = window.FbPlayableAd || {
+          onCTAClick: function() {
+            console.log('Facebook CTA clicked');
+            // 这里会被 Facebook 替换为实际的跟踪代码
+          }
+        };
+      </script>
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${fbScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // Facebook Playable Ad API
+      if (typeof FbPlayableAd !== 'undefined') {
+        // 在 CTA 按钮点击时调用
+        // FbPlayableAd.onCTAClick();
+      }
+    `;
+    }
+}

package/dist/platforms/google.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class GoogleAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}

package/dist/platforms/google.js

@@ -0,0 +1,53 @@
+import { PlatformAdapter } from './base.js';
+export class GoogleAdapter extends PlatformAdapter {
+    getName() {
+        return 'Google Ads';
+    }
+    getSizeLimit() {
+        // Google Ads: 5MB ZIP
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'zip';
+    }
+    modifyHTML(html, assets) {
+        // Google Ads 需要 exitapi.js
+        const googleScript = `
+      <script>
+        // Google Ads Exit API
+        window.ExitApi = window.ExitApi || {
+          exit: function() {
+            console.log('Google Ads CTA: opening store');
+            // Google 会替换为实际的跟踪代码
+            window.open('https://play.google.com/store', '_blank');
+          }
+        };
+      </script>
+      <!-- 
+        注意：
+        - Google Ads 要求 ZIP 格式，最大 5MB，最多 512 文件
+        - 必须包含 <!DOCTYPE html> 和完整的 html/head/body 结构
+        - 使用 <meta name="ad.orientation" content="portrait|landscape"> 声明方向
+        - 支持 Google 托管库：Fonts/jQuery/Greensock/CreateJS
+      -->
+      <meta name="ad.size" content="320x480,480x320,768x1024,1024x768">
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${googleScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // Google Ads Playable
+      // 使用 ExitApi.exit() 跳转应用商店
+      
+      if (typeof ExitApi !== 'undefined') {
+        console.log('Google ExitApi available');
+      }
+    `;
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'zip') {
+            console.warn('警告: Google Ads 要求 ZIP 格式');
+        }
+    }
+}

package/dist/platforms/index.d.ts

@@ -0,0 +1,14 @@
+import { PlatformAdapter } from './base.js';
+import type { BuildOptions } from '../types.js';
+export declare function createPlatformAdapter(options: BuildOptions): PlatformAdapter;
+export { PlatformAdapter } from './base.js';
+export { FacebookAdapter } from './facebook.js';
+export { SnapchatAdapter } from './snapchat.js';
+export { IronSourceAdapter } from './ironsource.js';
+export { AppLovinAdapter } from './applovin.js';
+export { GoogleAdapter } from './google.js';
+export { TikTokAdapter } from './tiktok.js';
+export { UnityAdapter } from './unity.js';
+export { LiftoffAdapter } from './liftoff.js';
+export { MolocoAdapter } from './moloco.js';
+export { BigoAdapter } from './bigo.js';

package/dist/platforms/index.js

@@ -0,0 +1,47 @@
+import { FacebookAdapter } from './facebook.js';
+import { SnapchatAdapter } from './snapchat.js';
+import { IronSourceAdapter } from './ironsource.js';
+import { AppLovinAdapter } from './applovin.js';
+import { GoogleAdapter } from './google.js';
+import { TikTokAdapter } from './tiktok.js';
+import { UnityAdapter } from './unity.js';
+import { LiftoffAdapter } from './liftoff.js';
+import { MolocoAdapter } from './moloco.js';
+import { BigoAdapter } from './bigo.js';
+export function createPlatformAdapter(options) {
+    switch (options.platform) {
+        case 'facebook':
+            return new FacebookAdapter(options);
+        case 'snapchat':
+            return new SnapchatAdapter(options);
+        case 'ironsource':
+            return new IronSourceAdapter(options);
+        case 'applovin':
+            return new AppLovinAdapter(options);
+        case 'google':
+            return new GoogleAdapter(options);
+        case 'tiktok':
+            return new TikTokAdapter(options);
+        case 'unity':
+            return new UnityAdapter(options);
+        case 'liftoff':
+            return new LiftoffAdapter(options);
+        case 'moloco':
+            return new MolocoAdapter(options);
+        case 'bigo':
+            return new BigoAdapter(options);
+        default:
+            throw new Error(`Unsupported platform: ${options.platform}`);
+    }
+}
+export { PlatformAdapter } from './base.js';
+export { FacebookAdapter } from './facebook.js';
+export { SnapchatAdapter } from './snapchat.js';
+export { IronSourceAdapter } from './ironsource.js';
+export { AppLovinAdapter } from './applovin.js';
+export { GoogleAdapter } from './google.js';
+export { TikTokAdapter } from './tiktok.js';
+export { UnityAdapter } from './unity.js';
+export { LiftoffAdapter } from './liftoff.js';
+export { MolocoAdapter } from './moloco.js';
+export { BigoAdapter } from './bigo.js';

package/dist/platforms/ironsource.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class IronSourceAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}

package/dist/platforms/ironsource.js

@@ -0,0 +1,71 @@
+import { PlatformAdapter } from './base.js';
+export class IronSourceAdapter extends PlatformAdapter {
+    getName() {
+        return 'ironSource';
+    }
+    getSizeLimit() {
+        // ironSource: 5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'html';
+    }
+    modifyHTML(html, assets) {
+        // ironSource 需要 MRAID 和 dapi API
+        const ironSourceScript = `
+      <script>
+        // MRAID 2.0 API
+        window.mraid = window.mraid || {
+          getVersion: function() { return '2.0'; },
+          isReady: function() { return true; },
+          open: function(url) { window.open(url); },
+          close: function() { 
+            console.log('ironSource: close() is handled by platform'); 
+          },
+          useCustomClose: function(useCustomClose) {
+            console.warn('ironSource: useCustomClose() is not allowed');
+          },
+          addEventListener: function(event, listener) {},
+          removeEventListener: function(event, listener) {},
+          getState: function() { return 'default'; },
+          getPlacementType: function() { return 'interstitial'; }
+        };
+
+        // dapi API (ironSource specific)
+        window.dapi = window.dapi || {
+          isReady: function() { return true; },
+          addEventListener: function(event, callback) {
+            if (event === 'ready') {
+              setTimeout(callback, 0);
+            }
+          },
+          removeEventListener: function(event, callback) {}
+        };
+      </script>
+      <!-- 
+        注意：ironSource 要求预留四角约30x30px区域给平台UI
+        请确保游戏内容不会被遮挡
+      -->
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${ironSourceScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // ironSource Playable Ad
+      // 使用 mraid.open() 跳转应用商店
+      // 禁止使用 close() 或 useCustomClose()
+      
+      if (typeof dapi !== 'undefined') {
+        dapi.addEventListener('ready', function() {
+          console.log('dapi ready');
+        });
+      }
+    `;
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'html') {
+            console.warn('警告: ironSource 使用单文件 HTML 格式');
+        }
+    }
+}

package/dist/platforms/liftoff.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class LiftoffAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}

package/dist/platforms/liftoff.js

@@ -0,0 +1,56 @@
+import { PlatformAdapter } from './base.js';
+export class LiftoffAdapter extends PlatformAdapter {
+    getName() {
+        return 'Liftoff';
+    }
+    getSizeLimit() {
+        // Liftoff: 建议 <5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'zip';
+    }
+    modifyHTML(html, assets) {
+        // Liftoff 支持 MRAID 或 window.open
+        const liftoffScript = `
+      <script>
+        // MRAID API（可选）
+        window.mraid = window.mraid || {
+          getVersion: function() { return '2.0'; },
+          isReady: function() { return true; },
+          open: function(url) { 
+            console.log('Liftoff CTA: opening store');
+            window.open(url, '_blank'); 
+          },
+          addEventListener: function(event, listener) {},
+          removeEventListener: function(event, listener) {}
+        };
+      </script>
+      <!-- 
+        注意：
+        - Liftoff 要求 ZIP 格式
+        - 文件名必须为 ASCII（禁止 UTF-8）
+        - 大小写敏感
+        - 跳转使用 mraid.open() 或 window.open()，禁止 window.location
+        - 需用户交互后才能跳转
+        - 支持标准尺寸：320x480, 480x320, 768x1024, 1024x768, 320x50, 728x90, 300x250
+        - 关闭按钮由平台处理，可能遮挡角落 50x50px
+      -->
+      <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${liftoffScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // Liftoff Playable Ad
+      // 使用 mraid.open() 或 window.open() 跳转
+      // 禁止 window.location 重定向
+    `;
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'zip') {
+            console.warn('警告: Liftoff 要求 ZIP 格式');
+        }
+    }
+}

package/dist/platforms/moloco.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class MolocoAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}

package/dist/platforms/moloco.js

@@ -0,0 +1,53 @@
+import { PlatformAdapter } from './base.js';
+export class MolocoAdapter extends PlatformAdapter {
+    getName() {
+        return 'Moloco';
+    }
+    getSizeLimit() {
+        // Moloco: 5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'html';
+    }
+    modifyHTML(html, assets) {
+        // Moloco 使用 FbPlayableAd API（与 Facebook 相同）
+        const molocoScript = `
+      <script>
+        // Moloco 使用 FbPlayableAd API
+        window.FbPlayableAd = window.FbPlayableAd || {
+          onCTAClick: function() {
+            console.log('Moloco CTA clicked');
+            // Moloco 要求：必须以"无参数"方式调用
+          }
+        };
+      </script>
+      <!-- 
+        注意：
+        - Moloco 使用单文件 HTML 格式，<5MB
+        - CTA 必须以"无参数"方式调用 FbPlayableAd.onCTAClick()
+        - 不得包含 mraid.js
+        - 不允许任何外部引用或 HTTP 动态加载
+        - 禁止 XMLHttpRequest 和 JS 重定向
+      -->
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${molocoScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // Moloco Playable Ad
+      // 使用 FbPlayableAd.onCTAClick() 跳转（无参数）
+      
+      if (typeof FbPlayableAd !== 'undefined') {
+        // 在 CTA 按钮点击时调用
+        // FbPlayableAd.onCTAClick();
+      }
+    `;
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'html') {
+            console.warn('警告: Moloco 使用单文件 HTML 格式');
+        }
+    }
+}

package/dist/platforms/snapchat.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class SnapchatAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}

package/dist/platforms/snapchat.js

@@ -0,0 +1,59 @@
+import { PlatformAdapter } from './base.js';
+export class SnapchatAdapter extends PlatformAdapter {
+    getName() {
+        return 'Snapchat';
+    }
+    getSizeLimit() {
+        // Snapchat: 5MB (uncompressed)
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'zip';
+    }
+    modifyHTML(html, assets) {
+        // Snapchat 需要 MRAID 2.0 和 snapchatCta 函数
+        const mraidScript = `
+      <script>
+        // MRAID 2.0 API
+        window.mraid = window.mraid || {
+          getVersion: function() { return '2.0'; },
+          isReady: function() { return true; },
+          open: function(url) { window.open(url); },
+          close: function() { window.close(); },
+          addEventListener: function(event, listener) {},
+          removeEventListener: function(event, listener) {},
+          getState: function() { return 'ready'; },
+          getPlacementType: function() { return 'interstitial'; }
+        };
+
+        // Snapchat CTA function
+        window.snapchatCta = function() {
+          if (window.mraid && window.mraid.open) {
+            window.mraid.open('https://snapchat.com');
+          }
+        };
+      </script>
+    `;
+        return html.replace('</head>', `${mraidScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // Snapchat Playable Ad
+      if (typeof mraid !== 'undefined') {
+        mraid.addEventListener('ready', function() {
+          console.log('MRAID ready');
+        });
+      }
+
+      // 在 CTA 按钮点击时调用
+      // snapchatCta();
+    `;
+    }
+    validateOptions() {
+        // Snapchat 默认使用 ZIP 格式，但不强制要求
+        // MRAID 支持会在 modifyHTML 中自动添加
+        if (this.options.format && this.options.format !== 'zip') {
+            console.warn('Warning: Snapchat typically uses ZIP format');
+        }
+    }
+}

package/dist/platforms/tiktok.d.ts

@@ -0,0 +1,15 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class TikTokAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    /**
+     * 生成 config.json（TikTok/Pangle 要求）
+     * @param orientation 0=横竖均可, 1=仅竖屏, 2=仅横屏
+     */
+    generateConfigJson(orientation?: 0 | 1 | 2): object;
+    validateOptions(): void;
+}

package/dist/platforms/tiktok.js

@@ -0,0 +1,65 @@
+import { PlatformAdapter } from './base.js';
+export class TikTokAdapter extends PlatformAdapter {
+    getName() {
+        return 'TikTok/Pangle';
+    }
+    getSizeLimit() {
+        // TikTok/Pangle: 5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'zip';
+    }
+    modifyHTML(html, assets) {
+        // TikTok/Pangle 需要 Pangle JS-SDK
+        const pangleScript = `
+      <script>
+        // Pangle JS-SDK 桥接
+        window.Pangle = window.Pangle || {
+          open: function(url) {
+            console.log('Pangle CTA: opening store');
+            // Pangle SDK 会处理跳转
+          },
+          ready: function() {
+            console.log('Pangle SDK ready');
+          }
+        };
+        
+        // 不使用 mraid.js（TikTok要求）
+      </script>
+      <!-- 
+        注意：
+        - TikTok/Pangle 要求 ZIP 格式，含 config.json
+        - config.json 需包含 playable_orientation 字段：0=横竖均可/1=仅竖/2=仅横
+        - 不允许外部网络加载动态素材
+        - 不应使用 mraid.js
+      -->
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${pangleScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // TikTok/Pangle Playable Ad
+      // 使用 Pangle SDK 进行跳转
+      
+      if (typeof Pangle !== 'undefined') {
+        Pangle.ready();
+      }
+    `;
+    }
+    /**
+     * 生成 config.json（TikTok/Pangle 要求）
+     * @param orientation 0=横竖均可, 1=仅竖屏, 2=仅横屏
+     */
+    generateConfigJson(orientation = 0) {
+        return {
+            playable_orientation: orientation,
+        };
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'zip') {
+            console.warn('警告: TikTok/Pangle 要求 ZIP 格式');
+        }
+    }
+}

package/dist/platforms/unity.d.ts

@@ -0,0 +1,10 @@
+import { PlatformAdapter } from './base.js';
+import type { AssetInfo } from '../types.js';
+export declare class UnityAdapter extends PlatformAdapter {
+    getName(): string;
+    getSizeLimit(): number;
+    getDefaultFormat(): 'html' | 'zip';
+    modifyHTML(html: string, assets: AssetInfo[]): string;
+    getPlatformScript(): string;
+    validateOptions(): void;
+}