@next2d/builder 0.1.7 → 0.1.10

package/dist/index.js

@@ -1,779 +1,43 @@
 #!/usr/bin/env node
 "use strict";
-import pc from "picocolors";
-import fs from "fs";
-import os from "os";
-import path from "path";
-import { fileURLToPath } from "url";
-import cp from "child_process";
-import { loadConfigFromFile } from "vite";
-import { api } from "@electron-forge/core";
-const recommendeVersion = 22;
-const version = process.versions.node;
-if (recommendeVersion > parseInt(version.split(".")[0])) {
-    pc.red(`You are running Node Version:${version}.
-View Generator requires Node ${recommendeVersion} or higher.
-Please update your version of Node.`);
-    process.exit(1);
-}
-let platform = "";
-let environment = "";
-let hasHelp = false;
-let preview = false;
-let open = false;
-let build = false;
-let v8Root = "";
-for (let idx = 0; idx < process.argv.length; ++idx) {
-    switch (process.argv[idx]) {
-        case "--preview":
-            preview = true;
-            break;
-        case "--open":
-            open = true;
-            break;
-        case "--build":
-            build = true;
-            break;
-        case "--help":
-        case "--h":
-            hasHelp = true;
-            break;
-        case "--platform":
-            platform = process.argv[++idx].toLowerCase();
-            break;
-        case "--env":
-            environment = process.argv[++idx];
-            break;
-        case "--v8-root":
-            // Xbox ビルドで使う prebuilt V8 monolith のパス (環境変数 V8_ROOT より優先)
-            v8Root = process.argv[++idx] || "";
-            break;
-        default:
-            break;
-    }
-    if (hasHelp) {
-        break;
-    }
-}
-if (!platform || !environment) {
-    hasHelp = true;
-}
-/**
- * @description ヘルプを出力して終了
- *              Output help and exit
- *
- * @return {void}
- * @method
- * @public
- */
-const echoHelp = () => {
-    console.log();
-    console.log(pc.green("`--platform` can be specified for macOS, Windows, iOS, Android, Xbox, and Web"));
-    console.log(pc.green("It is not case sensitive."));
-    console.log();
-    console.log("For build example:");
-    console.log("npx @next2d/builder --platform web --env prd");
-    console.log();
-    console.log("For preview example:");
-    console.log("npx @next2d/builder --preview --platform web --env prd");
-    console.log();
-    console.log("For Xbox build example (prebuilt V8 is downloaded automatically):");
-    console.log("npx @next2d/builder --platform xbox --env prd");
-    console.log("To use your own V8 build: --v8-root C:\\path\\to\\v8");
-    console.log();
-    process.exit(1);
-};
-if (hasHelp) {
-    echoHelp();
-}
-if (!platform || !environment) {
-    echoHelp();
-}
-switch (platform) {
-    case "windows":
-    case "macos":
-    case "linux":
-    case "steam:windows":
-    case "steam:macos":
-    case "steam:linux":
-    case "ios":
-    case "android":
-    case "xbox":
-    case "web":
-        break;
-    default:
-        echoHelp();
-        break;
-}
-/**
- * @type {string}
- * @private
- */
-const platformDir = platform.indexOf(":") ? platform.split(":").join("/") : platform;
-/**
- * @type {object}
- * @private
- */
-let $configObject = null;
-/**
- * @type {string}
- * @private
- */
-let $buildDir = "";
-/**
- * @type {string}
- * @private
- */
-let $outDir = "dist";
-// update env variables
-process.env.NEXT2D_EBUILD_ENVIRONMENT = environment;
-process.env.NEXT2D_TARGET_PLATFORM = platform;
-/**
- * @type {string}
- * @constant
- */
-const CAPACITOR_CONFIG_NAME = "capacitor.config.json";
-/**
- * @return {Promise}
- * @method
- * @public
- */
-const loadConfig = async () => {
-    const packageJson = JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, { "encoding": "utf8" }));
-    if (packageJson.type !== "module") {
-        packageJson.type = "module";
-        // overwride
-        fs.writeFileSync(`${process.cwd()}/package.json`, JSON.stringify(packageJson, null, 2));
-    }
-    const ext = fs.existsSync(`${process.cwd()}/vite.config.ts`) ? "ts" : "js";
-    const config = await loadConfigFromFile({
-        "command": "build",
-        "mode": "build"
-    }, `${process.cwd()}/vite.config.${ext}`);
-    // update config
-    $configObject = config;
-    $outDir = $configObject.config?.build?.outDir || "dist";
-    $buildDir = `${process.cwd()}/${$outDir}/${platformDir}/${environment}`;
-    if (!fs.existsSync(`${$buildDir}`)) {
-        fs.mkdirSync(`${$buildDir}`, { "recursive": true });
-        console.log(pc.green(`Create build directory: ${$buildDir}`));
-        console.log();
-    }
-};
-/**
- * @description Web用アプリの書き出し関数
- *              Export function for web applications
- *
- * @return {Promise}
- * @method
- * @public
- */
-const buildWeb = () => {
-    return new Promise((resolve, reject) => {
-        const stream = cp.spawn("npx", [
-            "@next2d/vite-plugin-next2d-auto-loader"
-        ], { "stdio": "inherit" });
-        stream.on("close", (code) => {
-            if (code !== 0) {
-                reject("vite plugin command failed.");
-            }
-            const stream = cp.spawn("npx", [
-                "vite",
-                "--outDir",
-                $buildDir,
-                "build"
-            ], { "stdio": "inherit" });
-            stream.on("close", (code) => {
-                if (code !== 0) {
-                    reject("Export of `HTML` and `JavaScript` failed.");
-                }
-                console.log();
-                console.log(pc.green("`HTML` and `JavaScript` files are written out."));
-                resolve();
-            });
-        });
-    });
-};
-/**
- * @description electronがインストールされてなければインストールを実行
- *              If electron is not installed, run install.
- *
- * @return {Promise}
- * @method
- * @public
- */
-const installElectron = () => {
-    return new Promise((resolve, reject) => {
-        if (fs.existsSync(`${process.cwd()}/electron/node_modules`)) {
-            return resolve();
-        }
-        const stream = cp.spawn("npm", [
-            "--prefix",
-            `${process.cwd()}/electron`,
-            "install",
-            `${process.cwd()}/electron`
-        ], { "stdio": "inherit" });
-        stream.on("close", (code) => {
-            if (code !== 0) {
-                reject("`Electron` installation failed.");
-            }
-            console.log(pc.green("`Electron` successfully installed."));
-            resolve();
-        });
-    });
-};
-/**
- * @description electronに含むリソースを初期化
- *              Initialize resources included in electron
- *
- * @return {Promise}
- * @method
- * @public
- */
-const removeResources = () => {
-    return new Promise((resolve, reject) => {
-        const stream = cp.spawn("rm", [
-            "-rf",
-            `${process.cwd()}/electron/resources/`
-        ], { "stdio": "inherit" });
-        stream.on("close", (code) => {
-            if (code !== 0) {
-                reject("Failed to remove built resources.");
-            }
-            console.log(pc.green("Successfully remove built resources."));
-            resolve();
-        });
-    });
-};
-/**
- * @description ビルドしたリソースをコピー
- *              Copy built resources
+// エントリポイント。CLI を初期化し、Web ビルド → 各プラットフォーム書き出しを実行する。
+// 各プラットフォームの実装は web/steam/native/xbox の各モジュールへ分割している。
+import { ctx } from "./context.js";
+import { initCli, echoHelp } from "./cli.js";
+import { loadConfig, buildWeb } from "./web.js";
+import { buildElectron } from "./electron.js";
+import { runNative, openNative, buildNative } from "./native.js";
+import { buildXbox } from "./xbox.js";
+// Node バージョン検証・引数解析・ctx 初期化 (不正時はここで終了)。
+initCli();
+/**
+ * @description プラットフォーム別のビルド実行関数
+ *              Build execution dispatcher per platform
  *
  * @return {Promise}
  * @method
  * @public
  */
-const copyResources = () => {
-    return new Promise((resolve, reject) => {
-        const stream = cp.spawn("cp", [
-            "-r",
-            `${$buildDir}/`,
-            `${process.cwd()}/electron/resources`
-        ], { "stdio": "inherit" });
-        stream.on("close", (code) => {
-            if (code !== 0) {
-                reject("Failed to copy built resources.");
-            }
-            console.log(pc.green("Successfully copy built resources."));
-            resolve();
-        });
-    });
-};
-/**
- * @description Windows用アプリの書き出し関数
- *              Export function for Windows apps
- *
- * @return {Promise}
- * @method
- * @public
- */
-const buildSteam = async () => {
-    // reset
-    await removeResources();
-    // copy HTML, JavaScript
-    await copyResources();
-    if (preview) {
-        cp.spawn("npx", [
-            "electron",
-            `${process.cwd()}/electron/index.js`
-        ], { "stdio": "inherit" });
-    }
-    else {
-        await installElectron();
-        console.log(pc.green("Start the `Electron` build process."));
-        console.log();
-        const packageOptions = {
-            "dir": `${process.cwd()}/electron`,
-            "outDir": `${$outDir}/${platformDir}/build`,
-            "platform": "",
-            "arch": "all"
-        };
-        switch (platform) {
-            case "windows":
-            case "steam:windows":
-                packageOptions.platform = "win32";
-                break;
-            case "macos":
-            case "steam:macos":
-                packageOptions.platform = "mas";
-                break;
-            case "linux":
-            case "steam:linux":
-                packageOptions.platform = "linux";
-                break;
-            default:
-                console.log(pc.red("There is an error in the export platform settings."));
-                console.log();
-                process.exit(1);
-        }
-        api
-            .package(packageOptions)
-            .then(() => {
-            console.log(pc.green(`Finished building \`Electron\` for ${platform}.`));
-            console.log();
-        })
-            .catch((error) => {
-            console.log(pc.red("Export of Electron failed."));
-            console.log(pc.red(error));
-        });
-    }
-};
-/**
- * @description iOSのプロジェクトを生成
- *              Generate iOS project
- *
- * @return {Promise}
- * @method
- * @public
- */
-const generateNativeProject = () => {
-    return new Promise((resolve, reject) => {
-        if (fs.existsSync(`${process.cwd()}/${platform}`)) {
-            return resolve();
-        }
-        const stream = cp.spawn("npx", [
-            "cap",
-            "add",
-            platform
-        ], { "stdio": "inherit" });
-        stream.on("close", (code) => {
-            if (code !== 0) {
-                reject(`Failed generated ${platform} project.`);
-            }
-            console.log(pc.green(`Successfully generated ${platform} project.`));
-            console.log();
-            resolve();
-        });
-    });
-};
-/**
- * @description iOS用アプリの書き出し関数
- *              Export function for iOS apps
- *
- * @return {Promise}
- * @method
- * @public
- */
-const runNative = async () => {
-    await generateNativeProject();
-    /**
-     * Capacitorの書き出しに必要な設定を生成
-     * Generate settings necessary for exporting Capacitor
-     */
-    const config = JSON.parse(fs.readFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, { "encoding": "utf8" }));
-    config.webDir = `${$outDir}/${platformDir}/${environment}/`;
-    fs.writeFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, JSON.stringify(config, null, 2));
-    cp.spawn("npx", [
-        "cap",
-        "run",
-        platform
-    ], { "stdio": "inherit" });
-};
-/**
- * @description iOS/Androidアプリのオープン関数
- *              Open function for iOS/Android apps
- *
- * @return {Promise}
- * @method
- * @public
- */
-const openNative = async () => {
-    await generateNativeProject();
-    /**
-     * Capacitorの書き出しに必要な設定を生成
-     * Generate settings necessary for exporting Capacitor
-     */
-    const config = JSON.parse(fs.readFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, { "encoding": "utf8" }));
-    config.webDir = `${$outDir}/${platformDir}/${environment}/`;
-    fs.writeFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, JSON.stringify(config, null, 2));
-    const stream = cp.spawn("npx", [
-        "cap",
-        "sync",
-        platform
-    ], { "stdio": "inherit" });
-    stream.on("close", (code) => {
-        if (code !== 0) {
-            console.log(pc.red(`Failed to sync ${platform} project.`));
-            return;
-        }
-        cp.spawn("npx", [
-            "cap",
-            "open",
-            platform
-        ], { "stdio": "inherit" });
-    });
-};
-/**
- * @description iOS/Androidアプリのビルド関数
- *              Build function for iOS/Android apps
- *
- * @return {Promise}
- * @method
- * @public
- */
-const buildNative = async () => {
-    await generateNativeProject();
-    /**
-     * Capacitorの書き出しに必要な設定を生成
-     * Generate settings necessary for exporting Capacitor
-     */
-    const config = JSON.parse(fs.readFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, { "encoding": "utf8" }));
-    config.webDir = `${$outDir}/${platformDir}/${environment}/`;
-    fs.writeFileSync(`${process.cwd()}/${CAPACITOR_CONFIG_NAME}`, JSON.stringify(config, null, 2));
-    const stream = cp.spawn("npx", [
-        "cap",
-        "sync",
-        platform
-    ], { "stdio": "inherit" });
-    stream.on("close", (code) => {
-        if (code !== 0) {
-            console.log(pc.red(`Failed to sync ${platform} project.`));
-            return;
-        }
-        cp.spawn("npx", [
-            "cap",
-            "build",
-            platform
-        ], { "stdio": "inherit" });
-    });
-};
-/**
- * @type {string}
- * @constant
- */
-const XBOX_DIR_NAME = "xbox";
-/**
- * @description builder パッケージに同梱したテンプレートの絶対パスを取得
- *              Get the absolute path of a template shipped with the builder package
- *
- * @param  {string} name
- * @return {string}
- * @method
- * @public
- */
-const getTemplateDir = (name) => {
-    // dist/index.js から見た templates/ (パッケージルート直下)
-    const currentDir = path.dirname(fileURLToPath(import.meta.url));
-    return path.resolve(currentDir, "..", "templates", name);
-};
-/**
- * @type {string}
- * @constant
- */
-const XBOX_CONFIG_NAME = "MicrosoftGame.config";
-/**
- * @description 自動ダウンロードする prebuilt V8 のバージョン。
- *              `.github/workflows/build-v8.yml` で発行した Releases のタグと、
- *              `xbox-host-ci.yml` の V8_TAG に一致させること。
- *              The prebuilt V8 version to auto-download. Must match the release tag
- *              published by `build-v8.yml` and V8_TAG in `xbox-host-ci.yml`.
- *
- * @type {string}
- * @constant
- */
-const XBOX_V8_VERSION = "13.6.233.17";
-/**
- * @description ゲーム側の `xbox/` へスキャフォールドしないテンプレート内ファイル。
- *              - MicrosoftGame.config : ゲーム固有設定 (injectGameConfig が注入)
- *              - tests / .v8_headers  : builder リポジトリ側の開発用テスト・キャッシュ
- *              - build 系             : テンプレート内でビルドした場合の生成物
- *              Template entries excluded from the per-game `xbox/` scaffold.
- *
- * @type {Set<string>}
- * @constant
- */
-const XBOX_SCAFFOLD_EXCLUDES = new Set([
-    XBOX_CONFIG_NAME,
-    "tests",
-    ".v8_headers",
-    "build",
-    "out",
-    "_deps",
-    "CMakeCache.txt",
-    "CMakeFiles"
-]);
-/**
- * @description XboxホストのC++/CMake一式をbuilder同梱テンプレートから毎回更新する。
- *              ホストは「エンジン相当」でユーザーは編集しない前提のため、常に最新へ上書きする。
- *              ただし各ゲーム固有の `MicrosoftGame.config` は対象外(injectGameConfigが扱う)。
- *              Refresh the Xbox host (C++/CMake) from the builder's bundled template on every build.
- *              The host is engine-like and not user-edited, so it is always overwritten,
- *              excluding the per-game `MicrosoftGame.config` (handled by injectGameConfig).
- *
- * @return {Promise}
- * @method
- * @public
- */
-const refreshXboxHost = () => {
-    return new Promise((resolve, reject) => {
-        const projectDir = `${process.cwd()}/${XBOX_DIR_NAME}`;
-        const templateDir = getTemplateDir("xbox");
-        if (!fs.existsSync(templateDir)) {
-            return reject(`Xbox template not found: ${templateDir}`);
-        }
-        try {
-            fs.cpSync(templateDir, projectDir, {
-                "recursive": true,
-                // ゲーム固有設定と builder 側の開発用ファイルはスキャフォールドしない
-                "filter": (src) => !XBOX_SCAFFOLD_EXCLUDES.has(path.basename(src))
-            });
-            console.log(pc.green(`Successfully refreshed \`${XBOX_DIR_NAME}\` host.`));
-            resolve();
-        }
-        catch (error) {
-            reject(`Failed to refresh ${XBOX_DIR_NAME} host. ${error}`);
-        }
-    });
-};
-/**
- * @description ゲームルートの `MicrosoftGame.config` をXboxホストへ注入する。
- *              capacitor.config.json と同様、各ゲーム固有の設定(TitleId/StoreId/名称/ロゴ)は
- *              プロジェクトルートで管理し、それをホストのビルド対象へ配置する。
- *              未配置ならbuilder同梱の既定をフォールバックとして使い、作成を促す。
- *              Inject the game-root `MicrosoftGame.config` into the Xbox host.
- *
- * @return {Promise}
- * @method
- * @public
- */
-const injectGameConfig = () => {
-    return new Promise((resolve, reject) => {
-        const rootConfig = `${process.cwd()}/${XBOX_CONFIG_NAME}`;
-        const hostConfig = `${process.cwd()}/${XBOX_DIR_NAME}/${XBOX_CONFIG_NAME}`;
-        try {
-            if (fs.existsSync(rootConfig)) {
-                fs.cpSync(rootConfig, hostConfig);
-                console.log(pc.green(`Applied project \`${XBOX_CONFIG_NAME}\`.`));
-            }
-            else {
-                // フォールバック: builder同梱の既定を配置し、ルートへの作成を促す
-                fs.cpSync(`${getTemplateDir("xbox")}/${XBOX_CONFIG_NAME}`, hostConfig);
-                console.log(pc.yellow(`\`${XBOX_CONFIG_NAME}\` not found at project root. Using the default template.`));
-                console.log(pc.yellow(`Create \`${XBOX_CONFIG_NAME}\` at your project root (like capacitor.config.json) to set TitleId/StoreId/logos.`));
-            }
-            resolve();
-        }
-        catch (error) {
-            reject(`Failed to apply ${XBOX_CONFIG_NAME}. ${error}`);
-        }
-    });
-};
-/**
- * @description ビルド済みWeb資材(JS/HTML/アセット)をXboxホストのassetsへ配置
- *              Deploy built web resources (JS/HTML/assets) into the Xbox host assets
- *
- * @return {Promise}
- * @method
- * @public
- */
-const copyXboxResources = () => {
-    return new Promise((resolve, reject) => {
-        const assetsDir = `${process.cwd()}/${XBOX_DIR_NAME}/assets/app`;
-        try {
-            // reset
-            fs.rmSync(assetsDir, { "recursive": true, "force": true });
-            fs.mkdirSync(assetsDir, { "recursive": true });
-            // copy built web resources (JS/HTML/assets)
-            fs.cpSync(`${$buildDir}/`, assetsDir, { "recursive": true });
-            console.log(pc.green("Successfully copy built resources to Xbox host."));
-            resolve();
-        }
-        catch (error) {
-            reject(`Failed to copy built resources to Xbox host. ${error}`);
-        }
-    });
-};
-/**
- * @description Xbox ビルドに使う V8 のパスを解決する。優先順:
- *              1. `--v8-root` 引数
- *              2. 環境変数 `V8_ROOT`
- *              3. キャッシュ済みの prebuilt (%LOCALAPPDATA%/next2d/v8/<version>)
- *              4. GitHub Releases (build-v8.yml が発行) から自動ダウンロード
- *              3・4 により、通常は何も指定せずに `--platform xbox` だけでビルドできる。
- *              Resolve the V8 path for the Xbox build. With the cached/auto-downloaded
- *              prebuilt, no flag or env var is required in the common case.
- *
- * @return {Promise<string>}
- * @method
- * @public
- */
-const resolveXboxV8Root = async () => {
-    // 1. --v8-root 引数
-    if (v8Root) {
-        return path.resolve(process.cwd(), v8Root);
-    }
-    // 2. 環境変数 V8_ROOT
-    if (process.env.V8_ROOT) {
-        return process.env.V8_ROOT;
-    }
-    // 3. キャッシュ済み prebuilt
-    const cacheBase = process.env.LOCALAPPDATA
-        ? `${process.env.LOCALAPPDATA}/next2d`
-        : `${os.homedir()}/.cache/next2d`;
-    const cacheDir = `${cacheBase}/v8/${XBOX_V8_VERSION}`;
-    if (fs.existsSync(`${cacheDir}/include/v8.h`)) {
-        return cacheDir;
-    }
-    // 4. GitHub Releases から自動ダウンロード (マシンごとに初回のみ)
-    const assetName = `v8-monolith-${XBOX_V8_VERSION}-windows-x64.zip`;
-    const url = `https://github.com/Next2D/builder/releases/download/v8-${XBOX_V8_VERSION}-windows-x64/${assetName}`;
-    console.log(pc.green(`Downloading prebuilt V8 ${XBOX_V8_VERSION} (first time only) ...`));
-    console.log(url);
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`download failed: HTTP ${response.status}`);
-    }
-    fs.mkdirSync(cacheDir, { "recursive": true });
-    const zipPath = `${cacheDir}/${assetName}.tmp`;
-    fs.writeFileSync(zipPath, Buffer.from(await response.arrayBuffer()));
-    // Windows 10+ 標準の tar (bsdtar) は zip も展開できる
-    const extract = cp.spawnSync("tar", ["-xf", zipPath, "-C", cacheDir], { "stdio": "inherit" });
-    fs.rmSync(zipPath, { "force": true });
-    if (extract.status !== 0 || !fs.existsSync(`${cacheDir}/include/v8.h`)) {
-        fs.rmSync(cacheDir, { "recursive": true, "force": true });
-        throw new Error("failed to extract the prebuilt V8 archive");
-    }
-    console.log(pc.green(`Prebuilt V8 cached at: ${cacheDir}`));
-    return cacheDir;
-};
-/**
- * @description Xbox(GDKネイティブ)用アプリの書き出し関数。
- *              V8にNext2DのJSを載せ、Dawn(WebGPU/D3D12)で描画するC++ホストをビルドする。
- *              Export function for Xbox (GDK native) apps.
- *              Builds a C++ host that runs Next2D's JS on V8 and renders via Dawn (WebGPU/D3D12).
- *
- * @return {Promise}
- * @method
- * @public
- */
-const buildXbox = async () => {
-    // C++/CMake ホストを最新へ更新 (ゲーム固有設定は除外)
-    await refreshXboxHost();
-    // ゲームルートの MicrosoftGame.config を注入
-    await injectGameConfig();
-    // ビルド済みWeb資材を配置
-    await copyXboxResources();
-    /**
-     * GDK ビルドは Windows + Visual Studio + Microsoft GDK が必須。
-     * それ以外の環境ではスキャフォールドと資材配置のみを行い、手順を案内する。
-     * The GDK build requires Windows + Visual Studio + Microsoft GDK.
-     * On other platforms we only scaffold and copy assets, then guide the next steps.
-     */
-    if (process.platform !== "win32") {
-        console.log();
-        console.log(pc.yellow("Xbox host project has been generated and assets were copied."));
-        console.log(pc.yellow("The GDK build must run on Windows with Visual Studio and the Microsoft GDK installed."));
-        console.log(pc.yellow(`See ${XBOX_DIR_NAME}/README.md for the build steps.`));
-        console.log();
-        return;
-    }
-    /**
-     * @type {string}
-     * GDK の対象コンソール世代。既定は Xbox Series X|S (Scarlett)。
-     * 必要に応じて `Gaming.Xbox.XboxOne.x64` / `Gaming.Desktop.x64` を選択。
-     */
-    const gdkArch = process.env.NEXT2D_XBOX_ARCH || "Gaming.Xbox.Scarlett.x64";
-    const cmakeBuildDir = `${process.cwd()}/${$outDir}/${platformDir}/build`;
-    /**
-     * prebuilt V8 のパスを解決する (--v8-root > V8_ROOT > キャッシュ > 自動ダウンロード)。
-     * 通常は何も指定せずにビルドできる。
-     */
-    let resolvedV8Root = "";
-    try {
-        resolvedV8Root = await resolveXboxV8Root();
-    }
-    catch (error) {
-        console.log(pc.red(`Failed to prepare the prebuilt V8: ${error}`));
-        console.log(pc.red("Fallbacks:"));
-        console.log(pc.red("  1) Retry later (the download may have failed temporarily)."));
-        console.log(pc.red("  2) Build V8 yourself and pass `--v8-root <path>`:"));
-        console.log(pc.red("     npx @next2d/builder --platform xbox --env prd --v8-root C:\\path\\to\\v8"));
-        console.log(pc.red(`     See ${XBOX_DIR_NAME}/README.md ("V8 の用意") for the build steps.`));
-        return;
-    }
-    if (!fs.existsSync(`${resolvedV8Root}/include/v8.h`)) {
-        console.log(pc.red(`\`include/v8.h\` not found under: ${resolvedV8Root}`));
-        console.log(pc.red(`Check the \`--v8-root\` path. See ${XBOX_DIR_NAME}/README.md for how to prepare the prebuilt V8.`));
-        return;
-    }
-    const configure = () => {
-        return new Promise((resolve, reject) => {
-            const stream = cp.spawn("cmake", [
-                "-S", `${process.cwd()}/${XBOX_DIR_NAME}`,
-                "-B", cmakeBuildDir,
-                "-G", "Visual Studio 17 2022",
-                "-A", gdkArch,
-                "-D", `V8_ROOT=${resolvedV8Root}`
-            ], { "stdio": "inherit" });
-            stream.on("close", (code) => {
-                if (code !== 0) {
-                    return reject("Failed to configure the Xbox (CMake/GDK) project.");
-                }
-                resolve();
-            });
-        });
-    };
-    await configure();
-    if (open || preview) {
-        // Visual Studio ソリューションを開く (実機/エミュレータでの実行はVS側で行う)
-        cp.spawn("cmake", [
-            "--open", cmakeBuildDir
-        ], { "stdio": "inherit" });
-        return;
-    }
-    // フルビルド (Release パッケージまで)
-    const stream = cp.spawn("cmake", [
-        "--build", cmakeBuildDir,
-        "--config", "Release"
-    ], { "stdio": "inherit" });
-    stream.on("close", (code) => {
-        if (code !== 0) {
-            console.log(pc.red("Export of the Xbox (GDK) package failed."));
-            return;
-        }
-        console.log();
-        console.log(pc.green(`Finished building the Xbox (GDK) package for ${gdkArch}.`));
-        console.log();
-    });
-};
-/**
- * @description ビルドの実行関数
- *              Build Execution Functions
- *
- * @return {void}
- * @method
- * @public
- */
 const multiBuild = async () => {
-    switch (platform) {
+    switch (ctx.platform) {
         case "windows":
         case "macos":
         case "linux":
         case "steam:windows":
         case "steam:macos":
         case "steam:linux":
-            await buildSteam();
+            await buildElectron();
             break;
         case "ios":
         case "android":
             switch (true) {
-                case open:
+                case ctx.open:
                     await openNative();
                     break;
-                case build:
+                case ctx.build:
                     await buildNative();
                     break;
-                case preview:
+                case ctx.preview:
                     await runNative();
                     break;
                 default: