UPDATED: Enumeration Generator

- Added a nested Added a new file for the JSON converter template
- Generated the JSON converter source each enum field

Samples/Dgmjr.Enumerations.CodeGenerator.Samples.csproj

@@ -22,7 +22,7 @@
     <Description>Samples for the DGMJR Enumeration data structure generator</Description>
   </PropertyGroup>
   <ItemGroup>
-    <SourceGeneratorPackageReference Include="Dgmjr.Enumerations.CodeGenerator" />
+    <PackageReference Include="Dgmjr.Enumerations.CodeGenerator" IncludeAssets="Analyzers;Build" ExcludeAssets="Native;BuildTransitive;BuildMultitargeting;ContentFiles;Compile;Runtime" PrivateAssets="All" />
     <!-- <PackageReference Include="Dgmjr.Enumerations.CodeGenerator" IncludeAssets="Analyzers;Build" ExcludeAssets="Native;BuildTransitive;ContentFiles" PrivateAssets="All" /> -->
     <!-- <ProjectReference Include="../src/Dgmjr.Enumerations.CodeGenerator.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="true" IncludeAssets="Analyzers;Build" ExcludeAssets="Native;BuildTransitive;ContentFiles" PrivateAssets="None" /> -->
     <PackageReference Include="Dgmjr.Enumerations.Enumeration" />

Samples/Dgmjr.Enumerations.CodeGenerator.Samples.sln

@@ -8,7 +8,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		..\..\..\..\..\Packages\Versions.Local.props = ..\..\..\..\..\Packages\Versions.Local.props
 	EndProjectSection
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dgmjr.Enumerations.CodeGenerator.Samples", "Dgmjr.Enumerations.CodeGenerator.Samples.csproj", "{166E5F60-3449-4A11-AA22-092E10E19564}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dgmjr.Enumerations.CodeGenerator.Samples", "Dgmjr.Enumerations.CodeGenerator.Samples.csproj", "{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -20,18 +20,18 @@ Global
 		Release|Any CPU = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Local|Any CPU.ActiveCfg = Local|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Local|Any CPU.Build.0 = Local|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Testing|Any CPU.ActiveCfg = Testing|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Testing|Any CPU.Build.0 = Testing|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Staging|Any CPU.ActiveCfg = Staging|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Staging|Any CPU.Build.0 = Staging|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Production|Any CPU.ActiveCfg = Local|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Production|Any CPU.Build.0 = Local|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{166E5F60-3449-4A11-AA22-092E10E19564}.Release|Any CPU.Build.0 = Release|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Local|Any CPU.ActiveCfg = Local|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Local|Any CPU.Build.0 = Local|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Testing|Any CPU.ActiveCfg = Testing|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Testing|Any CPU.Build.0 = Testing|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Staging|Any CPU.ActiveCfg = Staging|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Staging|Any CPU.Build.0 = Staging|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Production|Any CPU.ActiveCfg = Local|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Production|Any CPU.Build.0 = Local|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{72AF42ED-1B8A-46BA-BDB6-E666F7019AF7}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

Tests/Dgmjr.Enumerations.CodeGenerator.Tests.csproj

@@ -19,6 +19,7 @@
     <IsPackable>false</IsPackable>
     <IsTestProject>true</IsTestProject>
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+    <ProjectGuid>8037C3AA-FC4B-4379-8C4E-0517FC90E94E</ProjectGuid>
   </PropertyGroup>
 
   <ItemGroup>
@@ -40,7 +41,7 @@
     <ProjectReference Include="../src/Dgmjr.Enumerations.CodeGenerator.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="true" IncludeAssets="Analyzers;Build;Compile;Runtime" ExcludeAssets="Native;BuildTransitive;ContentFiles" PrivateAssets="All" />
 
     <PackageReference Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" />
-    <UsingsPackageReference Include="MSBuild.Usings" />
+    <PackageReference Include="MSBuild.Usings" IncludeAssets="Build;BuildTransitive;BuildMultitargeting;Runtime;Compile" ExcludeAssets="ContentFiles;Native;Analyzers" PrivateAssets="None" />
     <!-- <ProjectReference Include="../src/Runtime/Dgmjr.Enumerations.CodeGenerator.Runtime.csproj" Targets="Restore;Build" /> -->
   </ItemGroup>
 

Tests/Dgmjr.Enumerations.CodeGenerator.Tests.sln

@@ -1,4 +1,5 @@
 Microsoft Visual Studio Solution File, Format Version 12.00
+# 
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B283EBC2-E01F-412D-9339-FD56EF114549}"
 	ProjectSection(SolutionItems) = preProject
 		..\..\..\..\..\Directory.Build.props = ..\..\..\..\..\Directory.Build.props

src/Constants.cs

@@ -1,3 +1,4 @@
+using System.Reflection.PortableExecutable;
 /*
  * Constants.cs
  *
@@ -51,6 +52,7 @@ internal static class Constants
     public const string DisplayAttribute = nameof(DisplayAttribute);
     public const string DisplayName = nameof(DisplayName);
     public const string Enumeration = nameof(Enumeration);
+    public const string EnumerationJsonConverter = nameof(EnumerationJsonConverter);
     public const string GenerateEnumerationClassAttribute = nameof(
         GenerateEnumerationClassAttribute
     );
@@ -144,6 +146,10 @@ internal static class Constants
 
     private static readonly string IEnumerationDeclaration =
         typeof(Constants).Assembly.ReadAssemblyResourceAllText($"I{Enumeration}.{scriban}");
+    private static readonly string EnumerationJsonConverterDeclaration =
+        typeof(Constants).Assembly.ReadAssemblyResourceAllText(
+            $"{EnumerationJsonConverter}.{scriban}"
+        );
 
     // """
     //     namespace {{ dto_namespace }}.Abstractions;
@@ -194,6 +200,10 @@ internal static class Constants
         nameof(NestedEnumerationTypeDeclaration)
     );
 
+    private static readonly Template EnumerationJsonConverterDeclarationTemplate = Template.Parse(
+        EnumerationJsonConverterDeclaration
+    );
+
     public static string RenderHeader(string filename) => //Comment;
         HeaderTemplate.Render(new FilenameAndTimestampTuple(filename));
 
@@ -204,6 +214,10 @@ internal static class Constants
     //         DateTimeOffset.UtcNow.ToString("yyyy-MM-ddTHH:mm:ss.ffffzzzZ")
     //     );
 
+    public static string RenderJsonConverterDeclaration(EnumerationFieldDto e) => //Comment;
+        // IEnumerationDeclarationTemplate.Render(e);
+        EnumerationJsonConverterDeclarationTemplate.Render(e);
+
     public static string RenderIEnumerationDeclaration(EnumerationDto e) => //Comment;
         // IEnumerationDeclarationTemplate.Render(e);
         IEnumerationDeclaration

src/Dgmjr.Enumerations.CodeGenerator.csproj

@@ -18,6 +18,7 @@
     <Description>This package contains a source generator, which generates enumeration data structures from enum types.</Description>
     <IsRoslynComponent>true</IsRoslynComponent>
     <NoWarn>$(NoWarn);S3903;RCS1110;S3604</NoWarn>
+    <ProjectGuid>C4622771-2A7B-42E6-9B3C-8F71CDD7E65B</ProjectGuid>
   </PropertyGroup>
   <ItemGroup>
     <!-- <PackageReference Include="Dgmjr.CodeGeneration.Logging" /> -->
@@ -34,7 +35,7 @@
     <PackageReference Include="Scriban.Signed" Aliases="Scrib" />
     <PackageReference Include="ThisAssembly.AssemblyInfo" />
     <PackageReference Include="ThisAssembly.Project" />
-    <UsingsPackageReference Include="System.Text.Json.Usings" />
+    <PackageReference Include="System.Text.Json.Usings" IncludeAssets="Build;BuildTransitive;BuildMultitargeting;Runtime;Compile" ExcludeAssets="ContentFiles;Native;Analyzers" PrivateAssets="None" />
   </ItemGroup>
 
   <ItemGroup>

src/Dgmjr.Enumerations.CodeGenerator.sln

@@ -1,5 +1,5 @@
 Microsoft Visual Studio Solution File, Format Version 12.00
-#
+# 
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B283EBC2-E01F-412D-9339-FD56EF114549}"
 	ProjectSection(SolutionItems) = preProject
 		..\..\..\..\..\Directory.Build.props = ..\..\..\..\..\Directory.Build.props
@@ -8,30 +8,30 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		..\..\..\..\..\Packages\Versions.Local.props = ..\..\..\..\..\Packages\Versions.Local.props
 	EndProjectSection
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dgmjr.Enumerations.CodeGenerator", "Dgmjr.Enumerations.CodeGenerator.csproj", "{AC845DE2-CF87-49D2-A8A3-2019389FF879}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dgmjr.Enumerations.CodeGenerator", "Dgmjr.Enumerations.CodeGenerator.csproj", "{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Local|Any CPU = Local|Any CPU
 		Debug|Any CPU = Debug|Any CPU
-		Debug|x64 = Debug|x64
-		Debug|x86 = Debug|x86
+		Testing|Any CPU = Testing|Any CPU
+		Staging|Any CPU = Staging|Any CPU
+		Production|Any CPU = Production|Any CPU
 		Release|Any CPU = Release|Any CPU
-		Release|x64 = Release|x64
-		Release|x86 = Release|x86
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Local|Any CPU.ActiveCfg = Local|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Local|Any CPU.Build.0 = Local|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Testing|Any CPU.ActiveCfg = Testing|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Testing|Any CPU.Build.0 = Testing|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Staging|Any CPU.ActiveCfg = Staging|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Staging|Any CPU.Build.0 = Staging|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Production|Any CPU.ActiveCfg = Local|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Production|Any CPU.Build.0 = Local|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{AC845DE2-CF87-49D2-A8A3-2019389FF879}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Local|Any CPU.ActiveCfg = Local|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Local|Any CPU.Build.0 = Local|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Testing|Any CPU.ActiveCfg = Testing|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Testing|Any CPU.Build.0 = Testing|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Staging|Any CPU.ActiveCfg = Staging|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Staging|Any CPU.Build.0 = Staging|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Production|Any CPU.ActiveCfg = Local|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Production|Any CPU.Build.0 = Local|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C4622771-2A7B-42E6-9B3C-8F71CDD7E65B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

src/EnumerationGenerator.cs

@@ -246,6 +246,27 @@ var enumSymbol in values
                     {nestedClassDeclaration.NormalizeWhitespace().GetText()}
                     """
                 );
+                // Generate the nested class declaration
+                var jsonConverterDeclaration = RenderJsonConverterDeclaration(
+                    new EnumerationFieldDto(
+                        enumSymbol.GetMembers(fieldName).OfType<IFieldSymbol>().FirstOrDefault(),
+                        dataStructureType,
+                        dtoTypeName,
+                        dtoNamespace,
+                        enumSymbol.EnumUnderlyingType.ToDisplayString(),
+                        enumSymbol.MetadataName,
+                        baseType
+                    )
+                );
+
+                fileName = $"{dtoTypeName}.{fieldName}JsonConverter.g.cs";
+                context.AddSource(
+                    fileName,
+                    $"""
+                    {RenderHeader(fileName)}
+                    {ParseCompilationUnit(jsonConverterDeclaration).NormalizeWhitespace().GetText()}
+                    """
+                );
             }
         }
     }

src/Resources/EnumerationJsonConverter.scriban

@@ -0,0 +1,31 @@
+namespace {{ dto_namespace }};
+using {{ dto_namespace }}.Abstractions;
+
+public partial {{ data_structure_type }} @{{ dto_type_name }}
+{
+  {{ compiler_generated_attributes }}
+  public class {{ field_name }}JsonConverter : System.Text.Json.Serialization.JsonConverter<I{{ dto_type_name }}>
+  {
+      public override bool CanConvert(type typeToConvert) =>
+          typeof(I{{ dto_type_name }}).IsAssignableFrom(typeToConvert);
+
+      public override I{{ dto_type_name }} Read(
+          ref Utf8JsonReader reader,
+          type typeToConvert,
+          JsonSerializerOptions options
+      ) =>
+        @{{ dto_type_name }}.Parse(
+              reader.TokenType == JsonTokenType.String
+                  ? reader.GetString()
+                  : reader.GetInt32().ToString()
+          );
+
+      public override void Write(Utf8JsonWriter writer, I{{ dto_type_name }} value, Jso options) =>
+          writer.WriteStringValue(value.ShortName);
+  }
+
+  public class {{ field_name }}JsonConverterAttribute : System.Text.Json.Serialization.JsonConverterAttribute
+  {
+      public {{ field_name }}JsonConverterAttribute() : base(typeof({{ field_name }}JsonConverter)) { }
+  }
+}

src/Resources/Header.scriban

@@ -19,6 +19,9 @@ using System.Linq;
 using System.Runtime.CompilerServices;
 using System.Text;
 using System.Text.RegularExpressions;
+using System.Text.Json.Serialization;
+using System.Text.Json;
+using System.Xml.Serialization;
 #if NET7_0_OR_GREATER
 using StringSyntax = System.Diagnostics.CodeAnalysis.StringSyntaxAttribute;
 #endif

src/Resources/IEnumeration.scriban

@@ -9,6 +9,7 @@ IHaveAName,
     IHaveAValue<{{ enum_namespace }}.{{ enum_type_name }}>,
     IHaveADescription,
     IHaveAUri,
+    IHaveAuri,
     IHaveAUriString,
     IHaveSynonyms,
     IHaveAShortName,

src/Resources/NestedEnumerationType.scriban

@@ -6,27 +6,10 @@ public partial {{ data_structure_type }} @{{ dto_type_name }} {{ if base_type !=
   /// <summary>{{ description }}</summary>
   /// <value><see cref="{{ enum_namespace }}.{{ enum_type }}.{{ field_name }}" /><value>
   {{ compiler_generated_attributes }}
+  [{{ field_name }}JsonConverterAttribute]
   public partial {{ data_structure_type }} @{{ field_name }} :
       {{ if base_type != "" && base_type != null }}{{ dto_type_name }}, {{ end }}
-      I{{ enumeration_name }},
-      IHaveAName,
-      IHaveAValue,
-      IHaveAValue<{{ enum_underlying_type }}>,
-      IHaveAValue<{{ enum_namespace }}.{{ enum_type }}>,
-      IHaveADescription,
-      IHaveAUri,
-      IHaveAuri,
-      IHaveAUriString,
-      IHaveSynonyms,
-      IHaveAShortName,
-      IHaveAGuid,
-      IHaveAGuidString,
-      IHaveADisplayName,
-      IIdentifiable,
-      IIdentifiable<{{ enum_underlying_type }}>,
-      IConvertible,
-      IEquatable<{{ enum_underlying_type }}>,
-      IEquatable<I{{ dto_type_name }}>
+      I{{ enumeration_name }}
   {
       /// <summary>The {{ enumeration_name }}'s value</summary>
       /// <value><see cref="{{ enum_namespace }}.{{ enum_type }}.{{ field_name }}" /></value>
@@ -79,80 +62,98 @@ public partial {{ data_structure_type }} @{{ dto_type_name }} {{ if base_type !=
 
       /// <summary>The {{ enumeration_name }}'s synonyms</summary>
       /// <value>{{ synonyms }}</value>
+      [JsonIgnore, XmlIgnore]
       public static readonly string[] Synonyms = new string[] {
         {{ synonyms }}
       };
 
       /// <summary>The {{ enumeration_name }}'s value</summary>
       /// <value><see cref="{{ enum_namespace }}.{{ enum_type }}.{{ field_name }}" /></value>
+      [JsonIgnore, XmlIgnore]
       {{ enum_namespace }}.{{ enum_type }} IHaveAValue<{{ enum_namespace }}.{{ enum_type }}>.Value => Value;
 
       /// <summary>The {{ enumeration_name }}'s value as a(n) <see langword="{{ enum_underlying_type }}" /></summary>
       /// <value>{{ id }}</value>
+      [JsonIgnore, XmlIgnore]
       {{ enum_underlying_type }} IHaveAValue<{{ enum_underlying_type }}>.Value => Id;
 
       /// <summary>The {{ enumeration_name }}'s GUID</summary>
       /// <value>{{ guid_string }}</value>
+      [JsonIgnore, XmlIgnore]
       guid IHaveAGuid.Guid => Guid;
 
       /// <summary>The {{ enumeration_name }}'s GUID</summary>
       /// <value>{{ guid_string }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveAGuidString.GuidString => GuidString;
 
       /// <summary>The {{ enumeration_name }}'s display name</summary>
       /// <value>{{ display_name }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveADisplayName.DisplayName => DisplayName;
 
       /// <summary>The {{ enumeration_name }}'s value</summary>
       /// <value><see cref="{{ enum_namespace }}.{{ enum_type }}.{{ field_name }}" /><value>
+      [JsonIgnore, XmlIgnore]
       object IHaveAValue.Value => Value;
 
       /// <summary>A short description of the {{ enumeration_name }}</summary>
       /// <value>{{ description }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveADescription.Description => Description;
 
       /// <summary>The {{ enumeration_name }}'s name</summary>
       /// <value>{{ field_name }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveAName.Name => Name;
 
       /// <summary>The {{ enumeration_name }}'s short name</summary>
       /// <value>{{ short_name }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveAShortName.ShortName => ShortName;
 
       /// <summary>The {{ enumeration_name }}'s URI</summary>
       /// <value>{{ uri_string }}</value>
+      [JsonIgnore, XmlIgnore]
       Uri IHaveAUri.Uri => Uri;
 
       /// <summary>The {{ enumeration_name }}'s URI</summary>
       /// <value>{{ uri_string }}</value>
+      [JsonIgnore, XmlIgnore]
       string IHaveAUriString.UriString => UriString;
 
       /// <summary>The {{ enumeration_name }}'s URI</summary>
       /// <value>{{ uri_string }}</value>
+      [JsonIgnore, XmlIgnore]
       System.uri IHaveAuri.Uri => System.uri.From(Uri.ToString());
 
       /// <summary>The order in which the {{ enumeration_name }} should appear</summary>
       /// <value>{{ order }}</value>
       /// <default>0</default>
+      [JsonIgnore, XmlIgnore]
       int I{{ enumeration_name }}.Order => Order;
 
       /// <summary>The {{ enumeration_name }}'s URI</summary>
       /// <value>{{ uri_string }}</value>
+      [JsonIgnore, XmlIgnore]
       uri I{{ dto_type_name }}.Uri => uri.From(Uri.ToString());
 
       /// <summary>The {{ enumeration_name }}'s Id as an <see langword="object" /></summary>
       /// <value>{{ id }}</value>
+      [JsonIgnore, XmlIgnore]
       object IIdentifiable.Id => Id;
 
       /// <summary>The {{ enumeration_name }}'s Id as a(n) <see langword="{{ enum_underlying_type }}" /></summary>
       /// <value>{{ id }}</value>
+      [JsonIgnore, XmlIgnore]
       {{ enum_underlying_type }} IIdentifiable<{{ enum_underlying_type }}>.Id => Id;
 
       /// <summary>The {{ enumeration_name }}'s synonyms</summary>
       /// <value>{{ synonyms }}</value>
+      [JsonIgnore, XmlIgnore]
       string[]  IHaveSynonyms.Synonyms { get => Synonyms; init { } }
 
-      bool IEquatable<I{{ enumeration_name }}>.Equals(I{{ enumeration_name }} value)
+      bool IEquatable<I{{ enumeration_name }}>.Equals(I{{ enumeration_name }}? value)
         => this == value;
 
         bool IEquatable<{{ enum_underlying_type }}>.Equals({{ enum_underlying_type }} value)