feat: allow custom API filtering

[yufeih]

Enable API filter customization using the DotnetApiOptions API:

var options = new DotnetApiOptions
{
    IncludeApi = symbol => ...
    IncludeAttribute = symbol => ...
};

await DotnetApiCatalog.GenerateManagedReferenceYamlFiles("docfx.json", options);

BEHAVIOR CHANGES:

• Explicit interface implementations excluded from generated APIs
• Exclude a parent namespace using filter rule also exclude its child namespaces, same way as nested classes.

Implements #8253 #6820

[codecov]

Codecov Report

Base: 76.95% // Head: 77.06% // Increases project coverage by +0.11% 🎉

Coverage data is based on head (eb98246) compared to base (c3709c5).
Patch coverage: 97.46% of modified lines in pull request are covered.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #8408      +/-   ##
==========================================
+ Coverage   76.95%   77.06%   +0.11%     
==========================================
  Files         865      860       -5     
  Lines       30860    30740     -120     
==========================================
- Hits        23749    23691      -58     
+ Misses       7111     7049      -62     

Impacted Files	Coverage Δ
....DocAsCode.Dotnet/Visitors/SymbolVisitorAdapter.cs	95.04% <94.73%> (+0.19%)	⬆️
src/Microsoft.DocAsCode.Dotnet/SymbolFilter.cs	96.77% <96.77%> (ø)
src/Microsoft.DocAsCode.Dotnet/DotnetApiCatalog.cs	96.07% <100.00%> (ø)
src/Microsoft.DocAsCode.Dotnet/DotnetApiOptions.cs	100.00% <100.00%> (ø)
...de.Dotnet/ExtractMetadata/ExtractMetadataWorker.cs	83.33% <100.00%> (+0.16%)	⬆️
...crosoft.DocAsCode.Dotnet/SymbolFormatter.Syntax.cs	99.62% <100.00%> (-0.38%)	⬇️
src/Microsoft.DocAsCode.Dotnet/SymbolFormatter.cs	95.95% <100.00%> (-4.05%)	⬇️
src/Microsoft.DocAsCode.Dotnet/SymbolHelper.cs	100.00% <100.00%> (ø)
...ft.DocAsCode.Dotnet/Visitors/YamlModelGenerator.cs	97.87% <100.00%> (ø)
src/docfx/SubCommands/MetadataCommand.cs	89.55% <100.00%> (ø)
... and 6 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.