feat(api-markdown-documenter): Update filtering logic to exclude api items based on release tags (#20591)

[AB#7194](https://dev.azure.com/fluidframework/235294da-091d-4c29-84fc-cdfc3d90890b/_workitems/edit/7194)

## Description

This PR adds filtering logic in the link generation code to exclude api
items based on release tags. If a resolved API item should not be
included based on its release tag, a span node in italics is generated
instead.

Author: WayneFerrao

tools/api-markdown-documenter/src/api-item-transforms/Utilities.ts

@@ -13,7 +13,11 @@ import { type DocDeclarationReference } from "@microsoft/tsdoc";
 
 import { DocumentNode, type SectionNode } from "../documentation-domain/index.js";
 import { type Link } from "../Link.js";
-import { getDocumentPathForApiItem, getLinkForApiItem } from "./ApiItemTransformUtilities.js";
+import {
+	getDocumentPathForApiItem,
+	getLinkForApiItem,
+	shouldItemBeIncluded,
+} from "./ApiItemTransformUtilities.js";
 import { type TsdocNodeTransformOptions } from "./TsdocNodeTransforms.js";
 import { type ApiItemTransformationConfiguration } from "./configuration/index.js";
 import { wrapInSection } from "./helpers/index.js";
@@ -123,6 +127,13 @@ function resolveSymbolicLink(
 
 		return undefined;
 	}
+	const resolvedApiItem = resolvedReference.resolvedApiItem;
+
+	// Return undefined if the resolved API item should be excluded based on release tags
+	if (!shouldItemBeIncluded(resolvedApiItem, config)) {
+		logger.verbose("Excluding link to item based on release tags");
+		return undefined;
+	}
 
 	return getLinkForApiItem(resolvedReference.resolvedApiItem, config);
 }

tools/api-markdown-documenter/src/test/snapshots/html/simple-suite-test/flat-config/simple-suite-test.html

@@ -48,7 +48,7 @@ <h1 id="simple-suite-test-remarks">
           - Good link (no alias): <a href='docs/simple-suite-test#testclass-class'>TestClass</a>
         </p>
         <p>
-          - Good link (with alias): <a href='docs/simple-suite-test#testfunction-function'>function alias text</a>
+          - Good link (with alias): <span><i>function alias text</i></span>
         </p>
         <p>
           - Bad link (no alias): <span><i>InvalidItem</i></span>

tools/api-markdown-documenter/src/test/snapshots/html/simple-suite-test/sparse-config/simple-suite-test.html

@@ -46,7 +46,7 @@ <h3 id="simple-suite-test-remarks">
             - Good link (no alias): <a href='docs/simple-suite-test/testclass-class'>TestClass</a>
           </p>
           <p>
-            - Good link (with alias): <a href='docs/simple-suite-test/testfunction-function'>function alias text</a>
+            - Good link (with alias): <span><i>function alias text</i></span>
           </p>
           <p>
             - Bad link (no alias): <span><i>InvalidItem</i></span>

tools/api-markdown-documenter/src/test/snapshots/markdown/simple-suite-test/flat-config/simple-suite-test.md

@@ -24,7 +24,7 @@ Also, here is a link test, including a bad link, because we should have some rea
 
 - Good link (no alias): [TestClass](docs/simple-suite-test#testclass-class)
 
-- Good link (with alias): [function alias text](docs/simple-suite-test#testfunction-function)
+- Good link (with alias): _function alias text_
 
 - Bad link (no alias): _InvalidItem_
 

tools/api-markdown-documenter/src/test/snapshots/markdown/simple-suite-test/sparse-config/simple-suite-test.md

@@ -22,7 +22,7 @@ Also, here is a link test, including a bad link, because we should have some rea
 
 - Good link (no alias): [TestClass](docs/simple-suite-test/testclass-class)
 
-- Good link (with alias): [function alias text](docs/simple-suite-test/testfunction-function)
+- Good link (with alias): _function alias text_
 
 - Bad link (no alias): _InvalidItem_