@next2d/builder 0.1.7 → 0.1.10

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,7 +73,7 @@ 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 | 不要 (builder が prebuilt を自動ダウンロード)。自前ビルドは `--v8-root` で指定可 |
 | Dawn | CMake の FetchContent で自動取得(ネットワーク必須) |
@@ -120,9 +120,9 @@ set DEPOT_TOOLS_WIN_TOOLCHAIN=0
 fetch v8
 cd v8
 :: CI のコンパイル検証と同じバージョンに固定 (xbox-host-ci.yml の V8_TAG)
-git checkout 13.6.233.17
+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_jitless=true v8_enable_turbofan=false v8_enable_webassembly=false target_cpu=\"x64\" is_debug=false v8_enable_pointer_compression=true v8_enable_sandbox=false"
+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
 ```
 
@@ -142,9 +142,12 @@ ninja -C out\x64.release v8_monolith
 > - `treat_warnings_as_errors=false` を推奨。`use_custom_libcxx=false` では MSVC STL の
 >   ヘッダ警告が -Werror で停止することがあります。**VS のバージョンは VS2022 (v143) を推奨**
 >   (新しすぎる STL は V8 の clang が警告/エラーを出しやすい)。
-> - `v8_jitless=true` + `v8_enable_turbofan=false` + `v8_enable_webassembly=false` を推奨。
->   ホストは実行時 `--jitless` で動かすため (Xbox は JIT 禁止)、JIT/wasm をビルドから
->   外すのが正しい構成です (BUILD.gn の assert もこの組み合わせを要求)。ビルドも大幅に速くなります。
+> - `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.*`) 向けは
@@ -210,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`
@@ -302,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 を要するコンパイル・実機検証**(この環境では物理的に不可)。
@@ -370,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>`) は未対応。

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()

package/templates/xbox/cmake/FindV8.cmake

@@ -40,6 +40,21 @@ if(NOT V8_ROOT OR NOT EXISTS "${V8_ROOT}")
         "詳細は README.md の『V8 の用意』を参照。")
 endif()
 
+# find_path/find_library の結果は CMakeCache に永続化されるため、
+# V8_ROOT の変更 (バージョン更新等) や参照先の消滅に追随しない。
+# 古い/無効な検出結果はここで破棄して再探索させる。
+if(DEFINED CACHE{NEXT2D_V8_ROOT_LAST} AND NOT "$CACHE{NEXT2D_V8_ROOT_LAST}" STREQUAL "${V8_ROOT}")
+    unset(V8_INCLUDE_DIR CACHE)
+    unset(V8_MONOLITH_LIB CACHE)
+endif()
+if(V8_INCLUDE_DIR AND NOT EXISTS "${V8_INCLUDE_DIR}/v8.h")
+    unset(V8_INCLUDE_DIR CACHE)
+endif()
+if(V8_MONOLITH_LIB AND NOT EXISTS "${V8_MONOLITH_LIB}")
+    unset(V8_MONOLITH_LIB CACHE)
+endif()
+set(NEXT2D_V8_ROOT_LAST "${V8_ROOT}" CACHE INTERNAL "直近の構成で使った V8_ROOT")
+
 find_path(V8_INCLUDE_DIR
     NAMES v8.h
     PATHS "${V8_ROOT}/include"

package/templates/xbox/js/bootstrap.js

@@ -25,7 +25,7 @@
     // V8 単体には Web の Text* が含まれないため最小実装を提供する。
     if (typeof global.TextEncoder === "undefined") {
         global.TextEncoder = class TextEncoder {
-            get encoding() { return "utf-8"; }
+            get encoding() { return "utf-8" }
             encode(str) {
                 str = String(str);
                 const out = [];
@@ -34,23 +34,23 @@
                     if (code < 0x80) {
                         out.push(code);
                     } else if (code < 0x800) {
-                        out.push(0xc0 | (code >> 6), 0x80 | (code & 0x3f));
+                        out.push(0xc0 | code >> 6, 0x80 | code & 0x3f);
                     } else if (code >= 0xd800 && code <= 0xdbff) {
                         // サロゲートペア
                         const hi = code;
                         const lo = str.charCodeAt(++i);
-                        code = 0x10000 + ((hi - 0xd800) << 10) + (lo - 0xdc00);
+                        code = 0x10000 + (hi - 0xd800 << 10) + (lo - 0xdc00);
                         out.push(
-                            0xf0 | (code >> 18),
-                            0x80 | ((code >> 12) & 0x3f),
-                            0x80 | ((code >> 6) & 0x3f),
-                            0x80 | (code & 0x3f)
+                            0xf0 | code >> 18,
+                            0x80 | code >> 12 & 0x3f,
+                            0x80 | code >> 6 & 0x3f,
+                            0x80 | code & 0x3f
                         );
                     } else {
                         out.push(
-                            0xe0 | (code >> 12),
-                            0x80 | ((code >> 6) & 0x3f),
-                            0x80 | (code & 0x3f)
+                            0xe0 | code >> 12,
+                            0x80 | code >> 6 & 0x3f,
+                            0x80 | code & 0x3f
                         );
                     }
                 }
@@ -61,10 +61,10 @@
 
     if (typeof global.TextDecoder === "undefined") {
         global.TextDecoder = class TextDecoder {
-            constructor(label) { this._label = label || "utf-8"; }
-            get encoding() { return "utf-8"; }
+            constructor(label) { this._label = label || "utf-8" }
+            get encoding() { return "utf-8" }
             decode(input) {
-                if (!input) return "";
+                if (!input) { return "" }
                 const bytes = input instanceof Uint8Array
                     ? input
                     : new Uint8Array(input.buffer || input);
@@ -75,14 +75,14 @@
                     if (c < 0x80) {
                         out += String.fromCharCode(c);
                     } else if (c < 0xe0) {
-                        out += String.fromCharCode(((c & 0x1f) << 6) | (bytes[i++] & 0x3f));
+                        out += String.fromCharCode((c & 0x1f) << 6 | bytes[i++] & 0x3f);
                     } else if (c < 0xf0) {
                         out += String.fromCharCode(
-                            ((c & 0x0f) << 12) | ((bytes[i++] & 0x3f) << 6) | (bytes[i++] & 0x3f)
+                            (c & 0x0f) << 12 | (bytes[i++] & 0x3f) << 6 | bytes[i++] & 0x3f
                         );
                     } else {
-                        let code = ((c & 0x07) << 18) | ((bytes[i++] & 0x3f) << 12) |
-                                   ((bytes[i++] & 0x3f) << 6) | (bytes[i++] & 0x3f);
+                        let code = (c & 0x07) << 18 | (bytes[i++] & 0x3f) << 12 |
+                                   (bytes[i++] & 0x3f) << 6 | bytes[i++] & 0x3f;
                         code -= 0x10000;
                         out += String.fromCharCode(0xd800 + (code >> 10), 0xdc00 + (code & 0x3ff));
                     }
@@ -97,28 +97,151 @@
     if (typeof global.URL === "undefined") {
         global.URL = class URL {
             constructor(url, base) {
-                this.href = base ? (String(base).replace(/\/?$/, "/") + url) : String(url);
+                this.href = base ? String(base).replace(/\/?$/, "/") + url : String(url);
                 this.pathname = this.href.replace(/^[a-z]+:\/\/[^/]*/i, "");
                 this.search = "";
                 this.hash = "";
             }
-            toString() { return this.href; }
+            toString() { return this.href }
         };
-        global.URL.createObjectURL = function () { return ""; };
+        global.URL.createObjectURL = function () { return "" };
+        // 意図的な no-op スタブ (ローカル実行では解放処理は不要)
+        // eslint-disable-next-line no-empty-function
         global.URL.revokeObjectURL = function () {};
     }
 
+    // --- URLSearchParams の最小補完 ----------------------------------------
+    // V8 単体には URLSearchParams が存在しないため補完する。
+    // Next2D アプリがクエリ文字列 (?mode=0 等) を解析する際に使用する。
+    if (typeof global.URLSearchParams === "undefined") {
+        global.URLSearchParams = class URLSearchParams {
+            constructor(init) {
+                this._list = [];
+                if (typeof init === "string") {
+                    let query = init;
+                    if (query.charAt(0) === "?") {
+                        query = query.slice(1);
+                    }
+                    if (query.length) {
+                        const pairs = query.split("&");
+                        for (let i = 0; i < pairs.length; i++) {
+                            const pair = pairs[i];
+                            if (!pair) {
+                                continue;
+                            }
+                            const index = pair.indexOf("=");
+                            const decode = (value) => {
+                                try {
+                                    return decodeURIComponent(value.replace(/\+/g, " "));
+                                } catch {
+                                    return value;
+                                }
+                            };
+                            if (index === -1) {
+                                this._list.push([decode(pair), ""]);
+                            } else {
+                                this._list.push([decode(pair.slice(0, index)), decode(pair.slice(index + 1))]);
+                            }
+                        }
+                    }
+                } else if (init && typeof init === "object") {
+                    if (Array.isArray(init)) {
+                        for (let i = 0; i < init.length; i++) {
+                            this._list.push([String(init[i][0]), String(init[i][1])]);
+                        }
+                    } else if (typeof init.forEach === "function") {
+                        init.forEach((value, key) => this._list.push([String(key), String(value)]));
+                    } else {
+                        for (const key in init) {
+                            if (Object.prototype.hasOwnProperty.call(init, key)) {
+                                this._list.push([key, String(init[key])]);
+                            }
+                        }
+                    }
+                }
+            }
+            get(name) {
+                for (let i = 0; i < this._list.length; i++) {
+                    if (this._list[i][0] === name) {
+                        return this._list[i][1];
+                    }
+                }
+                return null;
+            }
+            getAll(name) {
+                const result = [];
+                for (let i = 0; i < this._list.length; i++) {
+                    if (this._list[i][0] === name) {
+                        result.push(this._list[i][1]);
+                    }
+                }
+                return result;
+            }
+            has(name) {
+                return this.get(name) !== null;
+            }
+            set(name, value) {
+                const text = String(value);
+                let done = false;
+                const next = [];
+                for (let i = 0; i < this._list.length; i++) {
+                    if (this._list[i][0] === name) {
+                        if (!done) {
+                            next.push([name, text]);
+                            done = true;
+                        }
+                    } else {
+                        next.push(this._list[i]);
+                    }
+                }
+                if (!done) {
+                    next.push([name, text]);
+                }
+                this._list = next;
+            }
+            append(name, value) {
+                this._list.push([String(name), String(value)]);
+            }
+            delete(name) {
+                this._list = this._list.filter((pair) => pair[0] !== name);
+            }
+            forEach(callback, thisArg) {
+                for (let i = 0; i < this._list.length; i++) {
+                    callback.call(thisArg, this._list[i][1], this._list[i][0], this);
+                }
+            }
+            keys() {
+                return this._list.map((pair) => pair[0])[Symbol.iterator]();
+            }
+            values() {
+                return this._list.map((pair) => pair[1])[Symbol.iterator]();
+            }
+            entries() {
+                return this._list.map((pair) => [pair[0], pair[1]])[Symbol.iterator]();
+            }
+            toString() {
+                return this._list
+                    .map((pair) => encodeURIComponent(pair[0]) + "=" + encodeURIComponent(pair[1]))
+                    .join("&");
+            }
+            [Symbol.iterator]() {
+                return this.entries();
+            }
+        };
+    }
+
     // --- location (Next2D が参照する場合の最小値) ---------------------------
     if (typeof global.location === "undefined") {
         global.location = {
-            href: "app://local/",
-            origin: "app://local",
-            protocol: "app:",
-            host: "local",
-            hostname: "local",
-            pathname: "/",
-            search: "",
-            hash: "",
+            "href": "app://local/",
+            "origin": "app://local",
+            "protocol": "app:",
+            "host": "local",
+            "hostname": "local",
+            "pathname": "/",
+            "search": "",
+            "hash": "",
+            // eslint-disable-next-line no-empty-function
             reload() {}
         };
     }