feat!: update the build to use api-extractor types

This commit updates our build config to use the types generated by the
API extractor. This prevents us exposing private implementation details
in our type declarations that are not marked `@public`

Author: matthewrobertson

.github/workflows/docs.yml

@@ -16,6 +16,6 @@ jobs:
     - name: Install dependencies
       run: npm install
     - name: Build TypeScript project
-      run: npm run docs
+      run: npm run build
     - name: Ensure there are no changes in docs
       run: git diff --exit-code docs/

api-extractor.json

@@ -19,7 +19,7 @@
 
   "dtsRollup": {
     "enabled": true,
-    "untrimmedFilePath": "docs/generated/api.d.ts",
+    "untrimmedFilePath": "build/src/index.d.ts",
     "omitTrimmingComments": true
   },
 

docs/generated/api.d.ts

@@ -18,15 +18,15 @@
   },
   "scripts": {
     "test": "mocha build/test --recursive",
+    "build": "npm run clean && npm run compile && npm run docs",
     "conformance": "./run_conformance_tests.sh",
     "check": "gts check",
-    "clean": "gts clean",
-    "compile": "rm -rf ./build && tsc -p .",
+    "clean": "rm -rf ./build",
+    "compile": "tsc -p .",
     "fix": "gts fix",
-    "predocs": "npm run compile",
     "docs": "api-extractor run --local --verbose",
     "watch": "npm run compile -- --watch",
-    "prepare": "npm run compile",
+    "prepare": "npm run build",
     "pretest": "npm run compile"
   },
   "files": [