andrewlock · andrewlock · Mar 9, 2026 · Mar 9, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,21 @@
 Changelog
 --- 
 
+## [v1.0.0-beta21](https://github.com/andrewlock/NetEscapades.EnumGenerators/compare/v1.0.0-beta20..v1.0.0-beta21) (2026-03-09)
+
+### Breaking Changes
+
+* When using the _NetEscapades.EnumGenerators_ meta package, set `EnumGenerator_PreserveAttributes=true` by default, so that usage analyzers can light up in downstream projects (#241)
+
+### Features
+
+* Add "Force Internal" to allow forcing extension methods to be `internal` even for `public` enums  (#230) Thanks [@xC0dex](https://github.com/xC0dex)!
+* Extend usage analyzers to nullable enum variables (#244)
+
+### Fixes
+
+* Scan all assemblies for "external" attributes for usage analyzers (#238)
+
 ## [v1.0.0-beta20](https://github.com/andrewlock/NetEscapades.EnumGenerators/compare/v1.0.0-beta19..v1.0.0-beta20) (2026-01-05)
 
 ### Breaking Changes

diff --git a/docs/NetEscapades.EnumGenerators.Generators.md b/docs/NetEscapades.EnumGenerators.Generators.md
@@ -90,7 +90,7 @@ This adds a `<PackageReference>` to your project. You can additionally mark the
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20"
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21"
     PrivateAssets="all" ExcludeAssets="runtime" />
   <!-- -->
 
@@ -451,10 +451,10 @@ In some cases you may not want these dependencies to flow to other projects. Thi
   </PropertyGroup>
 
   <!-- Add the generator package with PrivateAssets -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All"/>
 
   <!-- Optionally add the runtime dependencies package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -514,7 +514,7 @@ In general, for simplicity, we recommend referencing [NetEscapades.EnumGenerator
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -527,7 +527,7 @@ In contrast, if you are producing a reusable library and don't want any runtime
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime" />
 </Project>
 ```
 
@@ -541,8 +541,8 @@ The final option is to reference [NetEscapades.EnumGenerators.Generators](https:
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime"/>
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -655,7 +655,7 @@ The `[EnumExtensions]` attribute is decorated with the `[Conditional]` attribute
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 <!-- endInclude -->
diff --git a/docs/NetEscapades.EnumGenerators.Generators.source.md b/docs/NetEscapades.EnumGenerators.Generators.source.md
@@ -36,7 +36,7 @@ This adds a `<PackageReference>` to your project. You can additionally mark the
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20"
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21"
     PrivateAssets="all" ExcludeAssets="runtime" />
   <!-- -->
 

diff --git a/docs/NetEscapades.EnumGenerators.Interceptors.md b/docs/NetEscapades.EnumGenerators.Interceptors.md
@@ -69,7 +69,7 @@ This adds a `<PackageReference>` to your project. You can additionally mark the
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Interceptors" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Interceptors" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>

diff --git a/docs/NetEscapades.EnumGenerators.Interceptors.source.md b/docs/NetEscapades.EnumGenerators.Interceptors.source.md
@@ -57,7 +57,7 @@ This adds a `<PackageReference>` to your project. You can additionally mark the
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Interceptors" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Interceptors" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>

diff --git a/docs/NetEscapades.EnumGenerators.md b/docs/NetEscapades.EnumGenerators.md
@@ -90,7 +90,7 @@ This adds a `<PackageReference>` to your project:
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>
@@ -453,10 +453,10 @@ In some cases you may not want these dependencies to flow to other projects. Thi
   </PropertyGroup>
 
   <!-- Add the generator package with PrivateAssets -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All"/>
 
   <!-- Optionally add the runtime dependencies package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -516,7 +516,7 @@ In general, for simplicity, we recommend referencing [NetEscapades.EnumGenerator
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -529,7 +529,7 @@ In contrast, if you are producing a reusable library and don't want any runtime
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime" />
 </Project>
 ```
 
@@ -543,8 +543,8 @@ The final option is to reference [NetEscapades.EnumGenerators.Generators](https:
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime"/>
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -657,7 +657,7 @@ The `[EnumExtensions]` attribute is decorated with the `[Conditional]` attribute
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 <!-- endInclude -->
diff --git a/docs/NetEscapades.EnumGenerators.source.md b/docs/NetEscapades.EnumGenerators.source.md
@@ -36,7 +36,7 @@ This adds a `<PackageReference>` to your project:
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>

diff --git a/docs/README.md b/docs/README.md
@@ -90,7 +90,7 @@ This adds a `<PackageReference>` to your project:
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>
@@ -453,10 +453,10 @@ In some cases you may not want these dependencies to flow to other projects. Thi
   </PropertyGroup>
 
   <!-- Add the generator package with PrivateAssets -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All"/>
 
   <!-- Optionally add the runtime dependencies package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -516,7 +516,7 @@ In general, for simplicity, we recommend referencing [NetEscapades.EnumGenerator
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -529,7 +529,7 @@ In contrast, if you are producing a reusable library and don't want any runtime
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime" />
 </Project>
 ```
 
@@ -543,8 +543,8 @@ The final option is to reference [NetEscapades.EnumGenerators.Generators](https:
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime"/>
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -657,7 +657,7 @@ The `[EnumExtensions]` attribute is decorated with the `[Conditional]` attribute
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 <!-- endInclude -->
diff --git a/docs/README.source.md b/docs/README.source.md
@@ -36,7 +36,7 @@ This adds a `<PackageReference>` to your project:
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
   <!-- -->
 
 </Project>

diff --git a/docs/fragments/package-referencing.include.md b/docs/fragments/package-referencing.include.md
@@ -33,10 +33,10 @@ In some cases you may not want these dependencies to flow to other projects. Thi
   </PropertyGroup>
 
   <!-- Add the generator package with PrivateAssets -->
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All"/>
 
   <!-- Optionally add the runtime dependencies package -->
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -96,7 +96,7 @@ In general, for simplicity, we recommend referencing [NetEscapades.EnumGenerator
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
 
@@ -109,7 +109,7 @@ In contrast, if you are producing a reusable library and don't want any runtime
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime" />
 </Project>
 ```
 
@@ -123,8 +123,8 @@ The final option is to reference [NetEscapades.EnumGenerators.Generators](https:
     <TargetFramework>net8.0</TargetFramework>
   </PropertyGroup>
 
-  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta20" PrivateAssets="All" ExcludeAssets="runtime"/>
-  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators.Generators" Version="1.0.0-beta21" PrivateAssets="All" ExcludeAssets="runtime"/>
+  <PackageReference Include="NetEscapades.EnumGenerators.RuntimeDependencies" Version="1.0.0-beta21" />
 </Project>
 ```
 

diff --git a/docs/fragments/preserving-usages.include.md b/docs/fragments/preserving-usages.include.md
@@ -14,6 +14,6 @@ The `[EnumExtensions]` attribute is decorated with the `[Conditional]` attribute
   </PropertyGroup>
 
   <!-- Add the package -->
-  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta20" />
+  <PackageReference Include="NetEscapades.EnumGenerators" Version="1.0.0-beta21" />
 </Project>
 ```
diff --git a/releasenotes.props b/releasenotes.props
@@ -2,23 +2,20 @@
   <PropertyGroup>
     <PackageReleaseNotes>
       <![CDATA[
-## 1.0.0-beta20
+## 1.0.0-beta21
 
 ### Breaking Changes
 
-* Split NetEscapades.EnumGenerators package into 3 packages (#233, #234)
-  * _NetEscapades.EnumGenerators_ is a meta package, and should not be added with `PrivateAssets="All"` or `ExcludeAssets="runtime"`
-  * _NetEscapades.EnumGenerators.Generators_ contains the source generator, and _can_ be added with private assets
-  * _NetEscapades.EnumGenerators.RuntimeDependencies_ contains optional runtime dependencies used during generation
-  * Please see the readme for advice on choosing your packages: https://github.com/andrewlock/NetEscapades.EnumGenerators#package-referencing-options
+* When using the _NetEscapades.EnumGenerators_ meta package, set `EnumGenerator_PreserveAttributes=true` by default, so that usage analyzers can light up in downstream projects (#241)
 
 ### Features
 
-* Add analyzer to detect `StringBuilder.Append(enum)` on enums with `[EnumExtensions]` or `EnumExtensions<T>` (#230)
+* Add "Force Internal" to allow forcing extension methods to be `internal` even for `public` enums  (#230) Thanks [@xC0dex](https://github.com/xC0dex)!
+* Extend usage analyzers to nullable enum variables (#244)
 
 ### Fixes
 
-* Fix generating invalid XML in System.Memory warnings (#228)
+* Scan all assemblies for "external" attributes for usage analyzers (#238)
 
 ]]>
     </PackageReleaseNotes>

diff --git a/src/NetEscapades.EnumGenerators.Generators/Constants.cs b/src/NetEscapades.EnumGenerators.Generators/Constants.cs
@@ -2,7 +2,7 @@ namespace NetEscapades.EnumGenerators;
 
 public static class Constants
 {
-    public const string Version = "1.0.0-beta20";
+    public const string Version = "1.0.0-beta21";
     public const string MetadataSourcePropertyName = "EnumGenerator_EnumMetadataSource";
     public const string ForceExtensionMembers = "EnumGenerator_ForceExtensionMembers";
     public const string ForceInternalPropertyName = "EnumGenerator_ForceInternal";

diff --git a/version.props b/version.props
@@ -1,7 +1,7 @@
 <Project>
   <PropertyGroup>
     <VersionPrefix>1.0.0</VersionPrefix>
-    <VersionSuffix>beta20</VersionSuffix>
+    <VersionSuffix>beta21</VersionSuffix>
     <PackageVersion Condition="'$(VersionSuffix)' == ''">$(VersionPrefix)</PackageVersion>
     <PackageVersion Condition="'$(VersionSuffix)' != ''">$(VersionPrefix)-$(VersionSuffix)</PackageVersion>
   </PropertyGroup>