Merge pull request #20 from EFNext/feat/runtime-abstractions

Add ExpressiveSharp.Abstractions package

Author: koenbeuk

CLAUDE.md

@@ -62,8 +62,15 @@ CI targets both .NET 8.0 and .NET 10.0 SDKs.
 ### Project Dependencies
 
 ```
-ExpressiveSharp (core runtime, net8.0;net10.0)
+ExpressiveSharp.Abstractions (attributes + source generator, net8.0;net10.0)
   └── no external deps
+  Provides: [Expressive], [ExpressiveFor], [ExpressiveForConstructor], [PolyfillTarget],
+      IExpressionTreeTransformer, source generator + code fixers (as analyzers)
+
+ExpressiveSharp (core runtime, net8.0;net10.0)
+  └── ExpressiveSharp.Abstractions
+  Provides: ExpressiveResolver, ExpressiveReplacer, expression transformers,
+      IRewritableQueryable<T>, ExpressionPolyfill, .ExpandExpressives(), .AsExpressive()
 
 ExpressiveSharp.Generator (source generator, netstandard2.0)
   └── Microsoft.CodeAnalysis.CSharp 5.0.0

ExpressiveSharp.slnx

@@ -13,6 +13,7 @@
     <Project Path="src/ExpressiveSharp.EntityFrameworkCore.RelationalExtensions.Abstractions/ExpressiveSharp.EntityFrameworkCore.RelationalExtensions.Abstractions.csproj" />
     <Project Path="src/ExpressiveSharp.EntityFrameworkCore.RelationalExtensions/ExpressiveSharp.EntityFrameworkCore.RelationalExtensions.csproj" />
     <Project Path="src/ExpressiveSharp.Generator/ExpressiveSharp.Generator.csproj" />
+    <Project Path="src/ExpressiveSharp.Abstractions/ExpressiveSharp.Abstractions.csproj" />
     <Project Path="src/ExpressiveSharp/ExpressiveSharp.csproj" />
   </Folder>
   <Folder Name="/tests/">

README.md

@@ -79,6 +79,8 @@ WHERE "c"."Email" IS NOT NULL
 
 ```bash
 dotnet add package ExpressiveSharp
+# Lightweight alternative (attributes + source generator only, no runtime services):
+# dotnet add package ExpressiveSharp.Abstractions
 # Optional: EF Core integration
 dotnet add package ExpressiveSharp.EntityFrameworkCore
 ```

docs/guide/introduction.md

@@ -92,6 +92,7 @@ Mark computed properties and methods with `[Expressive]` to generate companion e
 | | .NET 8.0 | .NET 10.0 |
 |---|---|---|
 | **ExpressiveSharp** | C# 12 | C# 14 |
+| **ExpressiveSharp.Abstractions** | C# 12 | C# 14 |
 | **ExpressiveSharp.EntityFrameworkCore** | EF Core 8.x | EF Core 10.x |
 | **ExpressiveSharp.EntityFrameworkCore.RelationalExtensions** | EF Core 8.x | EF Core 10.x |
 

docs/guide/quickstart.md

@@ -21,7 +21,8 @@ dotnet add package ExpressiveSharp.EntityFrameworkCore
 
 | Package | Purpose |
 |---------|---------|
-| `ExpressiveSharp` | Core runtime -- `[Expressive]` attribute, source generator, expression expansion, transformers |
+| `ExpressiveSharp` | Core runtime -- expression expansion, transformers, `IRewritableQueryable<T>`, `ExpressionPolyfill` (includes everything from Abstractions) |
+| `ExpressiveSharp.Abstractions` | Lightweight -- `[Expressive]` attribute, `[ExpressiveFor]`, `IExpressionTreeTransformer`, source generator only (no runtime services) |
 | `ExpressiveSharp.EntityFrameworkCore` | EF Core integration -- `UseExpressives()`, `ExpressiveDbSet<T>`, Include/ThenInclude, async methods, analyzers and code fixes |
 | `ExpressiveSharp.EntityFrameworkCore.RelationalExtensions` | SQL window functions -- ROW_NUMBER, RANK, DENSE_RANK, NTILE (experimental) |
 

docs/index.md

@@ -150,6 +150,7 @@ Computed properties are **inlined into SQL** — no client-side evaluation, no N
 
 | Package | Description |
 |---------|-------------|
-| [`ExpressiveSharp`](https://www.nuget.org/packages/ExpressiveSharp/) | Core runtime — `[Expressive]` attribute, expression expansion, transformers |
+| [`ExpressiveSharp`](https://www.nuget.org/packages/ExpressiveSharp/) | Core runtime — expression expansion, transformers, `IRewritableQueryable<T>`, `ExpressionPolyfill` |
+| [`ExpressiveSharp.Abstractions`](https://www.nuget.org/packages/ExpressiveSharp.Abstractions/) | Lightweight — attributes (`[Expressive]`, `[ExpressiveFor]`), `IExpressionTreeTransformer`, source generator only |
 | [`ExpressiveSharp.EntityFrameworkCore`](https://www.nuget.org/packages/ExpressiveSharp.EntityFrameworkCore/) | EF Core integration — `UseExpressives()`, `ExpressiveDbSet<T>`, Include/ThenInclude, async methods |
 | [`ExpressiveSharp.EntityFrameworkCore.RelationalExtensions`](https://www.nuget.org/packages/ExpressiveSharp.EntityFrameworkCore.RelationalExtensions/) | SQL window functions — ROW_NUMBER, RANK, DENSE_RANK, NTILE (experimental) |

…c/ExpressiveSharp/ExpressiveAttribute.cs …harp.Abstractions/ExpressiveAttribute.cssrc/ExpressiveSharp/ExpressiveAttribute.cs renamed to src/ExpressiveSharp.Abstractions/ExpressiveAttribute.cs src/ExpressiveSharp/ExpressiveAttribute.cs renamed to src/ExpressiveSharp.Abstractions/ExpressiveAttribute.cs

@@ -0,0 +1,30 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <Description>Attributes, interfaces, and source generator for ExpressiveSharp — use this package when you only need compile-time expression tree generation without the full runtime</Description>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\ExpressiveSharp.Generator\ExpressiveSharp.Generator.csproj"
+                      OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+    <ProjectReference Include="..\ExpressiveSharp.CodeFixers\ExpressiveSharp.CodeFixers.csproj"
+                      OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+  </ItemGroup>
+
+  <!-- Pack the source generator and code fixers into analyzers/dotnet/cs/ so NuGet consumers get them -->
+  <ItemGroup>
+    <None Include="..\ExpressiveSharp.Generator\bin\$(Configuration)\netstandard2.0\ExpressiveSharp.Generator.dll"
+          Pack="true" PackagePath="analyzers/dotnet/cs/" Visible="false" />
+    <None Include="..\ExpressiveSharp.CodeFixers\bin\$(Configuration)\netstandard2.0\ExpressiveSharp.CodeFixers.dll"
+          Pack="true" PackagePath="analyzers/dotnet/cs/" Visible="false" />
+  </ItemGroup>
+
+  <!-- Pack build props so consumers get interceptor namespace + compiler-visible properties -->
+  <ItemGroup>
+    <None Include="..\ExpressiveSharp.Generator\build\ExpressiveSharp.Generator.props"
+          Pack="true" PackagePath="build/ExpressiveSharp.Abstractions.props" Visible="false" />
+    <None Include="..\ExpressiveSharp.Generator\build\ExpressiveSharp.Generator.props"
+          Pack="true" PackagePath="buildTransitive/ExpressiveSharp.Abstractions.props" Visible="false" />
+  </ItemGroup>
+
+</Project>