fix: upgrade puppeteer to 24.x + enable caching in GH Actions workflows

.github/workflows/build.yaml

@@ -44,6 +44,12 @@ jobs:
         run: |
           echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
 
+      - name: Enable Puppeteer cache
+        uses: actions/cache@v4
+        with:
+          path: .cache/puppeteer
+          key: puppeteer-${{ runner.os }}-${{ hashFiles('**/pnpm-lock.yaml') }}
+
       - name: Enable pnpm cache
         uses: actions/cache@v4
         with:
@@ -62,10 +68,10 @@ jobs:
         run: |
           pnpm install
 
-      # XXX: Workaround for Puppeteer issues
       - name: Install Chromium for Puppeteer
         run: |
-          node ./packages/docs-builder/node_modules/puppeteer/install.js
+          # Note: This will be a no-op if Chromium was already saved to the Puppeteer cache
+          pnpm dlx puppeteer browsers install
 
       - name: Build
         id: build

.github/workflows/release.yaml

@@ -58,6 +58,12 @@ jobs:
           # restore-keys: |
           #   pnpm-store-${{ runner.os }}-
 
+      - name: Enable Puppeteer cache
+        uses: actions/cache@v4
+        with:
+          path: .cache/puppeteer
+          key: puppeteer-${{ runner.os }}-${{ hashFiles('**/pnpm-lock.yaml') }}
+
       # Save the auth token so that the build can access private packages from
       # (and publish packages to) the GitHub Packages registry
       - name: Configure npm auth tokens
@@ -68,10 +74,10 @@ jobs:
         run: |
           pnpm install
 
-      # XXX: Workaround for Puppeteer issues
       - name: Install Chromium for Puppeteer
         run: |
-          node ./packages/docs-builder/node_modules/puppeteer/install.js
+          # Note: This will be a no-op if Chromium was already saved to the Puppeteer cache
+          pnpm dlx puppeteer browsers install
 
       - name: Build
         id: build

.gitignore

@@ -1 +1,3 @@
+.cache
+.claude/**/*.local.json
 node_modules

.puppeteerrc.cjs

@@ -0,0 +1,9 @@
+const { join } = require('path')
+
+/**
+ * @type {import("puppeteer").Configuration}
+ */
+module.exports = {
+  // Use a local cache directory to make it easier to persist the cache in GitHub Actions
+  cacheDirectory: join(__dirname, '.cache', 'puppeteer')
+}

packages/docs-builder/package.json

@@ -45,7 +45,7 @@
     "marked": "^4.0.10",
     "postcss": "^8.5.6",
     "postcss-rtlcss": "^5.7.1",
-    "puppeteer": "^18.2.1",
+    "puppeteer": "^24.0.0",
     "rev-hash": "^3.0.0",
     "semver-compare": "^1.0.0",
     "tinyglobby": "^0.2.15"