demo-build.yml

# Workflow for building and deploying a demo site to GitHub Pages
name: Deploy static demo files to Pages

on: push

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
    contents: write
    pages: write
    id-token: write

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these deployments to complete.
concurrency:
    group: 'pages'
    cancel-in-progress: false

jobs:
    build:
        name: Build the project
        runs-on: ubuntu-latest
        environment:
            name: github-pages
            url: ${{ steps.deployment.outputs.page_url }}
        steps:
            - uses: actions/checkout@v4
              with:
                path: ramp

            - uses: actions/setup-node@v4
              with:
                node-version: '22.5.1'
                cache: 'npm'
                cache-dependency-path: ramp/package-lock.json

            - name: Set up Git
              run: |
                git config --global user.name "GitHub Action"
                git config --global user.email "action@github.com"

            - uses: actions/checkout@v4
              with:
                ref: demo-page
                path: demo-page
              continue-on-error: true

            - name: Create orphan branch if checkout fails (demo-page doesn't exist)
              if: failure()
              run: |
                echo "Checkout failed, creating orphan branch..."
                mkdir -p demo-page
                cd demo-page
                git init
                git checkout --orphan demo-page
                git commit --allow-empty -m "Create orphan branch"
                git remote add origin ${{ github.repositoryUrl }}
                git push -u origin demo-page
                cd ../

            - name: Remove the old demo if it exists and make docs folder
              run: |
                rm -rf demo-page/${{ github.ref_name }}
                mkdir -p demo-page/${{ github.ref_name }}/docs/api-tech-docs

            - name: Update docsite version references before docs are built
              uses: jacobtomlinson/gha-find-replace@v3
              with:
                find: '{{ramp-version}}'
                replace: ${{ github.ref_name }}
                include: 'ramp/docs/**'
                regex: false

            - name: Build or delete the demo
              run: |
                  cd ramp
                  npm ci
                  npm run build
                  npm run ts-docs:generate
                  npm run vite-docs:generate

            - name: Publish to NPM
              if: github.repository == 'ramp4-pcar4/ramp4-pcar4' && startsWith(github.ref, 'refs/tags/v')
              run: |
                TAG_VERSION=${GITHUB_REF#refs/tags/v}
                PACKAGE_VERSION=$(node -p "require('./package.json').version")
                if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
                    npm version --allow-same-version --no-git-tag-version $TAG_VERSION
                 fi 

                npm publish
              env:
                NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

            - name: Move the built files and docs into the demo-page
              run: |
                  mv dist/* ../demo-page/${{ github.ref_name }}
                  mv vite-docs/* ../demo-page/${{ github.ref_name }}/docs
                  mv ts-docs/* ../demo-page/${{ github.ref_name }}/docs/api-tech-docs

            - name: Squash and push changes to demo-page 
              run: |
                cd ../demo-page
                git add .
                git commit -m "Applied changes from demo-folder to demo-page"

                # Squash the commit history into a single commit
                git reset --soft $(git rev-list --max-parents=0 HEAD)
                git commit -m "Applied changes from demo-folder to demo-page"
                git push -f origin demo-page

            - name: Upload artifact
              uses: actions/upload-pages-artifact@v3
              with:
                  path: '.'
                  retention-days: 1

            - name: Setup Pages
              uses: actions/configure-pages@v5

            - name: Deploy to GitHub Pages
              id: deployment
              uses: actions/deploy-pages@v4