Add LinqraftMappingGenerate attribute for EFCore query compilation support

src/Linqraft.Core/GenerateSourceCodeSnippets.cs

@@ -21,6 +21,10 @@ IncrementalGeneratorPostInitializationContext context
             "LinqraftAutoGeneratedDtoAttribute.g.cs",
             LinqraftAutoGeneratedDtoAttribute
         );
+        context.AddSource(
+            "LinqraftMappingGenerateAttribute.g.cs",
+            LinqraftMappingGenerateAttribute
+        );
     }
 
     // Generate expression and headers
@@ -231,6 +235,49 @@ internal sealed class LinqraftAutoGeneratedDtoAttribute : Attribute
         }
         """;
 
+    /// <summary>
+    /// Attribute to mark methods for Linqraft mapping generation.
+    /// This attribute is used to generate extension methods instead of using interceptors,
+    /// which is useful for EFCore query (pre)compilation and other scenarios where interceptors
+    /// are not supported.
+    /// </summary>
+    [StringSyntax("csharp")]
+    public const string LinqraftMappingGenerateAttribute = $$"""
+        {{CommentHeaderPartOnProd}}
+        #nullable enable
+        using System;
+        using System.ComponentModel;
+        using Microsoft.CodeAnalysis;
+
+        namespace Linqraft
+        {
+            /// <summary>
+            /// Marks a method for Linqraft mapping generation. The method must be in a static partial class
+            /// and contain a SelectExpr call. Linqraft will generate an extension method with the specified
+            /// name that contains the compiled Select expression.
+            /// This is useful for EFCore query (pre)compilation support where interceptors cannot be used.
+            /// </summary>
+            [AttributeUsage(AttributeTargets.Method, Inherited = false, AllowMultiple = false)]
+            [EmbeddedAttribute]
+            internal sealed class LinqraftMappingGenerateAttribute : Attribute
+            {
+                /// <summary>
+                /// Initializes a new instance of the LinqraftMappingGenerateAttribute class.
+                /// </summary>
+                /// <param name="methodName">The name of the extension method to generate.</param>
+                public LinqraftMappingGenerateAttribute(string methodName)
+                {
+                    MethodName = methodName;
+                }
+
+                /// <summary>
+                /// Gets the name of the extension method to generate.
+                /// </summary>
+                public string MethodName { get; }
+            }
+        }
+        """;
+
     [StringSyntax("csharp")]
     public const string SelectExprExtensions = $$""""
         {{CommentHeaderPartOnProd}}

src/Linqraft.Core/SelectExprInfo.cs

@@ -79,6 +79,18 @@ public abstract record SelectExprInfo
     /// </summary>
     public ITypeSymbol? CaptureArgumentType { get; init; }
 
+    /// <summary>
+    /// The name of the method to generate when using LinqraftMappingGenerate attribute.
+    /// If null, use the normal interceptor-based generation.
+    /// </summary>
+    public string? MappingMethodName { get; init; }
+
+    /// <summary>
+    /// The containing class for the mapping method when using LinqraftMappingGenerate attribute.
+    /// This should be a static partial class.
+    /// </summary>
+    public INamedTypeSymbol? MappingContainingClass { get; init; }
+
     /// <summary>
     /// Generates DTO class information (including nested DTOs)
     /// </summary>
@@ -87,25 +99,25 @@ public abstract record SelectExprInfo
     /// <summary>
     /// Generates the DTO structure for analysis and unique ID generation
     /// </summary>
-    protected abstract DtoStructure GenerateDtoStructure();
+    public abstract DtoStructure GenerateDtoStructure();
 
     /// <summary>
     /// Gets the class name for a DTO structure
     /// </summary>
-    protected abstract string GetClassName(DtoStructure structure);
+    public abstract string GetClassName(DtoStructure structure);
 
     /// <summary>
     /// Gets the parent (root) DTO class name
     /// </summary>
-    protected abstract string GetParentDtoClassName(DtoStructure structure);
+    public abstract string GetParentDtoClassName(DtoStructure structure);
 
     /// <summary>
     /// Gets the namespace where DTOs will be placed
     /// </summary>
-    protected abstract string GetDtoNamespace();
+    public abstract string GetDtoNamespace();
 
     // Get expression type string (for documentation)
-    protected abstract string GetExprTypeString();
+    public abstract string GetExprTypeString();
 
     /// <summary>
     /// Gets the full name for a nested DTO class using the structure.
@@ -218,7 +230,7 @@ protected bool IsEnumerableInvocation()
     /// <summary>
     /// Gets the return type prefix based on whether it's IQueryable or IEnumerable
     /// </summary>
-    protected string GetReturnTypePrefix()
+    public string GetReturnTypePrefix()
     {
         return IsEnumerableInvocation() ? "IEnumerable" : "IQueryable";
     }
@@ -264,7 +276,7 @@ protected string GenerateMethodHeaderPart(string dtoName, InterceptableLocation
     /// <summary>
     /// Generates property assignment code for a DTO property
     /// </summary>
-    protected string GeneratePropertyAssignment(DtoProperty property, int indents)
+    public string GeneratePropertyAssignment(DtoProperty property, int indents)
     {
         var expression = property.OriginalExpression;
         var syntax = property.OriginalSyntax;

src/Linqraft.Core/SelectExprInfoAnonymous.cs

@@ -26,7 +26,7 @@ public record SelectExprInfoAnonymous : SelectExprInfo
     /// <summary>
     /// Generates the DTO structure for unique ID generation
     /// </summary>
-    protected override DtoStructure GenerateDtoStructure()
+    public override DtoStructure GenerateDtoStructure()
     {
         return DtoStructure.AnalyzeAnonymousType(
             AnonymousObject,
@@ -39,21 +39,21 @@ protected override DtoStructure GenerateDtoStructure()
     /// <summary>
     /// Gets the DTO class name (empty for anonymous types)
     /// </summary>
-    protected override string GetClassName(DtoStructure structure) => "";
+    public override string GetClassName(DtoStructure structure) => "";
 
     /// <summary>
     /// Gets the parent DTO class name (empty for anonymous types)
     /// </summary>
-    protected override string GetParentDtoClassName(DtoStructure structure) => "";
+    public override string GetParentDtoClassName(DtoStructure structure) => "";
 
     /// <summary>
     /// Gets the namespace where DTOs will be placed
     /// Anonymous types don't generate separate DTOs, but return caller namespace for consistency
     /// </summary>
-    protected override string GetDtoNamespace() => CallerNamespace;
+    public override string GetDtoNamespace() => CallerNamespace;
 
     // Get expression type string (for documentation)
-    protected override string GetExprTypeString() => "anonymous";
+    public override string GetExprTypeString() => "anonymous";
 
     /// <summary>
     /// Generates static field declarations for pre-built expressions (if enabled)

src/Linqraft.Core/SelectExprInfoExplicitDto.cs

@@ -191,7 +191,7 @@ private List<string> GetParentAccessibilities()
     /// <summary>
     /// Generates the DTO structure for unique ID generation
     /// </summary>
-    protected override DtoStructure GenerateDtoStructure()
+    public override DtoStructure GenerateDtoStructure()
     {
         return DtoStructure.AnalyzeAnonymousType(
             AnonymousObject,
@@ -243,7 +243,7 @@ private string GetAccessibilityString(IPropertySymbol propertySymbol)
     /// When NestedDtoUseHashNamespace is enabled, the class name is just "{BestName}Dto"
     /// Otherwise, it includes the hash suffix: "{BestName}Dto_{hash}"
     /// </summary>
-    protected override string GetClassName(DtoStructure structure)
+    public override string GetClassName(DtoStructure structure)
     {
         if (Configuration?.NestedDtoUseHashNamespace == true)
         {
@@ -255,15 +255,15 @@ protected override string GetClassName(DtoStructure structure)
     /// <summary>
     /// Gets the parent DTO class name
     /// </summary>
-    protected override string GetParentDtoClassName(DtoStructure structure) => ExplicitDtoName;
+    public override string GetParentDtoClassName(DtoStructure structure) => ExplicitDtoName;
 
     /// <summary>
     /// Gets the namespace where DTOs will be placed
     /// </summary>
-    protected override string GetDtoNamespace() => GetActualDtoNamespace();
+    public override string GetDtoNamespace() => GetActualDtoNamespace();
 
     // Get expression type string (for documentation)
-    protected override string GetExprTypeString() => "explicit";
+    public override string GetExprTypeString() => "explicit";
 
     /// <summary>
     /// Generates static field declarations for pre-built expressions (if enabled)

src/Linqraft.Core/SelectExprInfoNamed.cs

@@ -26,7 +26,7 @@ public record SelectExprInfoNamed : SelectExprInfo
     /// <summary>
     /// Generates the DTO structure for unique ID generation
     /// </summary>
-    protected override DtoStructure GenerateDtoStructure()
+    public override DtoStructure GenerateDtoStructure()
     {
         return DtoStructure.AnalyzeNamedType(
             ObjectCreation,
@@ -39,23 +39,23 @@ protected override DtoStructure GenerateDtoStructure()
     /// <summary>
     /// Gets the DTO class name (uses the source type name)
     /// </summary>
-    protected override string GetClassName(DtoStructure structure) => structure.SourceTypeName;
+    public override string GetClassName(DtoStructure structure) => structure.SourceTypeName;
 
     /// <summary>
     /// Gets the parent DTO class name (fully qualified)
     /// </summary>
-    protected override string GetParentDtoClassName(DtoStructure structure) =>
+    public override string GetParentDtoClassName(DtoStructure structure) =>
         structure.SourceTypeFullName;
 
     /// <summary>
     /// Gets the namespace where DTOs will be placed
     /// Named types use the DTO's own namespace
     /// </summary>
-    protected override string GetDtoNamespace() =>
+    public override string GetDtoNamespace() =>
         SourceType.ContainingNamespace?.ToDisplayString() ?? CallerNamespace;
 
     // Get expression type string (for documentation)
-    protected override string GetExprTypeString() => "predefined";
+    public override string GetExprTypeString() => "predefined";
 
     /// <summary>
     /// Generates static field declarations for pre-built expressions (if enabled)

src/Linqraft.Core/SelectExprMappingInfo.cs

@@ -0,0 +1,35 @@
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+
+namespace Linqraft.Core;
+
+/// <summary>
+/// Information about a method marked with [LinqraftMappingGenerate] attribute
+/// </summary>
+public record SelectExprMappingInfo
+{
+    /// <summary>
+    /// The method declaration with the attribute
+    /// </summary>
+    public required MethodDeclarationSyntax MethodDeclaration { get; init; }
+
+    /// <summary>
+    /// The name of the method to generate (from attribute parameter)
+    /// </summary>
+    public required string TargetMethodName { get; init; }
+
+    /// <summary>
+    /// The containing class (must be static partial)
+    /// </summary>
+    public required INamedTypeSymbol ContainingClass { get; init; }
+
+    /// <summary>
+    /// The semantic model for this method
+    /// </summary>
+    public required SemanticModel SemanticModel { get; init; }
+
+    /// <summary>
+    /// The namespace where the class is defined
+    /// </summary>
+    public required string ContainingNamespace { get; init; }
+}