acdream/src/AcDream.App/UI/Layout/RetailAppraisalNameResolver.cs

using AcDream.Content;
using AcDream.Core.Items;
using DatReaderWriter;
using DatReaderWriter.DBObjs;
using DatReaderWriter.Types;

namespace AcDream.App.UI.Layout;

/// <summary>
/// Resolves the authored enum display names consumed by retail's appraisal
/// helpers. Material names follow
/// <c>MaterialTypeEnumMapper::MaterialTypeToString @ 0x005CD500</c>;
/// creature and heritage names follow
/// <c>AppraisalSystem::InqCreatureDisplayName @ 0x005B59E0</c> and
/// <c>InqHeritageGroupDisplayName @ 0x005B4710</c>.
/// </summary>
public sealed class RetailAppraisalNameResolver
{
    private const uint MaterialClientEnum = 0x10000001u;
    private const uint MaterialSubEnum = 1u;

    public static RetailAppraisalNameResolver Empty { get; } = new(
        new Dictionary<uint, string>(),
        new CreatureDisplayNameResolver(new Dictionary<uint, string>()));

    private readonly IReadOnlyDictionary<uint, string> _materials;
    private readonly CreatureDisplayNameResolver _creatures;

    public RetailAppraisalNameResolver(
        IReadOnlyDictionary<uint, string> materials,
        CreatureDisplayNameResolver creatures)
    {
        _materials = materials
            ?? throw new ArgumentNullException(nameof(materials));
        _creatures = creatures
            ?? throw new ArgumentNullException(nameof(creatures));
    }

    public static RetailAppraisalNameResolver Load(
        IDatReaderWriter dats,
        CreatureDisplayNameResolver creatures)
    {
        ArgumentNullException.ThrowIfNull(dats);
        ArgumentNullException.ThrowIfNull(creatures);

        var materials = new Dictionary<uint, string>();
        uint masterDid = (uint)dats.Portal.Db.Header.MasterMapId;
        EnumIDMap? master = masterDid == 0u
            ? null
            : dats.Get<EnumIDMap>(masterDid);
        if (master is not null
            && master.ClientEnumToID.TryGetValue(
                MaterialClientEnum,
                out uint materialRootMapDid)
            && dats.Get<EnumIDMap>(materialRootMapDid) is { } materialRootMap
            && materialRootMap.ClientEnumToID.TryGetValue(
                MaterialSubEnum,
                out uint materialMapDid)
            && dats.Get<DualEnumIDMap>(materialMapDid) is { } materialMap)
        {
            foreach ((uint id, PStringBase<byte> text)
                     in materialMap.ClientEnumToName)
            {
                materials.TryAdd(id, Normalize(text.Value));
            }
        }

        return new RetailAppraisalNameResolver(materials, creatures);
    }

    public string ResolveCreature(int creatureType)
        => _creatures.Resolve(creatureType);

    // Campaign CT slice CT5 (2026-08-25): the three hardcoded overrides this
    // method used to re-implement inline (2/5/13 -> "Gharu'ndim"/"Umbraen"/
    // "Olthoi") are dead duplication — CharacterIdentityText.HeritageGroupDisplayName
    // already bakes the identical AppraisalSystem::InqHeritageGroupDisplayName
    // overrides into its own switch (including id 12, which this method used
    // to leave to the fallback branch and get the same "Olthoi" answer
    // anyway). One owner for the override table now; behavior is unchanged
    // (byte-identical for every heritage id — verified by the existing
    // GenderHeritageDisplayNameTables_MatchTheRetailEnumMapperChain pin,
    // which exercises the shared table directly).
    public string ResolveHeritage(int heritageGroup)
        => CharacterIdentityText.HeritageGroupDisplayName(heritageGroup) ?? string.Empty;

    public string ResolveMaterial(int materialType)
        => materialType > 0
           && _materials.TryGetValue((uint)materialType, out string? name)
            ? name
            : string.Empty;

    /// <summary>
    /// Port of the material-decoration tail in
    /// <c>ACCWeenieObject::GetObjectName @ 0x0058E6E0</c>. Retail first
    /// chooses the singular/plural base name, removes an already-authored
    /// occurrence of the resolved material, trims it, then prefixes the
    /// material exactly once.
    /// </summary>
    public string ResolveAppropriateName(ClientObject obj)
    {
        ArgumentNullException.ThrowIfNull(obj);

        string baseName = obj.GetAppropriateName();
        if (obj.MaterialType is not { } materialType)
            return baseName;

        string material = ResolveMaterial(unchecked((int)materialType));
        if (string.IsNullOrEmpty(material))
            return baseName;

        string remainder = baseName
            .Replace(material, string.Empty, StringComparison.Ordinal)
            .Trim();
        return string.IsNullOrEmpty(remainder)
            ? material
            : $"{material} {remainder}";
    }

    private static string Normalize(string value)
        => value.Replace('_', ' ');
}