acdream/tests/AcDream.App.Tests/UI/Layout/LayoutConformanceTests.cs
Erik 3567135a04 test(D.2b): vitals importer conformance — golden fixture + tree/slice/chrome checks
Job 1: extract LayoutImporter.ImportInfos() (public dat-shell half that returns the
resolved ElementInfo tree without building widgets) so fixture generation and
conformance tests can call it directly. Import() now delegates to ImportInfos() +
Build() — existing 32 Layout tests stay green.

Job 2: generate tests/AcDream.App.Tests/UI/Layout/fixtures/vitals_2100006C.json
from the real portal.dat via a throwaway [Fact] generator (deleted, not committed).
System.Text.Json with IncludeFields=true — ValueTuple serializes as Item1/Item2.
Pre-write validation confirmed health meter BackLeft=0x0600747E FrontRight=0x06007483
rect (5,5,150,16). Round-trip deserialization re-validated before writing.

Job 3: FixtureLoader.LoadVitals() deserializes the fixture from the test output
directory (CopyToOutputDirectory item in csproj) and returns ImportedLayout via
LayoutImporter.Build(root, _ => (0,0,0), null) — no dats, no GL.

Job 4: LayoutConformanceTests — 3 golden tests (35 asserts total):
  - VitalsTree_HasThreeMetersAtExpectedRects: 3 meters at x=5, w=150, h=16, y=5/21/37
  - VitalsTree_MetersHaveExpectedSliceIds: all 18 back+front slice ids health/stamina/mana
  - VitalsTree_ChromeCornerHasExpectedSprite: TL corner 0x10000633 → sprite 0x060074C3

Full App suite: 326 pass / 1 skip (pre-existing) / 0 fail. Build: 0 errors, 0 warnings.
Throwaway generator not committed (confirmed via git status).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-15 14:29:30 +02:00

115 lines
4.3 KiB
C#

using AcDream.App.UI;
using AcDream.App.UI.Layout;
namespace AcDream.App.Tests.UI.Layout;
/// <summary>
/// Golden conformance tests for the vitals LayoutDesc importer.
/// Uses the committed JSON fixture (<c>vitals_2100006C.json</c>) — no dats, no GL.
///
/// These tests lock the importer's tree-building (factory dispatch, meter slice
/// extraction, rects) against the real portal.dat values captured when the
/// fixture was generated. Any regression in <see cref="LayoutImporter"/>,
/// <see cref="DatWidgetFactory"/>, or <see cref="ElementReader"/> will surface here.
///
/// Sprite ids sourced from <c>docs/research/2026-06-15-layoutdesc-format.md §11</c>.
/// </summary>
public class LayoutConformanceTests
{
// ── Test 1: Three meters at expected rects ────────────────────────────────
/// <summary>
/// The three vital bars must be UiMeters positioned at x=5, width=150, height=16,
/// at y=5 (health), y=21 (stamina), y=37 (mana).
/// </summary>
[Fact]
public void VitalsTree_HasThreeMetersAtExpectedRects()
{
var layout = FixtureLoader.LoadVitals();
(uint Id, float Y)[] expected =
[
(0x100000E6u, 5f), // health
(0x100000ECu, 21f), // stamina
(0x100000EEu, 37f), // mana
];
foreach (var (id, y) in expected)
{
var elem = layout.FindElement(id);
Assert.NotNull(elem);
var meter = Assert.IsType<UiMeter>(elem);
Assert.Equal(5f, meter.Left);
Assert.Equal(y, meter.Top);
Assert.Equal(150f, meter.Width);
Assert.Equal(16f, meter.Height);
}
}
// ── Test 2: All 18 slice ids ──────────────────────────────────────────────
/// <summary>
/// The six back+front 3-slice sprite ids for each of the three meters must
/// match the values confirmed from the dat dump (format doc §11).
/// This proves the factory's grandchild slice extraction against committed data.
/// </summary>
[Fact]
public void VitalsTree_MetersHaveExpectedSliceIds()
{
var layout = FixtureLoader.LoadVitals();
// Health bar
{
var elem = layout.FindElement(0x100000E6u);
var m = Assert.IsType<UiMeter>(elem);
Assert.Equal(0x0600747Eu, m.BackLeft);
Assert.Equal(0x0600747Fu, m.BackTile);
Assert.Equal(0x06007480u, m.BackRight);
Assert.Equal(0x06007481u, m.FrontLeft);
Assert.Equal(0x06007482u, m.FrontTile);
Assert.Equal(0x06007483u, m.FrontRight);
}
// Stamina bar
{
var elem = layout.FindElement(0x100000ECu);
var m = Assert.IsType<UiMeter>(elem);
Assert.Equal(0x06007484u, m.BackLeft);
Assert.Equal(0x06007485u, m.BackTile);
Assert.Equal(0x06007486u, m.BackRight);
Assert.Equal(0x06007487u, m.FrontLeft);
Assert.Equal(0x06007488u, m.FrontTile);
Assert.Equal(0x06007489u, m.FrontRight);
}
// Mana bar
{
var elem = layout.FindElement(0x100000EEu);
var m = Assert.IsType<UiMeter>(elem);
Assert.Equal(0x0600748Au, m.BackLeft);
Assert.Equal(0x0600748Bu, m.BackTile);
Assert.Equal(0x0600748Cu, m.BackRight);
Assert.Equal(0x0600748Du, m.FrontLeft);
Assert.Equal(0x0600748Eu, m.FrontTile);
Assert.Equal(0x0600748Fu, m.FrontRight);
}
}
// ── Test 3: Chrome TL corner sprite ───────────────────────────────────────
/// <summary>
/// The top-left chrome corner element (id <c>0x10000633</c>) must be a
/// <see cref="UiDatElement"/> whose active media file id is <c>0x060074C3</c>.
/// </summary>
[Fact]
public void VitalsTree_ChromeCornerHasExpectedSprite()
{
var layout = FixtureLoader.LoadVitals();
var elem = layout.FindElement(0x10000633u);
Assert.NotNull(elem);
var datElem = Assert.IsType<UiDatElement>(elem);
var (file, _) = datElem.ActiveMedia();
Assert.Equal(0x060074C3u, file);
}
}