@next2d/builder 0.1.8 → 0.1.11

package/dist/xbox.js

@@ -0,0 +1,426 @@
+// Xbox (GDK ネイティブ) ビルド。V8 に Next2D の JS を載せ、Dawn(WebGPU/D3D12)で
+// 描画する C++ ホストを、テンプレートのスキャフォールド → 資材配置 → pak 埋め込み →
+// CMake/GDK ビルドの順で書き出す。
+import pc from "picocolors";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import cp from "child_process";
+import { minifySync } from "vite";
+import { ctx } from "./context.js";
+import { getTemplateDir } from "./utils.js";
+import { XBOX_DIR_NAME, XBOX_CONFIG_NAME, XBOX_V8_VERSION, XBOX_V8_REVISION, XBOX_SCAFFOLD_EXCLUDES } from "./constants.js";
+/**
+ * @description XboxホストのC++/CMake一式をbuilder同梱テンプレートから毎回更新する。
+ *              ホストは「エンジン相当」でユーザーは編集しない前提のため、常に最新へ上書きする。
+ *              ただし各ゲーム固有の `MicrosoftGame.config` は対象外(injectGameConfigが扱う)。
+ *              Refresh the Xbox host (C++/CMake) from the builder's bundled template.
+ *
+ * @return {Promise}
+ * @method
+ * @private
+ */
+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ホストへ注入する。
+ *              未配置ならbuilder同梱の既定をフォールバックとして使い、作成を促す。
+ *              Inject the game-root `MicrosoftGame.config` into the Xbox host.
+ *
+ * @return {Promise}
+ * @method
+ * @private
+ */
+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
+ * @private
+ */
+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(`${ctx.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 ディレクトリを再帰的に走査し、各ファイルの
+ *              [posix 相対キー, 絶対パス] を集める。
+ *              Walk a directory recursively, collecting [posixRelKey, absPath] pairs.
+ *
+ * @param  {string} rootDir 走査ルート
+ * @param  {string} [prefix] キーへ付与する接頭辞 (例 "" / "assets/")
+ * @return {Array<[string, string]>}
+ * @method
+ * @public
+ */
+export const walkFiles = (rootDir, prefix = "") => {
+    const out = [];
+    if (!fs.existsSync(rootDir)) {
+        return out;
+    }
+    for (const entry of fs.readdirSync(rootDir, { "withFileTypes": true })) {
+        const abs = path.join(rootDir, entry.name);
+        const key = prefix ? `${prefix}${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            out.push(...walkFiles(abs, `${key}/`));
+        }
+        else if (entry.isFile()) {
+            out.push([key, abs]);
+        }
+    }
+    return out;
+};
+/**
+ * @description (key, データ) の並びを exe 埋め込み用 pak バイナリへ直列化する純関数。
+ *              host 側 EmbeddedAssets.cpp の ParseEmbeddedPak と対になる。
+ *              フォーマット (リトルエンディアン uint32):
+ *                magic "N2DA" / version(=1) / count / [keyLen,key,dataLen,data]...
+ *              Serialize (key, data) entries into the embedded pak binary.
+ *
+ * @param  {Array<[string, Buffer]>} entries
+ * @return {Buffer}
+ * @method
+ * @public
+ */
+export const buildPak = (entries) => {
+    const chunks = [];
+    const header = Buffer.alloc(12);
+    header.write("N2DA", 0, "ascii");
+    header.writeUInt32LE(1, 4); // version
+    header.writeUInt32LE(entries.length, 8); // count
+    chunks.push(header);
+    for (const [key, data] of entries) {
+        const keyBuf = Buffer.from(key, "utf8");
+        const meta = Buffer.alloc(4);
+        meta.writeUInt32LE(keyBuf.length, 0);
+        chunks.push(meta, keyBuf);
+        const meta2 = Buffer.alloc(4);
+        meta2.writeUInt32LE(data.length, 0);
+        chunks.push(meta2, data);
+    }
+    return Buffer.concat(chunks);
+};
+/**
+ * @description assets.pak を RCDATA "N2DASSETS" として取り込む .rc の内容を生成する純関数。
+ *              相対パスだと rc.exe の CWD (build ディレクトリ) 基準で探して見つからない
+ *              (RC2135) ため絶対パスを埋める。RC はフォワードスラッシュを受理する。
+ *              文字列は必ずダブルクォート (RC 仕様。シングルクォートは不可)。
+ *              Render the .rc content that embeds assets.pak as RCDATA.
+ *
+ * @param  {string} pakAbsPath  assets.pak の絶対パス
+ * @return {string}
+ * @method
+ * @public
+ */
+export const renderAssetsRc = (pakAbsPath) => {
+    const forward = pakAbsPath.replace(/\\/g, "/");
+    return `N2DASSETS RCDATA "${forward}"\n`;
+};
+/**
+ * @description ホストスクリプト(js/bootstrap.js 等)を minify + 難読化する純関数。
+ *              Oxc(vite 同梱)でコメント除去・空白圧縮・ローカル識別子マングルを行う。
+ *              `globalThis.*` 等のグローバル名はゲームが参照するため保持される。
+ *              失敗時は元コードをそのまま返す(埋め込み自体は継続)。
+ *              Minify/obfuscate a host script; returns the original on failure.
+ *
+ * @param  {string} name  ファイル名 (拡張子で構文判定)
+ * @param  {string} code  元の JavaScript
+ * @return {string}
+ * @method
+ * @public
+ */
+export const minifyJs = (name, code) => {
+    try {
+        const result = minifySync(name, code);
+        if (result.errors && result.errors.length > 0) {
+            const msg = result.errors[0]?.message ?? String(result.errors[0]);
+            console.log(pc.yellow(`Xbox: minify skipped for ${name} (${msg}); embedding as-is.`));
+            return code;
+        }
+        return result.code;
+    }
+    catch (error) {
+        console.log(pc.yellow(`Xbox: minify failed for ${name}; embedding as-is. ${error}`));
+        return code;
+    }
+};
+/**
+ * @description Xbox ホストの assets/app とホストスクリプト(js/bootstrap.js 等)を
+ *              単一の pak バイナリへまとめ、`assets.pak` と RCDATA 参照用の
+ *              `assets.rc` を xbox/ 直下へ生成する。CMake が assets.rc を検出して
+ *              これらを exe 内リソースへ**必ず**埋め込み、平文 JS/HTML を配布物に残さない。
+ *              埋め込みは必須(非埋め込みの選択肢は無い)。資材が無ければハードエラー。
+ *
+ *              pak フォーマット (リトルエンディアン uint32):
+ *                magic "N2DA" / version(=1) / count / [keyLen,key,dataLen,data]...
+ *              キーは assets/app 基準の posix 相対パス、または "js/bootstrap.js"。
+ *              host 側 EmbeddedAssets.cpp の ParseEmbeddedPak と対になる。
+ *
+ * @return {Promise}
+ * @method
+ * @private
+ */
+const embedXboxAssets = () => {
+    return new Promise((resolve, reject) => {
+        const xboxDir = `${process.cwd()}/${XBOX_DIR_NAME}`;
+        const pakPath = `${xboxDir}/assets.pak`;
+        const rcPath = `${xboxDir}/assets.rc`;
+        try {
+            // 収集: assets/app 一式 (キーは app 基準) + host スクリプト (js/ 基準)。
+            const entries = [];
+            entries.push(...walkFiles(`${xboxDir}/assets/app`, ""));
+            const bootstrap = `${xboxDir}/js/bootstrap.js`;
+            if (fs.existsSync(bootstrap)) {
+                entries.push(["js/bootstrap.js", bootstrap]);
+            }
+            const selftest = `${xboxDir}/js/selftest.js`;
+            if (fs.existsSync(selftest)) {
+                entries.push(["js/selftest.js", selftest]);
+            }
+            if (entries.length === 0) {
+                return reject("No Xbox assets found to embed (assets/app is empty).");
+            }
+            // (key, データ) を読み込み、pak バイナリへ直列化する。
+            // js/ のホストスクリプト(bootstrap.js/selftest.js)は minify + 難読化する。
+            // assets/app の JS は vite が本番ビルドで minify 済みのためそのまま。
+            let minified = 0;
+            const pakEntries = entries.map(([key, abs]) => {
+                if (key.startsWith("js/") && key.endsWith(".js")) {
+                    const src = fs.readFileSync(abs, { "encoding": "utf8" });
+                    const out = minifyJs(key, src);
+                    if (out.length < src.length) {
+                        ++minified;
+                    }
+                    return [key, Buffer.from(out, "utf8")];
+                }
+                return [key, fs.readFileSync(abs)];
+            });
+            const pak = buildPak(pakEntries);
+            if (minified > 0) {
+                console.log(pc.green(`Minified ${minified} host script(s) before embedding.`));
+            }
+            fs.writeFileSync(pakPath, pak);
+            // rc.exe が assets.pak を RCDATA "N2DASSETS" として取り込む .rc を生成する。
+            fs.writeFileSync(rcPath, renderAssetsRc(path.resolve(pakPath)), "utf8");
+            console.log(pc.green(`Embedded ${entries.length} Xbox asset file(s) into assets.pak `
+                + `(${(pak.length / 1024 / 1024).toFixed(2)} MB).`));
+            // 埋め込み済みの平文 `assets/`・`js/` は書き出し一覧から除外する。
+            // これらは assets.pak (=exe 内 RCDATA) に格納済みで、CMake も埋め込みモードでは
+            // exe 隣へステージしないため、xbox/ 直下に残しても不要かつ平文流出になる。
+            fs.rmSync(`${xboxDir}/assets`, { "recursive": true, "force": true });
+            fs.rmSync(`${xboxDir}/js`, { "recursive": true, "force": true });
+            console.log(pc.green("Excluded plaintext `assets/` and `js/` from the export (embedded in exe)."));
+            resolve();
+        }
+        catch (error) {
+            reject(`Failed to embed Xbox assets. ${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.
+ *
+ * @return {Promise<string>}
+ * @method
+ * @private
+ */
+const resolveXboxV8Root = async () => {
+    // 1. --v8-root 引数
+    if (ctx.v8Root) {
+        return path.resolve(process.cwd(), ctx.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++ホストをビルドする。
+ *              Export function for Xbox (GDK native) apps.
+ *
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const buildXbox = async () => {
+    // C++/CMake ホストを最新へ更新 (ゲーム固有設定は除外)
+    await refreshXboxHost();
+    // ゲームルートの MicrosoftGame.config を注入
+    await injectGameConfig();
+    // ビルド済みWeb資材を配置
+    await copyXboxResources();
+    // assets/app + host スクリプトを exe 埋め込み用 pak (+ rc) へまとめる
+    await embedXboxAssets();
+    /**
+     * GDK ビルドは Windows + Visual Studio + Microsoft GDK が必須。
+     * それ以外の環境ではスキャフォールドと資材配置のみを行い、手順を案内する。
+     * The GDK build requires Windows + Visual Studio + Microsoft GDK.
+     */
+    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)。
+     */
+    const gdkArch = process.env.NEXT2D_XBOX_ARCH || "Gaming.Xbox.Scarlett.x64";
+    const cmakeBuildDir = `${process.cwd()}/${ctx.outDir}/${ctx.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 (ctx.open || ctx.preview) {
+        // Visual Studio ソリューションを開く (実機/エミュレータでの実行はVS側で行う)
+        cp.spawn("cmake", [
+            "--open", cmakeBuildDir
+        ], { "stdio": "inherit" });
+        return;
+    }
+    // フルビルド (Release パッケージまで)。失敗時は reject して非ゼロ終了させる
+    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.8",
+  "version": "0.1.11",
   "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",
@@ -21,7 +21,9 @@
     "Multi-platform builder"
   ],
   "scripts": {
-    "lint": "eslint src/index.ts",
+    "lint": "eslint src",
+    "build": "tsc",
+    "test": "tsc && node --test \"tests/**/*.test.ts\"",
     "prepare": "tsc",
     "release": "tsc"
   },
@@ -38,18 +40,18 @@
   },
   "dependencies": {
     "@electron-forge/core": "^7.11.2",
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.4.0",
     "picocolors": "^1.1.1",
-    "vite": "^8.1.3"
+    "vite": "^8.2.2"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/eslintrc": "^3.3.7",
     "@eslint/js": "^10.0.1",
-    "@typescript-eslint/eslint-plugin": "^8.62.1",
-    "@typescript-eslint/parser": "^8.62.1",
-    "eslint": "^10.6.0",
+    "@typescript-eslint/eslint-plugin": "^8.69.0",
+    "@typescript-eslint/parser": "^8.69.0",
+    "eslint": "^10.9.1",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "globals": "^17.7.0",
+    "globals": "^17.12.0",
     "typescript": "^6.0.3"
   }
 }

package/templates/xbox/CMakeLists.txt

@@ -89,10 +89,24 @@ file(GLOB_RECURSE NEXT2D_HOST_SOURCES
     "${CMAKE_CURRENT_SOURCE_DIR}/src/*.h"
 )
 
+# 埋め込みアセット: builder の buildXbox が assets.pak と assets.rc を必ず生成し、
+# RCDATA "N2DASSETS" として exe にリンクする (ゲーム JS/HTML は平文で隣に置かない)。
+# 埋め込みは必須。assets.rc が無いのは builder を経由せず cmake を直接叩いた
+# ホスト単体ビルド (ゲーム資材なし) のみで、その場合はゲームは起動しない。
+set(NEXT2D_ASSETS_RC "${CMAKE_CURRENT_SOURCE_DIR}/assets.rc")
+if(EXISTS "${NEXT2D_ASSETS_RC}")
+    enable_language(RC)
+    list(APPEND NEXT2D_HOST_SOURCES "${NEXT2D_ASSETS_RC}")
+    message(STATUS "Next2D: embedding assets from ${NEXT2D_ASSETS_RC}")
+else()
+    message(WARNING "Next2D: assets.rc not found - host-only build (no game assets). Run @next2d/builder to embed.")
+endif()
+
 add_executable(Next2DXboxHost WIN32 ${NEXT2D_HOST_SOURCES})
 
 target_include_directories(Next2DXboxHost PRIVATE
     "${CMAKE_CURRENT_SOURCE_DIR}/src"
+    "${CMAKE_CURRENT_SOURCE_DIR}"   # third_party/ (stb_image, dr_mp3 等)
 )
 
 # 展開レイアウト (GDK_ROOT) 使用時: include/lib を明示指定し、実行時 DLL を並べる
@@ -124,6 +138,20 @@ if(MSVC)
     # Release でも PDB を生成する (クラッシュダンプ解析でスタックを名前解決するため)
     target_compile_options(Next2DXboxHost PRIVATE /Zi)
     target_link_options(Next2DXboxHost PRIVATE /DEBUG /OPT:REF /OPT:ICF)
+
+    # Release: リンク時コード生成 (LTCG)。翻訳単位を跨いだインライン化が効き、
+    # 毎フレーム通る V8 バインディング層 (小さな関数の呼び出し連鎖) に有効。
+    # (VS ジェネレータでは COMPILE_OPTIONS は C++ (ClCompile) にのみ渡り、
+    #  RC (assets.rc) には影響しない。/Zi と同じ流儀)
+    target_compile_options(Next2DXboxHost PRIVATE $<$<CONFIG:Release>:/GL>)
+    target_link_options(Next2DXboxHost PRIVATE $<$<CONFIG:Release>:/LTCG>)
+
+    # /arch:AVX2: Xbox Series X|S (Zen 2) と Haswell (2013) 以降の PC で動作。
+    # ソフトラスタ (RasterCore) や pak 解析などホスト C++ の自動ベクトル化が進む。
+    # Xbox One (Jaguar) は AVX2 非対応のため除外する。
+    if(NOT CMAKE_GENERATOR_PLATFORM MATCHES "XboxOne")
+        target_compile_options(Next2DXboxHost PRIVATE /arch:AVX2)
+    endif()
 endif()
 
 # webgpu_dawn は SHARED (DLL)。実行に必要なため exe の隣へステージする
@@ -135,14 +163,25 @@ if(TARGET webgpu_dawn)
         COMMENT "Staging webgpu_dawn.dll next to the executable")
 endif()
 
-# WebGPU / D3D12 / GameInput / WIC / XAudio2 / GDK
+# WebGPU / D3D12 / GameInput / XAudio2 / GDK
 target_link_libraries(Next2DXboxHost PRIVATE
     d3d12
     dxgi
     dxguid
-    windowscodecs   # WIC: 画像デコード
 )
 
+if(NOT NEXT2D_IS_CONSOLE)
+    # デスクトップ専用 (Game Core OS に存在しない):
+    #   windowscodecs = WIC (stb_image で扱えない形式の画像デコードフォールバック)
+    #   dbghelp       = クラッシュハンドラのスタックトレース (StackWalk64/SymFromAddr)
+    # MF (mfplat 等)/d2d1/dwrite/shlwapi/winmm はソース側の #pragma comment(lib) が
+    # 同じ NEXT2D_XBOX_CONSOLE ガード内でリンク指示する。
+    target_link_libraries(Next2DXboxHost PRIVATE
+        windowscodecs
+        dbghelp
+    )
+endif()
+
 if(NEXT2D_IS_CONSOLE)
     # コンソール用ライブラリ (GDK が提供)
     target_link_libraries(Next2DXboxHost PRIVATE
@@ -176,18 +215,15 @@ target_compile_definitions(Next2DXboxHost PRIVATE
 
 # -----------------------------------------------------------------------------
 # ランタイム資材のステージング
-#   builder が assets/app に JS/HTML/アセットを配置する。
-#   js/bootstrap.js はブラウザ相当グローバルを整える起動スクリプト。
+#   ゲーム JS/HTML/アセット (assets/app) とホストスクリプト (js/bootstrap.js) は
+#   builder が assets.pak にまとめて exe 内 RCDATA へ**必ず**埋め込む
+#   (非埋め込みの選択肢は無い。平文 JS/HTML を配布物に残さないのが目的)。
+#   したがって exe 隣へは assets/ も js/ もコピーしない。
+#   MicrosoftGame.config (GDK タイトル設定) だけを exe の隣へステージングする。
 # -----------------------------------------------------------------------------
 add_custom_command(TARGET Next2DXboxHost POST_BUILD
-    COMMAND ${CMAKE_COMMAND} -E copy_directory
-        "${CMAKE_CURRENT_SOURCE_DIR}/assets"
-        "$<TARGET_FILE_DIR:Next2DXboxHost>/assets"
-    COMMAND ${CMAKE_COMMAND} -E copy_directory
-        "${CMAKE_CURRENT_SOURCE_DIR}/js"
-        "$<TARGET_FILE_DIR:Next2DXboxHost>/js"
     COMMAND ${CMAKE_COMMAND} -E copy_if_different
         "${CMAKE_CURRENT_SOURCE_DIR}/MicrosoftGame.config"
         "$<TARGET_FILE_DIR:Next2DXboxHost>/MicrosoftGame.config"
-    COMMENT "Staging Next2D assets, bootstrap JS and MicrosoftGame.config"
+    COMMENT "Staging MicrosoftGame.config (assets/JS embedded in exe)"
 )

package/templates/xbox/README.md

@@ -378,3 +378,21 @@ xbox/
       ├─ Gamepad.cpp DomShims.cpp
       └─ webgpu/{WebGPU.cpp,WebGPUCommon.h,WebGPUEnums.h}
 ```
+
+---
+
+## コンソール (Game Core OS) とテキスト描画・フォント
+
+コンソールには DirectWrite / システムフォントが存在しないため、`fillText`/`measureText`
+は同梱の stb_truetype 実装 (`platform/StbTextRasterizer`) が担う。フォントは実行時登録:
+
+- **ゲーム資材に TTF/OTF を含める**(推奨): Web ビルドの資材 (`assets/app`) に
+  `*.ttf` / `*.otf` があれば起動時に自動登録される (vite の `public/` に置く等)。
+  日本語テキストを使う場合は Noto Sans JP (OFL) などの同梱を推奨。
+- 開発ビルド: exe 隣接の `fonts/` ディレクトリからも読み込む。
+- フォント未登録の場合、テキストは近似メトリクスのみ (グリフ描画なし) になる。
+
+デスクトップ (PC/GDK) は従来どおり DirectWrite が主経路のため、フォント同梱は不要。
+同様に、画像は stb_image、音声は dr_mp3/dr_wav/stb_vorbis が全プラットフォーム共通の
+第一経路で、WIC / Media Foundation はデスクトップ限定のフォールバック
+(AAC/TIFF 等の非標準形式向け)。コンソールでの動画 (`<video>`) は未対応。