build.yml

name: Build

# Verifies build artifacts in pull requests.
# Note: this workflow does not trigger on pushes to main,
# because the release workflow includes a build+verify step.
on:
  pull_request:

env:
  NODE_OPTIONS: "--max-old-space-size=4096"

jobs:
  build:
    name: Build and validate artifacts
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          submodules: recursive
          fetch-depth: 0

      - name: Check for changes outside docs
        id: check_changes
        run: ./.github/scripts/check_changes_outside_docs.sh

      - name: Setup
        if: steps.check_changes.outputs.changes_outside_docs
        uses: ./.github/actions/setup

      - name: Clean
        if: steps.check_changes.outputs.changes_outside_docs
        shell: bash
        run: pnpm run clean

      - name: Build
        if: steps.check_changes.outputs.changes_outside_docs
        shell: bash
        run: pnpm run build

      - name: Outdated files, run `pnpm build` and commit them
        if: steps.check_changes.outputs.changes_outside_docs
        uses: ./.github/actions/require-empty-diff

      - name: Build API docs
        if: steps.check_changes.outputs.changes_outside_docs
        shell: bash
        run: pnpm docs:generate:api

      - name: Outdated files, run `pnpm docs:generate:api` and commit them
        if: steps.check_changes.outputs.changes_outside_docs
        uses: ./.github/actions/require-empty-diff