tweak: work on fivem docs

Author: AvarianKnight

src/NativeCodeGen.Cli/Program.cs

@@ -296,9 +296,15 @@ static async Task<int> Validate(string input, bool strict)
         db.SharedExamples = sharedExampleRegistry.GetAllExamples();
 
         // Find all MDX files (natives are in namespace directories)
+        var resolvedInputDir = Path.GetFullPath(inputDir);
         var mdxFiles = Directory.GetFiles(inputDir, "*.mdx", SearchOption.AllDirectories)
+            .Concat(Directory.GetFiles(inputDir, "*.md", SearchOption.AllDirectories))
             .Where(f => !f.Contains(Path.Combine("code", "enums")))           // Exclude enum files
             .Where(f => !f.Contains(Path.Combine("code", "shared-examples"))) // Exclude shared examples
+            .Where(f => !Path.GetFileName(f).Equals("README.md", StringComparison.OrdinalIgnoreCase)) // Exclude README
+            .Where(f => !Path.GetFullPath(f)[resolvedInputDir.Length..]       // Exclude dotfile directories
+                .Split(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar)
+                .Any(segment => segment.StartsWith('.')))
             .ToArray();
 
         Console.WriteLine($"Found {mdxFiles.Length} MDX files to parse...");

src/NativeCodeGen.Core/Parsing/MdxParser.cs

@@ -1,3 +1,4 @@
+using System.Text.RegularExpressions;
 using Markdig;
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
@@ -125,7 +126,7 @@ public ParseResult<NativeDefinition> Parse(string content, string filePath)
                         }
 
                         // Parse signature from second line
-                        var signatureLine = codeLines[1].Trim();
+                        var signatureLine = StripCsAnnotations(codeLines[1].Trim());
                         try
                         {
                             var lexer = new SignatureLexer(signatureLine);
@@ -450,6 +451,19 @@ private static string GetListItemText(ListItemBlock listItem)
         return string.Join(" ", parts);
     }
 
+    private static readonly Regex CsTypePattern = new(@"\bcs_type\([^)]*\)\s*", RegexOptions.Compiled);
+
+    /// <summary>
+    /// Strips cs_type(...) and cs_split annotations from signature lines.
+    /// These are C# type hints used in some native databases that aren't part of the signature grammar.
+    /// </summary>
+    private static string StripCsAnnotations(string signature)
+    {
+        signature = CsTypePattern.Replace(signature, "");
+        signature = signature.Replace("cs_split ", "");
+        return signature;
+    }
+
     private static string GetInlineText(Inline inline) => inline switch
     {
         LiteralInline literal => literal.Content.ToString(),

src/NativeCodeGen.Core/Registry/EnumRegistry.cs

@@ -14,6 +14,7 @@ public void LoadEnums(string enumsDirectory)
             return;
 
         var files = Directory.GetFiles(enumsDirectory, "*.mdx")
+            .Concat(Directory.GetFiles(enumsDirectory, "*.md"))
             .Concat(Directory.GetFiles(enumsDirectory, "*.c"))
             .Concat(Directory.GetFiles(enumsDirectory, "*.h"));
 

src/NativeCodeGen.Core/Registry/SharedExampleRegistry.cs

@@ -33,7 +33,8 @@ public void LoadExamples(string directory)
         if (!Directory.Exists(directory))
             return;
 
-        foreach (var file in Directory.GetFiles(directory, "*.mdx"))
+        foreach (var file in Directory.GetFiles(directory, "*.mdx")
+                     .Concat(Directory.GetFiles(directory, "*.md")))
         {
             var name = Path.GetFileNameWithoutExtension(file);
             var content = File.ReadAllText(file);