.NET 10 + .NET 11 TFMs with NativeAOT and Runtime Async support

.editorconfig

@@ -23,6 +23,9 @@ indent_style = tab
 # Sort using and Import directives with System.* appearing first
 dotnet_sort_system_directives_first = true
 
+# Omit accessibility modifiers when they match the language default (e.g. private on class members)
+dotnet_style_require_accessibility_modifiers = omit_if_default:error
+
 # Avoid "this." and "Me." if not necessary
 dotnet_style_qualification_for_field = false:error
 dotnet_style_qualification_for_property = false:error
@@ -42,6 +45,12 @@ dotnet_style_explicit_tuple_names = true:error
 
 # CSharp code style settings:
 [*.cs]
+# Prefer file-scoped namespace declarations (single `namespace Foo;`)
+csharp_style_namespace_declarations = file_scoped:error
+
+# Allow single-statement bodies without braces (e.g. `if (x) F();`, `for (...) F();`)
+csharp_prefer_braces = false:silent
+
 # Prefer "var" everywhere
 csharp_style_var_for_built_in_types = true:error
 csharp_style_var_when_type_is_apparent = true:error

.github/workflows/ci.yml

@@ -16,6 +16,7 @@ jobs:
           8.0.*
           9.0.*
           10.0.*
+          11.0.*
       env:
         DOTNET_NOLOGO: 1
         DOTNET_CLI_TELEMETRY_OPTOUT: 1
@@ -25,3 +26,7 @@ jobs:
       run: dotnet build --no-restore
     - name: Test
       run: dotnet test --no-build -v n /p:CollectCoverage=true /p:CoverletOutput='../../' /p:CoverletOutputFormat=opencover /p:Threshold=91 /p:SkipAutoProps=true /p:UseSourceLink=true
+    - name: AOT smoke-test (net8.0)
+      run: dotnet publish test/TaskTupleAwaiter.AotSmokeTest -c Release -f net8.0 --no-restore
+    - name: AOT smoke-test (net11.0)
+      run: dotnet publish test/TaskTupleAwaiter.AotSmokeTest -c Release -f net11.0 --no-restore

.github/workflows/release.yml

@@ -12,7 +12,7 @@ jobs:
     - name: Setup .NET
       uses: actions/setup-dotnet@v5
       with:
-        dotnet-version: 10.0.*
+        dotnet-version: 11.0.*
       env:
         DOTNET_NOLOGO: 1
         DOTNET_CLI_TELEMETRY_OPTOUT: 1

CLAUDE.md

@@ -2,26 +2,30 @@
 
 ## Project Overview
 
-TaskTupleAwaiter provides extension methods that allow you to `await` a `ValueTuple` of `Task<T>` (or non-generic `Task`) instances and destructure the results in a single line. The `source_generator` branch replaces the hand-authored `TaskTupleExtensions.cs` (up to arity 16) with a Roslyn incremental source generator.
+TaskTupleAwaiter provides extension methods that allow you to `await` a `ValueTuple` of `Task<T>` (or non-generic `Task`) instances and destructure the results in a single line. In this repository, a Roslyn incremental source generator (`src/TaskTupleAwaiter.Generator`) generates the extension-method source during library build under `namespace System.Threading.Tasks`, and that generated code is compiled into `TaskTupleAwaiter.dll` for each target framework. Consumers install and reference the compiled package binaries; the generator is a private build-time implementation detail.
 
 ## Repository Layout
 
 ```
 TaskTupleAwaiter/
 ├── src/
-│   ├── TaskTupleAwaiter/                  # Main library (netstandard2.0)
-│   │   └── TaskTupleExtensions.cs         # Hand-authored fallback / reference implementation
+│   ├── TaskTupleAwaiter/                  # Main library shell (netstandard2.0, net462, net8.0)
+│   │                                      #   No hand-authored .cs sources — code is generated at build and compiled into the library.
 │   └── TaskTupleAwaiter.Generator/        # Roslyn incremental source generator (netstandard2.0)
 │       └── TaskTupleExtensionsGenerator.cs
 ├── test/
-│   └── TaskTupleAwaiter.Tests/            # xUnit test project
-│       ├── TaskTupleAwaiterTests.cs
-│       ├── BehaviorComparisonTests.cs
-│       ├── Adapters/
-│       │   └── AwaiterAdapter.cs
-│       ├── DummyException.cs
-│       ├── On.cs
-│       └── SpySynchronizationContext.cs
+│   ├── TaskTupleAwaiter.Tests/            # xUnit v3 test project
+│   │   ├── TaskTupleAwaiterTests.cs
+│   │   ├── BehaviorComparisonTests.cs
+│   │   ├── Adapters/
+│   │   │   └── AwaiterAdapter.cs
+│   │   ├── DummyException.cs
+│   │   ├── On.cs
+│   │   └── SpySynchronizationContext.cs
+│   └── TaskTupleAwaiter.AotSmokeTest/     # NativeAOT downstream-consumer smoke-test (net8.0, net11.0)
+│       ├── TaskTupleAwaiter.AotSmokeTest.csproj
+│       └── Program.cs
+├── docs/superpowers/                      # Specs and implementation plans
 ├── README.md
 ├── LICENSE.txt
 └── CLAUDE.md                              # This file
@@ -32,7 +36,9 @@ TaskTupleAwaiter/
 | Concern | Choice |
 |---|---|
 | Language | C# 14.0 |
-| Library / Generator target | .NET Standard 2.0 |
+| Library TFMs | netstandard2.0, net462, net8.0 |
+| Generator target | netstandard2.0 (Roslyn analyzer requirement) |
+| AOT-compatible TFMs | net8.0+ (`<IsAotCompatible>true</IsAotCompatible>` via `IsTargetFrameworkCompatible`) |
 | Generator framework | Roslyn `IIncrementalGenerator` |
 | Test framework | xUnit v3 |
 | Assertion library | Shouldly |

Directory.Build.props

@@ -1,9 +1,10 @@
 <Project>
   <PropertyGroup>
+    <AnalysisLevel>latest-Recommended</AnalysisLevel>
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <ImplicitUsings>true</ImplicitUsings>
     <LangVersion>latest</LangVersion>
-    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
-    <AnalysisLevel>latest-Recommended</AnalysisLevel>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
   </PropertyGroup>
 </Project>

README.md

@@ -31,6 +31,7 @@ var (user, orders) = await (GetUserAsync(id), GetOrdersAsync(id));
 - **Non-generic `Task` support** — await tuples of `Task` (not just `Task<T>`) when you don't need return values
 - **Zero dependencies** — a single file, no external packages (except `System.ValueTuple` on .NET Framework 4.6.2)
 - **Broad compatibility** — targets .NET Standard 2.0, .NET Framework 4.6.2, and .NET 8+
+- **NativeAOT ready** — the package sets `<IsAotCompatible>true</IsAotCompatible>` for .NET 8+ targets, and CI publishes downstream NativeAOT smoke tests
 
 ## Installation
 

TaskTupleAwaiter.slnx

@@ -23,4 +23,5 @@
   <Project Path="test\TaskTupleAwaiter.Tests\TaskTupleAwaiter.Tests.csproj">
     <Configuration Solution="Release|*" Project="*|*|NoBuild" />
   </Project>
+  <Project Path="test\TaskTupleAwaiter.AotSmokeTest\TaskTupleAwaiter.AotSmokeTest.csproj" />
 </Solution>

src/Directory.Build.props

@@ -1,30 +1,29 @@
 <Project>
 
-  <Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" Condition="'' != $([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
+	<Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" Condition="'' != $([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
 
-  <PropertyGroup>
-    <TargetFrameworks>netstandard2.0;net462;net8.0</TargetFrameworks>
-    <Authors>Joseph Musser,Brian Buvinghausen</Authors>
-    <Company>Buvinghausen Solutions</Company>
-    <Copyright>Copyright © $([System.DateTime]::UtcNow.ToString("yyyy")) Brian Buvinghausen</Copyright>
-    <PackageLicenseExpression>MIT</PackageLicenseExpression>
-    <PackageReadmeFile>README.md</PackageReadmeFile>
-    <PackageProjectUrl>https://github.com/buvinghausen/TaskTupleAwaiter/blob/master/README.md</PackageProjectUrl>
-    <PackageTags>C# 7.0;Value Tuple;Async Await Elegant Code</PackageTags>
-    <PublishRepositoryUrl>true</PublishRepositoryUrl>
-    <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <EmbedUntrackedSources>true</EmbedUntrackedSources>
-    <IncludeSymbols>true</IncludeSymbols>
-    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-    <ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>
-    <PackageOutputPath>..\..\</PackageOutputPath>
-  </PropertyGroup>
+	<PropertyGroup>
+		<Authors>Joseph Musser,Brian Buvinghausen</Authors>
+		<Company>Buvinghausen Solutions</Company>
+		<ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>
+		<Copyright>Copyright © $([System.DateTime]::UtcNow.ToString("yyyy")) Brian Buvinghausen</Copyright>
+		<EmbedUntrackedSources>true</EmbedUntrackedSources>
+		<IncludeSymbols>true</IncludeSymbols>
+		<IsAotCompatible Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net8.0'))">true</IsAotCompatible>
+		<PackageLicenseExpression>MIT</PackageLicenseExpression>
+		<PackageOutputPath>..\..\</PackageOutputPath>
+		<PackageProjectUrl>https://github.com/buvinghausen/TaskTupleAwaiter/blob/master/README.md</PackageProjectUrl>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
+		<PackageTags>C# 7.0;Value Tuple;Async Await Elegant Code</PackageTags>
+		<PublishRepositoryUrl>true</PublishRepositoryUrl>
+		<SymbolPackageFormat>snupkg</SymbolPackageFormat>
+		<TargetFrameworks>netstandard2.0;net462;net8.0</TargetFrameworks>
+	</PropertyGroup>
 
-  <ItemGroup>
-    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="*" PrivateAssets="All" />
-    <None Include="../../LICENSE.txt" Pack="true" PackagePath="$(PackageLicenseFile)" />
-    <None Include="../../README.md" Pack="true" PackagePath="$(PackageReadmeFile)" />
-    <InternalsVisibleTo Include="$(AssemblyName).Tests" />
-  </ItemGroup>
+	<ItemGroup>
+		<None Include="../../LICENSE.txt" Pack="true" PackagePath="$(PackageLicenseFile)" />
+		<None Include="../../README.md" Pack="true" PackagePath="$(PackageReadmeFile)" />
+		<InternalsVisibleTo Include="$(AssemblyName).Tests" />
+	</ItemGroup>
 
 </Project>

src/TaskTupleAwaiter.Generator/CSharpEmit.cs

@@ -0,0 +1,13 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Text;
+
+namespace TaskTupleAwaiter.Generator;
+
+static class CSharpEmit
+{
+	// Identical to StringBuilder.AppendLine at runtime; the [StringSyntax("C#")] annotation
+	// is what Visual Studio 2022 and JetBrains Rider use to syntax-highlight the raw-string
+	// content at each call site as C# instead of as opaque text.
+	public static StringBuilder AppendCSharp(this StringBuilder sb, [StringSyntax("C#")] string code) =>
+		sb.AppendLine(code);
+}

src/TaskTupleAwaiter.Generator/StringSyntaxAttribute.cs

@@ -0,0 +1,13 @@
+// Polyfill for System.Diagnostics.CodeAnalysis.StringSyntaxAttribute (added in .NET 7).
+// The generator project targets netstandard2.0, so the BCL definition isn't available.
+// Roslyn's IDE classifiers recognise the attribute by namespace + type name (not assembly
+// identity), so an internal declaration here drives the embedded-language hint in VS / Rider.
+#pragma warning disable IDE0130 // Namespace does not match folder structure
+namespace System.Diagnostics.CodeAnalysis;
+#pragma warning restore IDE0130 // Namespace does not match folder structure
+
+[AttributeUsage(AttributeTargets.Field | AttributeTargets.Parameter | AttributeTargets.Property, AllowMultiple = false)]
+sealed class StringSyntaxAttribute(string syntax) : Attribute
+{
+	public string Syntax { get; } = syntax;
+}

src/TaskTupleAwaiter.Generator/TaskTupleAwaiter.Generator.csproj

@@ -1,15 +1,15 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
-  <PropertyGroup>
-    <TargetFrameworks>netstandard2.0</TargetFrameworks>
-    <IsRoslynComponent>true</IsRoslynComponent>
-    <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
-    <IsPackable>false</IsPackable>
-    <GenerateDocumentationFile>false</GenerateDocumentationFile>
-  </PropertyGroup>
+	<PropertyGroup>
+		<EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
+		<IsPackable>false</IsPackable>
+		<IsRoslynComponent>true</IsRoslynComponent>
+		<NoWarn>$(NoWarn);CS1591</NoWarn>
+		<TargetFrameworks>netstandard2.0</TargetFrameworks>
+	</PropertyGroup>
 
-  <ItemGroup>
-    <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="*" PrivateAssets="all" />
-  </ItemGroup>
+	<ItemGroup>
+		<PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="*" PrivateAssets="all" />
+	</ItemGroup>
 
 </Project>

src/TaskTupleAwaiter.Generator/TaskTupleExtensionsGenerator.cs

@@ -28,7 +28,7 @@ static string GenerateSource(bool hasAwaitOptions)
 	{
 		StringBuilder sb = new();
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			// <auto-generated/>
 			using System.Runtime.CompilerServices;
@@ -55,15 +55,15 @@ public static class TaskTupleExtensions
 			AppendTypedArity(sb, arity, hasAwaitOptions);
 		AppendNonGenericSection(sb, hasAwaitOptions);
 
-		sb.AppendLine("}");
+		sb.AppendCSharp("}");
 		return sb.ToString();
 	}
 
 	// ── Typed Task<T> ─────────────────────────────────────────────────────
 
 	static void AppendTypedArity1(StringBuilder sb, bool hasAwaitOptions)
 	{
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			#region (Task<T1>)
 
@@ -78,15 +78,15 @@ public static ConfiguredTaskAwaitable<T1> ConfigureAwait<T1>(this ValueTuple<Tas
 			""");
 
 		if (hasAwaitOptions)
-			sb.AppendLine(
+			sb.AppendCSharp(
 				"""
 				/// <summary>This type and its members are intended for use by the compiler.</summary>
 				public static ConfiguredTaskAwaitable<T1> ConfigureAwait<T1>(this ValueTuple<Task<T1>> tasks, ConfigureAwaitOptions options) =>
 					tasks.Item1.ConfigureAwait(options);
 
 				""");
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			#endregion
 
@@ -102,7 +102,7 @@ static void AppendTypedArity(StringBuilder sb, int arity, bool hasAwaitOptions)
 			? "continueOnCapturedContext ? ConfigureAwaitOptions.ContinueOnCapturedContext : ConfigureAwaitOptions.None"
 			: "continueOnCapturedContext";
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			$"""
 			#region (Task<T1>..Task<T{arity}>)
 
@@ -117,7 +117,7 @@ static void AppendTypedArity(StringBuilder sb, int arity, bool hasAwaitOptions)
 			""");
 
 		if (hasAwaitOptions)
-			sb.AppendLine(
+			sb.AppendCSharp(
 				$"""
 				/// <summary>This type and its members are intended for use by the compiler.</summary>
 				public static TupleConfiguredTaskAwaitable<{tp}> ConfigureAwait<{tp}>(this {tupleType} tasks, ConfigureAwaitOptions options) =>
@@ -129,14 +129,14 @@ static void AppendTypedArity(StringBuilder sb, int arity, bool hasAwaitOptions)
 
 		AppendTupleConfiguredTaskAwaitableStruct(sb, arity, tp, tupleType, optionsType);
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			#endregion
 
 			""");
 	}
 
-	static void AppendTupleTaskAwaiterStruct(StringBuilder sb, int arity, string tp, string tupleType) => sb.AppendLine(
+	static void AppendTupleTaskAwaiterStruct(StringBuilder sb, int arity, string tp, string tupleType) => sb.AppendCSharp(
 		$$"""
 		/// <summary>This type and its members are intended for use by the compiler.</summary>
 		public readonly record struct TupleTaskAwaiter<{{tp}}> : ICriticalNotifyCompletion
@@ -174,7 +174,7 @@ public void UnsafeOnCompleted(Action continuation) =>
 		""");
 
 	static void AppendTupleConfiguredTaskAwaitableStruct(StringBuilder sb, int arity, string tp,
-		string tupleType, string optionsType) => sb.AppendLine(
+		string tupleType, string optionsType) => sb.AppendCSharp(
 		$$"""
 		/// <summary>This type and its members are intended for use by the compiler.</summary>
 		public readonly record struct TupleConfiguredTaskAwaitable<{{tp}}>
@@ -232,7 +232,7 @@ public void UnsafeOnCompleted(Action continuation) =>
 
 	static void AppendNonGenericSection(StringBuilder sb, bool hasAwaitOptions)
 	{
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			#region Task
 
@@ -247,7 +247,7 @@ public static ConfiguredTaskAwaitable ConfigureAwait(this ValueTuple<Task> tasks
 			""");
 
 		if (hasAwaitOptions)
-			sb.AppendLine(
+			sb.AppendCSharp(
 				"""
 				/// <summary>This type and its members are intended for use by the compiler.</summary>
 				public static ConfiguredTaskAwaitable ConfigureAwait(this ValueTuple<Task> tasks, ConfigureAwaitOptions options) =>
@@ -260,7 +260,7 @@ public static ConfiguredTaskAwaitable ConfigureAwait(this ValueTuple<Task> tasks
 			AppendNonGenericArity(sb, arity, hasAwaitOptions);
 		}
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			"""
 			#endregion
 
@@ -271,7 +271,7 @@ static void AppendNonGenericArity(StringBuilder sb, int arity, bool hasAwaitOpti
 	{
 		var tupleType = NonGenericTaskTupleType(arity);
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			$"""
 			/// <summary>This type and its members are intended for use by the compiler.</summary>
 			public static TaskAwaiter GetAwaiter(this {tupleType} tasks) =>
@@ -285,7 +285,7 @@ public static ConfiguredTaskAwaitable ConfigureAwait(this {tupleType} tasks, boo
 
 		if (!hasAwaitOptions) return;
 
-		sb.AppendLine(
+		sb.AppendCSharp(
 			$"""
 			/// <summary>This type and its members are intended for use by the compiler.</summary>
 			public static ConfiguredTaskAwaitable ConfigureAwait(this {tupleType} tasks, ConfigureAwaitOptions options) =>

test/Directory.Build.props

@@ -3,19 +3,21 @@
   <Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" Condition="'' != $([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" />
 
   <PropertyGroup>
-    <!-- .NET 8 & 9 end on November 10, 2026 -->
-    <TargetFrameworks>net10.0;net9.0;net8.0;net472</TargetFrameworks>
-    <OutputType>Exe</OutputType>
     <IsPackable>false</IsPackable>
+    <NoWarn>$(NoWarn);CS1591;IDE0051</NoWarn>
+    <OutputType>Exe</OutputType>
+    <TargetFrameworks>net11.0;net10.0;net9.0;net8.0;net472</TargetFrameworks>
     <TestingPlatformDotnetTestSupport>true</TestingPlatformDotnetTestSupport>
     <UseMicrosoftTestingPlatformRunner>true</UseMicrosoftTestingPlatformRunner>
   </PropertyGroup>
 
   <ItemGroup>
-    <Using Include="Shouldly" />
-    <Using Include="Xunit" />
     <PackageReference Include="Shouldly" Version="4.*" />
     <PackageReference Include="xunit.v3.mtp-v2" Version="3.*" />
+    <Using Include="Shouldly" />
+    <Using Include="Xunit" />
+    <Using Remove="System.IO" />
+    <Using Remove="System.Net.Http" />
   </ItemGroup>
 
 </Project>