tests.yml

name: Test Suite

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

on:
  push:
    branches: [main]
    paths:
      - "**.swift"
      - "Package.swift"
      - "Info.plist"
      - "Kaset.entitlements"
      - "Sources/**"
      - "Scripts/**"
      - "Tests/**"
      - ".github/workflows/tests.yml"
  pull_request:
    branches: [main]
    paths:
      - "**.swift"
      - "Package.swift"
      - "Info.plist"
      - "Kaset.entitlements"
      - "Sources/**"
      - "Scripts/**"
      - "Tests/**"
      - ".github/workflows/tests.yml"
  workflow_dispatch:

jobs:
  macos_unit_tests:
    name: macOS Unit Tests (${{ matrix.os }})
    timeout-minutes: 20
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        # macos-15 covers the Sequoia fallback paths (LegacyFallbackViews,
        # `else` branches of LiquidGlassCompat). macos-26 covers the Tahoe
        # Liquid Glass paths.
        os: [macos-26, macos-15]
    steps:
      - name: Checkout code
        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v4

      - name: Select Xcode version
        run: |
          set -euo pipefail
          # Swift 6.2 requires Xcode 26.x. Both runner images carry one or
          # more Xcode 26.x installs; prefer the newest available.
          for candidate in \
            /Applications/Xcode_26.2.app \
            /Applications/Xcode_26.1.app \
            /Applications/Xcode_26.0.app \
            /Applications/Xcode_26.app
          do
            if [ -d "$candidate" ]; then
              sudo xcode-select -s "$candidate/Contents/Developer"
              echo "Selected $candidate"
              xcodebuild -version
              exit 0
            fi
          done
          echo "::error::No Xcode 26.x install found on $RUNNER_NAME" >&2
          ls /Applications | grep -i xcode || true
          exit 1

      - name: Show Swift version
        run: swift --version

      - name: Cache SPM dependencies
        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
        with:
          path: |
            ~/Library/Caches/org.swift.swiftpm/spm-repositories
            .build
          key: ${{ runner.os }}-${{ matrix.os }}-spm-${{ hashFiles('Package.resolved') }}
          restore-keys: |
            ${{ runner.os }}-${{ matrix.os }}-spm-

      - name: Clear SPM binary artifacts cache
        run: rm -rf ~/Library/Caches/org.swift.swiftpm/artifacts

      - name: Run unit tests
        # --disable-xctest avoids a swiftpm-xctest-helper segfault on macOS 15
        # (Xcode 26 + Sequoia) during XCTest discovery. The unit suite is
        # entirely Swift Testing; the only XCTest target is the manual
        # ParserPerformanceTests, which is invoked separately via xcodebuild.
        run: swift test -q --skip KasetUITests --disable-xctest

  macos_ui_tests:
    name: macOS UI Tests (${{ matrix.os }})
    timeout-minutes: 30
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        # macos-15 exercises Sequoia fallback UI paths; macos-26 exercises
        # the full Tahoe Liquid Glass / Apple Intelligence UI paths.
        os: [macos-26, macos-15]
    steps:
      - name: Checkout code
        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v4

      - name: Select Xcode version
        run: |
          set -euo pipefail
          for candidate in \
            /Applications/Xcode_26.2.app \
            /Applications/Xcode_26.1.app \
            /Applications/Xcode_26.0.app \
            /Applications/Xcode_26.app
          do
            if [ -d "$candidate" ]; then
              sudo xcode-select -s "$candidate/Contents/Developer"
              echo "Selected $candidate"
              xcodebuild -version
              exit 0
            fi
          done
          echo "::error::No Xcode 26.x install found on $RUNNER_NAME" >&2
          ls /Applications | grep -i xcode || true
          exit 1

      - name: Show Xcode version
        run: xcodebuild -version

      - name: Cache SPM dependencies
        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
        with:
          path: |
            ~/Library/Caches/org.swift.swiftpm/spm-repositories
            .build
          key: ${{ runner.os }}-${{ matrix.os }}-spm-ui-${{ hashFiles('Package.resolved') }}
          restore-keys: |
            ${{ runner.os }}-${{ matrix.os }}-spm-ui-

      - name: Clear SPM binary artifacts cache
        run: rm -rf ~/Library/Caches/org.swift.swiftpm/artifacts

      - name: Build app bundle for UI tests
        env:
          KASET_SIGNING: adhoc
          # Xcode 26 actool cannot distill Icon Composer assets on macos-15
          # runners, but UI tests only need a launchable bundle.
          KASET_SKIP_MAIN_ASSETS: ${{ matrix.os == 'macos-15' && '1' || '0' }}
        run: Scripts/build-app.sh debug

      - name: Verify packaged app
        run: Scripts/verify-release-app.sh .build/app/Kaset.app

      - name: Install app for UI tests
        run: |
          sudo cp -R .build/app/Kaset.app /Applications/Kaset.app
          # Register with Launch Services so XCUIApplication can find it
          /System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -f /Applications/Kaset.app

      - name: Run UI tests
        run: |
          set -o pipefail
          xcodebuild \
            -project KasetUITests.xcodeproj \
            -scheme KasetUITests \
            -destination 'platform=macOS' \
            -derivedDataPath ./build \
            CODE_SIGN_IDENTITY="-" \
            CODE_SIGNING_REQUIRED=NO \
            CODE_SIGNING_ALLOWED=NO \
            test

      - name: Upload test results on failure
        if: failure()
        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v4
        with:
          name: macOS-UITestResults-${{ matrix.os }}
          path: ./build/*.xcresult
          retention-days: 7