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

using System.Numerics;
using System.Text;

namespace AcDream.App.UI.Layout;

/// <summary>
/// Font-color indices selected by retail <c>ItemExamineUI</c>. The concrete
/// colors come from the item report's LayoutDesc property <c>0x1B</c>.
/// </summary>
public enum ItemAppraisalFontStyle
{
    Normal = 0,
    Beneficial = 1,
    Detrimental = 2,
}

/// <summary>
/// Separator inserted before an appraisal fragment. This is the retained
/// equivalent of <c>ItemExamineUI::AddItemInfo</c>'s final argument.
/// </summary>
public enum ItemAppraisalSeparator
{
    None,
    Line,
    Paragraph,
}

/// <summary>
/// One retail appraisal append operation: prose, separator, and authored
/// font-color index. Keeping these separate until shaping preserves style
/// when a long fragment wraps.
/// </summary>
public readonly record struct ItemAppraisalFragment(
    string Text,
    ItemAppraisalSeparator Separator,
    ItemAppraisalFontStyle Style);

/// <summary>
/// Immutable item appraisal report in retail append order.
/// </summary>
public sealed class ItemAppraisalReport
{
    public static ItemAppraisalReport Empty { get; } = new([]);

    public ItemAppraisalReport(IReadOnlyList<ItemAppraisalFragment> fragments)
    {
        ArgumentNullException.ThrowIfNull(fragments);
        Fragments = fragments;
    }

    public IReadOnlyList<ItemAppraisalFragment> Fragments { get; }
    public bool IsEmpty => Fragments.Count == 0;

    public override string ToString()
    {
        var text = new StringBuilder();
        foreach (ItemAppraisalFragment fragment in Fragments)
        {
            if (text.Length != 0)
            {
                text.Append(fragment.Separator == ItemAppraisalSeparator.Paragraph
                    ? "\n\n"
                    : "\n");
            }
            text.Append(fragment.Text);
        }
        return text.ToString();
    }
}

/// <summary>
/// Port of <c>ItemExamineUI::AddItemInfo @ 0x004AC050/0x004ADCA0</c>.
/// Retail appends one newline when <paramref name="sameParagraph"/> is true,
/// two otherwise, then applies font DID index zero and the supplied color index.
/// </summary>
internal sealed class ItemAppraisalReportBuilder
{
    private readonly List<ItemAppraisalFragment> _fragments = [];

    public void Line(
        string value,
        ItemAppraisalFontStyle style = ItemAppraisalFontStyle.Normal)
        => Add(value, sameParagraph: true, style);

    public void Paragraph(
        string value,
        ItemAppraisalFontStyle style = ItemAppraisalFontStyle.Normal)
        => Add(value, sameParagraph: false, style);

    /// <summary>
    /// Preserve an empty retail <c>AddItemInfo("", ..., true)</c> append.
    /// Once text exists this contributes one physical empty row; on an empty
    /// glyph list retail has no preceding separator to append.
    /// </summary>
    public void BlankLine(
        ItemAppraisalFontStyle style = ItemAppraisalFontStyle.Normal)
    {
        if (_fragments.Count == 0)
            return;

        _fragments.Add(new ItemAppraisalFragment(
            string.Empty,
            ItemAppraisalSeparator.Line,
            style));
    }

    public ItemAppraisalReport Build()
        => _fragments.Count == 0
            ? ItemAppraisalReport.Empty
            : new ItemAppraisalReport(_fragments.ToArray());

    private void Add(
        string value,
        bool sameParagraph,
        ItemAppraisalFontStyle style)
    {
        if (string.IsNullOrWhiteSpace(value))
            return;

        _fragments.Add(new ItemAppraisalFragment(
            value,
            _fragments.Count == 0
                ? ItemAppraisalSeparator.None
                : sameParagraph
                    ? ItemAppraisalSeparator.Line
                    : ItemAppraisalSeparator.Paragraph,
            style));
    }
}

/// <summary>
/// Width-aware projection of retail appraisal fragments into the retained
/// <see cref="UiText"/> line model.
/// </summary>
internal static class ItemAppraisalTextLayout
{
    public static IReadOnlyList<UiText.Line> Shape(
        UiText target,
        ItemAppraisalReport report)
    {
        ArgumentNullException.ThrowIfNull(target);
        ArgumentNullException.ThrowIfNull(report);

        float maxWidth = Math.Max(1f, target.Width - (2f * target.Padding));
        float Measure(string value)
            => target.DatFont?.MeasureWidth(value)
               ?? target.Font?.MeasureWidth(value)
               ?? value.Length * 8f;

        var lines = new List<UiText.Line>();
        foreach (ItemAppraisalFragment fragment in report.Fragments)
        {
            if (lines.Count != 0
                && fragment.Separator == ItemAppraisalSeparator.Paragraph)
            {
                lines.Add(new UiText.Line(string.Empty, ResolveColor(target, fragment.Style)));
            }

            Vector4 color = ResolveColor(target, fragment.Style);
            // WIRE-domain normalize — deliberately NOT the DAT source
            // decode (DatStringResolver → RetailStringEscapes, 2026-08-17
            // systemic round): appraisal fragments are server strings
            // (long description, use text, inscription), which never pass
            // the DAT string source, so this is not a duplicate path. It
            // accommodates literal "\n" sequences in ACE's database
            // strings; server strings with REAL line breaks flow through
            // the Split below either way.
            string normalized = fragment.Text.Replace(
                "\\n",
                "\n",
                StringComparison.Ordinal);
            foreach (string logicalLine in normalized.Split('\n'))
            {
                if (logicalLine.Length == 0)
                {
                    lines.Add(new UiText.Line(string.Empty, color));
                    continue;
                }

                foreach (string wrapped in ChatTranscriptRenderer.WrapText(
                             logicalLine,
                             maxWidth,
                             Measure))
                {
                    lines.Add(new UiText.Line(wrapped, color));
                }
            }
        }

        return lines;
    }

    private static Vector4 ResolveColor(
        UiText target,
        ItemAppraisalFontStyle style)
    {
        int index = (int)style;
        return index >= 0 && index < target.FontColorPalette.Count
            ? target.FontColorPalette[index]
            : target.DefaultColor;
    }
}