feat(ci): align build matrix with ffmpeg-prebuilds packages

Expand CI from 4 builds to 10 builds matching @pproenca/webcodecs-ffmpeg:
- 5 platforms: darwin-arm64, darwin-x64, linux-x64-glibc, linux-arm64, linux-x64-musl
- 2 variants: free (LGPL), non-free (GPL)

Changes:
- Refactor to unified matrix strategy (replaces 4 separate jobs)
- Add linux-arm64 support via QEMU emulation
- Add variant-aware FFmpeg package installation
- macOS free variant uses npm packages, non-free uses Homebrew
- Linux builds explicitly install correct FFmpeg package per variant
- Update ffmpeg-prebuilds to 0.1.6
- Add linux-arm64 to optionalDependencies
- Simplify to Node.js 20 only

Author: pproenca

.github/workflows/ci.yml

@@ -1,13 +1,18 @@
 # CI workflow for node-webcodecs
 # Runs linting, building, and testing on all supported platforms
 #
-# Platforms:
-# - Linux x64 glibc (Rocky Linux 9 container - FFmpeg 6+, glibc 2.34)
-# - Linux x64 musl (Alpine 3.20 container - FFmpeg 6+, musl libc)
-# - macOS ARM64 (macos-14 runner)
-# - macOS x64 (macos-13 runner)
+# Platforms (matching @pproenca/webcodecs-ffmpeg packages):
+# - darwin-arm64 (macos-14 runner)
+# - darwin-x64 (macos-13 runner)
+# - linux-x64-glibc (Rocky Linux 9 container)
+# - linux-arm64 (QEMU + ARM64 container)
+# - linux-x64-musl (Alpine 3.20 container)
 #
-# Node.js versions: 20, 22 (matching engines field)
+# Variants:
+# - free (LGPL FFmpeg)
+# - non-free (GPL FFmpeg with x264/x265)
+#
+# Node.js version: 20
 
 name: CI
 
@@ -31,7 +36,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 20
 
       - name: Setup Python
         uses: actions/setup-python@v5
@@ -59,137 +64,169 @@ jobs:
       - name: Lint markdown
         run: npm run lint:md
 
-  build-linux-glibc:
-    name: Linux glibc (Node ${{ matrix.node }})
-    runs-on: ubuntu-24.04
-    container: rockylinux:9
+  build:
+    name: ${{ matrix.platform }}-${{ matrix.variant }}
+    runs-on: ${{ matrix.runner }}
+    container: ${{ matrix.container || '' }}
     strategy:
+      fail-fast: false
       matrix:
-        node: [20, 22]
+        platform: [darwin-arm64, darwin-x64, linux-x64-glibc, linux-arm64, linux-x64-musl]
+        variant: [free, non-free]
+        include:
+          - platform: darwin-arm64
+            runner: macos-14
+            os: darwin
+            ffmpeg_pkg: darwin-arm64
+          - platform: darwin-x64
+            runner: macos-13
+            os: darwin
+            ffmpeg_pkg: darwin-x64
+          - platform: linux-x64-glibc
+            runner: ubuntu-24.04
+            container: rockylinux:9
+            os: linux
+            ffmpeg_pkg: linux-x64
+          - platform: linux-arm64
+            runner: ubuntu-24.04
+            os: linux
+            ffmpeg_pkg: linux-arm64
+            qemu: true
+          - platform: linux-x64-musl
+            runner: ubuntu-24.04
+            container: alpine:3.20
+            os: linux
+            ffmpeg_pkg: linux-x64-musl
+
     steps:
-      - name: Install system dependencies
+      # QEMU setup for ARM64 cross-compilation
+      - name: Set up QEMU
+        if: matrix.qemu == true
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Set up Docker Buildx
+        if: matrix.qemu == true
+        uses: docker/setup-buildx-action@v3
+
+      # System dependencies for Rocky Linux container
+      - name: Install system dependencies (Rocky Linux)
+        if: contains(matrix.container, 'rockylinux')
         run: |
-          # Enable EPEL and CRB repositories for FFmpeg
           dnf install -y epel-release
           dnf config-manager --set-enabled crb
-          # Install RPMFusion for FFmpeg 6+ (EPEL has ffmpeg-free but missing some libs)
           dnf install -y https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm
-          # Install build tools (FFmpeg comes from npm packages)
           dnf install -y gcc-c++ make python3 git pkgconfig
 
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node }}
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Build
-        run: npm run build
-
-      - name: Test
-        run: npm test
-
-  build-linux-musl:
-    name: Linux musl (Node ${{ matrix.node }})
-    runs-on: ubuntu-24.04
-    container: alpine:3.20
-    strategy:
-      matrix:
-        node: [20, 22]
-    steps:
-      - name: Install system dependencies
+      # System dependencies for Alpine container
+      - name: Install system dependencies (Alpine)
+        if: contains(matrix.container, 'alpine')
         run: |
-          # Install build tools and Node.js
-          # zlib-dev and bzip2-dev required for linking FFmpeg
           apk add --no-cache build-base python3 pkgconf git nodejs npm zlib-dev bzip2-dev
 
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Install dependencies
-        run: npm install
-
-      - name: Build
-        run: npm run build
-
-      - name: Test
-        run: npm test
-
-  build-macos-arm64:
-    name: macOS ARM64 (Node ${{ matrix.node }})
-    runs-on: macos-14
-    strategy:
-      matrix:
-        node: [20, 22]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install FFmpeg
-        run: brew install ffmpeg
-
+      # Node.js setup for non-container jobs (macOS)
       - name: Setup Node.js
+        if: matrix.os == 'darwin'
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node }}
-
-      - name: Cache node-gyp
-        uses: actions/cache@v4
-        with:
-          path: |
-            ~/.cache/node-gyp
-            ~/Library/Caches/node-gyp
-          key: node-gyp-macos-arm64-node${{ matrix.node }}-${{ hashFiles('binding.gyp') }}
-          restore-keys: |
-            node-gyp-macos-arm64-node${{ matrix.node }}-
-
-      - name: Install dependencies
-        run: npm install --omit=optional
-
-      - name: Build
-        run: npm run build
-
-      - name: Test
-        run: npm test
-
-  build-macos-x64:
-    name: macOS x64 (Node ${{ matrix.node }})
-    runs-on: macos-13
-    strategy:
-      matrix:
-        node: [20, 22]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
+          node-version: 20
 
-      - name: Install FFmpeg
-        run: brew install ffmpeg
-
-      - name: Setup Node.js
+      # Node.js setup for Rocky Linux container
+      - name: Install Node.js (Rocky Linux)
+        if: contains(matrix.container, 'rockylinux')
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node }}
+          node-version: 20
 
+      # Cache node-gyp for macOS
       - name: Cache node-gyp
+        if: matrix.os == 'darwin'
         uses: actions/cache@v4
         with:
           path: |
             ~/.cache/node-gyp
             ~/Library/Caches/node-gyp
-          key: node-gyp-macos-x64-node${{ matrix.node }}-${{ hashFiles('binding.gyp') }}
+          key: node-gyp-${{ matrix.platform }}-node20-${{ hashFiles('binding.gyp') }}
           restore-keys: |
-            node-gyp-macos-x64-node${{ matrix.node }}-
+            node-gyp-${{ matrix.platform }}-node20-
 
-      - name: Install dependencies
+      # FFmpeg installation for macOS
+      # - free variant: npm LGPL package
+      # - non-free variant: Homebrew (includes x264/x265)
+      - name: Install FFmpeg (macOS npm - free)
+        if: matrix.os == 'darwin' && matrix.variant == 'free'
+        run: |
+          PKG="@pproenca/webcodecs-ffmpeg-${{ matrix.ffmpeg_pkg }}"
+          echo "Installing FFmpeg package: $PKG"
+          npm install --no-save "$PKG"
+
+      - name: Install FFmpeg (macOS Homebrew - non-free)
+        if: matrix.os == 'darwin' && matrix.variant == 'non-free'
+        run: brew install ffmpeg
+
+      # Install dependencies (macOS - omit optional to avoid platform mismatch)
+      - name: Install dependencies (macOS)
+        if: matrix.os == 'darwin'
         run: npm install --omit=optional
 
+      # Install FFmpeg npm package based on variant (Linux non-ARM64)
+      - name: Install FFmpeg (Linux npm)
+        if: matrix.os == 'linux' && matrix.qemu != true
+        run: |
+          PKG="@pproenca/webcodecs-ffmpeg-${{ matrix.ffmpeg_pkg }}"
+          if [ "${{ matrix.variant }}" = "non-free" ]; then
+            PKG="${PKG}-non-free"
+          fi
+          echo "Installing FFmpeg package: $PKG"
+          npm install --no-save "$PKG"
+
+      # Install dependencies (Linux containers)
+      - name: Install dependencies (Linux)
+        if: matrix.os == 'linux' && matrix.qemu != true
+        run: npm install
+
+      # Linux ARM64 builds via Docker with QEMU
+      - name: Build and Test (linux-arm64)
+        if: matrix.qemu == true
+        env:
+          VARIANT: ${{ matrix.variant }}
+        run: |
+          # Determine FFmpeg package based on variant
+          if [ "$VARIANT" = "non-free" ]; then
+            FFMPEG_PKG="@pproenca/webcodecs-ffmpeg-linux-arm64-non-free"
+          else
+            FFMPEG_PKG="@pproenca/webcodecs-ffmpeg-linux-arm64"
+          fi
+
+          docker run --rm --platform linux/arm64 \
+            -v "${{ github.workspace }}:/workspace" \
+            -w /workspace \
+            -e FFMPEG_VARIANT="$VARIANT" \
+            arm64v8/rockylinux:9 \
+            bash -c "
+              set -e
+              dnf install -y epel-release
+              dnf config-manager --set-enabled crb
+              dnf install -y https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm
+              dnf install -y gcc-c++ make python3 git pkgconfig
+              curl -fsSL https://rpm.nodesource.com/setup_20.x | bash -
+              dnf install -y nodejs
+              npm install --no-save \"$FFMPEG_PKG\"
+              npm install
+              npm run build
+              npm test
+            "
+
+      # Build for non-ARM64 platforms
       - name: Build
+        if: matrix.qemu != true
         run: npm run build
 
+      # Test for non-ARM64 platforms
       - name: Test
+        if: matrix.qemu != true
         run: npm test

package.json

@@ -80,10 +80,11 @@
     "@pproenca/node-webcodecs-darwin-x64": "0.1.1-alpha.8",
     "@pproenca/node-webcodecs-linux-x64-glibc": "0.1.1-alpha.8",
     "@pproenca/node-webcodecs-linux-x64-musl": "0.1.1-alpha.8",
-    "@pproenca/webcodecs-ffmpeg-darwin-arm64": "^0.1.4",
-    "@pproenca/webcodecs-ffmpeg-darwin-x64": "^0.1.4",
-    "@pproenca/webcodecs-ffmpeg-linux-x64": "^0.1.4",
-    "@pproenca/webcodecs-ffmpeg-linux-x64-musl": "^0.1.4"
+    "@pproenca/webcodecs-ffmpeg-darwin-arm64": "^0.1.6",
+    "@pproenca/webcodecs-ffmpeg-darwin-x64": "^0.1.6",
+    "@pproenca/webcodecs-ffmpeg-linux-arm64": "^0.1.6",
+    "@pproenca/webcodecs-ffmpeg-linux-x64": "^0.1.6",
+    "@pproenca/webcodecs-ffmpeg-linux-x64-musl": "^0.1.6"
   },
   "dependencies": {
     "detect-libc": "^2.1.2",
@@ -92,7 +93,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
     "@cpplint/cli": "^0.1.0",
-    "@pproenca/webcodecs-ffmpeg-dev": "^0.1.4",
+    "@pproenca/webcodecs-ffmpeg-dev": "^0.1.6",
     "@types/node": "^25.0.3",
     "@types/turndown": "^5.0.6",
     "c8": "^10.1.3",