Move some stuff around and add gen projects

Author: jaybarden1

AStar.Dev.slnx

@@ -39,7 +39,7 @@
   </Folder>
   <Folder Name="/src/modules/usage module/">
     <Project Path="src/nuget-packages/AStar.Dev.Api.Usage.Sdk/AStar.Dev.Api.Usage.Sdk.csproj" />
-    <Project Path="src\nuget-packages\AStar.Dev.Usage.Api.Client.SDK\AStar.Dev.Usage.Api.Client.SDK.csproj" Type="C#" />
+    <Project Path="src/nuget-packages/AStar.Dev.Usage.Api.Client.SDK/AStar.Dev.Usage.Api.Client.SDK.csproj" Type="C#" />
   </Folder>
   <Folder Name="/src/nuget-packages/">
     <Project Path="src/nuget-packages/AStar.Dev.Api.HealthChecks/AStar.Dev.Api.HealthChecks.csproj" />
@@ -63,8 +63,9 @@
     <Project Path="src/nuget-packages/AStar.Dev.Utilities/AStar.Dev.Utilities.csproj" />
   </Folder>
   <Folder Name="/src/source-generators/">
-    <Project Path="src/source-generators/AStar.Dev.SourceGenerators/AStar.Dev.SourceGenerators.csproj" />
     <Project Path="src\source-generators\AStar.Dev.Annotations\AStar.Dev.Annotations.csproj" Type="Classic C#" />
+    <Project Path="src\source-generators\AStar.Dev.SourceGenerators.TestApp\AStar.Dev.SourceGenerators.TestApp.csproj" Type="Classic C#" />
+    <Project Path="src\source-generators\AStar.Dev.SourceGenerators\AStar.Dev.SourceGenerators.csproj" Type="Classic C#" />
   </Folder>
   <Folder Name="/src/uis/">
     <Project Path="src/uis/AStar.Dev.Web/AStar.Dev.Web.csproj" />
@@ -78,9 +79,9 @@
     <Project Path="test/AStar.Dev.Tests.Architecture/AStar.Dev.Tests.Architecture.csproj" />
   </Folder>
   <Folder Name="/test/modules/">
-    <Project Path="test/modules/AStar.Dev.Database.Updater.Core.Tests.Unit/AStar.Dev.Database.Updater.Core.Tests.Unit.csproj" />
     <Project Path="test/modules/AStar.Dev.Database.Updater.Tests.Integration/AStar.Dev.Database.Updater.Tests.Integration.csproj" />
     <Project Path="test/modules/AStar.Dev.Database.Updater.Tests.Unit/AStar.Dev.Database.Updater.Tests.Unit.csproj" />
+    <Project Path="test\modules\AStar.Dev.Database.Updater.Core.Tests.Integration\AStar.Dev.Database.Updater.Core.Tests.Integration.csproj" />
   </Folder>
   <Folder Name="/test/modules/apis/">
     <Project Path="test/modules/apis/AStar.Dev.Admin.Api.Tests.EndToEnd/AStar.Dev.Admin.Api.Tests.EndToEnd.csproj" />

src/source-generators/AStar.Dev.Annotations/AStar.Dev.Annotations.csproj

@@ -1,10 +1,8 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
+<Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <TargetFramework>netstandard2.0</TargetFramework>
         <LangVersion>preview</LangVersion>
         <Nullable>enable</Nullable>
         <ImplicitUsings>enable</ImplicitUsings>
     </PropertyGroup>
-
 </Project>

src/source-generators/AStar.Dev.Annotations/ConfigSectionAttribute.cs

@@ -0,0 +1,7 @@
+namespace AStar.Dev.Annotations;
+
+[AttributeUsage(AttributeTargets.Class, Inherited = false)]
+public sealed class ConfigSectionAttribute(string name) : Attribute
+{
+    public string Name { get; } = name;
+}

src/source-generators/AStar.Dev.Annotations/MapFromAttribute.cs

@@ -0,0 +1,7 @@
+namespace AStar.Dev.Annotations;
+
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
+public sealed class MapFromAttribute(Type source) : Attribute
+{
+    public Type Source { get; } = source;
+}

src/source-generators/AStar.Dev.Annotations/ServiceAttribute.cs

@@ -0,0 +1,21 @@
+namespace AStar.Dev.Annotations;
+
+public enum Lifetime
+{
+    Singleton,
+    Scoped,
+    Transient
+}
+
+[AttributeUsage(AttributeTargets.Class, Inherited = false)]
+public sealed class ServiceAttribute(Lifetime lifetime = Lifetime.Scoped) : Attribute
+{
+    // Positional: choose lifetime (default Scoped)
+    public Lifetime Lifetime { get; } = lifetime;
+
+    // Named: override the service interface to register against
+    public Type? As { get; set; }
+
+    // Named: also register the concrete type as itself (optional)
+    public bool AsSelf { get; set; } = false;
+}

src/source-generators/AStar.Dev.Annotations/StrongIdAttribute.cs

@@ -1,40 +1,11 @@
-using System;
-
 namespace AStar.Dev.Annotations;
 
-/// <summary>
-/// Represents an attribute that can be used to mark a struct as a strong identifier.
-/// </summary>
-/// <remarks>
-/// This attribute is used to annotate structures with a specific identifier type, typically
-/// to signify that the struct is a strongly typed id. The default identifier type is a GUID.
-/// </remarks>
-/// <param name="idType">
-/// The type of the identifier associated with the struct. By default, it is "System.Guid".
-/// </param>
-/// <param name="guidV7">
-/// Indicates whether the GUID used as the identifier for the struct conforms to the version 7 GUID format.
-/// </param>
 [AttributeUsage(AttributeTargets.Struct)]
-public sealed class StrongIdAttribute(string idType = "System.Guid", bool guidV7 = true) : Attribute
+public sealed class StrongIdAttribute(string underlying = "System.Guid") : Attribute
 {
     /// <summary>
-    /// Gets the type of the identifier associated with a struct marked by the <see cref="StrongIdAttribute"/>.
-    /// </summary>
-    /// <remarks>
-    /// This property returns the string name of the identifier type. By default, it is "System.Guid".
-    /// The identifier type specifies the type used as an identifier for the struct.
-    /// </remarks>
-    public string IdType { get; } = idType;
-
-    /// <summary>
-    /// Indicates whether the GUID used as the identifier for a struct marked by the <see cref="StrongIdAttribute"/>
-    /// conforms to the version 7 GUID format.
+    ///     Underlying CLR type. Defaults to System.Guid.
+    ///     Examples: "System.Guid", "int", "long", "string".
     /// </summary>
-    /// <remarks>
-    /// Version 7 GUIDs are designed to facilitate time-based sorting and are a newer standard
-    /// compared to the traditional random GUIDs (version 4). When this property is set to true,
-    /// the identifier adopts the version 7 format.
-    /// </remarks>
-    public bool GuidV7 { get; } = guidV7;
-}
+    public string Underlying { get; } = underlying;
+}

src/source-generators/AStar.Dev.SourceGenerators.TestApp/AStar.Dev.SourceGenerators.TestApp.csproj

@@ -0,0 +1,35 @@
+<Project Sdk="Microsoft.NET.Sdk">
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net9.0</TargetFramework>
+        <Nullable>enable</Nullable>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
+        <!-- <CompilerGeneratedFilesOutputPath>.\GeneratedFiles</CompilerGeneratedFilesOutputPath> -->
+    </PropertyGroup>
+
+    <ItemGroup>
+        <!-- Source generator wired in as an analyzer -->
+        <ProjectReference Include="..\AStar.Dev.Annotations\AStar.Dev.Annotations.csproj" />
+        <ProjectReference Include="..\AStar.Dev.SourceGenerators\AStar.Dev.SourceGenerators.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.10"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.10"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="9.0.10"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="9.0.10"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="9.0.10"/>
+        <PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="9.0.10"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <AdditionalFiles Include="options.schema"/>
+    </ItemGroup>
+
+    <ItemGroup>
+        <None Include="appsettings.json">
+            <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+        </None>
+    </ItemGroup>
+</Project>

src/source-generators/AStar.Dev.SourceGenerators.TestApp/Order.cs

@@ -0,0 +1,14 @@
+using AStar.Dev.Annotations;
+
+namespace AStar.Dev.SourceGenerators.TestApp;
+
+[StrongId]
+public readonly partial struct OrderId;
+
+public sealed class Order
+{
+    public OrderId Id { get; set; }
+    public string Status { get; set; } = "";
+    public int Quantity { get; set; }
+    public string? Note { get; set; }
+}

src/source-generators/AStar.Dev.SourceGenerators.TestApp/OrderDTO.cs

@@ -0,0 +1,12 @@
+using AStar.Dev.Annotations;
+
+namespace AStar.Dev.SourceGenerators.TestApp;
+
+[MapFrom(typeof(Order))]
+public sealed class OrderDto
+{
+    public OrderId Id { get; set; } // same type → direct assign
+    public string Status { get; set; } = "";
+    public int Quantity { get; set; }
+    public string? Note { get; set; } // no source → generator will DIAGNOSE
+}

src/source-generators/AStar.Dev.SourceGenerators.TestApp/PaymentOptions.cs

@@ -0,0 +1,12 @@
+using System.ComponentModel.DataAnnotations;
+using AStar.Dev.Annotations;
+
+namespace AStar.Dev.SourceGenerators.TestApp;
+
+[ConfigSection("Payments")]
+public sealed class PaymentsOptions
+{
+    public string ApiKey { get; set; } = default!;
+
+    [Range(1, 120)] public int TimeoutSeconds { get; set; }
+}