version-bump.yml

name: Create Release PR

# Manually triggered from the Actions tab. Pick how to bump; the target version
# is computed from the CURRENT version at run time (nothing is hard-coded). This
# sets every package in lockstep (lerna fixed mode) and opens a "Release X.Y.Z"
# PR that only touches lerna.json + package.json files. Merging that PR and
# publishing a GitHub Release is what actually ships to npm.
on:
  workflow_dispatch:
    inputs:
      bump:
        description: 'How to bump (examples are illustrative; the actual resulting version is shown in the run summary):'
        required: true
        default: "prerelease  (e.g. 1.2.3-beta.4 -> 1.2.3-beta.5)"
        type: choice
        options:
          - "prerelease  (e.g. 1.2.3-beta.4 -> 1.2.3-beta.5)"
          - "patch  (e.g. 1.2.3-beta.4 -> 1.2.3, or 1.2.3 -> 1.2.4)"
          - "minor  (e.g. 1.2.3 -> 1.3.0)"
          - "major  (e.g. 1.2.3 -> 2.0.0)"
          - "preminor  (e.g. 1.2.3 -> 1.3.0-beta.0)"
          - "premajor  (e.g. 1.2.3 -> 2.0.0-beta.0)"

permissions:
  contents: write
  pull-requests: write

jobs:
  release-pr:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
        with:
          fetch-depth: 0

      - uses: actions/setup-node@v5
        with:
          node-version: 24

      - run: yarn install --frozen-lockfile

      - name: Configure git
        run: |
          git config user.name "percy-release-bot"
          git config user.email "percy-release-bot@users.noreply.github.com"

      - name: Bump version
        id: bump
        env:
          BUMP: ${{ inputs.bump }}
        run: |
          set -euo pipefail

          # The dropdown value is "<keyword>  (e.g. ...)"; take the first word.
          KEYWORD="${BUMP%% *}"

          CURRENT=$(node -p "require('./lerna.json').version")

          # Compute the target version dynamically from the current version.
          # 'beta' is the prerelease identifier for any pre* bump.
          TARGET=$(KEYWORD="$KEYWORD" node -e "const s=require('semver'); const t=s.inc('$CURRENT', process.env.KEYWORD, 'beta'); if(!t){process.exit(1)} process.stdout.write(t)")
          if [[ -z "$TARGET" ]]; then
            echo "::error::Could not compute a target version for bump '$KEYWORD' from '$CURRENT'."
            exit 1
          fi

          yarn lerna version "$TARGET" \
            --exact --no-git-tag-version --no-push --force-publish --yes

          VERSION=$(node -p "require('./lerna.json').version")
          echo "version=$VERSION" >> "$GITHUB_OUTPUT"

          # A prerelease version (contains a hyphen) ships under the `beta`
          # npm dist-tag; a clean semver ships under `latest`.
          if [[ "$VERSION" == *-* ]]; then
            DIST_TAG=beta
          else
            DIST_TAG=latest
          fi
          echo "dist_tag=$DIST_TAG" >> "$GITHUB_OUTPUT"

          # Keep each package's publishConfig.tag (the npm dist-tag used by
          # `lerna publish from-package`) in step with the version.
          DIST_TAG="$DIST_TAG" node -e 'const fs=require("fs");const t=process.env.DIST_TAG;for(const d of fs.readdirSync("packages")){const f="packages/"+d+"/package.json";if(!fs.existsSync(f))continue;const p=JSON.parse(fs.readFileSync(f));if(p.publishConfig&&p.publishConfig.tag!==t){p.publishConfig.tag=t;fs.writeFileSync(f,JSON.stringify(p,null,2)+"\n")}}'

          {
            echo "### Version bump"
            echo ""
            echo "Bump: \`$BUMP\`"
            echo ""
            echo "\`$CURRENT\` → **\`$VERSION\`**  (npm dist-tag: \`$DIST_TAG\`)"
          } >> "$GITHUB_STEP_SUMMARY"

      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v7
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          base: master
          branch: release/${{ steps.bump.outputs.version }}
          # Only commit version files — never workflow files (GITHUB_TOKEN may
          # not push to .github/workflows, and a release PR shouldn't anyway).
          add-paths: |
            lerna.json
            packages/**/package.json
          commit-message: "Release ${{ steps.bump.outputs.version }}"
          title: "Release ${{ steps.bump.outputs.version }}"
          labels: "🧹 maintenance"
          body: |
            Automated version bump to **`${{ steps.bump.outputs.version }}`**.

            - Triggered by @${{ github.actor }} via `workflow_dispatch` (bump: `${{ inputs.bump }}`).
            - On publishing a GitHub Release, this will go to npm under dist-tag **`${{ steps.bump.outputs.dist_tag }}`**.

            **Next steps:** review & merge, then cut the GitHub Release.