build: switch to API signature test tool from dev-infra

We recently introduced a new tool for testing the public API
signature of entry-points. This tool is part of the shared
dev-infra package and uses Microsoft's API extractor under the
hood. This commit sets up the new tool and removes ts-api-guardian.

Author: devversion

.circleci/config.yml

@@ -220,7 +220,7 @@ jobs:
       - *slack_notify_on_failure
 
   # --------------------------------------------------------------------------------------------
-  # Job that runs ts-api-guardian against our API goldens in "tools/public_api_guard".
+  # Job that runs API golden tests in "tools/public_api_guard".
   # This job fails whenever an API has been updated but not explicitly approved through goldens.
   # --------------------------------------------------------------------------------------------
   api_golden_checks:

BUILD.bazel

@@ -8,6 +8,7 @@ package(default_visibility = ["//visibility:public"])
 
 exports_files([
     "LICENSE",
+    "package.json",
 ])
 
 genrule(

package.json

@@ -218,7 +218,6 @@
     "shelljs": "^0.8.3",
     "stylelint": "^13.8.0",
     "terser": "^4.8.0",
-    "ts-api-guardian": "^0.6.0",
     "ts-node": "^9.1.1",
     "tsickle": "0.39.1",
     "tslint": "^6.1.3",

scripts/check-mdc-exports.ts

@@ -75,7 +75,6 @@ function getMissingSymbols(name: string, skipped: string[], skippedPatterns: Reg
 
 /**
  * Gets the name of the exported symbols from a particular package.
- * Based on https://github.com/angular/angular/blob/master/tools/ts-api-guardian/lib/serializer.ts
  */
 function getExports(name: string): string[] {
   const entryPoint = join(__dirname, '../src', name, 'public-api.ts');

src/material/index.ts

@@ -9,3 +9,7 @@
 // primary entry-point which is empty as of version 9. All components should
 // be imported through their individual entry-points. This file is needed to
 // satisfy the "ng_package" bazel rule which also requires a primary entry-point.
+
+// Workaround for: https://github.com/microsoft/rushstack/issues/2806.
+// This is a private export that can be removed at any time.
+export const ɵɵtsModuleIndicatorApiExtractorWorkaround = true;

tools/public_api_guard/BUILD.bazel

@@ -4,14 +4,14 @@ load(":generate-guard-tests.bzl", "generate_test_targets")
 
 package(default_visibility = ["//visibility:public"])
 
-golden_files = ["cdk/%s.d.ts" % e for e in CDK_ENTRYPOINTS] + \
-               ["material/%s.d.ts" % e for e in MATERIAL_ENTRYPOINTS + MATERIAL_TESTING_ENTRYPOINTS] + [
-    # Primary entry-points.
-    "cdk/cdk.d.ts",
-    "material/material.d.ts",
-    "youtube-player/youtube-player.d.ts",
-    "google-maps/google-maps.d.ts",
-]
+golden_files = [
+                   # Primary entry-points.
+                   "cdk/cdk.md",
+                   "material/material.md",
+                   "youtube-player/youtube-player.md",
+                   "google-maps/google-maps.md",
+               ] + ["cdk/%s.md" % e for e in CDK_ENTRYPOINTS] + \
+               ["material/%s.md" % e for e in MATERIAL_ENTRYPOINTS + MATERIAL_TESTING_ENTRYPOINTS]
 
 # Generate the API guard test targets for each golden file in the current package.
-generate_test_targets(golden_files)
+generate_test_targets(targets = golden_files)