[API Proposal]: Add freezing APIs to JsonTypeInfo

[eiriktsarpalis]

Background and motivation

Following up on #76540, this tracks the proposal to add user browsable locking APIs for the System.Text.Json metadata types. It follows the API shape applied to JsonSerializerOptions in #74431.

API Proposal

namespace System.Text.Json.Metadata;

public partial static class JsonTypeInfo
{
    public bool IsReadOnly { get; }
    public void MakeReadOnly();
}

API Usage

var resolver = new DefaultJsonTypeInfoResolver
{
    Modifiers =
    {
         static typeInfo =>
         {
               if (typeInfo.IsReadOnly)
               {
                       // type is locked for further modification, exit the modifier
                       return;
               }

               if (typeInfo.Type == typeof(MySpecialPoco))
               {
                      typeInfo.CreateObject = () => new MySpecialPoco("defaultValue");
                      // prevent subsequent modifiers/resolvers from further modifying this contract
                      typeInfo.MakeReadOnly(); 
               }
         }
    }
};

Alternative Designs

No response

Risks

No response

[dotnet-issue-labeler]

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

[ghost]

Tagging subscribers to this area: @dotnet/area-system-text-json, @gregsdennis
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Background and motivation

Following up on #76540, this tracks the proposal to add user browsable locking APIs for the System.Text.Json metadata types. It follows the API shape applied to JsonSerializerOptions in #74431.

API Proposal

namespace System.Text.Json.Metadata;

public partial static class JsonTypeInfo
{
    public bool IsReadOnly { get; }
    public void MakeReadOnly();
}

API Usage

var resolver = new DefaultJsonTypeInfoResolver
{
    Modifiers =
    {
         static typeInfo =>
         {
               if (typeInfo.IsReadOnly)
               {
                       // type is locked for further modification, exit the modifier
                       return;
               }

               if (typeInfo.Type == typeof(MySpecialPoco))
               {
                      typeInfo.CreateObject = () => new MySpecialPoco("defaultValue");
                      // prevent subsequent modifiers/resolvers from further modifying this contract
                      typeInfo.MakeReadOnly(); 
               }
         }
    }
}

Alternative Designs

No response

Risks

No response

Author:	eiriktsarpalis
Assignees:	eiriktsarpalis
Labels:	area-System.Text.Json, api-ready-for-review
Milestone:	8.0.0