acdream/tests/AcDream.App.Tests/Plugins/AppAutomationSurfaceIconInstalledDatTests.cs

using AcDream.App.Plugins;
using AcDream.App.Tests.Rendering;
using AcDream.Content;
using AcDream.Core.Spells;
using AcDream.Plugin.Abstractions;
using DatReaderWriter;
using DatReaderWriter.Options;
using Xunit;

namespace AcDream.App.Tests.Plugins;

/// <summary>
/// Slice B item 11 (<c>docs/plans/2026-09-06-plugin-shelf-and-dat-icons.md</c>):
/// <see cref="PluginSpellInfo.IconId"/> must carry the REAL installed
/// portal.dat SpellTable (<c>0x0E00000E</c>) icon field through
/// <see cref="AppAutomationSurface"/> unchanged, not just a synthetic
/// <see cref="SpellMetadata"/> fixture. Mirrors the
/// <see cref="AcDream.App.Tests.Rendering.ChargenPreviewEntityBuilderTests"/>
/// installed-DAT gate convention: <see cref="InstalledDatTestPath"/> +
/// <c>[Trait("Lane", "InstalledDat")]</c>, <c>Assert.Fail</c> with the
/// standard message when no DAT is configured (see docs/release-gate.md).
/// </summary>
[Trait("Lane", "InstalledDat")]
public sealed class AppAutomationSurfaceIconInstalledDatTests
{
    /// <summary>Retail's Strength Other I — the same well-known spell id
    /// SmokeIconPanel falls back to when the local character has learned
    /// nothing yet.</summary>
    private const uint KnownSpellId = 1u;

    [Fact]
    public void KnownSpell_IconId_MatchesTheInstalledSpellTablesIconFieldExactly()
    {
        string? datDir = InstalledDatTestPath.Resolve();
        if (datDir is null)
        {
            Assert.Fail(
                "Lane=InstalledDat requires an installed retail DAT directory; see docs/release-gate.md.");
            return;
        }

        using var dats = new DatCollection(datDir, DatAccessType.Read);
        using var adapter = new DatCollectionAdapter(dats);
        MagicCatalog catalog = MagicCatalog.Load(adapter);

        Assert.True(
            catalog.SpellTable.TryGet(KnownSpellId, out SpellMetadata expected),
            $"expected spell {KnownSpellId} (Strength Other I) to exist in the installed SpellTable");
        // A real production install's SpellTable always has non-zero art for
        // an ordinary named spell; a zero here would mean the projector
        // silently dropped SpellBase.Icon rather than proving the pipeline.
        Assert.NotEqual(0u, expected.IconId);

        using var runtime = GameRuntimeTestFactory.Create();
        runtime.CharacterOwner.InstallSpellMetadata(catalog.SpellTable);
        runtime.CharacterOwner.Spellbook.OnSpellLearned(KnownSpellId);
        using var surface = new AppAutomationSurface();
        surface.Bind(runtime, runtime.CharacterOwner, runtime.ActionOwner.SpellCast);

        Assert.True(surface.Spells.TryGet(KnownSpellId, out PluginSpellInfo info));
        Assert.Equal(expected.IconId, info.IconId);
    }
}