name: Build and deploy docs

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: docs-runner        # must match the label of your registered act_runner
    steps:
      - name: Load environment
        run: |
          set -a
          source .env
          set +a
          echo "BAL_DOCS_DEPLOY_DIR=$BAL_DOCS_DEPLOY_DIR" >> $GITHUB_ENV
        shell: bash
        
      - name: Checkout repository
        run: |
          git clone --depth 1 https://oauth2:${GITHUB_TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY} .
          
      - name: Set up virtualenv
        run: |
          echo "PATH=$HOME/venv/bin:$PATH" >> $GITHUB_ENV

      - name: Install dependencies
        run: pip install mkdocs-material mkdocs-macros-plugin pyyaml pillow mkdocs-glightbox

      - name: Generate placeholders for missing screenshots
        run: python3 tools/make_placeholders.py

      - name: Build site (strict — fails on broken links)
        run: mkdocs build --strict

      - name: Publish
        run: rsync -a --delete site/ $BAL_DOCS_DEPLOY_DIR