V2.0.0

.github/copilot-instructions.md

@@ -50,6 +50,7 @@ XML doc transformation uses embedded XSLT resources:
 - Uses **NUnit** with **Moq** for mocking
 - Use `[TestCase(..., ExpectedResult=...)]` for parameterized tests.
 - Name test methods: `MemberName_StateUnderTest_ExpectedBehavior`.
+- When applicable, use types and members defined in `Acme.cs` for test cases.
 - Prefer constraint-based assertions.
 - Write only tests for public members and business logic (skip private methods and parameter validation).
 - `tests/MockHelper.cs` provides common test utilities

.github/workflows/main.yml

@@ -17,10 +17,10 @@ jobs:
     steps:
     - uses: actions/checkout@v4
 
-    - name: Setup .NET 8.0
-      uses: actions/setup-dotnet@v3
+    - name: Setup .NET SDK
+      uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: '8.0.x'
+        dotnet-version: '10.0.x'
 
     - name: Restore Dependencies
       run: dotnet restore

src/DevOpsWikiStrategy.cs

@@ -305,7 +305,7 @@ public static string EncodeWikiPath(ReadOnlySpan<char> title)
         /// <remarks>
         /// This method encodes fragments to match Azure DevOps Wiki heading fragment rules:
         /// <list type="bullet">
-        ///   <item><description>Lowercases all characters.</description></item>
+        ///   <item><description>All characters are converted to lowercase.</description></item>
         ///   <item><description>Spaces are replaced with hyphens.</description></item>
         ///   <item><description>Reserved or special characters are percent-encoded.</description></item>
         ///   <item><description>Forbidden characters such (#, /, \) are replaced with underscores.</description></item>

src/DocFxStrategy.cs

@@ -97,7 +97,7 @@ public override bool TryResolveMemberAddress(IMember member, [NotNullWhen(true)]
             if (member is not IType type)
             {
                 type = member.DeclaringType!;
-                memberAnchor = member.CodeReference[2..].ReplaceMany(['.', '`', '#', ',', '(', ')', '~'], '_');
+                memberAnchor = member.CodeReference[2..].ReplaceChars(['.', '`', '#', ',', '(', ')', '~'], '_');
             }
 
             var typePath = type.Signature.Replace('`', '_');

src/DocumentationComposer.cs

@@ -269,11 +269,7 @@ protected virtual void GenerateDocumentationForInterface(IDocumentWriterFactory
             }
 
             if (granularity.HasFlag(PageGranularity.Member))
-            {
-                GenerateDocumentationForProperties(writerFactory, interfaceType.Properties);
-                GenerateDocumentationForMethods(writerFactory, interfaceType.Methods);
-                GenerateDocumentationForEvents(writerFactory, interfaceType.Events);
-            }
+                GenerateDocumentationForCompositeTypeMembers(writerFactory, interfaceType);
         }
 
         /// <summary>
@@ -485,12 +481,12 @@ protected virtual void GenerateDocumentationForCompositeTypeMembers(IDocumentWri
             if (compositeType is null)
                 throw new ArgumentNullException(nameof(compositeType));
 
-            GenerateDocumentationForConstructors(writerFactory, compositeType.Constructors);
             GenerateDocumentationForFields(writerFactory, compositeType.Fields);
+            GenerateDocumentationForConstructors(writerFactory, compositeType.Constructors);
             GenerateDocumentationForProperties(writerFactory, compositeType.Properties.Concat(compositeType.ExplicitInterfaceMembers.OfType<PropertyModel>()));
             GenerateDocumentationForMethods(writerFactory, compositeType.Methods.Concat(compositeType.ExplicitInterfaceMembers.OfType<MethodModel>()));
             GenerateDocumentationForEvents(writerFactory, compositeType.Events.Concat(compositeType.ExplicitInterfaceMembers.OfType<EventModel>()));
-            GenerateDocumentationForOperators(writerFactory, compositeType.Operators);
+            GenerateDocumentationForOperators(writerFactory, compositeType.Operators.Concat(compositeType.ExplicitInterfaceMembers.OfType<OperatorModel>()));
         }
     }
 }

src/DocumentationContext.cs

@@ -235,7 +235,7 @@ protected void Dispose(bool disposing)
         {
             0 => TypeCollection.Empty,
             1 => Assemblies.First().ExportedTypes,
-            _ => new TypeCollection(Assemblies.SelectMany(asm => asm.ExportedTypes).OrderBy(static type => type.Name, StringComparer.Ordinal))
+            _ => new TypeCollection(Assemblies.SelectMany(static asm => asm.ExportedTypes).OrderBy(static type => type.Name, StringComparer.Ordinal))
         };
     }
 }

src/DocumentationContextBuilder.cs

@@ -230,7 +230,7 @@ public virtual DocumentationContextBuilder<TContext> AddTopic(string topicId, st
         /// <returns>The current builder instance for method chaining.</returns>
         /// <exception cref="ArgumentNullException">Thrown when <paramref name="topic"/> is <see langword="null"/>.</exception>
         /// <exception cref="ArgumentException">Thrown when <paramref name="topic"/> is a subtopic.</exception>
-        /// <exception cref="ArgumentException">Thrown when a topic with the same ID already exists.</exception>"
+        /// <exception cref="ArgumentException">Thrown when a topic with the same ID already exists.</exception>
         public virtual DocumentationContextBuilder<TContext> AddTopic(ITopic topic)
         {
             if (topic is null)
@@ -309,15 +309,15 @@ protected virtual MetadataUniverse CreateMetadataUniverse()
         /// </remarks>
         protected virtual IXmlDocProvider CreateXmlDocProvider()
         {
-            var xmlProvider = new XmlDocProvider
+            var repository = new XmlDocRepository
             {
                 ErrorHandler = XmlDocErrorHandler
             };
 
             foreach (var xmlDocPath in XmlDocPaths)
-                xmlProvider.ImportFile(xmlDocPath);
+                repository.ImportFile(xmlDocPath);
 
-            return xmlProvider;
+            return new XmlDocProvider(repository);
         }
 
         /// <summary>

src/DocumentationContextExtensions.cs

@@ -8,6 +8,7 @@ namespace Kampute.DocToolkit
     using Kampute.DocToolkit.Formatters;
     using Kampute.DocToolkit.Languages;
     using Kampute.DocToolkit.Metadata;
+    using Kampute.DocToolkit.Metadata.Capabilities;
     using Kampute.DocToolkit.Models;
     using Kampute.DocToolkit.XmlDoc;
     using System;
@@ -182,7 +183,7 @@ public static NameQualifier DetermineNameQualifier(this IDocumentationContext co
             if (member is IType)
                 return NameQualifier.DeclaringType;
 
-            if (member is IMethod { IsExtension: true } or IOperator)
+            if (member is IWithExtensionBehavior { IsExtension: true } or IOperator)
                 return NameQualifier.None;
 
             return context.AddressProvider.ActiveScope.Model is TypeModel typeModel

src/DocumentationModelType.cs

@@ -74,5 +74,10 @@ public enum DocumentationModelType
         /// The model represents an operator member or overloads.
         /// </summary>
         Operator,
+
+        /// <summary>
+        /// The model represents an extension block.
+        /// </summary>
+        ExtensionBlock,
     }
 }

src/DotNetApiStrategy.cs

@@ -108,7 +108,7 @@ public override bool TryResolveMemberAddress(IMember member, [NotNullWhen(true)]
 
             var memberAnchor = string.Empty;
             if (member is IWithOverloads { HasOverloads: true })
-                memberAnchor = signature.ReplaceMany(['.', '_'], '-').Replace("--", "-");
+                memberAnchor = signature.ReplaceChars(['.', '_'], '-').Replace("--", "-");
 
             address = CreateAddressFromPath(GetApiPath(memberPath), memberAnchor);
             return true;

src/IO/Minifiers/HtmlMinifier.cs

@@ -97,7 +97,7 @@ public HtmlMinifier(TextWriter writer, bool leaveOpen = false)
         /// </value>
         public HashSet<string> PreformattedTags { get; } = new(StringComparer.OrdinalIgnoreCase)
         {
-            "pre", "textarea", "script", "style"
+            "PRE", "TEXTAREA", "SCRIPT", "STYLE"
         };
 
         /// <summary>
@@ -109,9 +109,9 @@ public HtmlMinifier(TextWriter writer, bool leaveOpen = false)
         /// </value>
         public HashSet<string> InlineTags { get; } = new(StringComparer.OrdinalIgnoreCase)
         {
-            "a", "abbr", "b", "bdi", "bdo", "br", "button", "cite", "code", "data", "dfn", "del", "em", "i",
-            "img", "input", "ins", "kbd", "label", "mark", "object", "output", "q", "ruby", "rt", "rp", "s",
-            "samp", "select", "small", "span", "strong", "sub", "sup", "time", "tt", "u", "var", "wbr"
+            "A", "ABBR", "B", "BDI", "BDO", "BR", "BUTTON", "CITE", "CODE", "DATA", "DFN", "DEL", "EM", "I",
+            "IMG", "INPUT", "INS", "KBD", "LABEL", "MARK", "OBJECT", "OUTPUT", "Q", "RUBY", "RT", "RP", "S",
+            "SAMP", "SELECT", "SMALL", "SPAN", "STRONG", "SUB", "SUP", "TIME", "TT", "U", "VAR", "WBR"
         };
 
         /// <summary>

src/IO/Writers/MarkupWriter.cs

@@ -270,7 +270,7 @@ public virtual void WriteDocLink(MemberModel member)
         /// <param name="ns">The namespace for which the link is written.</param>
         /// <exception cref="ArgumentNullException">Thrown when <paramref name="ns"/> is <see langword="null"/>.</exception>
         /// <remarks>
-        /// This method writes a hyperlink to the documentation for the specified namespace. If the namespace has has a valid documentation
+        /// This method writes a hyperlink to the documentation for the specified namespace. If the namespace has a valid documentation
         /// URL, a hyperlink is written using the namespace's name. If the namespace does not have documentation URL, the namespace's name
         /// is written as plain text.
         /// </remarks>

src/Kampute.DocToolkit.csproj

@@ -4,7 +4,7 @@
     <TargetFramework>netstandard2.1</TargetFramework>
     <Title>Kampute.DocDotLib</Title>
     <Description>Provides extensible pipeline for generating .NET API documentation by transforming assembly metadata and XML documentation into structured models, with automatic cross-reference resolution, support for multiple output formats (HTML, Markdown), and integration of conceptual topics.</Description>
-    <Version>1.1.1</Version>
+    <Version>2.0.0</Version>
     <Company>Kampute</Company>
     <Authors>Kambiz Khojasteh</Authors>
     <Copyright>Copyright (c) 2025 Kampute</Copyright>
@@ -48,7 +48,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="System.Reflection.MetadataLoadContext" Version="9.0.10" />
+    <PackageReference Include="System.Reflection.MetadataLoadContext" Version="10.0.*" />
   </ItemGroup>
 
   <PropertyGroup Condition="Exists('../SigningKey.snk')">

src/Languages/CSharp.Data.cs

@@ -114,6 +114,7 @@ public partial class CSharp
             ["descending"] = "descending",
             ["dynamic"] = "../builtin-types/reference-types",
             ["equals"] = "equals",
+            ["extension"] = "extension",
             ["field"] = "field",
             ["file"] = "file",
             ["from"] = "from-clause",
@@ -203,6 +204,20 @@ public partial class CSharp
             ["Decrement"] = "--",
             ["Implicit"] = "implicit",
             ["Explicit"] = "explicit",
+            ["UnsignedRightShift"] = ">>>",
+            ["AdditionAssignment"] = "+=",
+            ["SubtractionAssignment"] = "-=",
+            ["MultiplyAssignment"] = "*=",
+            ["DivisionAssignment"] = "/=",
+            ["ModulusAssignment"] = "%=",
+            ["AndAssignment"] = "&=",
+            ["OrAssignment"] = "|=",
+            ["ExclOrAssignment"] = "^=",
+            ["LeftShiftAssignment"] = "<<=",
+            ["RightShiftAssignment"] = ">>=",
+            ["UnsignedRightShiftAssignment"] = ">>>=",
+            ["IncrementAssignment"] = "++",
+            ["DecrementAssignment"] = "--",
         };
 
         /// <summary>