release.yml

name: Release

# One tag, both front-ends. Push a vX.Y.Z tag and CI builds and publishes BOTH:
# the LichLoader DLL (this repo) and the WarcraftXL extension
# (brues-code/wxl-wrathclassicapi), each stamped to the tag. The wrapper repo is
# never touched by hand.
#
# Requires one secret: WRAPPER_REPO_TOKEN — a fine-grained PAT scoped to
# brues-code/wxl-wrathclassicapi with Contents: Read and write. It clones the
# wrapper, pushes the stamped wxl.json, the synced docs/API.md and the tag, and
# creates its release.

on:
  push:
    tags:
      - 'v*'

permissions:
  contents: write # GITHUB_TOKEN: this repo's release

concurrency:
  group: release-${{ github.ref }}
  cancel-in-progress: false

jobs:
  build:
    runs-on: windows-latest
    steps:
      - name: Checkout WrathClassicAPI (at the tag)
        uses: actions/checkout@v4
        with:
          submodules: recursive
          path: WrathClassicAPI

      - name: Checkout wxl-core (extension ABI)
        uses: actions/checkout@v4
        with:
          repository: WarcraftXL/wxl-core
          path: wxl-core

      - name: Checkout wxl-wrathclassicapi (writable)
        uses: actions/checkout@v4
        with:
          repository: brues-code/wxl-wrathclassicapi
          ref: main
          token: ${{ secrets.WRAPPER_REPO_TOKEN }}
          path: wxl-wrathclassicapi

      - name: Build WrathClassicAPI.dll (LichLoader front-end)
        run: |
          cmake -S WrathClassicAPI -B WrathClassicAPI/build -A Win32 "-DWRATHCLASSICAPI_TAG=${{ github.ref_name }}"
          cmake --build WrathClassicAPI/build --config Release

      - name: Build wxl-wrathclassicapi.dll (WXL extension front-end)
        run: |
          cmake -S wxl-wrathclassicapi -B wxl-wrathclassicapi/build -A Win32 "-DWRATHCLASSICAPI_TAG=${{ github.ref_name }}" "-DWRATHCLASSICAPI_DIR=${{ github.workspace }}/WrathClassicAPI" "-DWXL_CORE_DIR=${{ github.workspace }}/wxl-core"
          cmake --build wxl-wrathclassicapi/build --config Release

      - name: Stamp wxl.json, sync docs/API.md + tag the wrapper repo
        shell: pwsh
        working-directory: wxl-wrathclassicapi
        run: |
          $ver = "${{ github.ref_name }}".TrimStart('v')
          $stamped = ([regex]'("version"\s*:\s*")[^"]*(")').Replace((Get-Content -Raw wxl.json), ('${1}' + $ver + '${2}'), 1)
          [System.IO.File]::WriteAllText((Join-Path (Get-Location) 'wxl.json'), $stamped)
          # The wrapper ships the per-function reference next to the DLL: docs/API.md
          # is a copy of the core's, refreshed on every release so it matches the
          # shipped build. The header marks it as synced so nobody edits the copy, and
          # the core's repo-relative links (../README.md, ../src/...) are pointed at
          # the core repository at this tag, since those files are not in the wrapper.
          New-Item -ItemType Directory -Force docs | Out-Null
          $core = "https://github.com/brues-code/WrathClassicAPI/blob/${{ github.ref_name }}/"
          $header = "<!-- Synced from ${core}docs/API.md by the WrathClassicAPI release workflow. Edit it there, not here. -->`n`n"
          $api = [System.IO.File]::ReadAllText("${{ github.workspace }}/WrathClassicAPI/docs/API.md") -replace '\]\(\.\./', ('](' + $core)
          [System.IO.File]::WriteAllText((Join-Path (Get-Location) 'docs/API.md'), $header + $api, [System.Text.UTF8Encoding]::new($false))
          git config user.name  "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add wxl.json docs/API.md
          if (git status --porcelain -- wxl.json docs/API.md) { git commit -m "release ${{ github.ref_name }}" }
          git tag "${{ github.ref_name }}"
          git push origin HEAD:main
          git push origin "${{ github.ref_name }}"

      - name: Release WrathClassicAPI.dll (this repo)
        uses: softprops/action-gh-release@v2
        with:
          files: WrathClassicAPI/build/Release/WrathClassicAPI.dll
          generate_release_notes: true

      - name: Release wxl-wrathclassicapi.dll (extension repo)
        shell: pwsh
        env:
          GH_TOKEN: ${{ secrets.WRAPPER_REPO_TOKEN }}
        run: |
          gh release create "${{ github.ref_name }}" "wxl-wrathclassicapi/build/Release/wxl-wrathclassicapi.dll" --repo brues-code/wxl-wrathclassicapi --title "WrathClassicAPI ${{ github.ref_name }}" --generate-notes