@next2d/builder 0.1.4 → 0.1.6

package/templates/xbox/tests/check_local.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# macOS / Linux で Windows 実機なしに実行できる検証をまとめて回す。
+#   1. RasterCore 単体テスト (実行)
+#   2. RasterCore 単体テスト (ASan/UBSan)
+#   3. V8 依存ソースの構文チェック (実 V8 ヘッダに対して。Windows API 非依存の12ファイル)
+#
+# 使い方:
+#   tests/check_local.sh [V8_INCLUDE_DIR]
+# V8_INCLUDE_DIR 省略時は ./.v8_headers/include へ sparse clone する。
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+V8_TAG="13.6.233.17"
+V8INC="${1:-}"
+
+echo "== 1/3 RasterCore unit tests =="
+c++ -std=c++17 -Wall -Wextra -O1 -o /tmp/next2d_raster_test tests/raster_test.cpp
+/tmp/next2d_raster_test
+
+echo "== 2/3 RasterCore unit tests (ASan/UBSan) =="
+c++ -std=c++17 -g -fsanitize=address,undefined -fno-omit-frame-pointer \
+    -o /tmp/next2d_raster_test_asan tests/raster_test.cpp
+/tmp/next2d_raster_test_asan
+
+echo "== 3/3 V8-dependent sources syntax check (V8 ${V8_TAG}) =="
+if [ -z "${V8INC}" ]; then
+    if [ ! -d ".v8_headers/include" ]; then
+        git clone --depth 1 --branch "${V8_TAG}" --filter=blob:none --sparse \
+            https://github.com/v8/v8.git .v8_headers
+        (cd .v8_headers && git sparse-checkout set include)
+    fi
+    V8INC=".v8_headers/include"
+fi
+
+# Windows API に依存しない V8 バインディング (Windows 依存分は CI の windows-latest で検証)
+FILES=(
+    src/EventLoop.cpp
+    src/AssetLoader.cpp
+    src/v8/V8Runtime.cpp
+    src/worker/WorkerRuntime.cpp
+    src/bindings/Console.cpp
+    src/bindings/Timers.cpp
+    src/bindings/EventTarget.cpp
+    src/bindings/Network.cpp
+    src/bindings/Fetch.cpp
+    src/bindings/Canvas.cpp
+    src/bindings/Audio.cpp
+    src/bindings/Gamepad.cpp
+)
+for f in "${FILES[@]}"; do
+    c++ -fsyntax-only -std=c++20 -Isrc -isystem "${V8INC}" \
+        -DV8_COMPRESS_POINTERS -DV8_ENABLE_SANDBOX "$f"
+    echo "OK   $f"
+done
+
+echo "all checks passed"

package/templates/xbox/tests/raster_test.cpp

@@ -0,0 +1,279 @@
+// RasterCore.h (Canvas2D ソフトラスタライザ純ロジック) の単体テスト。
+// V8 / Windows 不要。macOS/Linux では:
+//   c++ -std=c++17 -O1 -o raster_test tests/raster_test.cpp && ./raster_test
+// Windows (MSVC) では:
+//   cl /std:c++17 /EHsc tests\raster_test.cpp && raster_test.exe
+#include "../src/bindings/RasterCore.h"
+
+#include <cmath>
+#include <cstdio>
+
+using namespace next2d::raster;
+
+static int failures = 0;
+static int checks = 0;
+
+#define CHECK(cond) do { ++checks; if (!(cond)) { \
+    ++failures; std::printf("not ok - %s:%d: %s\n", __FILE__, __LINE__, #cond); } } while (0)
+
+#define CHECK_NEAR(a, b, eps) do { ++checks; if (std::fabs((a) - (b)) > (eps)) { \
+    ++failures; std::printf("not ok - %s:%d: %s=%f != %s=%f\n", \
+        __FILE__, __LINE__, #a, static_cast<double>(a), #b, static_cast<double>(b)); } } while (0)
+
+// (x,y) のピクセルを取得
+static RGBA Px(const Surface& s, int x, int y)
+{
+    size_t i = (static_cast<size_t>(y) * s.width + x) * 4;
+    return { s.pixels[i], s.pixels[i+1], s.pixels[i+2], s.pixels[i+3] };
+}
+
+static SubPath MakeRectPath(double x, double y, double w, double h, bool reverse = false)
+{
+    SubPath sp;
+    if (!reverse) {
+        sp.pts = { {x,y}, {x+w,y}, {x+w,y+h}, {x,y+h} };
+    } else {
+        sp.pts = { {x,y}, {x,y+h}, {x+w,y+h}, {x+w,y} };
+    }
+    sp.closed = true;
+    return sp;
+}
+
+static void TestParseColor()
+{
+    RGBA c = ParseColor("#fff");
+    CHECK(c.r == 255 && c.g == 255 && c.b == 255 && c.a == 255);
+    c = ParseColor("#ff8000");
+    CHECK(c.r == 255 && c.g == 128 && c.b == 0);
+    c = ParseColor("rgb(10, 20, 30)");
+    CHECK(c.r == 10 && c.g == 20 && c.b == 30 && c.a == 255);
+    c = ParseColor("rgba(10, 20, 30, 0.5)");
+    CHECK(c.r == 10 && c.g == 20 && c.b == 30 && c.a == 127);
+    c = ParseColor("");
+    CHECK(c.r == 0 && c.g == 0 && c.b == 0 && c.a == 255);
+}
+
+static void TestFontPixelSize()
+{
+    CHECK_NEAR(FontPixelSize("10px sans-serif"), 10.0, 1e-9);
+    CHECK_NEAR(FontPixelSize("bold 24px Arial"), 24.0, 1e-9);
+    CHECK_NEAR(FontPixelSize("italic 1.5px x"), 1.5, 1e-9);
+    CHECK_NEAR(FontPixelSize("no-size"), 10.0, 1e-9);
+}
+
+static void TestMatrix()
+{
+    // translate(10,0) してから scale(2,2): Canvas と同じく後から掛けた変換が先に適用される
+    Mat m;
+    m = Multiply(m, {1,0,0,1,10,0});
+    m = Multiply(m, {2,0,0,2,0,0});
+    Point p = Apply(m, 1, 1);
+    CHECK_NEAR(p.x, 12.0, 1e-9);
+    CHECK_NEAR(p.y, 2.0, 1e-9);
+
+    // 90 度回転 (a=cos,b=sin,c=-sin,d=cos)
+    const double r = kPi / 2;
+    Mat rot = { std::cos(r), std::sin(r), -std::sin(r), std::cos(r), 0, 0 };
+    Point q = Apply(rot, 1, 0);
+    CHECK_NEAR(q.x, 0.0, 1e-9);
+    CHECK_NEAR(q.y, 1.0, 1e-9);
+}
+
+static void TestFillRectPath()
+{
+    Surface s(100, 100);
+    ClipRect clip;
+    std::vector<SubPath> path = { MakeRectPath(10, 10, 10, 10) };
+    FillPath(s, clip, path, {255, 0, 0, 255}, 1.0);
+    CHECK(Px(s, 15, 15).r == 255 && Px(s, 15, 15).a == 255);  // 内側
+    CHECK(Px(s, 5, 15).a == 0);                               // 左外
+    CHECK(Px(s, 25, 15).a == 0);                              // 右外
+    CHECK(Px(s, 15, 25).a == 0);                              // 下外
+}
+
+static void TestFillImplicitClose()
+{
+    // 未クローズの三角形 (moveTo/lineTo のみ) — Canvas 仕様では fill 時に暗黙クローズ
+    Surface s(100, 100);
+    ClipRect clip;
+    SubPath tri;
+    tri.pts = { {10,10}, {50,10}, {30,40} };
+    tri.closed = false;
+    std::vector<SubPath> path = { tri };
+    FillPath(s, clip, path, {0, 255, 0, 255}, 1.0);
+    CHECK(Px(s, 30, 20).g == 255);   // 重心付近は塗られる
+    CHECK(Px(s, 12, 35).a == 0);     // 三角形の外
+}
+
+static void TestNonzeroWindingDonut()
+{
+    // 外周 CW + 内周 CCW → 穴には塗らない (nonzero)
+    Surface s(100, 100);
+    ClipRect clip;
+    std::vector<SubPath> path = {
+        MakeRectPath(10, 10, 50, 50, false),  // 外周
+        MakeRectPath(20, 20, 30, 30, true),   // 内周 (逆回り)
+    };
+    FillPath(s, clip, path, {0, 0, 255, 255}, 1.0);
+    CHECK(Px(s, 15, 35).b == 255);   // リング部
+    CHECK(Px(s, 35, 35).a == 0);     // 穴
+
+    // isPointInPath も同じ nonzero 判定
+    CHECK(PointInPath(path, 15, 35));
+    CHECK(!PointInPath(path, 35, 35));
+    CHECK(!PointInPath(path, 90, 90));
+}
+
+static void TestClip()
+{
+    Surface s(100, 100);
+    ClipRect clip;
+    IntersectClip(clip, 10, 10, 20, 20);
+    CHECK(clip.active);
+
+    std::vector<SubPath> path = { MakeRectPath(0, 0, 100, 100) };
+    FillPath(s, clip, path, {255, 0, 0, 255}, 1.0);
+    CHECK(Px(s, 15, 15).r == 255);   // クリップ内
+    CHECK(Px(s, 25, 15).a == 0);     // クリップ外 (右)
+    CHECK(Px(s, 5, 5).a == 0);       // クリップ外 (左上)
+
+    // 2 回目の clip は積集合
+    IntersectClip(clip, 0, 0, 15, 100);
+    CHECK_NEAR(clip.x0, 10.0, 1e-9);
+    CHECK_NEAR(clip.x1, 15.0, 1e-9);
+    Surface s2(100, 100);
+    FillPath(s2, clip, path, {255, 0, 0, 255}, 1.0);
+    CHECK(Px(s2, 12, 15).r == 255);
+    CHECK(Px(s2, 17, 15).a == 0);    // 積集合で除外
+}
+
+static void TestClearRect()
+{
+    Surface s(50, 50);
+    ClipRect clip;
+    std::vector<SubPath> path = { MakeRectPath(0, 0, 50, 50) };
+    FillPath(s, clip, path, {255, 255, 255, 255}, 1.0);
+    ClearRect(s, 10, 10, 10, 10);
+    CHECK(Px(s, 15, 15).a == 0);     // クリア済み
+    CHECK(Px(s, 25, 25).r == 255);   // クリア外は残る
+}
+
+static void TestStroke()
+{
+    Surface s(50, 50);
+    ClipRect clip;
+    SubPath line;
+    line.pts = { {5, 10}, {40, 10} };
+    line.closed = false;
+    std::vector<SubPath> path = { line };
+    StrokePath(s, clip, path, {255, 0, 255, 255}, 1.0);
+    CHECK(Px(s, 20, 10).r == 255 && Px(s, 20, 10).b == 255);
+    CHECK(Px(s, 20, 20).a == 0);
+    // 未クローズなので終点→始点の辺は描かれない (stroke は暗黙クローズしない)
+    CHECK(Px(s, 45, 10).a == 0);
+}
+
+static void TestBlendAlpha()
+{
+    Surface s(4, 4);
+    ClipRect clip;
+    // 下地: 白
+    Blend(s, clip, 1, 1, {255, 255, 255, 255}, 1.0);
+    // 50% の赤を重ねる
+    Blend(s, clip, 1, 1, {255, 0, 0, 255}, 0.5);
+    RGBA p = Px(s, 1, 1);
+    CHECK(p.r == 255);
+    CHECK(p.g >= 126 && p.g <= 128);
+    CHECK(p.b >= 126 && p.b <= 128);
+
+    // クリップ外は書き込まれない
+    IntersectClip(clip, 0, 0, 1, 1);
+    Blend(s, clip, 2, 2, {255, 0, 0, 255}, 1.0);
+    CHECK(Px(s, 2, 2).a == 0);
+}
+
+static void TestFlattenCurves()
+{
+    // 2次ベジェ: 終点が p2 に一致
+    std::vector<Point> out;
+    FlattenQuadratic(out, {0,0}, {5,10}, {10,0});
+    CHECK(!out.empty());
+    CHECK_NEAR(out.back().x, 10.0, 1e-9);
+    CHECK_NEAR(out.back().y, 0.0, 1e-9);
+
+    // 3次ベジェ: 終点が p3 に一致
+    out.clear();
+    FlattenCubic(out, {0,0}, {0,10}, {10,10}, {10,0});
+    CHECK_NEAR(out.back().x, 10.0, 1e-9);
+    CHECK_NEAR(out.back().y, 0.0, 1e-9);
+
+    // 全周円: 始点と終点が一致し半径を保つ
+    out.clear();
+    Mat identity;
+    FlattenArc(out, identity, 50, 50, 10, 0, 2 * kPi, false);
+    CHECK(out.size() == 33);
+    CHECK_NEAR(out.front().x, out.back().x, 1e-6);
+    CHECK_NEAR(out.front().y, out.back().y, 1e-6);
+    for (auto& p : out) {
+        CHECK_NEAR(std::hypot(p.x - 50, p.y - 50), 10.0, 1e-6);
+    }
+
+    // ccw で end > start の場合は 2π 巻き戻す (過去に壊れていた経路)
+    out.clear();
+    FlattenArc(out, identity, 0, 0, 1, 0, kPi / 2, true);
+    // 終点は角度 π/2 - 2π = -3π/2 → (cos,sin) = (0, 1)
+    CHECK_NEAR(out.back().x, 0.0, 1e-6);
+    CHECK_NEAR(out.back().y, 1.0, 1e-6);
+}
+
+static void TestPathBounds()
+{
+    std::vector<SubPath> path = { MakeRectPath(5, 7, 10, 20) };
+    double x0, y0, x1, y1;
+    CHECK(PathBounds(path, &x0, &y0, &x1, &y1));
+    CHECK_NEAR(x0, 5.0, 1e-9);
+    CHECK_NEAR(y0, 7.0, 1e-9);
+    CHECK_NEAR(x1, 15.0, 1e-9);
+    CHECK_NEAR(y1, 27.0, 1e-9);
+
+    std::vector<SubPath> empty;
+    CHECK(!PathBounds(empty, &x0, &y0, &x1, &y1));
+}
+
+static void TestTransformedFill()
+{
+    // setTransform(2,0,0,2,10,10) で組んだ 5x5 矩形 → デバイス座標 20..30
+    Surface s(64, 64);
+    ClipRect clip;
+    Mat m = {2, 0, 0, 2, 10, 10};
+    SubPath sp;
+    const double corners[4][2] = { {5,5}, {10,5}, {10,10}, {5,10} };
+    for (auto& c : corners) sp.pts.push_back(Apply(m, c[0], c[1]));
+    sp.closed = true;
+    std::vector<SubPath> path = { sp };
+    FillPath(s, clip, path, {255, 128, 0, 255}, 1.0);
+    CHECK(Px(s, 25, 25).r == 255);
+    CHECK(Px(s, 15, 15).a == 0);
+    CHECK(Px(s, 33, 25).a == 0);
+}
+
+int main()
+{
+    TestParseColor();
+    TestFontPixelSize();
+    TestMatrix();
+    TestFillRectPath();
+    TestFillImplicitClose();
+    TestNonzeroWindingDonut();
+    TestClip();
+    TestClearRect();
+    TestStroke();
+    TestBlendAlpha();
+    TestFlattenCurves();
+    TestPathBounds();
+    TestTransformedFill();
+
+    std::printf("%s: %d checks, %d failures\n",
+                failures ? "FAILED" : "ok", checks, failures);
+    return failures ? 1 : 0;
+}

package/templates/xbox/tests/windows_platform_test.cpp

@@ -0,0 +1,187 @@
+// Windows 実 API (WIC / DirectWrite / Media Foundation / XAudio2) の smoke テスト。
+// V8 / Dawn / GDK 不要 — Windows SDK だけでビルドでき、GitHub Actions の
+// windows-latest ランナーで実行して「Windows 上で実際に動く」ことを検証する。
+//
+// ビルド (Developer Command Prompt / CI):
+//   cl /std:c++17 /EHsc /Isrc tests\windows_platform_test.cpp ^
+//      src\platform\WicDecoder.cpp src\platform\TextRasterizer.cpp ^
+//      src\platform\AudioEngine.cpp ^
+//      ole32.lib windowscodecs.lib d2d1.lib dwrite.lib ^
+//      mfplat.lib mfreadwrite.lib mfuuid.lib xaudio2.lib shlwapi.lib
+//
+// XAudio2 の CreateMasteringVoice はヘッドレス環境 (音声デバイス無し) では失敗し得る
+// ため warn 扱い。WIC / DirectWrite / MF デコードは必ず成功すべきで、失敗はエラー。
+#ifndef NOMINMAX
+#define NOMINMAX
+#endif
+
+#include "../src/platform/WicDecoder.h"
+#include "../src/platform/TextRasterizer.h"
+#include "../src/platform/AudioEngine.h"
+
+#include <Windows.h>
+#include <mfapi.h>
+
+#include <algorithm>
+#include <cmath>
+#include <cstdio>
+#include <memory>
+#include <vector>
+
+#pragma comment(lib, "ole32.lib")
+#pragma comment(lib, "windowscodecs.lib")
+#pragma comment(lib, "mfplat.lib")
+#pragma comment(lib, "shlwapi.lib")
+
+static int failures = 0;
+static int checks = 0;
+
+#define CHECK(cond) do { ++checks; if (!(cond)) { \
+    ++failures; std::printf("not ok - %s:%d: %s\n", __FILE__, __LINE__, #cond); } } while (0)
+
+// 2x2 PNG: (0,0)=赤 (1,0)=緑 (0,1)=青 (1,1)=半透明白
+static const unsigned char kTestPng[] = {
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00, 0x00, 0x0d,
+    0x49, 0x48, 0x44, 0x52, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x02,
+    0x08, 0x06, 0x00, 0x00, 0x00, 0x72, 0xb6, 0x0d, 0x24, 0x00, 0x00, 0x00,
+    0x13, 0x49, 0x44, 0x41, 0x54, 0x78, 0x9c, 0x63, 0xf8, 0xcf, 0xc0, 0xf0,
+    0x1f, 0x0c, 0x81, 0x34, 0x08, 0x34, 0x00, 0x00, 0x49, 0x49, 0x09, 0x78,
+    0x28, 0xa0, 0xdb, 0x77, 0x00, 0x00, 0x00, 0x00, 0x49, 0x45, 0x4e, 0x44,
+    0xae, 0x42, 0x60, 0x82
+};
+
+// 48kHz mono 16bit PCM WAV (0.5 振幅の矩形波 48 サンプル)
+static const unsigned char kTestWav[] = {
+    0x52, 0x49, 0x46, 0x46, 0x84, 0x00, 0x00, 0x00, 0x57, 0x41, 0x56, 0x45,
+    0x66, 0x6d, 0x74, 0x20, 0x10, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00,
+    0x80, 0xbb, 0x00, 0x00, 0x00, 0x77, 0x01, 0x00, 0x02, 0x00, 0x10, 0x00,
+    0x64, 0x61, 0x74, 0x61, 0x60, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00, 0x40,
+    0x00, 0x40, 0x00, 0x40, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0,
+    0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0xc0, 0x00, 0xc0,
+    0x00, 0xc0, 0x00, 0xc0, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40,
+    0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0x40, 0x00, 0x40,
+    0x00, 0x40, 0x00, 0x40, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0,
+    0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0xc0, 0x00, 0xc0,
+    0x00, 0xc0, 0x00, 0xc0, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40, 0x00, 0x40,
+    0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0, 0x00, 0xc0
+};
+
+// --- WIC: PNG デコード (createImageBitmap / Image.src の実体) ---------------
+static void TestWicDecode()
+{
+    std::vector<uint8_t> png(kTestPng, kTestPng + sizeof(kTestPng));
+    next2d::DecodedImage img;
+    CHECK(next2d::DecodeImageWithWIC(png, img));
+    CHECK(img.width == 2 && img.height == 2);
+    CHECK(img.rgba.size() == 16);
+    // (0,0)=赤
+    CHECK(img.rgba[0] == 255 && img.rgba[1] == 0 && img.rgba[2] == 0 && img.rgba[3] == 255);
+    // (1,0)=緑
+    CHECK(img.rgba[4] == 0 && img.rgba[5] == 255 && img.rgba[6] == 0);
+    // (0,1)=青
+    CHECK(img.rgba[8] == 0 && img.rgba[9] == 0 && img.rgba[10] == 255);
+    // (1,1)=半透明 (alpha=128)
+    CHECK(img.rgba[15] == 128);
+
+    // 壊れた入力は false
+    std::vector<uint8_t> garbage(32, 0xAB);
+    next2d::DecodedImage bad;
+    CHECK(!next2d::DecodeImageWithWIC(garbage, bad));
+}
+
+// --- DirectWrite: メトリクスとグリフラスタライズ (fillText の実体) ----------
+static void TestTextRasterizer()
+{
+    next2d::TextMetricsInfo m;
+    CHECK(next2d::MeasureTextWithDWrite("24px Segoe UI", L"Hello", m));
+    CHECK(m.width > 10.0);
+    CHECK(m.ascent > 5.0 && m.ascent < 40.0);
+    CHECK(m.descent > 0.0 && m.descent < 20.0);
+
+    // bold は同サイズの normal より広い (フォントメトリクスの妥当性)
+    next2d::TextMetricsInfo mb;
+    CHECK(next2d::MeasureTextWithDWrite("bold 24px Segoe UI", L"Hello", mb));
+    CHECK(mb.width >= m.width);
+
+    next2d::TextBitmap bmp;
+    CHECK(next2d::RasterizeTextWithDWrite("24px Segoe UI", L"A", 255, 0, 0, bmp));
+    CHECK(bmp.width > 0 && bmp.height > 0);
+    CHECK(bmp.baseline > 0.0);
+    // 何らかの不透明ピクセルがあり、色は赤
+    int opaque = 0;
+    bool red_ok = true;
+    for (size_t i = 0; i + 3 < bmp.rgba.size(); i += 4) {
+        if (bmp.rgba[i + 3] > 200) {
+            ++opaque;
+            if (bmp.rgba[i] < 200 || bmp.rgba[i + 1] > 60 || bmp.rgba[i + 2] > 60) red_ok = false;
+        }
+    }
+    CHECK(opaque > 5);
+    CHECK(red_ok);
+
+    // 日本語グリフもラスタライズできる
+    next2d::TextBitmap jp;
+    CHECK(next2d::RasterizeTextWithDWrite("24px Yu Gothic", L"あ", 0, 0, 0, jp)); // あ
+    int jp_opaque = 0;
+    for (size_t i = 3; i < jp.rgba.size(); i += 4) if (jp.rgba[i] > 200) ++jp_opaque;
+    CHECK(jp_opaque > 5);
+
+    // 空文字は false
+    next2d::TextBitmap empty;
+    CHECK(!next2d::RasterizeTextWithDWrite("24px Segoe UI", L"", 0, 0, 0, empty));
+}
+
+// --- Media Foundation: 音声デコード (decodeAudioData の実体) -----------------
+static void TestAudioDecode()
+{
+    std::vector<uint8_t> wav(kTestWav, kTestWav + sizeof(kTestWav));
+    next2d::PcmBuffer pcm;
+    CHECK(next2d::AudioEngine::Decode(wav, pcm));
+    CHECK(pcm.sample_rate == 48000);
+    CHECK(pcm.channels == 1);
+    CHECK(pcm.samples.size() >= 40);   // 48 サンプル前後 (MF は端数調整あり)
+    // 振幅 0.5 の矩形波 → ピーク絶対値が 0.4〜0.6
+    float peak = 0;
+    for (float s : pcm.samples) peak = std::max(peak, std::fabs(s));
+    CHECK(peak > 0.4f && peak < 0.6f);
+}
+
+// --- XAudio2: 初期化 (ヘッドレス CI では音声デバイスが無く失敗し得る → warn) --
+static void TestAudioEngineInit()
+{
+    next2d::AudioEngine engine;
+    if (!engine.Initialize()) {
+        std::printf("warn - XAudio2 init failed (headless runner? not counted as failure)\n");
+        return;
+    }
+    std::printf("ok - XAudio2 initialized\n");
+    // ボイス生成 + 音量設定 + 即停止 (クラッシュしないこと)
+    auto pcm = std::make_shared<next2d::PcmBuffer>();
+    pcm->sample_rate = 48000;
+    pcm->channels = 1;
+    pcm->samples.assign(480, 0.1f);
+    auto voice = engine.CreateVoice(pcm);
+    CHECK(voice != nullptr);
+    voice->SetVolume(0.5f);
+    voice->Start(false);
+    CHECK(!voice->IsFinished() || true);  // 状態取得がクラッシュしないこと
+    voice->Stop();
+}
+
+int main()
+{
+    CoInitializeEx(nullptr, COINIT_MULTITHREADED);
+    // AudioEngine::Decode は MF を使う (AudioEngine::Initialize を通さない場合は自前で起動)
+    MFStartup(MF_VERSION);
+
+    TestWicDecode();
+    TestTextRasterizer();
+    TestAudioDecode();
+    TestAudioEngineInit();
+
+    MFShutdown();
+
+    std::printf("%s: %d checks, %d failures\n",
+                failures ? "FAILED" : "ok", checks, failures);
+    return failures ? 1 : 0;
+}