Editor/Core/Formats/Dmx/Kv2Writer.cs

Editor-side text emitter for Source 2 DMX keyvalues2_noids format. Builds the output with CRLF line endings and tab indentation, brackets top-level and inline elements, writes attribute and value arrays plus element references, and has invariant formatting helpers for floats, vectors, quaternions and time.

#nullable enable annotations

using System.Globalization;
using System.Numerics;
using System.Text;

namespace WeaponImporter.EditorTools.Core.Formats.Dmx;

using Vector2 = System.Numerics.Vector2;
using Vector3 = System.Numerics.Vector3;

/// <summary>
/// Low-level DMX <c>keyvalues2_noids</c> text emitter: CRLF line endings, tab indentation,
/// top-level elements separated by blank lines (the layout fbx2dmx produces).
/// </summary>
public sealed class Kv2Writer
{
    public const string ModelHeader = "<!-- dmx encoding keyvalues2_noids 4 format model 22 -->";

    private readonly StringBuilder _sb = new();
    private readonly bool _blankAfterInline;
    private int _indent;

    /// <param name="blankAfterInline">Emit an indentation-only line after each inline element (fbx2dmx animation quirk).</param>
    public Kv2Writer(bool blankAfterInline = false) => _blankAfterInline = blankAfterInline;

    public void Raw(string text) => _sb.Append(text).Append("\r\n");

    private void Line(string text) => _sb.Append('\t', _indent).Append(text).Append("\r\n");

    public void Attr(string name, string type, string value)
        => Line($"\"{Escape(name)}\" \"{type}\" \"{Escape(value)}\"");

    public void BeginTop(string className)
    {
        Line($"\"{className}\"");
        Line("{");
        _indent++;
    }

    public void EndTop()
    {
        _indent--;
        Line("}");
        _sb.Append("\r\n");
    }

    public void BeginInline(string name, string className)
    {
        Line($"\"{Escape(name)}\" \"{className}\"");
        Line("{");
        _indent++;
    }

    public void EndInline()
    {
        _indent--;
        Line("}");
        if (_blankAfterInline)
            Line("");
    }

    public void BeginArrayElement(string className)
    {
        Line($"\"{className}\"");
        Line("{");
        _indent++;
    }

    public void EndArrayElement(bool last)
    {
        _indent--;
        Line(last ? "}" : "},");
    }

    public void BeginArray(string name, string type = "element_array")
    {
        Line($"\"{Escape(name)}\" \"{type}\" ");
        Line("[");
        _indent++;
    }

    public void EndArray()
    {
        _indent--;
        Line("]");
    }

    public void ElementRef(string id, bool last) => Line($"\"element\" \"{id}\"" + (last ? "" : ","));

    public void Value(string value, bool last) => Line($"\"{Escape(value)}\"" + (last ? "" : ","));

    /// <summary>A whole value array on consecutive lines.</summary>
    public void ValueArray<T>(string name, string type, IReadOnlyList<T> values, Func<T, string> format)
    {
        BeginArray(name, type);
        for (var i = 0; i < values.Count; i++)
            Value(format(values[i]), i == values.Count - 1);
        EndArray();
    }

    public void Refs(string name, IReadOnlyList<string> ids)
    {
        BeginArray(name);
        for (var i = 0; i < ids.Count; i++)
            ElementRef(ids[i], i == ids.Count - 1);
        EndArray();
    }

    public void EmptyBinary(string name)
    {
        Line($"\"{Escape(name)}\" \"binary\" ");
        Line("\"");
        Line("\"");
    }

    public override string ToString() => _sb.ToString();

    private static string Escape(string value)
        => value.Replace("\\", "\\\\").Replace("\"", "\\\"").Replace("\r", " ").Replace("\n", " ");

    // ------------------------------------------------------------------ formatting

    /// <summary>Invariant float, up to 10 decimals, trailing zeros stripped, no negative zero.</summary>
    public static string F(float value)
    {
        if (value == 0f || !float.IsFinite(value))
            return "0";
        return ((double)value).ToString("0.##########", CultureInfo.InvariantCulture);
    }

    public static string I(int value) => value.ToString(CultureInfo.InvariantCulture);

    public static string Vec(Vector3 v) => $"{F(v.X)} {F(v.Y)} {F(v.Z)}";

    public static string Vec(Vector2 v) => $"{F(v.X)} {F(v.Y)}";

    public static string Quat(Quaternion q) => $"{F(q.X)} {F(q.Y)} {F(q.Z)} {F(q.W)}";

    public static string Time(double seconds) => seconds.ToString("0.0000", CultureInfo.InvariantCulture);
}