@next2d/builder 0.1.6 → 0.1.8

package/README.md

@@ -48,9 +48,13 @@ On other platforms the builder scaffolds the host project and stages assets only
 See the generated `xbox/README.md` for full build steps.
 
 ```bat
-npx @next2d/builder --platform xbox --env prd --v8-root C:\path\to\v8
+npx @next2d/builder --platform xbox --env prd
 ```
 
+The prebuilt V8 engine is downloaded automatically on the first Xbox build
+(published from the `build-v8` workflow). To use your own build, pass
+`--v8-root C:\path\to\v8`.
+
 ### Scheduled introduction
 
 | platform        | 

package/dist/index.js

@@ -2,6 +2,7 @@
 "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";
@@ -76,8 +77,9 @@ const echoHelp = () => {
     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 monolith path):");
-    console.log("npx @next2d/builder --platform xbox --env prd --v8-root C:\\path\\to\\v8");
+    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);
 };
@@ -168,14 +170,14 @@ const loadConfig = async () => {
  */
 const buildWeb = () => {
     return new Promise((resolve, reject) => {
-        const stream = cp.spawn("npx", [
+        const stream = $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", [
+            const stream = $spawn("npx", [
                 "vite",
                 "--outDir",
                 $buildDir,
@@ -205,7 +207,7 @@ const installElectron = () => {
         if (fs.existsSync(`${process.cwd()}/electron/node_modules`)) {
             return resolve();
         }
-        const stream = cp.spawn("npm", [
+        const stream = $spawn("npm", [
             "--prefix",
             `${process.cwd()}/electron`,
             "install",
@@ -281,7 +283,7 @@ const buildSteam = async () => {
     // copy HTML, JavaScript
     await copyResources();
     if (preview) {
-        cp.spawn("npx", [
+        $spawn("npx", [
             "electron",
             `${process.cwd()}/electron/index.js`
         ], { "stdio": "inherit" });
@@ -339,7 +341,7 @@ const generateNativeProject = () => {
         if (fs.existsSync(`${process.cwd()}/${platform}`)) {
             return resolve();
         }
-        const stream = cp.spawn("npx", [
+        const stream = $spawn("npx", [
             "cap",
             "add",
             platform
@@ -371,7 +373,7 @@ const runNative = async () => {
     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", [
+    $spawn("npx", [
         "cap",
         "run",
         platform
@@ -394,7 +396,7 @@ const openNative = async () => {
     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", [
+    const stream = $spawn("npx", [
         "cap",
         "sync",
         platform
@@ -404,7 +406,7 @@ const openNative = async () => {
             console.log(pc.red(`Failed to sync ${platform} project.`));
             return;
         }
-        cp.spawn("npx", [
+        $spawn("npx", [
             "cap",
             "open",
             platform
@@ -428,7 +430,7 @@ const buildNative = async () => {
     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", [
+    const stream = $spawn("npx", [
         "cap",
         "sync",
         platform
@@ -438,7 +440,7 @@ const buildNative = async () => {
             console.log(pc.red(`Failed to sync ${platform} project.`));
             return;
         }
-        cp.spawn("npx", [
+        $spawn("npx", [
             "cap",
             "build",
             platform
@@ -469,6 +471,50 @@ const getTemplateDir = (name) => {
  * @constant
  */
 const XBOX_CONFIG_NAME = "MicrosoftGame.config";
+/**
+ * @description npx / npm を子プロセスとして起動する (クロスプラットフォーム)。
+ *              Windows では npx/npm が .cmd (バッチファイル) のため、shell 経由で
+ *              ないと起動できない (spawn ENOENT / Node の CVE-2024-27980 対応により
+ *              .cmd の直接 spawn も不可)。スペースを含む引数は二重引用符で保護する。
+ *              Spawn npx/npm cross-platform. On Windows they are .cmd batch files,
+ *              which require a shell to spawn.
+ *
+ * @param  {string} command
+ * @param  {array} args
+ * @param  {object} options
+ * @return {object}
+ * @method
+ * @public
+ */
+const $spawn = (command, args, options = {}) => {
+    if (process.platform === "win32" && (command === "npx" || command === "npm")) {
+        const quoted = args.map((a) => /\s/.test(a) ? `"${a}"` : a);
+        return cp.spawn(command, quoted, { ...options, "shell": true });
+    }
+    return cp.spawn(command, args, options);
+};
+/**
+ * @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.7.152.19";
+/**
+ * @description prebuilt V8 のアセットリビジョン。同一 V8 バージョンでも
+ *              gn フラグ変更 (例: r2 = WebAssembly + DrumBrake 有効化) で
+ *              バイナリが変わる場合に上げ、Release タグとローカルキャッシュを分離する。
+ *              Asset revision. Bump when gn flags change for the same V8 version
+ *              (r2 = WebAssembly + DrumBrake enabled).
+ *
+ * @type {string}
+ * @constant
+ */
+const XBOX_V8_REVISION = "r3";
 /**
  * @description ゲーム側の `xbox/` へスキャフォールドしないテンプレート内ファイル。
  *              - MicrosoftGame.config : ゲーム固有設定 (injectGameConfig が注入)
@@ -580,6 +626,59 @@ const copyXboxResources = () => {
         }
     });
 };
+/**
+ * @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}-${XBOX_V8_REVISION}`;
+    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-${XBOX_V8_REVISION}/${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++ホストをビルドする。
@@ -619,18 +718,20 @@ const buildXbox = async () => {
     const gdkArch = process.env.NEXT2D_XBOX_ARCH || "Gaming.Xbox.Scarlett.x64";
     const cmakeBuildDir = `${process.cwd()}/${$outDir}/${platformDir}/build`;
     /**
-     * prebuilt V8 monolith のパス。優先順: `--v8-root` 引数 > 環境変数 V8_ROOT。
-     * どちらも無い場合は CMake (FindV8.cmake) が明確なエラーで停止するため、
-     * ここでは事前に分かりやすく案内だけする。
+     * prebuilt V8 のパスを解決する (--v8-root > V8_ROOT > キャッシュ > 自動ダウンロード)。
+     * 通常は何も指定せずにビルドできる。
      */
-    const resolvedV8Root = v8Root
-        ? path.resolve(process.cwd(), v8Root)
-        : process.env.V8_ROOT || "";
-    if (!resolvedV8Root) {
-        console.log(pc.red("V8 path is not specified."));
-        console.log(pc.red("Pass `--v8-root <path>` (or set the V8_ROOT environment variable):"));
-        console.log(pc.red("  npx @next2d/builder --platform xbox --env prd --v8-root C:\\path\\to\\v8"));
-        console.log(pc.red(`The path must contain \`include/v8.h\` and \`lib/v8_monolith.lib\`. See ${XBOX_DIR_NAME}/README.md.`));
+    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`)) {
@@ -663,19 +764,22 @@ const buildXbox = async () => {
         ], { "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();
+    // フルビルド (Release パッケージまで)。失敗時は reject して非ゼロ終了させる
+    // (以前は表示のみで exit code 0 のまま成功扱いになっていた)
+    await new Promise((resolve, reject) => {
+        const stream = cp.spawn("cmake", [
+            "--build", cmakeBuildDir,
+            "--config", "Release"
+        ], { "stdio": "inherit" });
+        stream.on("close", (code) => {
+            if (code !== 0) {
+                return reject("Export of the Xbox (GDK) package failed.");
+            }
+            console.log();
+            console.log(pc.green(`Finished building the Xbox (GDK) package for ${gdkArch}.`));
+            console.log();
+            resolve();
+        });
     });
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next2d/builder",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Multi-platform builder for Next2d Framework, supporting export to various platforms such as macOS, Windows, iOS, Android and Web(HTML)",
   "author": "Toshiyuki Ienaga <ienaga@next2d.app>",
   "license": "MIT",
@@ -22,6 +22,7 @@
   ],
   "scripts": {
     "lint": "eslint src/index.ts",
+    "prepare": "tsc",
     "release": "tsc"
   },
   "files": [
@@ -39,7 +40,7 @@
     "@electron-forge/core": "^7.11.2",
     "@types/node": "^26.1.0",
     "picocolors": "^1.1.1",
-    "vite": "^8.1.2"
+    "vite": "^8.1.3"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.5",

package/templates/xbox/CMakeLists.txt

@@ -23,6 +23,18 @@ set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_CXX_EXTENSIONS OFF)
 
+if(MSVC)
+    # MSVC は /Zc:__cplusplus を渡さないと __cplusplus を 199711L のまま報告し
+    # (/std:c++20 を指定していても)、v8config.h の C++20 チェックで停止する。
+    add_compile_options(/Zc:__cplusplus)
+endif()
+
+# CRT は静的 (/MT, Debug は /MTd) に統一する。
+# prebuilt V8 monolith は GN の既定で静的 CRT ビルドのため、ホスト側が既定の /MD だと
+# libcpmt.lib と msvcprt.lib が衝突して LNK2005/LNK2038 でリンクに失敗する。
+# ここで設定することで FetchContent の Dawn も同じ CRT でビルドされる。
+set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+
 # GDK target platform (Gaming.Xbox.* / Gaming.Desktop.*) の判定
 if(NOT DEFINED CMAKE_GENERATOR_PLATFORM)
     message(WARNING "CMAKE_GENERATOR_PLATFORM が未設定です。builder は -A Gaming.Xbox.Scarlett.x64 等を渡します。")
@@ -35,6 +47,28 @@ else()
     set(NEXT2D_IS_CONSOLE OFF)
 endif()
 
+# -----------------------------------------------------------------------------
+# GDK の解決 (2通り)
+#   A) インストール済み GDK: -A Gaming.Desktop.x64 / Gaming.Xbox.* でビルド。
+#      VS 統合が include/lib を自動供給するため追加設定は不要。
+#   B) 展開レイアウト (インストーラ不要・CI 向け): NuGet の Microsoft.GDK.Windows を
+#      展開し、-A x64 + GDK_ROOT (cmake 変数 or 環境変数) で指定する。
+#      GDK_ROOT は <package>/native/<edition>/windows を指す (include/, lib/x64/, bin/x64/)。
+# -----------------------------------------------------------------------------
+string(FIND "${CMAKE_GENERATOR_PLATFORM}" "Gaming." _is_gaming_platform)
+if(_is_gaming_platform LESS 0)
+    if(NOT DEFINED GDK_ROOT)
+        set(GDK_ROOT "$ENV{GDK_ROOT}")
+    endif()
+    if(NOT GDK_ROOT OR NOT EXISTS "${GDK_ROOT}/include/XGameRuntime.h")
+        message(FATAL_ERROR
+            "GDK が見つかりません。次のいずれかで指定してください:\n"
+            "  1) GDK をインストールして -A Gaming.Desktop.x64 でビルド\n"
+            "  2) NuGet の Microsoft.GDK.Windows を展開し、-A x64 で\n"
+            "     -D GDK_ROOT=<package>/native/<edition>/windows (または環境変数 GDK_ROOT) を指定")
+    endif()
+endif()
+
 # -----------------------------------------------------------------------------
 # 依存: Dawn (WebGPU 実装 / D3D12 バックエンド)
 # -----------------------------------------------------------------------------
@@ -61,11 +95,46 @@ target_include_directories(Next2DXboxHost PRIVATE
     "${CMAKE_CURRENT_SOURCE_DIR}/src"
 )
 
+# 展開レイアウト (GDK_ROOT) 使用時: include/lib を明示指定し、実行時 DLL を並べる
+if(_is_gaming_platform LESS 0)
+    target_include_directories(Next2DXboxHost PRIVATE "${GDK_ROOT}/include")
+    target_link_directories(Next2DXboxHost PRIVATE "${GDK_ROOT}/lib/x64")
+    add_custom_command(TARGET Next2DXboxHost POST_BUILD
+        COMMAND ${CMAKE_COMMAND} -E copy_if_different
+            "${GDK_ROOT}/bin/x64/xgameruntime.dll"
+            "$<TARGET_FILE_DIR:Next2DXboxHost>"
+        COMMENT "Staging xgameruntime.dll next to the executable")
+endif()
+
 target_link_libraries(Next2DXboxHost PRIVATE
     v8::v8
     dawn::webgpu_dawn
 )
 
+if(MSVC)
+    # CRT は静的 (/MT) に統一している (V8 monolith が静的 CRT 固定のため)。
+    # 一方 GDK の xgameruntime.lib 等は /MD ビルドで /DEFAULTLIB:msvcprt を
+    # 持ち込み LNK2005 (多重定義) を起こすので、動的 C++ ランタイムを除外して
+    # 静的側 (libcpmt) に一本化する。
+    target_link_options(Next2DXboxHost PRIVATE
+        /NODEFAULTLIB:msvcprt.lib
+        /NODEFAULTLIB:msvcprtd.lib
+    )
+
+    # Release でも PDB を生成する (クラッシュダンプ解析でスタックを名前解決するため)
+    target_compile_options(Next2DXboxHost PRIVATE /Zi)
+    target_link_options(Next2DXboxHost PRIVATE /DEBUG /OPT:REF /OPT:ICF)
+endif()
+
+# webgpu_dawn は SHARED (DLL)。実行に必要なため exe の隣へステージする
+if(TARGET webgpu_dawn)
+    add_custom_command(TARGET Next2DXboxHost POST_BUILD
+        COMMAND ${CMAKE_COMMAND} -E copy_if_different
+            "$<TARGET_FILE:webgpu_dawn>"
+            "$<TARGET_FILE_DIR:Next2DXboxHost>"
+        COMMENT "Staging webgpu_dawn.dll next to the executable")
+endif()
+
 # WebGPU / D3D12 / GameInput / WIC / XAudio2 / GDK
 target_link_libraries(Next2DXboxHost PRIVATE
     d3d12
@@ -92,10 +161,13 @@ else()
     target_compile_definitions(Next2DXboxHost PRIVATE NEXT2D_XBOX_CONSOLE=0)
 endif()
 
-# V8 のプラットフォーム要件
+# V8 のプラットフォーム要件。
+# prebuilt V8 (build-v8.yml) のビルドフラグと一致させること:
+#   V8_COMPRESS_POINTERS <-> v8_enable_pointer_compression=true
+#   sandbox は無効 (libc++ ハードニング必須のため use_custom_libcxx=false と両立しない)
+#   → V8_ENABLE_SANDBOX は定義しない
 target_compile_definitions(Next2DXboxHost PRIVATE
     V8_COMPRESS_POINTERS
-    V8_ENABLE_SANDBOX
     NOMINMAX
     WIN32_LEAN_AND_MEAN
     UNICODE

package/templates/xbox/README.md

@@ -51,7 +51,7 @@ C++ 実行ファイルをビルドします。Electron や WebView は使用し
 ### ランタイム環境の要点
 
 - **jitless V8**: Xbox/Switch のリテールは JIT(動的コード生成)を禁止するため、V8 は
-  `--jitless`(Ignition インタプリタのみ)で起動する。WebAssembly も無効。
+  `--jitless --wasm-jitless` で起動する (JS=Ignition インタプリタ、wasm=DrumBrake インタープリタ)。
 - **Worker / OffscreenCanvas**: player はレンダラを Worker + `transferControlToOffscreen`
   で動かす。本ホストは **「同一 Isolate 内の別 Context を協調スケジューリングする単一スレッド
   Worker モデル」** を採用（`src/worker/WorkerRuntime`）。`postMessage` は V8 の
@@ -73,9 +73,9 @@ C++ 実行ファイルをビルドします。Electron や WebView は使用し
 |------|------|
 | OS | Windows 11 |
 | IDE | Visual Studio 2022 (v143, C++ Game development workload) |
-| GDK | Microsoft GDK (June 2024 以降) — ID@Xbox 登録が必要 |
+| GDK | 公開版 GDK をインストール (`-A Gaming.Desktop.x64`)、**または** NuGet `Microsoft.GDK.Windows` を展開して `-A x64` + 環境変数/`-D` `GDK_ROOT=<pkg>/native/<edition>/windows`(インストーラ不要・CI 向け)。コンソール向け GDKX は ID@Xbox 登録が必要 |
 | CMake | 3.26 以降 |
-| V8 | prebuilt monolith (`v8_monolith.lib` + `include/`) |
+| V8 | 不要 (builder が prebuilt を自動ダウンロード)。自前ビルドは `--v8-root` で指定可 |
 | Dawn | CMake の FetchContent で自動取得(ネットワーク必須) |
 | devkit | Xbox 開発機(実機検証用) |
 
@@ -83,25 +83,75 @@ C++ 実行ファイルをビルドします。Electron や WebView は使用し
 
 ## V8 の用意
 
-V8 はソースビルドが非常に重いため prebuilt monolith を使います。自前ビルド例:
+**通常は何も必要ありません。** builder が Next2D の GitHub Releases から
+prebuilt V8 monolith を自動ダウンロードし、`%LOCALAPPDATA%\next2d\v8\<version>` に
+キャッシュします (マシンごとに初回のみ、以後は再利用)。
+
+自動ダウンロードを使わない場合の優先順:
+
+1. `--v8-root <path>` 引数
+2. 環境変数 `V8_ROOT`
+3. キャッシュ済み prebuilt
+4. GitHub Releases から自動ダウンロード
+
+> prebuilt は builder リポジトリの `build-v8.yml` ワークフロー (windows-latest) で
+> ビルドして Releases に発行しています。バージョンは builder の `XBOX_V8_VERSION` に固定。
+
+### 自前ビルドする場合 (任意)
+
+コンソール実機向け (GDK ツールチェーン) や V8 バージョンを変えたい場合のみ。
+**マシンごとに 1 回だけ**の作業で、以後は `--v8-root` で使い回せます。
+
+事前準備 (V8 ビルド用):
+
+| 項目 | 内容 |
+|------|------|
+| ディスク | 約 40GB (ソース + ビルド生成物) |
+| 時間 | 初回 fetch 30〜60 分 + ビルド 1〜3 時間 |
+| Git | インストール済みであること |
+| depot_tools | [取得手順](https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up)に従い展開し、**PATH の先頭**に追加 |
+| 環境変数 | `DEPOT_TOOLS_WIN_TOOLCHAIN=0` (Google 社内ツールチェーンを使わない指定。未設定だと fetch が失敗する) |
+| Windows SDK | Visual Studio Installer で「Windows 11 SDK」と「Windows 用デバッグツール」を含めること (GN が要求する) |
+
+ビルド手順:
 
 ```bat
-:: depot_tools 導入後
+set DEPOT_TOOLS_WIN_TOOLCHAIN=0
 fetch v8
 cd v8
-gn gen out\x64.release --args="v8_monolithic=true v8_use_external_startup_data=false is_component_build=false target_cpu=\"x64\" is_debug=false v8_enable_pointer_compression=true v8_enable_sandbox=true"
+:: CI のコンパイル検証と同じバージョンに固定 (xbox-host-ci.yml の V8_TAG)
+git checkout 13.7.152.19
+gclient sync
+gn gen out\x64.release --args="v8_monolithic=true v8_use_external_startup_data=false is_component_build=false use_custom_libcxx=false icu_use_data_file=false treat_warnings_as_errors=false v8_enable_drumbrake=true target_cpu=\"x64\" is_debug=false v8_enable_pointer_compression=true v8_enable_sandbox=false"
 ninja -C out\x64.release v8_monolith
 ```
 
 生成物を次の構成で配置し、builder の `--v8-root` 引数 (または環境変数 `V8_ROOT`) で指すこと:
 
 ```
-<V8_ROOT>/include/v8.h ...
-<V8_ROOT>/lib/v8_monolith.lib
+<V8_ROOT>/include/v8.h ...      (v8/include を丸ごとコピー)
+<V8_ROOT>/lib/v8_monolith.lib   (v8/out/x64.release/obj/v8_monolith.lib)
 ```
 
-> V8 のビルドフラグ(pointer compression / sandbox)は `CMakeLists.txt` の
-> `V8_COMPRESS_POINTERS` / `V8_ENABLE_SANDBOX` と一致させてください。不一致は ABI 崩れの原因になります。
+> - `use_custom_libcxx=false` は必須。V8 は clang でビルドされるため、これを外すと
+>   V8 同梱の libc++ が使われ、MSVC (MS STL) でビルドする本ホストとリンクできません。
+> - `v8_enable_sandbox=false` は必須。sandbox は libc++ ハードニング(=V8 同梱 libc++)を
+>   要求するため `use_custom_libcxx=false` と両立しません (BUILD.gn の assert で停止)。
+>   本ホストは自明に信頼済みのゲーム JS のみ実行するため無効で問題ありません。
+> - `icu_use_data_file=false` を推奨。外すと実行時に `icudtl.dat` の同梱が必要になります。
+> - `treat_warnings_as_errors=false` を推奨。`use_custom_libcxx=false` では MSVC STL の
+>   ヘッダ警告が -Werror で停止することがあります。**VS のバージョンは VS2022 (v143) を推奨**
+>   (新しすぎる STL は V8 の clang が警告/エラーを出しやすい)。
+> - `v8_enable_drumbrake=true` は必須 (r2)。**DrumBrake = V8 の wasm インタープリタ**で、
+>   JIT 禁止環境 (コンソール) でも wasm を解釈実行できます。wasm はビルド時に turbofan を
+>   要求するため `v8_jitless` ビルドは使えません — JIT の無効化はホストが実行時フラグ
+>   `--jitless --wasm-jitless` で行います (JS=Ignition / wasm=DrumBrake)。
+>   注意: DrumBrake は既定ビルド対象外のためタグによりコンパイル不能な場合があります
+>   (13.6.233.17 は不可 → 13.7.152.19 で修正済み)。
+> - pointer compression は `CMakeLists.txt` の `V8_COMPRESS_POINTERS` と一致させてください
+>   (sandbox 無効に合わせ `V8_ENABLE_SANDBOX` は定義しません)。不一致は ABI 崩れの原因になります。
+> - 上記は PC (`Gaming.Desktop.x64`) 用。コンソール実機 (`Gaming.Xbox.*`) 向けは
+>   GDK ツールチェーンでの再ビルドが必要です (devkit 入手後の作業)。
 
 ---
 
@@ -110,7 +160,13 @@ ninja -C out\x64.release v8_monolith
 builder 経由(推奨):
 
 ```bat
-:: プロジェクトルートで。V8 は --v8-root で指定する (環境変数 V8_ROOT でも可)
+:: プロジェクトルートで。V8 は初回に自動ダウンロードされる (指定不要)
+npx @next2d/builder --platform xbox --env prd
+```
+
+自前の V8 を使う場合のみ `--v8-root` を指定:
+
+```bat
 npx @next2d/builder --platform xbox --env prd --v8-root C:\path\to\v8
 ```
 
@@ -157,7 +213,7 @@ macOS / Linux でそのまま実行できます:
 tests/check_local.sh
 ```
 
-構文チェックは実 V8 ヘッダ (pin: `13.6.233.17`) に対して、Windows API 非依存の
+構文チェックは実 V8 ヘッダ (pin: `13.7.152.19`) に対して、Windows API 非依存の
 V8 バインディング 12 ファイルをコンパイル検証します (API 削除・型不整合を検出)。
 
 ### 2. GitHub Actions (windows-latest) — `.github/workflows/xbox-host-ci.yml`
@@ -249,6 +305,11 @@ player の実 API 使用を全面調査し、以下を実装済み。**この環
 | ポインタ/キーボード/ホイール入力 | ⚠️ 実装(要検証) | `WndProc`→`DispatchEvent`。配送先canvasの特定は実機検証 |
 | 動画 (HTMLVideoElement) | ⚠️ 実装(要検証) | `Video.cpp`(Media Foundation)。フレーム精度/音声同期は実機検証 |
 | クリップボード (`navigator.clipboard`) | ✅ 実装 | Win32 クリップボード (readText/writeText) |
+| **JS エンジン/グローバル機能** (player 全数調査) | ✅ 実装 | Proxy=V8コア。`crypto.randomUUID`/`getRandomValues`(BCrypt)、`TextEncoder`/`TextDecoder`/`queueMicrotask`/`location`/`atob`/`btoa` は worker 含む全コンテキストへ注入。`createImageBitmap` は ImageData/ImageBitmap/canvas/Blob を受理 |
+| **WebAssembly** | ✅ 実装 (要 V8 r2) | prebuilt V8 r2 = wasm + **DrumBrake**(V8 の wasm インタープリタ、JIT 禁止コンソール向け)。実行時 `--jitless --wasm-jitless` で JS=Ignition / wasm=DrumBrake 解釈実行 |
+| **indexedDB** (最小実装) | ✅ 実装 | open/createObjectStore/transaction/get/put/delete/clear/getAll/count/keyPath。値は JSON 化可能なもの + ArrayBuffer/TypedArray(base64 永続化)。カーソル/インデックスは未対応。保存先 `%LOCALAPPDATA%\Next2D\idb_<db>.json` |
+| **localStorage / sessionStorage** | ✅ 実装 | JS セマンティクス + ファイル永続化 (`%LOCALAPPDATA%\Next2D\`)。コンソール実機では XGameSave 化が必要 («EXTEND») |
+| **Audio 要素** (`new Audio(url)`) | ✅ 実装 | play/pause/paused/loop/volume/currentTime/preload (pause→play は先頭から) |
 
 > player が使用する API はコード上すべて実装済み。残る唯一の障壁は
 > **GDK/devkit を要するコンパイル・実機検証**(この環境では物理的に不可)。

package/templates/xbox/cmake/FetchDawn.cmake

@@ -3,13 +3,18 @@
 # D3D12 バックエンドのみを有効化し、Xbox(GDK)/PC(GDK) で利用する。
 #
 # 注意:
-#   - Dawn のビルドには depot_tools 由来の一部が不要になる CMake パスを使用する。
+#   - submodule はクローンしない (GIT_SUBMODULES "")。SwiftShader→LLVM まで再帰して
+#     数 GB のクローン + Windows の MAX_PATH 超過 ("Filename too long") で失敗するため。
+#     依存は Dawn 公式の DAWN_FETCH_DEPENDENCIES (python スクリプト) が必要分だけ取得する。
+#   - DAWN_FETCH_DEPENDENCIES には python3 が PATH に必要。
 #   - 初回構成はネットワークとビルド時間を要する。CI ではキャッシュ推奨。
-#   - DAWN_TAG は動作確認済みタグに固定すること (chromium ブランチに追従)。
+#   - DAWN_TAG はバインディング (bindings/webgpu/*) が使う API 世代と一致させること:
+#     wgpu::Limits / ShaderSourceWGSL / SurfaceSourceWindowsHWND / OptionalBool
+#     (いずれも 2025 以降の命名。古いタグでは SupportedLimits 等になりビルド不可)
 # =============================================================================
 include(FetchContent)
 
-set(DAWN_TAG "chromium/6478" CACHE STRING "Dawn のチェックアウトタグ")
+set(DAWN_TAG "v20260402.171122" CACHE STRING "Dawn のチェックアウトタグ (github.com/google/dawn)")
 
 # Dawn のビルドオプション: 必要なものだけを有効化
 set(DAWN_FETCH_DEPENDENCIES     ON  CACHE BOOL "" FORCE)
@@ -24,14 +29,24 @@ set(DAWN_BUILD_SAMPLES          OFF CACHE BOOL "" FORCE)
 set(TINT_BUILD_TESTS            OFF CACHE BOOL "" FORCE)
 set(TINT_BUILD_CMD_TOOLS        OFF CACHE BOOL "" FORCE)
 
-# webgpu_dawn: webgpu.h C-API を提供する統合ライブラリ (バインディング層はこれを叩く)
-set(DAWN_BUILD_MONOLITHIC_LIBRARY ON CACHE BOOL "" FORCE)
+# webgpu_dawn: webgpu.h C-API を提供する統合ライブラリ (バインディング層はこれを叩く)。
+# 2025 以降の Dawn では SHARED / STATIC / OFF の3値。
+# SHARED (DLL) を選ぶ理由: V8 monolith と Dawn は双方が abseil を静的に内蔵しており、
+# STATIC だと raw_hash_set 等の同名シンボルが LNK2005 で衝突する (しかも absl の
+# バージョンが異なるため /FORCE:MULTIPLE は実行時破壊のリスクがある)。
+# DLL にすれば公開されるのは WebGPU C API のみで、absl は DLL 内部に閉じる。
+set(DAWN_BUILD_MONOLITHIC_LIBRARY SHARED CACHE STRING "" FORCE)
+set(BUILD_SHARED_LIBS OFF CACHE BOOL "" FORCE)
 
 FetchContent_Declare(
     dawn
-    GIT_REPOSITORY https://dawn.googlesource.com/dawn
+    # GitHub ミラーの方が CI から高速・安定 (googlesource はレート制限がきつい)
+    GIT_REPOSITORY https://github.com/google/dawn.git
     GIT_TAG        ${DAWN_TAG}
     GIT_SHALLOW    TRUE
+    # submodule は取得しない (DAWN_FETCH_DEPENDENCIES が必要分を取得する)
+    GIT_SUBMODULES ""
+    GIT_SUBMODULES_RECURSE FALSE
 )
 
 FetchContent_MakeAvailable(dawn)
@@ -40,3 +55,29 @@ FetchContent_MakeAvailable(dawn)
 if(NOT TARGET dawn::webgpu_dawn AND TARGET webgpu_dawn)
     add_library(dawn::webgpu_dawn ALIAS webgpu_dawn)
 endif()
+
+# -----------------------------------------------------------------------------
+# CRT を静的 (/MT) へ強制統一する。
+# CMAKE_MSVC_RUNTIME_LIBRARY 変数だけでは Dawn の third_party (fetch_dawn_dependencies
+# が取得する abseil/protobuf 等) の一部に伝播せず /MD が混ざり、静的 CRT 固定の
+# prebuilt V8 とのリンクで LNK2005/LNK2019 になる。全ターゲットへ再帰的に
+# プロパティを直接設定して確実に揃える。
+# -----------------------------------------------------------------------------
+function(next2d_force_static_crt dir)
+    get_property(_targets DIRECTORY "${dir}" PROPERTY BUILDSYSTEM_TARGETS)
+    foreach(_t IN LISTS _targets)
+        get_target_property(_type ${_t} TYPE)
+        if(NOT _type STREQUAL "INTERFACE_LIBRARY")
+            set_property(TARGET ${_t} PROPERTY
+                MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+        endif()
+    endforeach()
+    get_property(_subdirs DIRECTORY "${dir}" PROPERTY SUBDIRECTORIES)
+    foreach(_sd IN LISTS _subdirs)
+        next2d_force_static_crt("${_sd}")
+    endforeach()
+endfunction()
+
+if(MSVC)
+    next2d_force_static_crt("${dawn_SOURCE_DIR}")
+endif()