expose enum description in openapi

Author: nb-rubenoost

tools/EVA.SDK.Generator.V2/Commands/Generate/Outputs/apidocs/ApiDocsOutput.cs

@@ -513,7 +513,7 @@ private static (string type, string? properties, List<OneOf>? oneof, string? des
           {
 
             var totals = targetType.EnumValues.ToTotals();
-            var possibleValues = string.Join('\n', totals.OrderBy(kv => kv.Value).Select(kv => $"* `{kv.Value}` - {kv.Key}"));
+            var possibleValues = string.Join('\n', totals.Select(kv => $"* `{kv.value}` - {kv.name}"));
 
             if (enumIsFlag)
             {

tools/EVA.SDK.Generator.V2/Commands/Generate/Outputs/openapi/OpenApiOutput.cs

@@ -363,7 +363,7 @@ private static OpenApiSchema ToSchema(ApiDefinitionModel input, TypeSpecificatio
     if (type.EnumIsFlag.HasValue)
     {
       var totals = type.EnumValues.ToTotals();
-      var possibleValues = string.Join('\n', totals.OrderBy(kv => kv.Value).Select(kv => $"* `{kv.Value}` - {kv.Key}"));
+      var possibleValues = string.Join('\n', totals.Select(x => $"* `{x.value}` - {x.name}{(x.description is {} d ? $" - {d}" : "")}"));
 
       if (type.EnumIsFlag is true)
       {
@@ -379,7 +379,7 @@ private static OpenApiSchema ToSchema(ApiDefinitionModel input, TypeSpecificatio
         return new OpenApiSchema
         {
           Type = "integer",
-          Enum = totals.Select(kv => new OpenApiInteger((int)kv.Value) as IOpenApiAny).ToList(),
+          Enum = totals.Select(kv => new OpenApiInteger((int)kv.value) as IOpenApiAny).ToList(),
           Description = $"Possible values:\n\n{possibleValues}"
         };
       }

tools/EVA.SDK.Generator.V2/Commands/Generate/Outputs/swift/SwiftOutput.cs

@@ -624,7 +624,7 @@ private static void WriteFlagsEnum(TypeSpecification type, string typename, Inde
       output.WriteLine("}");
       output.WriteLine();
 
-      foreach (var (name, value) in type.EnumValues.ToTotals().OrderBy(v => v.Value))
+      foreach (var (value, name, _) in type.EnumValues.ToTotals())
       {
         if (value == 0) continue;
         output.WriteLine($"public static let {name} = {typename}(rawValue: {value})");

tools/EVA.SDK.Generator.V2/Commands/Generate/Outputs/typescript/TypescriptOutput.cs

@@ -231,7 +231,7 @@ private static void WriteTypes(ApiDefinitionModelExtensions.GroupedApiDefinition
 
         using (o.Indentation)
         {
-          foreach (var (name, value) in type.EnumValues.ToTotals().OrderBy(x => x.Value))
+          foreach (var (value, name, _) in type.EnumValues.ToTotals())
           {
             o.WriteLine($"{name} = {value},");
           }

tools/EVA.SDK.Generator.V2/Commands/Generate/Outputs/zod/ZodOutput.cs

@@ -49,7 +49,7 @@ private static void WriteType(string id, TypeSpecification type, IndentedStringB
       }
       else
       {
-        var values = type.EnumValues.ToTotals().Select(x => x.Value).Order().Select(x => $"z.literal({x})");
+        var values = type.EnumValues.ToTotals().Select(x => x.value).Order().Select(x => $"z.literal({x})");
 
         if (values.Count() == 1)
         {

tools/EVA.SDK.Generator.V2/Helpers/ApiDefinitionModelExtensions.cs

@@ -176,20 +176,25 @@ internal static PrefixGroupedErrors GroupByPrefix(this IEnumerable<ErrorSpecific
     );
   }
 
-  internal static Dictionary<string, long> ToTotals(this ImmutableSortedDictionary<string, EnumValueSpecification> source)
+  internal static List<(long value, string name, string? description)> ToTotals(this ImmutableSortedDictionary<string, EnumValueSpecification> source)
   {
-    var result = new Dictionary<string, long>();
+    var result = new List<(long value, string name, string? description)>();
 
     long GetVal(string s)
     {
-      if (result.TryGetValue(s, out var v)) return v;
+      if (result.FirstOrDefault(x => x.name == s) is { } v)
+      {
+        return v.value;
+      }
+      
       var spec = source[s];
-      result[s] = v = spec.Extends.Aggregate(spec.Value, (a, b) => a | GetVal(b));
-      return v;
+      var total = spec.Extends.Aggregate(spec.Value, (a, b) => a | GetVal(b));
+      result.Add((total, s, spec.Description));
+      return total;
     }
 
     foreach (var x in source.Keys) GetVal(x);
-    return result;
+    return result.OrderBy(x => x.value).ToList();
   }
 
   internal static TypeReference CloneAsNotNull(this TypeReference reference)