Add infrastructure and diagnostics for unsupported directives (#57)

Author: Mpdreamz

src/Elastic.Markdown/Diagnostics/DiagnosticsChannel.cs

@@ -29,6 +29,8 @@ public void TryComplete(Exception? exception = null)
 		_ctxSource.Cancel();
 	}
 
+	public ValueTask<bool> WaitToWrite() => _channel.Writer.WaitToWriteAsync();
+
 	public void Write(Diagnostic diagnostic)
 	{
 		var written = _channel.Writer.TryWrite(diagnostic);
@@ -84,10 +86,18 @@ public class DiagnosticsCollector(ILoggerFactory loggerFactory, IReadOnlyCollect
 
 	public async Task StartAsync(Cancel ctx)
 	{
+		await Channel.WaitToWrite();
 		while (!Channel.CancellationToken.IsCancellationRequested)
 		{
-			while (await Channel.Reader.WaitToReadAsync(Channel.CancellationToken))
-				Drain();
+			try
+			{
+				while (await Channel.Reader.WaitToReadAsync(Channel.CancellationToken))
+					Drain();
+			}
+			catch
+			{
+				//ignore
+			}
 		}
 		Drain();
 

src/Elastic.Markdown/Diagnostics/ProcessorDiagnosticExtensions.cs

@@ -12,6 +12,8 @@ public static class ProcessorDiagnosticExtensions
 {
 	public static void EmitError(this InlineProcessor processor, int line, int column, int length, string message)
 	{
+		var context = processor.GetContext();
+		if (context.SkipValidation) return;
 		var d = new Diagnostic
 		{
 			Severity = Severity.Error,
@@ -21,6 +23,53 @@ public static void EmitError(this InlineProcessor processor, int line, int colum
 			Message = message,
 			Length = length
 		};
-		processor.GetBuildContext().Collector.Channel.Write(d);
+		context.Build.Collector.Channel.Write(d);
+	}
+
+
+	public static void EmitWarning(this BlockProcessor processor, int line, int column, int length, string message)
+	{
+		var context = processor.GetContext();
+		if (context.SkipValidation) return;
+		var d = new Diagnostic
+		{
+			Severity = Severity.Warning,
+			File = processor.GetContext().Path.FullName,
+			Column = column,
+			Line = line,
+			Message = message,
+			Length = length
+		};
+		context.Build.Collector.Channel.Write(d);
+	}
+
+	public static void EmitError(this ParserContext context, int line, int column, int length, string message)
+	{
+		if (context.SkipValidation) return;
+		var d = new Diagnostic
+		{
+			Severity = Severity.Error,
+			File = context.Path.FullName,
+			Column = column,
+			Line = line,
+			Message = message,
+			Length = length
+		};
+		context.Build.Collector.Channel.Write(d);
+	}
+
+	public static void EmitWarning(this ParserContext context, int line, int column, int length, string message)
+	{
+		if (context.SkipValidation) return;
+		var d = new Diagnostic
+		{
+			Severity = Severity.Warning,
+			File = context.Path.FullName,
+			Column = column,
+			Line = line,
+			Message = message,
+			Length = length
+		};
+		context.Build.Collector.Channel.Write(d);
 	}
 }

src/Elastic.Markdown/Myst/Directives/AdmonitionBlock.cs

@@ -25,7 +25,7 @@ public string Title
 		}
 	}
 
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 		Classes = Properties.GetValueOrDefault("class");
 		CrossReferenceName = Properties.GetValueOrDefault("name");
@@ -38,9 +38,9 @@ public class DropdownBlock(DirectiveBlockParser parser, Dictionary<string, strin
 	: AdmonitionBlock(parser, "admonition", properties)
 {
 	// ReSharper disable once RedundantOverriddenMember
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
-		base.FinalizeAndValidate();
+		base.FinalizeAndValidate(context);
 		Classes = $"dropdown {Classes}";
 	}
 }

src/Elastic.Markdown/Myst/Directives/CardBlock.cs

@@ -14,7 +14,7 @@ public class CardBlock(DirectiveBlockParser parser, Dictionary<string, string> p
 
 	public string? Footer { get; set; }
 
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 		Title = Arguments;
 		Link = Properties.GetValueOrDefault("link");

src/Elastic.Markdown/Myst/Directives/CodeBlock.cs

@@ -20,7 +20,7 @@ public string Language
 		}
 	}
 
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 		Caption = Properties.GetValueOrDefault("caption");
 		CrossReferenceName = Properties.GetValueOrDefault("name");

src/Elastic.Markdown/Myst/Directives/DirectiveBlock.cs

@@ -66,7 +66,8 @@ public abstract class DirectiveBlock(DirectiveBlockParser parser, Dictionary<str
     /// <summary>
     /// Allows blocks to finalize setting properties once fully parsed
     /// </summary>
-    public abstract void FinalizeAndValidate();
+    /// <param name="context"></param>
+    public abstract void FinalizeAndValidate(ParserContext context);
 
 	protected void ParseBool(string key, Action<bool> setter)
 	{

src/Elastic.Markdown/Myst/Directives/DirectiveBlockParser.cs

@@ -5,6 +5,7 @@
 // This file is licensed under the BSD-Clause 2 license.
 // See the license.txt file in the project root for more information.
 
+using System.Collections.Frozen;
 using Markdig.Parsers;
 using Markdig.Syntax;
 using static System.StringSplitOptions;
@@ -37,6 +38,20 @@ public DirectiveBlockParser()
 
 	private readonly string[] _codeBlocks = [ "code", "code-block", "sourcecode"];
 
+	private readonly FrozenDictionary<string, int> _unsupportedBlocks = new Dictionary<string, int>
+	{
+		{ "bibliography", 5 },
+		{ "blockquote", 6 },
+		{ "csv-table", 9 },
+		{ "iframe", 14 },
+		{ "list-table", 17 },
+		{ "myst", 22 },
+		{ "topic", 24 },
+		{ "exercise", 30 },
+		{ "solution", 31 },
+		{ "toctree", 32 },
+	}.ToFrozenDictionary();
+
     protected override DirectiveBlock CreateFencedBlock(BlockProcessor processor)
     {
 	    _admonitionData = new Dictionary<string, string>();
@@ -108,14 +123,18 @@ protected override DirectiveBlock CreateFencedBlock(BlockProcessor processor)
 		    if (info.IndexOf($"{{{code}}}") > 0)
 			    return new CodeBlock(this, code, _admonitionData);
 	    }
+	    // TODO alternate lookup .NET 9
+	    var directive = info.ToString().Trim(['{', '}', '`']);
+	    if (_unsupportedBlocks.TryGetValue(directive, out var issueId))
+		    return new UnsupportedDirectiveBlock(this, directive, _admonitionData, issueId);
 
 	    return new UnknownDirectiveBlock(this, info.ToString(), _admonitionData);
     }
 
     public override bool Close(BlockProcessor processor, Block block)
     {
 	    if (block is DirectiveBlock directiveBlock)
-		    directiveBlock.FinalizeAndValidate();
+		    directiveBlock.FinalizeAndValidate(processor.GetContext());
 
 
 	    if (block is not TocTreeBlock toc)

src/Elastic.Markdown/Myst/Directives/ImageBlock.cs

@@ -56,7 +56,7 @@ public class ImageBlock(DirectiveBlockParser parser, Dictionary<string, string>
 
 	public string ImageUrl { get; private set; } = default!;
 
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 		ImageUrl = Arguments ?? string.Empty; //todo validate
 		Classes = Properties.GetValueOrDefault("class");

src/Elastic.Markdown/Myst/Directives/IncludeBlock.cs

@@ -28,7 +28,7 @@ public class IncludeBlock(DirectiveBlockParser parser, Dictionary<string, string
 
 	//TODO add all options from
 	//https://mystmd.org/guide/directives#directive-include
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 		var includePath = Arguments; //todo validate
 		Literal |= bool.TryParse(Properties.GetValueOrDefault("literal"), out var b) && b;

src/Elastic.Markdown/Myst/Directives/MermaidBlock.cs

@@ -6,7 +6,7 @@ namespace Elastic.Markdown.Myst.Directives;
 public class MermaidBlock(DirectiveBlockParser parser, Dictionary<string, string> properties)
 	: DirectiveBlock(parser, properties)
 {
-	public override void FinalizeAndValidate()
+	public override void FinalizeAndValidate(ParserContext context)
 	{
 	}
 }