Markdown + RSS Parser for .NET Standard, MarkdownTextBlock Style Improvements, Syntax Highlighting

Microsoft.Toolkit.Services/Services/Markdown/Display/IRenderContext.cs

@@ -0,0 +1,36 @@
+// ******************************************************************
+// Copyright (c) Microsoft. All rights reserved.
+// This code is licensed under the MIT License (MIT).
+// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
+// ******************************************************************
+
+namespace Microsoft.Toolkit.Services.Markdown.Display
+{
+    /// <summary>
+    /// Helper for holding persistent state of Renderer.
+    /// </summary>
+    public interface IRenderContext
+    {
+        /// <summary>
+        /// Gets or sets a value indicating whether to trim whitespace.
+        /// </summary>
+        bool TrimLeadingWhitespace { get; set; }
+
+        /// <summary>
+        /// Gets or sets the parent Element for this Context.
+        /// </summary>
+        object Parent { get; set; }
+
+        /// <summary>
+        /// Clones the Context.
+        /// </summary>
+        /// <returns>Clone</returns>
+        IRenderContext Clone();
+    }
+}

Microsoft.Toolkit.Services/Services/Markdown/Display/MarkdownRendererBase.Blocks.cs

@@ -0,0 +1,57 @@
+// ******************************************************************
+// Copyright (c) Microsoft. All rights reserved.
+// This code is licensed under the MIT License (MIT).
+// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
+// ******************************************************************
+
+using Microsoft.Toolkit.Services.Markdown.Parse;
+
+namespace Microsoft.Toolkit.Services.Markdown.Display
+{
+    /// <summary>
+    /// Block Rendering Methods.
+    /// </summary>
+    public partial class MarkdownRendererBase
+    {
+        /// <summary>
+        /// Renders a paragraph element.
+        /// </summary>
+        protected abstract void RenderParagraph(ParagraphBlock element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a header element.
+        /// </summary>
+        protected abstract void RenderHeader(HeaderBlock element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a list element.
+        /// </summary>
+        protected abstract void RenderListElement(ListBlock element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a horizontal rule element.
+        /// </summary>
+        protected abstract void RenderHorizontalRule(IRenderContext context);
+
+        /// <summary>
+        /// Renders a quote element.
+        /// </summary>
+        protected abstract void RenderQuote(QuoteBlock element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a code element.
+        /// </summary>
+        protected abstract void RenderCode(CodeBlock element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a table element.
+        /// </summary>
+        protected abstract void RenderTable(TableBlock element, IRenderContext context);
+    }
+}

Microsoft.Toolkit.Services/Services/Markdown/Display/MarkdownRendererBase.Inlines.cs

@@ -0,0 +1,92 @@
+// ******************************************************************
+// Copyright (c) Microsoft. All rights reserved.
+// This code is licensed under the MIT License (MIT).
+// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
+// ******************************************************************
+
+using Microsoft.Toolkit.Services.Markdown.Parse;
+
+namespace Microsoft.Toolkit.Services.Markdown.Display
+{
+    /// <summary>
+    /// Inline Rendering Methods.
+    /// </summary>
+    public partial class MarkdownRendererBase
+    {
+        /// <summary>
+        /// Renders emoji element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderEmoji(EmojiInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a text run element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderTextRun(TextRunInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a bold run element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderBoldRun(BoldTextInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a link element
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderMarkdownLink(MarkdownLinkInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders an image element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderImage(ImageInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a raw link element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderHyperlink(HyperlinkInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a text run element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderItalicRun(ItalicTextInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a strikethrough element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderStrikethroughRun(StrikethroughTextInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a superscript element.
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderSuperscriptRun(SuperscriptTextInline element, IRenderContext context);
+
+        /// <summary>
+        /// Renders a code element
+        /// </summary>
+        /// <param name="element"> The parsed inline element to render. </param>
+        /// <param name="context"> Persistent state. </param>
+        protected abstract void RenderCodeRun(CodeInline element, IRenderContext context);
+    }
+}