// JsonConverter<T>の派生クラスを定義します。Tはシリアライズ・デシリアライズされる型を指定します。
public class Vector3Converter : JsonConverter<Vector3>
{
    // JSONを読み込む処理を記述します。(デシリアライズ)
    public override Vector3 Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        // 最初が「[」でなければJsonExceptionを投げます。シリアライザーはJsonExceptionとNotSupportedExceptionを特別に処理するので注意してください。
        if (reader.TokenType != JsonTokenType.StartArray)
        {
            throw new JsonException();
        }

        // xを読み取ります。
        reader.Read();
        if (reader.TokenType != JsonTokenType.Number)
        {
            throw new JsonException();
        }
        var x = reader.GetSingle();

        // yを読み取ります。
        reader.Read();
        if (reader.TokenType != JsonTokenType.Number)
        {
            throw new JsonException();
        }
        var y = reader.GetSingle();

        // zを読み取ります。
        reader.Read();
        if (reader.TokenType != JsonTokenType.Number)
        {
            throw new JsonException();
        }
        var z = reader.GetSingle();

        // 最後が「]」でなければJsonExceptionを投げます。
        reader.Read();
        if (reader.TokenType != JsonTokenType.EndArray)
        {
            throw new JsonException();
        }

        return new Vector3(x, y, z);
    }

    // JSONとして書き込む処理を記述します。(シリアライズ)
    public override void Write(Utf8JsonWriter writer, Vector3 value, JsonSerializerOptions options)
    {
        // [x,y,z]のようにJSONに変換をします。
        writer.WriteStartArray();
        writer.WriteNumberValue(value.x);
        writer.WriteNumberValue(value.y);
        writer.WriteNumberValue(value.z);
        writer.WriteEndArray();
    }
}

[JsonSerializable(typeof(Color))]
internal partial class UnityEngineColorSourceGenerationContext : JsonSerializerContext
{
}

public class Sample
{
    public static void SampleMethod()
    {
        var color = Color.red;

        // ----------------------
        // ----  リフレクション  ----
        // ----------------------
        // ERROR: System.Text.Json.JsonException
        var json = JsonSerializer.Serialize(color);

        // ----------------------
        // ----   ソース生成   ----
        // ----------------------
        // ERROR: System.InvalidOperationException
        var json2 = JsonSerializer.Serialize(color, UnityEngineColorSourceGenerationContext.Default.Color);

        // ERROR: System.Text.Json.JsonException
        var json3 = JsonSerializer.Serialize(color, typeof(Color), UnityEngineColorSourceGenerationContext.Default);

        // ERROR: System.InvalidOperationException
        var json4 = JsonSerializer.Serialize(color, UnityEngineColorSourceGenerationContext.Default.Options);
    }
}

// UnityEngine.Vector3に対するJsonUtilityでのシリアライズ結果
{"x":1.0,"y":2.0,"z":3.0}

// UnityEngine.Vector3に対する本ライブラリでのシリアライズ結果
[1,2,3]

Color color = Color.red;

// 1. UnityEngine・Mathematicsの型を含む型をSerializeする場合は"UnityOptions.Default"を引数に渡す
string colorJson = JsonSerializer.Serialize(color, UnityOptions.Default);

// 2. UnityEngine・Mathematicsの型を含む型をDeserializeする場合は"UnityOptions.Default"を引数に渡す
Color deserializedColor = JsonSerializer.Deserialize<Color>(colorJson, UnityOptions.Default);

public class TestClass
{
    public Color Color { get; set; }
    public int2x3 Number { get; set; }
    public float FloatNumber { get; set; }
}

[JsonSerializable(typeof(TestClass))]
public partial class TestClassContext : JsonSerializerContext
{
}

// 以下利用サンプル
public static class Sample
{
    public static void SampleMethod()
    {
        var value = new TestClass
        {
            Color = Color.red,
            Number = new int2x3(0, 1, 2, 3, 4, 5),
            FloatNumber = 1f
        };

        // Unity用のJsonConverterを追加します。
        var json = JsonSerializer.Serialize(value, TestClassContext.Default.WithUnityConverters());
        var deserializedValue = JsonSerializer.Deserialize<TestClass>(json, TestClassContext.Default.WithUnityConverters());
    }
}

// 変換前
internal class Program
{
    public static void Main()
    {
        var x = 10;
        string code = $$$"""
-------
x is {{{x}}}.
-------
""";
    }
}

// 変換後
internal class Program
{
    public static void Main()
    {
        var x = 10;
        string code = $@"-------
x is {x}.
-------";
    }
}