Add YamlDotNet source generator infrastructure for Native AOT support

[Copilot]

Overview

This PR adds the YamlDotNet source generator infrastructure to prepare GitVersion for Native AOT (Ahead-of-Time) compilation support, as outlined in Using the YamlDotNet Source Generator for Native AOT.

Changes

1. Source Generator Package

• Added Vecc.YamlDotNet.Analyzers.StaticGenerator v16.3.0 package reference
• Created GitVersionConfigurationStaticContext class with [YamlStaticContext] and [YamlSerializable] attributes for main configuration types

2. Property Accessor Updates

Changed internal init to internal set for all configuration properties to support source generator requirements:

• BranchConfiguration (14 properties)
• GitVersionConfiguration (21 properties)
• IgnoreConfiguration (4 properties)
• PreventIncrementConfiguration (3 properties)

This change maintains encapsulation (internal setters) while providing flexibility for serialization and future source generator use.

3. Updated Public API Surface

Added generated types to PublicAPI.Unshipped.txt:

• GitVersionConfigurationStaticContext
• StaticTypeInspector and related methods

Current Status

While the infrastructure is in place, the static serializer/deserializer is not actively used due to current limitations in YamlDotNet's source generator (v16.3.0):

1. Custom Type Inspector Limitation: The generated StaticTypeInspector doesn't honor custom type inspectors, which GitVersion requires for JsonPropertyName attribute mapping
2. Dynamic Type Support: No support for Dictionary<object, object?> used in override configurations
3. Complex Type Handling: Issues with nested and record types

The ConfigurationSerializer currently uses regular DeserializerBuilder/SerializerBuilder with a comment explaining the situation. The static context is instantiated but kept ready for future use.

Testing

✅ All 82 configuration tests pass (net8.0 and net9.0)
✅ Full backward compatibility maintained
✅ No breaking changes to existing functionality

Documentation

Added YAMLDOTNET_SOURCE_GENERATOR.md documenting:

• Current implementation status
• Known limitations
• Migration path for future improvements

Future Work

When YamlDotNet's source generator improves support for custom type inspectors and complex types, we can enable it in ConfigurationSerializer.cs by switching to StaticDeserializerBuilder/StaticSerializerBuilder.

Related

Fixes #[issue_number]

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[ISSUE]: Use the YamlDotNet source generator</issue_title>
<issue_description>Check this Blog https://andrewlock.net/using-the-yamldotnet-source-generator-for-native-aot/</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #4369

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[arturcic]

@copilot I actually need to use the source generator version, and I will later check the AOT

[Copilot]

Pull Request Overview

This PR adds YamlDotNet source generator infrastructure to prepare GitVersion for Native AOT (Ahead-of-Time) compilation support. The infrastructure is implemented but not actively used due to current limitations in YamlDotNet's source generator capabilities.

• Added Vecc.YamlDotNet.Analyzers.StaticGenerator v16.3.0 package reference and created GitVersionConfigurationStaticContext class
• Changed property accessors from internal init to internal set across all configuration classes to support source generator requirements
• Added documentation explaining current limitations and future migration path

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
YAMLDOTNET_SOURCE_GENERATOR.md	Documents implementation status, limitations, and future migration path
PublicAPI.Unshipped.txt	Adds generated types to public API surface
PreventIncrementConfiguration.cs	Changes 3 properties from init to set for generator compatibility
IgnoreConfiguration.cs	Changes 4 properties from init to set for generator compatibility
GitVersionConfigurationStaticContext.cs	New static context class with YamlDotNet source generator attributes
GitVersionConfiguration.cs	Changes 21 properties from init to set for generator compatibility
GitVersion.Configuration.csproj	Adds source generator package reference
ConfigurationSerializer.cs	Adds static context instance for future use
BranchConfiguration.cs	Changes 14 properties from init to set for generator compatibility
Directory.Packages.props	Adds version definition for source generator package

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud