ci: standardize the workflow with the other libraries

.github/workflows/ci.yml

@@ -10,51 +10,37 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  build-and-test:
-    runs-on: macos-latest
+  test:
+    name: Build and test (iOS Simulator)
+    runs-on: macos-15
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Select Xcode
-        # Pin to the latest stable Xcode provided by the runner image so the
-        # Swift 6 toolchain is deterministic across runs.
-        run: sudo xcode-select -switch /Applications/Xcode.app
+        uses: actions/checkout@v7
 
       - name: Show environment
         run: |
           xcodebuild -version
           swift --version
 
       - name: Build
-        # Build against a generic simulator destination. We do not pin a device
-        # name here (like "iPhone 16") because the exact simulators installed on
-        # GitHub macos-latest runners change over time, and a generic Simulator
-        # destination always resolves. A successful build in Swift 6 language
-        # mode (tools-version 6.0) is also the strict concurrency guard.
-        run: |
-          xcodebuild build \
-            -scheme NerdzPinView \
-            -destination 'generic/platform=iOS Simulator'
+        run: >
+          xcodebuild build
+          -scheme NerdzPinView
+          -destination 'generic/platform=iOS Simulator'
 
       - name: Select an available iPhone simulator
-        # Tests need a concrete device, so we derive one at runtime instead of
-        # hardcoding a name. We list available devices as JSON and pick the first
-        # available iPhone, exposing its UDID for the test step. This survives
-        # runner image changes (any iPhone the image ships with will be used).
         id: sim
         run: |
           UDID=$(xcrun simctl list devices available --json | python3 -c "import json,sys; d=json.load(sys.stdin)['devices']; ids=[x['udid'] for r in d for x in d[r] if x.get('isAvailable') and x.get('name','').startswith('iPhone')]; print(ids[0] if ids else '')")
           if [ -z "$UDID" ]; then
             echo "No available iPhone simulator found." >&2
             exit 1
           fi
-          echo "Using simulator UDID: $UDID"
           echo "udid=$UDID" >> "$GITHUB_OUTPUT"
 
       - name: Test
-        run: |
-          xcodebuild test \
-            -scheme NerdzPinView \
-            -destination "platform=iOS Simulator,id=${{ steps.sim.outputs.udid }}" \
-            -enableCodeCoverage YES
+        run: >
+          xcodebuild test
+          -scheme NerdzPinView
+          -destination "platform=iOS Simulator,id=${{ steps.sim.outputs.udid }}"
+          -enableCodeCoverage YES

.github/workflows/release.yml

@@ -9,9 +9,6 @@ concurrency:
   group: release-${{ github.ref }}
   cancel-in-progress: false
 
-env:
-  SCHEME: NerdzPinView
-
 jobs:
   release:
     name: Publish GitHub release
@@ -20,11 +17,13 @@ jobs:
       contents: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
 
       - name: Extract changelog section
         run: |
-          version="${GITHUB_REF_NAME#v}"
+          version="${GITHUB_REF_NAME}"
           awk -v v="$version" '
             $0 ~ "^## \\[" v "\\]" { found = 1; next }
             found && /^## \[/ { exit }
@@ -42,7 +41,7 @@ jobs:
 
   docs:
     name: Build and deploy DocC
-    runs-on: macos-latest
+    runs-on: macos-15
     permissions:
       pages: write
       id-token: write
@@ -51,16 +50,33 @@ jobs:
       url: ${{ steps.deploy.outputs.page_url }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
+
+      - name: Show environment
+        run: |
+          xcodebuild -version
+          swift --version
 
-      - name: Select Xcode
-        run: sudo xcode-select -switch /Applications/Xcode.app
+      - name: Locate the documentation catalog
+        id: catalog
+        run: |
+          catalog="$(find Sources -maxdepth 3 -name '*.docc' -print -quit)"
+          if [ -z "$catalog" ]; then
+            echo "No DocC catalog found, skipping documentation." >&2
+            echo "found=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          module="$(basename "$(dirname "$catalog")")"
+          echo "found=true" >> "$GITHUB_OUTPUT"
+          echo "path=$catalog" >> "$GITHUB_OUTPUT"
+          echo "module=$module" >> "$GITHUB_OUTPUT"
 
       - name: Build documentation
+        if: steps.catalog.outputs.found == 'true'
         run: |
           set -o pipefail
           xcodebuild docbuild \
-            -scheme "$SCHEME" \
+            -scheme "${GITHUB_REPOSITORY#*/}" \
             -destination 'generic/platform=iOS Simulator' \
             -derivedDataPath .build/docc \
             2>&1 | tee docbuild.log
@@ -70,6 +86,7 @@ jobs:
           fi
 
       - name: Transform for static hosting
+        if: steps.catalog.outputs.found == 'true'
         run: |
           archive="$(find .build/docc -name '*.doccarchive' -print -quit)"
           if [ -z "$archive" ]; then
@@ -81,10 +98,12 @@ jobs:
             --hosting-base-path "${GITHUB_REPOSITORY#*/}"
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        if: steps.catalog.outputs.found == 'true'
+        uses: actions/upload-pages-artifact@v5
         with:
           path: _site
 
       - name: Deploy to Pages
+        if: steps.catalog.outputs.found == 'true'
         id: deploy
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5