Merge 3.18.x into 4.0.x

.github/workflows/coding-standard.yml

@@ -26,10 +26,10 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: "Install PHP"
-        uses: "shivammathur/setup-php@2.37.0"
+        uses: "shivammathur/setup-php@2.37.2"
         with:
           coverage: "pcov"
           php-version: "${{ matrix.php-version }}"

.github/workflows/docs-check.yml

@@ -25,10 +25,10 @@ jobs:
 
         steps:
             - name: "Checkout"
-              uses: actions/checkout@v6
+              uses: actions/checkout@v7
 
             - name: "Install PHP"
-              uses: "shivammathur/setup-php@2.37.0"
+              uses: "shivammathur/setup-php@2.37.2"
               with:
                   coverage: none
                   php-version: "${{ matrix.php-version }}"

.github/workflows/docs-deploy.yml

@@ -0,0 +1,71 @@
+name: Publish docs
+
+on:
+  push:
+    branches:
+      - "[0-9]+.[0-9]+.x"
+    paths:
+      - "docs/**"
+  release:
+    types:
+      - published
+
+permissions:
+  contents: read
+
+jobs:
+  trigger:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check whether this ref belongs to the latest release of its major version
+        id: check
+        env:
+          GH_TOKEN: ${{ github.token }}
+          EVENT_NAME: ${{ github.event_name }}
+          REF_NAME: ${{ github.ref_name }}
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          if [ "$EVENT_NAME" = "release" ]; then
+            current="$RELEASE_TAG"
+          else
+            current="$REF_NAME"
+          fi
+
+          major="${current%%.*}"
+
+          latest_tag=$(gh release list \
+              --repo "$GITHUB_REPOSITORY" \
+              --exclude-drafts \
+              --exclude-pre-releases \
+              --limit 1000 \
+              --json tagName \
+              --jq '.[].tagName' \
+            | grep -E "^${major}\.[0-9]+\.[0-9]+$" \
+            | sort -V \
+            | tail -n1)
+          latest_branch="${latest_tag%.*}.x"
+
+          if [ "$EVENT_NAME" = "release" ]; then
+            expected="$latest_tag"
+          else
+            expected="$latest_branch"
+          fi
+
+          echo "latest release of ${major}.x: ${latest_tag:-none} (branch ${latest_branch}), current: ${current}"
+
+          if [ -n "$latest_tag" ] && [ "$current" = "$expected" ]; then
+            echo "deploy=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "deploy=false" >> "$GITHUB_OUTPUT"
+            echo "Skipping docs deployment: ${current} is not the latest release of ${major}.x."
+          fi
+
+      - name: Trigger workflow in other repo
+        if: steps.check.outputs.deploy == 'true'
+        run: |
+          curl -L -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.ORGANIZATION_ADMIN_TOKEN }}" \
+            -H "X-GitHub-Api-Version: 2026-03-10" \
+            https://api.github.com/repos/patchlevel/patchlevel.dev/actions/workflows/prod-deployment.yaml/dispatches \
+            -d '{"ref":"main"}'

.github/workflows/mutation-tests-diff.yml

@@ -22,12 +22,12 @@ jobs:
 
         steps:
             - name: "Checkout"
-              uses: actions/checkout@v6
+              uses: actions/checkout@v7
               with:
                 fetch-depth: 0
 
             - name: "Install PHP"
-              uses: "shivammathur/setup-php@2.37.0"
+              uses: "shivammathur/setup-php@2.37.2"
               with:
                   coverage: "pcov"
                   php-version: "${{ matrix.php-version }}"

.github/workflows/mutation-tests.yml

@@ -26,10 +26,10 @@ jobs:
 
         steps:
             - name: "Checkout"
-              uses: actions/checkout@v6
+              uses: actions/checkout@v7
 
             - name: "Install PHP"
-              uses: "shivammathur/setup-php@2.37.0"
+              uses: "shivammathur/setup-php@2.37.2"
               with:
                   coverage: "pcov"
                   php-version: "${{ matrix.php-version }}"

.github/workflows/phpstan.yml

@@ -26,10 +26,10 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: "Install PHP"
-        uses: "shivammathur/setup-php@2.37.0"
+        uses: "shivammathur/setup-php@2.37.2"
         with:
           coverage: "pcov"
           php-version: "${{ matrix.php-version }}"

.github/workflows/phpunit.yml

@@ -37,10 +37,10 @@ jobs:
             operating-system: "windows-latest"
     steps:
       - name: "Checkout"
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: "Install PHP"
-        uses: "shivammathur/setup-php@2.37.0"
+        uses: "shivammathur/setup-php@2.37.2"
         with:
           coverage: "pcov"
           php-version: "${{ matrix.php-version }}"

.github/workflows/release-on-milestone-closed-triggering-release-event.yml

@@ -18,7 +18,7 @@ jobs:
 
         steps:
             - name: "Checkout"
-              uses: actions/checkout@v6
+              uses: actions/checkout@v7
 
             - name: "Release"
               uses: "laminas/automatic-releases@v1"