tweak: remove callouts from proto/json, we just parse these in the description

Author: AvarianKnight

src/NativeCodeGen.Core/Export/DatabaseConverter.cs

@@ -98,22 +98,11 @@ private static ExportNative ConvertNative(NativeDefinition native)
             ReturnDescription = native.ReturnDescription,
             Aliases = native.Aliases.Count > 0 ? native.Aliases : null,
             RelatedExamples = native.RelatedExamples.Count > 0 ? native.RelatedExamples : null,
-            Callouts = native.Callouts.Count > 0 ? native.Callouts.Select(ConvertCallout).ToList() : null,
             ApiSet = native.ApiSet,
             Parameters = native.Parameters.Select(ConvertParameter).ToList()
         };
     }
 
-    private static ExportCallout ConvertCallout(Callout callout)
-    {
-        return new ExportCallout
-        {
-            Type = callout.Type,
-            Title = callout.Title,
-            Description = callout.Description
-        };
-    }
-
     private static ExportParameter ConvertParameter(NativeParameter param)
     {
         return new ExportParameter

src/NativeCodeGen.Core/Export/ExportModels.cs

@@ -77,10 +77,6 @@ public partial class ExportNative
     [ProtoMember(11)]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? RelatedExamples { get; set; }
-
-    [ProtoMember(12)]
-    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
-    public List<ExportCallout>? Callouts { get; set; }
 }
 
 [ProtoContract]
@@ -204,17 +200,3 @@ public partial class ExportSharedExampleCode
     public string? Language { get; set; }
 }
 
-[ProtoContract]
-public partial class ExportCallout
-{
-    [ProtoMember(1)]
-    [JsonConverter(typeof(JsonStringEnumConverter<CalloutType>))]
-    public CalloutType Type { get; set; }
-
-    [ProtoMember(2)]
-    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
-    public string? Title { get; set; }
-
-    [ProtoMember(3)]
-    public string Description { get; set; } = string.Empty;
-}

src/NativeCodeGen.Core/Export/JsonContext.cs

@@ -23,9 +23,6 @@ namespace NativeCodeGen.Core.Export;
 [JsonSerializable(typeof(ExportSharedExample))]
 [JsonSerializable(typeof(ExportSharedExampleCode))]
 [JsonSerializable(typeof(List<ExportSharedExampleCode>))]
-[JsonSerializable(typeof(ExportCallout))]
-[JsonSerializable(typeof(List<ExportCallout>))]
-[JsonSerializable(typeof(CalloutType))]
 [JsonSerializable(typeof(ParamFlags))]
 [JsonSerializable(typeof(FieldFlags))]
 [JsonSerializable(typeof(List<ExportNative>))]

src/NativeCodeGen.Core/Export/natives.proto

@@ -67,7 +67,6 @@ message Native {
   repeated string used_enums = 9;
   string apiset = 10;
   repeated string related_examples = 11;
-  repeated Callout callouts = 12;
 }
 
 message Parameter {
@@ -117,16 +116,3 @@ message SharedExampleCode {
   string content = 1;
   optional string language = 2;
 }
-
-enum CalloutType {
-  NOTE = 0;
-  WARNING = 1;
-  INFO = 2;
-  DANGER = 3;
-}
-
-message Callout {
-  CalloutType type = 1;
-  optional string title = 2;
-  string description = 3;
-}

src/NativeCodeGen.Core/Models/Callout.cs

@@ -1,8 +1,5 @@
-using ProtoBuf;
-
 namespace NativeCodeGen.Core.Models;
 
-[ProtoContract]
 public enum CalloutType
 {
     Note = 0,

src/NativeCodeGen.Core/Parsing/MdxComponentParser.cs

@@ -75,6 +75,7 @@ public string NormalizeDescription(string content)
     /// <summary>
     /// Converts description text for code generation output.
     /// Transforms [enum: Name] and [struct: Name] to {@link Name} for JSDoc.
+    /// Formats [note:], [warning:], [info:], [danger:] as readable callouts.
     /// </summary>
     public static string FormatDescriptionForCodeGen(string? content)
     {
@@ -87,9 +88,33 @@ public static string FormatDescriptionForCodeGen(string? content)
         // Convert [struct: Name] to {@link Name}
         result = StructAttributeRegex().Replace(result, "{@link $1}");
 
+        // Format callouts as @remarks tags (JSDoc/TypeDoc compatible)
+        result = NoteAttributeRegex().Replace(result, m => FormatCalloutAsRemarks(m.Groups[1].Value));
+        result = WarningAttributeRegex().Replace(result, m => FormatCalloutAsRemarks(m.Groups[1].Value, "Warning"));
+        result = InfoAttributeRegex().Replace(result, m => FormatCalloutAsRemarks(m.Groups[1].Value));
+        result = DangerAttributeRegex().Replace(result, m => FormatCalloutAsRemarks(m.Groups[1].Value, "Danger"));
+
         return result;
     }
 
+    private static string FormatCalloutAsRemarks(string content, string? prefix = null)
+    {
+        var trimmed = content.Trim();
+        // Check for title | description format
+        var pipeIndex = trimmed.IndexOf('|');
+        if (pipeIndex >= 0)
+        {
+            var title = trimmed[..pipeIndex].Trim();
+            var description = trimmed[(pipeIndex + 1)..].Trim();
+            trimmed = $"{title}: {description}";
+        }
+
+        // Add newlines before and after to separate from surrounding text
+        return prefix != null
+            ? $"\n@remarks **{prefix}:** {trimmed}\n"
+            : $"\n@remarks {trimmed}\n";
+    }
+
     public List<EmbeddedEnumRef> ParseEmbeddedEnums(string content)
     {
         var results = new List<EmbeddedEnumRef>();

tests/NativeCodeGen.Tests/Export/ProtobufSerializationTests.cs

@@ -716,12 +716,12 @@ public void ListAllProtoContractTypes()
             "ExportDatabase", "ExportNamespace", "ExportNative", "ExportParameter",
             "ExportEnum", "ExportEnumMember", "ExportStruct", "ExportStructField",
             "ExportSharedExample", "ExportSharedExampleCode",
-            "ExportTypeInfo", "ExportTypeEntry", "ExportCallout"
+            "ExportTypeInfo", "ExportTypeEntry"
         };
 
         var expectedEnums = new[]
         {
-            "ParamFlags", "FieldFlags", "ExportTypeCategory", "CalloutType"
+            "ParamFlags", "FieldFlags", "ExportTypeCategory"
         };
 
         foreach (var expected in expectedClasses)