Merge branch 'main' into rmannibucau/watch-option

Author: rmannibucau

Directory.Packages.props

@@ -8,14 +8,14 @@
     <PackageVersion Include="ICSharpCode.Decompiler" Version="8.2.0.7535" />
     <PackageVersion Include="IgnoresAccessChecksToGenerator" Version="0.7.0" />
     <PackageVersion Include="Jint" Version="3.1.2" />
-    <PackageVersion Include="JsonSchema.Net" Version="7.0.3" />
+    <PackageVersion Include="JsonSchema.Net" Version="7.0.4" />
     <PackageVersion Include="Markdig" Version="0.37.0" />
     <PackageVersion Include="Microsoft.Playwright" Version="1.44.0" />
     <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="8.0.0" />
     <PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
     <PackageVersion Include="OneOf" Version="3.0.271" />
     <PackageVersion Include="OneOf.SourceGenerator" Version="3.0.271" />
-    <PackageVersion Include="PdfPig" Version="0.1.9-alpha-20240601-65a18" />
+    <PackageVersion Include="PdfPig" Version="0.1.9-alpha-20240612-d2cae" />
     <PackageVersion Include="PlantUml.Net" Version="1.4.80" />
     <PackageVersion Include="PolySharp" Version="1.14.1" />
     <PackageVersion Include="Spectre.Console" Version="0.49.1" />
@@ -58,7 +58,7 @@
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
     <PackageVersion Include="PublicApiGenerator" Version="11.1.0" />
     <PackageVersion Include="Verify.DiffPlex" Version="2.3.0" />
-    <PackageVersion Include="Verify.Xunit" Version="25.0.1" />
+    <PackageVersion Include="Verify.Xunit" Version="25.0.2" />
     <PackageVersion Include="xunit.runner.visualstudio" Version="2.8.1" />
     <PackageVersion Include="xunit" Version="2.8.1" />
   </ItemGroup>

src/Docfx.Build/XRefMaps/XRefMapDownloader.cs

@@ -3,6 +3,7 @@
 
 using System;
 using System.Diagnostics;
+using System.IO.Compression;
 using System.Net;
 using Docfx.Common;
 
@@ -119,6 +120,24 @@ private static async ValueTask<IXRefContainer> ReadLocalFileAsync(string filePat
             case ".zip":
                 return XRefArchive.Open(filePath, XRefArchiveMode.Read);
 
+            case ".gz":
+                {
+                    using var fileStream = File.OpenRead(filePath);
+                    using var stream = new GZipStream(fileStream, CompressionMode.Decompress);
+
+                    switch (Path.GetExtension(Path.GetFileNameWithoutExtension(filePath)).ToLowerInvariant())
+                    {
+                        case ".json":
+                            return await SystemTextJsonUtility.DeserializeAsync<XRefMap>(stream, token);
+                        case ".yml":
+                        default:
+                            {
+                                using var reader = new StreamReader(stream);
+                                return YamlUtility.Deserialize<XRefMap>(reader);
+                            };
+                    }
+                }
+
             case ".json":
                 {
                     using var stream = File.OpenRead(filePath);