@playcraft/build 0.0.2

package/dist/converter.js

@@ -0,0 +1,148 @@
+import fs from 'fs/promises';
+import path from 'path';
+import mimeTypes from 'mime-types';
+export class OnePageConverter {
+    constructor(projectDir, options) {
+        this.assets = [];
+        this.projectDir = projectDir;
+        this.options = options;
+    }
+    /**
+     * 添加资产到转换列表
+     */
+    addAsset(assetPath, type) {
+        this.assets.push({
+            path: assetPath,
+            type,
+            size: 0,
+        });
+    }
+    /**
+     * 编码所有资产为 Base64
+     */
+    async encodeAssets() {
+        for (const asset of this.assets) {
+            const fullPath = path.join(this.projectDir, asset.path);
+            try {
+                const fileBuffer = await fs.readFile(fullPath);
+                asset.size = fileBuffer.length;
+                asset.base64 = fileBuffer.toString('base64');
+                asset.mimeType = mimeTypes.lookup(asset.path) || 'application/octet-stream';
+            }
+            catch (error) {
+                console.warn(`Warning: Failed to encode asset ${asset.path}: ${error.message}`);
+            }
+        }
+    }
+    /**
+     * 获取资产的 Base64 数据 URL
+     */
+    getDataUrl(assetPath) {
+        if (!assetPath)
+            return null;
+        // 移除查询参数
+        let cleanPath = assetPath;
+        if (cleanPath.includes('?')) {
+            cleanPath = cleanPath.split('?')[0];
+        }
+        // 解码 URL 编码的路径
+        try {
+            cleanPath = decodeURIComponent(cleanPath);
+        }
+        catch (e) {
+            // 如果解码失败，使用原始路径
+        }
+        // 1. 精确匹配
+        let asset = this.assets.find(a => a.path === cleanPath);
+        // 2. 尝试移除前导斜杠
+        if (!asset && cleanPath.startsWith('/')) {
+            asset = this.assets.find(a => a.path === cleanPath.substring(1));
+        }
+        // 3. 尝试模糊匹配（文件名匹配）
+        if (!asset) {
+            const filename = path.basename(cleanPath);
+            asset = this.assets.find(a => {
+                const assetFilename = path.basename(a.path);
+                return assetFilename === filename;
+            });
+        }
+        // 4. 尝试部分路径匹配（处理 files/assets/... 格式）
+        if (!asset) {
+            asset = this.assets.find(a => a.path.endsWith(cleanPath) || cleanPath.endsWith(a.path));
+        }
+        if (!asset || !asset.base64) {
+            return null;
+        }
+        return `data:${asset.mimeType};base64,${asset.base64}`;
+    }
+    /**
+     * 替换 HTML 中的 URL 为 Base64 数据 URL
+     */
+    replaceUrlsWithBase64(html, urlMap) {
+        let result = html;
+        for (const [url, dataUrl] of urlMap.entries()) {
+            // 替换各种可能的 URL 格式
+            result = result.replace(new RegExp(url.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), dataUrl);
+            // 也替换相对路径
+            const relativeUrl = url.startsWith('/') ? url.substring(1) : url;
+            result = result.replace(new RegExp(relativeUrl.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), dataUrl);
+        }
+        return result;
+    }
+    /**
+     * 内联脚本到 HTML
+     */
+    async inlineScripts(html) {
+        // 查找所有 <script src="..."> 标签
+        const scriptRegex = /<script\s+src=["']([^"']+)["'][^>]*><\/script>/gi;
+        let result = html;
+        const matches = [];
+        let match;
+        // 先收集所有匹配项
+        while ((match = scriptRegex.exec(html)) !== null) {
+            matches.push({
+                fullMatch: match[0],
+                scriptPath: match[1],
+            });
+        }
+        // 处理每个脚本
+        for (const { fullMatch, scriptPath } of matches) {
+            // 尝试多个可能的路径
+            const possiblePaths = [
+                path.join(this.projectDir, scriptPath),
+                path.join(this.projectDir, scriptPath.replace(/^\//, '')),
+                scriptPath, // 绝对路径
+            ];
+            let scriptContent = null;
+            for (const fullPath of possiblePaths) {
+                try {
+                    scriptContent = await fs.readFile(fullPath, 'utf-8');
+                    break;
+                }
+                catch (error) {
+                    // 继续尝试下一个路径
+                }
+            }
+            if (scriptContent) {
+                // 替换为内联脚本
+                result = result.replace(fullMatch, `<script>${scriptContent}</script>`);
+            }
+            else {
+                console.warn(`Warning: Failed to inline script ${scriptPath}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取所有资产信息
+     */
+    getAssets() {
+        return this.assets;
+    }
+    /**
+     * 获取总大小
+     */
+    getTotalSize() {
+        return this.assets.reduce((sum, asset) => sum + asset.size, 0);
+    }
+}

package/dist/generators/config-generator.d.ts

@@ -0,0 +1,7 @@
+import { PlayCanvasProject } from '../loaders/playcanvas-loader.js';
+import { PlayCraftProject } from '../loaders/playcraft-loader.js';
+export type ProjectConfig = PlayCanvasProject | PlayCraftProject;
+/**
+ * 生成 PlayCanvas 构建产物格式的 config.json
+ */
+export declare function generateConfig(projectConfig: ProjectConfig): any;

package/dist/generators/config-generator.js

@@ -0,0 +1,122 @@
+function shouldIncludeAsset(asset, scriptIds, requiredScriptIds) {
+    if (!asset) {
+        return false;
+    }
+    if (asset.type === 'folder') {
+        return false;
+    }
+    // PlayCanvas 源资产（source=true）不进入构建产物
+    if (asset.source === true) {
+        return false;
+    }
+    // 字体源文件（ttf/otf）不进入构建产物
+    const filename = asset.file?.filename?.toLowerCase?.();
+    if (filename && (filename.endsWith('.ttf') || filename.endsWith('.otf'))) {
+        return false;
+    }
+    // 仅保留在 settings.scripts 中声明的脚本资产
+    if (asset.type === 'script' && asset.id != null) {
+        const id = String(asset.id);
+        return scriptIds.has(id) || requiredScriptIds.has(id);
+    }
+    return true;
+}
+function collectRequiredScriptIds(assets) {
+    const required = new Set();
+    for (const asset of Object.values(assets)) {
+        const assetData = asset;
+        if (assetData?.type === 'wasm' && assetData?.data) {
+            const glueId = assetData.data.glueScriptId;
+            const fallbackId = assetData.data.fallbackScriptId;
+            if (glueId != null) {
+                required.add(String(glueId));
+            }
+            if (fallbackId != null) {
+                required.add(String(fallbackId));
+            }
+        }
+    }
+    return required;
+}
+/**
+ * 生成 PlayCanvas 构建产物格式的 config.json
+ */
+export function generateConfig(projectConfig) {
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        // 从 PlayCanvas 项目格式生成 config.json
+        const config = {
+            application_properties: pcProject.project.settings || {},
+        };
+        // 兼容官方构建：确保 libraries/batchGroups 为数组
+        if (!Array.isArray(config.application_properties.libraries)) {
+            config.application_properties.libraries = [];
+        }
+        if (!Array.isArray(config.application_properties.batchGroups)) {
+            config.application_properties.batchGroups = [];
+        }
+        // 处理场景
+        if (pcProject.scenes) {
+            if (Array.isArray(pcProject.scenes)) {
+                config.scenes = pcProject.scenes.map((scene) => ({
+                    name: scene.name || scene.id,
+                    url: scene.url || scene.file || `${scene.id}.json`,
+                }));
+            }
+            else {
+                // scenes.json 是对象格式
+                config.scenes = Object.entries(pcProject.scenes).map(([id, scene]) => ({
+                    name: scene.name || id,
+                    url: scene.url || scene.file || `${id}.json`,
+                }));
+            }
+        }
+        // 处理资产（过滤非运行时资产）
+        if (pcProject.assets) {
+            const scriptIds = new Set((pcProject.project.settings?.scripts || []).map((id) => String(id)));
+            const requiredScriptIds = collectRequiredScriptIds(pcProject.assets);
+            const filtered = {};
+            for (const [assetId, asset] of Object.entries(pcProject.assets)) {
+                if (shouldIncludeAsset(asset, scriptIds, requiredScriptIds)) {
+                    filtered[assetId] = asset;
+                }
+            }
+            config.assets = filtered;
+        }
+        return config;
+    }
+    else {
+        // PlayCraft 格式
+        const pcProject = projectConfig;
+        const config = {
+            application_properties: pcProject.manifest.settings || {},
+        };
+        // 兼容官方构建：确保 libraries/batchGroups 为数组
+        if (!Array.isArray(config.application_properties.libraries)) {
+            config.application_properties.libraries = [];
+        }
+        if (!Array.isArray(config.application_properties.batchGroups)) {
+            config.application_properties.batchGroups = [];
+        }
+        // 处理场景
+        if (pcProject.scenes && pcProject.scenes.length > 0) {
+            config.scenes = pcProject.scenes.map((scene) => ({
+                name: scene.name || scene.id,
+                url: scene.url || `${scene.id || 'scene'}.json`,
+            }));
+        }
+        // 处理资产（过滤非运行时资产）
+        if (pcProject.assets) {
+            const scriptIds = new Set((pcProject.manifest.settings?.scripts || []).map((id) => String(id)));
+            const requiredScriptIds = collectRequiredScriptIds(pcProject.assets);
+            const filtered = {};
+            for (const [assetId, asset] of Object.entries(pcProject.assets)) {
+                if (shouldIncludeAsset(asset, scriptIds, requiredScriptIds)) {
+                    filtered[assetId] = asset;
+                }
+            }
+            config.assets = filtered;
+        }
+        return config;
+    }
+}

package/dist/generators/settings-generator.d.ts

@@ -0,0 +1,14 @@
+import { PlayCanvasProject } from '../loaders/playcanvas-loader.js';
+import { PlayCraftProject } from '../loaders/playcraft-loader.js';
+export type ProjectConfig = PlayCanvasProject | PlayCraftProject;
+export interface PreloadModule {
+    moduleName: string;
+    glueUrl: string;
+    wasmUrl: string;
+    fallbackUrl?: string;
+    preload?: boolean;
+}
+/**
+ * 生成 __settings__.js 文件内容
+ */
+export declare function generateSettings(projectConfig: ProjectConfig, scenePath?: string): string;

package/dist/generators/settings-generator.js

@@ -0,0 +1,100 @@
+/**
+ * 提取预加载模块（WASM 等）
+ */
+function extractPreloadModules(projectConfig) {
+    const modules = [];
+    const assets = projectConfig.format === 'playcanvas'
+        ? projectConfig.assets
+        : projectConfig.assets;
+    if (!assets) {
+        return modules;
+    }
+    for (const asset of Object.values(assets)) {
+        const assetData = asset;
+        if (assetData.type !== 'wasm') {
+            continue;
+        }
+        const wasmUrl = assetData.file?.url;
+        const moduleName = assetData.data?.moduleName;
+        const glueId = assetData.data?.glueScriptId;
+        const fallbackId = assetData.data?.fallbackScriptId;
+        if (!wasmUrl || !moduleName || !glueId) {
+            continue;
+        }
+        const glueAsset = assets[String(glueId)];
+        const fallbackAsset = fallbackId ? assets[String(fallbackId)] : null;
+        const glueUrl = glueAsset?.file?.url;
+        const fallbackUrl = fallbackAsset?.file?.url;
+        if (!glueUrl) {
+            continue;
+        }
+        modules.push({
+            moduleName,
+            glueUrl,
+            wasmUrl,
+            fallbackUrl,
+            preload: true,
+        });
+    }
+    return modules;
+}
+/**
+ * 生成 __settings__.js 文件内容
+ */
+export function generateSettings(projectConfig, scenePath) {
+    let settings;
+    let scripts = [];
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        settings = pcProject.project.settings || {};
+        scripts = settings.scripts || [];
+    }
+    else {
+        const pcProject = projectConfig;
+        settings = pcProject.manifest.settings || {};
+        scripts = settings.scripts || [];
+    }
+    // 确定场景路径
+    let finalScenePath = scenePath || '';
+    if (!finalScenePath && projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        if (pcProject.scenes) {
+            const scenes = Array.isArray(pcProject.scenes)
+                ? pcProject.scenes
+                : Object.values(pcProject.scenes);
+            if (scenes.length > 0) {
+                const firstScene = scenes[0];
+                finalScenePath = firstScene.url || firstScene.file || `${firstScene.id || 'scene'}.json`;
+            }
+        }
+    }
+    else if (!finalScenePath) {
+        const pcProject = projectConfig;
+        if (pcProject.scenes && pcProject.scenes.length > 0) {
+            const firstScene = pcProject.scenes[0];
+            finalScenePath = firstScene.url || `${firstScene.id || 'scene'}.json`;
+        }
+    }
+    const preloadModules = extractPreloadModules(projectConfig);
+    return `window.ASSET_PREFIX = "";
+window.SCRIPT_PREFIX = "";
+window.SCENE_PATH = "${finalScenePath}";
+window.CONTEXT_OPTIONS = {
+  antialias: ${settings.antiAlias ?? true},
+  alpha: false,
+  preserveDrawingBuffer: ${settings.preserveDrawingBuffer ?? false},
+  deviceTypes: ['webgl2', 'webgl1'],
+  powerPreference: "${settings.powerPreference || 'default'}"
+};
+window.SCRIPTS = ${JSON.stringify(scripts)};
+window.CONFIG_FILENAME = "config.json";
+window.INPUT_SETTINGS = {
+  useKeyboard: ${settings.useKeyboard ?? true},
+  useMouse: ${settings.useMouse ?? true},
+  useGamepads: ${settings.useGamepads ?? false},
+  useTouch: ${settings.useTouch ?? true}
+};
+pc.script.legacy = ${settings.useLegacyScripts ?? false};
+window.PRELOAD_MODULES = ${JSON.stringify(preloadModules)};
+`;
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { BaseBuilder } from './base-builder.js';
+export type { BaseBuildOptions, BaseBuildOutput } from './base-builder.js';
+export { ViteBuilder } from './vite-builder.js';
+export type { ViteBuildOutput } from './vite-builder.js';
+export { PlayableBuilder } from './playable-builder.js';
+export type { PlayableBuildOutput } from './playable-builder.js';
+export { OnePageConverter } from './converter.js';
+export { createPlatformAdapter, PlatformAdapter } from './platforms/index.js';
+export { FacebookAdapter } from './platforms/facebook.js';
+export { SnapchatAdapter } from './platforms/snapchat.js';
+export { ViteConfigBuilder } from './vite/config-builder.js';
+export { PLATFORM_CONFIGS } from './vite/platform-configs.js';
+export type { PlatformViteConfig } from './vite/platform-configs.js';
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,14 @@
+// 导出构建器
+export { BaseBuilder } from './base-builder.js';
+export { ViteBuilder } from './vite-builder.js';
+export { PlayableBuilder } from './playable-builder.js';
+export { OnePageConverter } from './converter.js';
+// 导出平台适配器
+export { createPlatformAdapter, PlatformAdapter } from './platforms/index.js';
+export { FacebookAdapter } from './platforms/facebook.js';
+export { SnapchatAdapter } from './platforms/snapchat.js';
+// 导出 Vite 配置
+export { ViteConfigBuilder } from './vite/config-builder.js';
+export { PLATFORM_CONFIGS } from './vite/platform-configs.js';
+// 导出类型
+export * from './types.js';

package/dist/loaders/playcanvas-loader.d.ts

@@ -0,0 +1,10 @@
+export interface PlayCanvasProject {
+    project: any;
+    scenes: any;
+    assets: any;
+    format: 'playcanvas';
+}
+/**
+ * 加载 PlayCanvas 源代码项目
+ */
+export declare function loadPlayCanvasProject(projectDir: string): Promise<PlayCanvasProject>;

package/dist/loaders/playcanvas-loader.js

@@ -0,0 +1,18 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * 加载 PlayCanvas 源代码项目
+ */
+export async function loadPlayCanvasProject(projectDir) {
+    const [projectJson, scenesJson, assetsJson] = await Promise.all([
+        fs.readFile(path.join(projectDir, 'project.json'), 'utf-8'),
+        fs.readFile(path.join(projectDir, 'scenes.json'), 'utf-8'),
+        fs.readFile(path.join(projectDir, 'assets.json'), 'utf-8'),
+    ]);
+    return {
+        project: JSON.parse(projectJson),
+        scenes: JSON.parse(scenesJson),
+        assets: JSON.parse(assetsJson),
+        format: 'playcanvas',
+    };
+}

package/dist/loaders/playcraft-loader.d.ts

@@ -0,0 +1,10 @@
+export interface PlayCraftProject {
+    manifest: any;
+    scenes: any[];
+    assets: any;
+    format: 'playcraft';
+}
+/**
+ * 加载 PlayCraft 源代码项目
+ */
+export declare function loadPlayCraftProject(projectDir: string): Promise<PlayCraftProject>;

package/dist/loaders/playcraft-loader.js

@@ -0,0 +1,51 @@
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * 加载 PlayCraft 源代码项目
+ */
+export async function loadPlayCraftProject(projectDir) {
+    // 1. 读取 manifest.json
+    const manifestContent = await fs.readFile(path.join(projectDir, 'manifest.json'), 'utf-8');
+    const manifest = JSON.parse(manifestContent);
+    // 2. 读取场景文件
+    const scenesDir = path.join(projectDir, 'scenes');
+    let scenes = [];
+    try {
+        const sceneFiles = await fs.readdir(scenesDir);
+        scenes = await Promise.all(sceneFiles
+            .filter(f => f.endsWith('.scene.json'))
+            .map(async (f) => {
+            const content = await fs.readFile(path.join(scenesDir, f), 'utf-8');
+            return JSON.parse(content);
+        }));
+    }
+    catch (error) {
+        // scenes 目录可能不存在
+        console.warn('警告: scenes 目录不存在，跳过场景加载');
+    }
+    // 3. 读取 assets.json（PlayCraft 保留的 PlayCanvas 兼容层）
+    let assets = {};
+    const assetsJsonPath = path.join(projectDir, 'assets', 'assets.json');
+    try {
+        const assetsContent = await fs.readFile(assetsJsonPath, 'utf-8');
+        assets = JSON.parse(assetsContent);
+    }
+    catch (error) {
+        // assets.json 可能不存在，尝试从 manifest 中读取
+        if (manifest.assets && Array.isArray(manifest.assets)) {
+            // 转换为 PlayCanvas 格式（key-value 对象）
+            assets = {};
+            for (const asset of manifest.assets) {
+                if (asset.id) {
+                    assets[asset.id] = asset;
+                }
+            }
+        }
+    }
+    return {
+        manifest,
+        scenes,
+        assets,
+        format: 'playcraft',
+    };
+}

package/dist/platforms/applovin.d.ts

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

package/dist/platforms/applovin.js

@@ -0,0 +1,67 @@
+import { PlatformAdapter } from './base.js';
+export class AppLovinAdapter extends PlatformAdapter {
+    getName() {
+        return 'AppLovin';
+    }
+    getSizeLimit() {
+        // AppLovin: 5MB
+        return 5 * 1024 * 1024;
+    }
+    getDefaultFormat() {
+        return 'html';
+    }
+    modifyHTML(html, assets) {
+        // AppLovin 需要 MRAID v2.0 支持
+        const appLovinScript = `
+      <script>
+        // MRAID 2.0 API
+        window.mraid = window.mraid || {
+          getVersion: function() { return '2.0'; },
+          isReady: function() { return true; },
+          open: function(url) { 
+            console.log('AppLovin CTA: opening store');
+            window.open(url); 
+          },
+          close: function() { 
+            console.warn('AppLovin: close() button is disabled, handled by platform'); 
+          },
+          addEventListener: function(event, listener) {
+            if (event === 'ready') {
+              setTimeout(listener, 0);
+            }
+          },
+          removeEventListener: function(event, listener) {},
+          getState: function() { return 'default'; },
+          getPlacementType: function() { return 'interstitial'; },
+          isViewable: function() { return true; }
+        };
+      </script>
+      <!-- 
+        注意：
+        - AppLovin 要求必须同时支持横屏和竖屏
+        - 禁止添加退出按钮（平台统一处理）
+        - CTA 使用 mraid.open()
+      -->
+    `;
+        // 在 </head> 之前插入
+        return html.replace('</head>', `${appLovinScript}</head>`);
+    }
+    getPlatformScript() {
+        return `
+      // AppLovin Playable Ad
+      // 使用 mraid.open() 跳转应用商店
+      // 禁止自定义退出按钮
+      
+      if (typeof mraid !== 'undefined') {
+        mraid.addEventListener('ready', function() {
+          console.log('MRAID ready');
+        });
+      }
+    `;
+    }
+    validateOptions() {
+        if (this.options.format && this.options.format !== 'html') {
+            console.warn('警告: AppLovin 使用单文件 HTML 格式');
+        }
+    }
+}

package/dist/platforms/base.d.ts

@@ -0,0 +1,29 @@
+import type { BuildOptions, AssetInfo } from '../types.js';
+export declare abstract class PlatformAdapter {
+    protected options: BuildOptions;
+    constructor(options: BuildOptions);
+    /**
+     * 获取平台名称
+     */
+    abstract getName(): string;
+    /**
+     * 获取大小限制（字节）
+     */
+    abstract getSizeLimit(): number;
+    /**
+     * 获取默认格式
+     */
+    abstract getDefaultFormat(): 'html' | 'zip';
+    /**
+     * 应用平台特定的 HTML 修改
+     */
+    abstract modifyHTML(html: string, assets: AssetInfo[]): string;
+    /**
+     * 获取平台特定的 JavaScript 代码
+     */
+    abstract getPlatformScript(): string;
+    /**
+     * 验证配置
+     */
+    validateOptions(): void;
+}

package/dist/platforms/base.js

@@ -0,0 +1,11 @@
+export class PlatformAdapter {
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * 验证配置
+     */
+    validateOptions() {
+        // 默认实现，子类可以覆盖
+    }
+}

package/dist/platforms/bigo.d.ts

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