Add code coverage testing with lcov to GitHub Actions

Add a dedicated Coverage job that:
- Uses g++ with --coverage flag for comprehensive coverage collection
- Installs and configures lcov for coverage data processing
- Filters coverage to focus on main library headers (include/*)
- Excludes system headers, vendor files, tests, and build artifacts
- Generates HTML coverage reports with titles and legends
- Uploads results to Codecov for PR comments and online tracking
- Provides downloadable coverage artifacts as backup

The coverage job runs independently of main builds to avoid performance
overhead while providing detailed coverage metrics and PR feedback.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: kkaefer

.github/workflows/build.yml

@@ -64,6 +64,94 @@ jobs:
       - name: Run tests
         run: build/tests
 
+  Coverage:
+    runs-on: ubuntu-latest
+
+    container:
+      image: ubuntu:24.04
+
+    env:
+      CXX: g++
+      DEBIAN_FRONTEND: noninteractive
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Update Git
+        run: |
+          apt-get update
+          apt-get install -y git
+          git --version
+
+      - name: Checkout repository
+        uses: actions/checkout@v5
+        with:
+          submodules: true
+
+      - name: Install dependencies
+        run: |
+          apt-get install -y cmake ninja-build g++ xorg-dev lcov
+          g++ --version
+          cmake --version
+          ninja --version
+          lcov --version
+
+      - name: Create build directory
+        run: mkdir -p build
+        shell: bash
+
+      - name: Configure CMake for coverage
+        working-directory: build
+        run: cmake .. -GNinja -DCMAKE_CXX_FLAGS="--coverage" -DCMAKE_BUILD_TYPE=Debug
+
+      - name: Build all targets
+        working-directory: build
+        run: ninja
+
+      - name: Run tests
+        run: build/tests
+
+      - name: Generate coverage report
+        run: |
+          # Create coverage directory
+          mkdir -p coverage
+
+          # Capture coverage data
+          lcov --capture --directory build --output-file coverage/coverage_raw.info
+
+          # Remove system headers, vendor files, and test files from coverage
+          lcov --remove coverage/coverage_raw.info '/usr/*' --output-file coverage/coverage.info
+          lcov --remove coverage/coverage.info '*/vendor/*' --output-file coverage/coverage.info
+          lcov --remove coverage/coverage.info '*/test/*' --output-file coverage/coverage.info
+          lcov --remove coverage/coverage.info '*/build/*' --output-file coverage/coverage.info
+          lcov --remove coverage/coverage.info '*/CMakeFiles/*' --output-file coverage/coverage.info
+
+          # Only include our main header files
+          lcov --extract coverage/coverage.info '*/include/*' --output-file coverage/coverage.info
+
+          # Generate HTML report
+          genhtml coverage/coverage.info --output-directory coverage/html --title "Earcut.hpp Coverage Report" --legend
+
+          # Show summary
+          lcov --summary coverage/coverage.info
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: coverage/coverage.info
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+          verbose: true
+
+      - name: Upload coverage reports as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+
   MacOS:
     strategy:
       fail-fast: false