Check in API data instead of building it every time (#591)

Previously, we checked out, built, and analyzed the Lit every time we deployed. Now, we check the generated data files into the Git repo instead. There is also a new GitHub check that ensures the checked in files are up-to-date. The advantages of this are:

- We can see in PRs when the data files have changed. This lets us see the effects of changes from the annotations in the Lit source, changes to the API generator, or other changes/bugs.

- Deploying should be much faster, since we no longer need to check out, build, and analyze the Lit repo as part of deploying. This will help even more once we are also analyzing the Lit 1.x repos.

Author: aomarks

.github/workflows/check-api-data-in-sync.yml

@@ -0,0 +1,24 @@
+# This action fails if the API docs JSON data files have changed but have not
+# been committed.
+
+# We check generated API data into the Git repo because otherwise it is very
+# difficult to tell when something has changed or broken in them. It also makes
+# deploying faster, since we don't need to clone and analyze repos every time.
+
+name: Check API data in sync
+on: [push, pull_request]
+
+jobs:
+  check-api-data-in-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          # Don't cache because we don't fully bootstrap
+
+      - run: npm ci
+      - run: npx lerna bootstrap --scope lit-dev-api --include-dependencies
+      - run: npx lerna run build --scope lit-dev-api --include-dependencies
+      - run: command test -z "$(git status --porcelain)"

.gitignore

@@ -12,8 +12,6 @@ packages/lit-dev-content/temp
 packages/lit-dev-content/samples/js
 
 packages/lit-dev-api/lit/
-packages/lit-dev-api/api-data/**/*
-!packages/lit-dev-api/api-data/.gitkeep
 
 # We only want to keep '-linux' screenshots which are tested by Github Actions.
 packages/lit-dev-tests/src/playwright/**/*.png

Dockerfile

@@ -35,13 +35,8 @@ COPY packages/lit-dev-tools-esm/ ./packages/lit-dev-tools-esm/
 COPY packages/lit-dev-server/ ./packages/lit-dev-server/
 RUN npx lerna run build:ts --scope lit-dev-tools-cjs --scope lit-dev-tools-esm --scope lit-dev-server --stream
 
-# Generated API docs
+# Pre-generated API docs data
 COPY packages/lit-dev-api/ ./packages/lit-dev-api/
-RUN npx lerna run build --scope lit-dev-api --stream && \
-  # By cloning and deleting the Lit monorepo checkout all within the same RUN
-  # command, we avoid ever including any Lit monorepo files in our Docker
-  # filesystem layers.
-  rm -rf packages/lit-dev-api/lit/
 
 # Site content
 COPY packages/lit-dev-content/ ./packages/lit-dev-content/