test(producer): add hdr-regression and hdr-hlg-regression test suites (heygen-com#365)

## Summary

Replace the trivial `hdr-pq` and `hdr-image-only` tests with two consolidated, time-windowed regression suites that exercise the full HDR pipeline. These goldens are the safety net for every other PR in this stack.

## Why

The pre-existing HDR tests covered only a single full-bleed video or image with a static text label — none of the features that the HDR pipeline has to handle differently from SDR (opacity animation, z-ordered multi-layer compositing, transforms, border-radius clipping, shader transitions, multiple HDR sources, object-fit modes, mixed HDR+SDR layering, HLG transfer). This PR builds the missing safety net first so every subsequent fix can be proven correct.

## What changed

- New `packages/producer/tests/hdr-regression/` (PQ, BT.2020, ~20 s, 1080p, 8 windows A–H):
  - A: static baseline (HDR video + DOM overlay)
  - B: wrapper-opacity fade
  - C: direct-on-`<video>` opacity tween (documents the Chunk 1 bug)
  - D: z-order sandwich (DOM → HDR → DOM)
  - E: two HDR videos side-by-side (pins PR heygen-com#289)
  - F: rotation + scale + border-radius (documents the Chunk 4 bug)
  - G: `object-fit: contain`
  - H: shader crossfade between HDR video and HDR image
- New `packages/producer/tests/hdr-hlg-regression/` (HLG, ARIB STD-B67, ~5 s, 2 windows A–B) — exercises the separate HLG LUT/OETF code path that previously had **zero** coverage.
- New `scripts/generate-hdr-photo-pq.py` synthesizes `hdr-photo-pq.png` with a cICP chunk for BT.2020/PQ/full.
- Removed `tests/hdr-pq/` and `tests/hdr-image-only/`.
- Updated `.github/workflows/regression.yml` HDR shard to run the new pair sequentially.
- All compositions follow the documented timed-element pattern (`data-start`, `data-duration`, `class="clip"` directly on each timed leaf — no wrapper inheritance).

## Test plan

- [x] Goldens generated with `bun run test:update --sequential`.
- [x] `ffprobe` confirms HEVC/yuv420p10le/bt2020nc/smpte2084 (PQ) and arib-std-b67 (HLG).
- [x] Suite green with `maxFrameFailures` budgets that absorb the documented Chunk 1 / Chunk 4 known-fails — tightened in follow-up PRs in this stack.

## Stack

Foundational PR for the HDR follow-ups stack (Chunk 0 of `plans/hdr-followups.md`). Every subsequent PR builds on this safety net.

Author: vanceingalls

.github/workflows/regression.yml

@@ -2,21 +2,10 @@ name: regression
 
 on:
   pull_request:
-    branches: [main]
   push:
     branches:
       - main
 
-concurrency:
-  group: regression-${{ github.ref }}
-  cancel-in-progress: true
-
-# Least-privilege token: only reading code. Jobs that need more (e.g. GHA
-# cache reads/writes from docker/build-push-action with `type=gha`) elevate
-# their own permissions inline.
-permissions:
-  contents: read
-
 jobs:
   changes:
     name: Detect changes
@@ -36,56 +25,11 @@ jobs:
               - "packages/engine/**"
               - "Dockerfile*"
 
-  # Build the regression Docker image once, export it as a tarball, and upload
-  # as an artifact. Each matrix shard then downloads + `docker load`s it instead
-  # of rebuilding from cache. Measured on PR #419: the Docker build step takes
-  # ~4 min per shard even with GHA cache, so 11 shards = ~44 min of redundant
-  # build time per run. This job replaces that with a single ~4 min build plus
-  # ~15s of artifact download per shard.
-  build-image:
-    name: Build regression test image
-    needs: changes
-    if: needs.changes.outputs.code == 'true'
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    permissions:
-      contents: read
-      actions: write # docker/build-push-action `type=gha` cache reads + writes
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        # No LFS needed here — Dockerfile.test only copies source + package manifests,
-        # not the golden baselines under packages/producer/tests/**/output.
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Build test image to tarball
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: Dockerfile.test
-          tags: hyperframes-producer:test
-          cache-from: type=gha,scope=regression-test-image
-          cache-to: type=gha,mode=max,scope=regression-test-image
-          outputs: type=docker,dest=/tmp/regression-test-image.tar
-
-      - name: Report image size
-        run: ls -lh /tmp/regression-test-image.tar
-
-      - name: Upload image artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: regression-test-image
-          path: /tmp/regression-test-image.tar
-          retention-days: 1
-          compression-level: 1
-
   regression-shards:
-    needs: [changes, build-image]
+    needs: changes
     if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
-    timeout-minutes: 40
+    timeout-minutes: 60
     strategy:
       fail-fast: false
       matrix:
@@ -95,7 +39,7 @@ jobs:
           - shard: render-compat
             args: "--sequential gsap-letters-render-compat css-spinner-render-compat raf-ball-render-compat iframe-render-compat"
           - shard: hdr
-            args: "--sequential hdr-pq hdr-image-only"
+            args: "--sequential hdr-regression hdr-hlg-regression"
           - shard: styles-a
             args: "style-1-prod style-2-prod style-3-prod"
           - shard: styles-b
@@ -130,16 +74,18 @@ jobs:
             fi
           done
 
-      - name: Download test image artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: regression-test-image
-          path: /tmp
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
 
-      - name: Load test image
-        run: |
-          docker load -i /tmp/regression-test-image.tar
-          docker image ls hyperframes-producer:test
+      - name: Build test Docker image (cached)
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: Dockerfile.test
+          load: true
+          tags: hyperframes-producer:test
+          cache-from: type=gha,scope=regression-test-image
+          cache-to: type=gha,mode=min,scope=regression-test-image
 
       - name: "Run regression shard: ${{ matrix.shard }}"
         run: |

packages/engine/src/utils/ffprobe.test.ts

@@ -55,7 +55,7 @@ describe("extractVideoMetadata", () => {
   it("reads HDR PNG cICP metadata when ffprobe color fields are absent", async () => {
     const fixturePath = resolve(
       __dirname,
-      "../../../producer/tests/hdr-image-only/src/hdr-photo.png",
+      "../../../producer/tests/hdr-regression/src/hdr-photo-pq.png",
     );
 
     const metadata = await extractVideoMetadata(fixturePath);
@@ -102,7 +102,7 @@ describe("extractPngMetadataFromBuffer", () => {
 
   it("continues to parse the checked-in HDR PNG fixture", () => {
     const fixture = readFileSync(
-      resolve(__dirname, "../../../producer/tests/hdr-image-only/src/hdr-photo.png"),
+      resolve(__dirname, "../../../producer/tests/hdr-regression/src/hdr-photo-pq.png"),
     );
     expect(extractPngMetadataFromBuffer(fixture)?.colorSpace?.colorTransfer).toBe("smpte2084");
   });

packages/producer/tests/hdr-hlg-regression/README.md

@@ -0,0 +1,52 @@
+# hdr-hlg-regression
+
+Regression test that locks down end-to-end **HDR HLG (BT.2020 ARIB STD-B67)**
+video rendering. Companion to `hdr-regression` (PQ), kept as a separate suite
+so the HLG-specific encoder/metadata path stays tested in isolation.
+
+## What it covers
+
+| Window | Time         | Shape                                 | Expected |
+| ------ | ------------ | ------------------------------------- | -------- |
+| A      | 0.0 – 2.5 s  | Baseline HLG video + DOM overlay      | pass     |
+| B      | 2.5 – 5.0 s  | Wrapper opacity fade around HLG video | pass     |
+
+The test pins the contract that:
+
+- `extractVideoMetadata` reports `bt2020/arib-std-b67/limited` for the HLG
+  source (i.e. HLG is detected and not silently coerced to PQ).
+- `isHdrColorSpace` flips the orchestrator into the layered HDR path on the
+  HLG signal.
+- The HLG source is decoded into `rgb48le` and blitted under the SDR DOM
+  overlay on every frame.
+- Wrapper-opacity composition (window B) does not break HLG pass-through.
+- `hdrEncoder` writes HEVC Main10 / `yuv420p10le` / BT.2020 HLG with the
+  correct color tags (no PQ mastering display metadata for HLG).
+
+The suite is intentionally short (5 s, two windows) — it exists to detect
+regressions in the HLG-specific code path, not to enumerate every composition
+shape (those live in `hdr-regression`).
+
+## Tolerance
+
+`maxFrameFailures` is **0** here. HLG is a pure pass-through path — no known
+failures, no transcoder workarounds — and HEVC encoding against the rendered
+`rgb48le` buffer is byte-deterministic on the same fixture. Any drift is a
+real regression, not codec noise, so the budget is the strictest possible.
+
+## Fixture
+
+`src/hdr-hlg-clip.mp4` — last 5 seconds of a user-recorded HEVC HLG clip,
+remuxed (no re-encode) so the HLG color tags survive verbatim.
+
+## Running
+
+```bash
+cd packages/producer
+bun run test hdr-hlg-regression
+
+bun run test:update hdr-hlg-regression
+```
+
+In CI it runs in the `hdr` shard alongside `hdr-regression`
+(see `.github/workflows/regression.yml`).

packages/producer/tests/hdr-hlg-regression/meta.json

@@ -0,0 +1,14 @@
+{
+  "name": "hdr-hlg-regression",
+  "description": "Regression test for HDR HLG (BT.2020 ARIB STD-B67) video pass-through. Two windows: (A) baseline HLG video + SDR DOM overlay, (B) wrapper-opacity fade applied to an HLG video. Verifies that an HLG HEVC source drives the layered HDR pipeline end-to-end (extractVideoMetadata reports hlg, ffmpegFrameSource decodes correctly, hdrEncoder writes HEVC Main10 / yuv420p10le / BT.2020 HLG with the appropriate mastering metadata) and that opacity composition does not break HLG signal pass-through.",
+  "tags": ["regression", "hdr"],
+  "minPsnr": 28,
+  "maxFrameFailures": 0,
+  "minAudioCorrelation": 0,
+  "maxAudioLagWindows": 1,
+  "renderConfig": {
+    "fps": 30,
+    "workers": 1,
+    "hdr": true
+  }
+}

…oducer/tests/hdr-pq/output/compiled.html …/hdr-hlg-regression/output/compiled.htmlpackages/producer/tests/hdr-pq/output/compiled.html renamed to packages/producer/tests/hdr-hlg-regression/output/compiled.html packages/producer/tests/hdr-pq/output/compiled.html renamed to packages/producer/tests/hdr-hlg-regression/output/compiled.html

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8a55a505de180ef3eea4311848bc58d56778a0a291713726b8c27f07e80d5bfe
+size 6156319

packages/producer/tests/hdr-hlg-regression/output/output.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e6f0be49c970a41111a10f146e6b19177da7d42c7791aeb70fdabf3cbf8e06d2
+size 4533211

packages/producer/tests/hdr-hlg-regression/src/hdr-hlg-clip.mp4

@@ -0,0 +1,112 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>HDR HLG Regression Suite</title>
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+        background: #000;
+      }
+
+      #main {
+        position: relative;
+        width: 1920px;
+        height: 1080px;
+        overflow: hidden;
+        background: #000;
+      }
+
+      .hdr-video {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+        object-fit: cover;
+        display: block;
+      }
+
+      .label {
+        position: absolute;
+        padding: 14px 22px;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+        font-size: 36px;
+        font-weight: 700;
+        color: #ffffff;
+        background: rgba(0, 0, 0, 0.6);
+        border-radius: 8px;
+        letter-spacing: 0.04em;
+        z-index: 100;
+      }
+
+      .label-tl {
+        top: 48px;
+        left: 64px;
+      }
+
+      /* Window B: opacity-tweenable wrapper around the HLG video */
+      #window-b-wrapper {
+        position: absolute;
+        inset: 0;
+        opacity: 1;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="main"
+      data-composition-id="hdr-hlg-regression"
+      data-start="0"
+      data-duration="5"
+      data-width="1920"
+      data-height="1080"
+    >
+      <!-- Window A · Static baseline HLG · 0.0–2.5s -->
+      <video
+        id="wa-video"
+        class="clip hdr-video"
+        data-start="0"
+        data-duration="2.5"
+        data-track-index="0"
+        src="hdr-hlg-clip.mp4"
+        muted
+        playsinline
+      ></video>
+      <div class="label label-tl clip" data-start="0" data-duration="2.5">
+        A · HLG baseline + DOM overlay
+      </div>
+
+      <!-- Window B · Wrapper opacity fade on HLG · 2.5–5.0s -->
+      <div id="window-b-wrapper">
+        <video
+          id="wb-video"
+          class="clip hdr-video"
+          data-start="2.5"
+          data-duration="2.5"
+          data-track-index="0"
+          src="hdr-hlg-clip.mp4"
+          muted
+          playsinline
+        ></video>
+      </div>
+      <div class="label label-tl clip" data-start="2.5" data-duration="2.5">
+        B · HLG wrapper opacity fade
+      </div>
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+
+      const tl = gsap.timeline({ paused: true });
+
+      // Window B · wrapper opacity 1 → 0.15 → 1 inside the 2.5s window
+      tl.to("#window-b-wrapper", { opacity: 0.15, duration: 1.0, ease: "power2.inOut" }, 2.75);
+      tl.to("#window-b-wrapper", { opacity: 1.0, duration: 1.0, ease: "power2.inOut" }, 3.75);
+
+      window.__timelines["hdr-hlg-regression"] = tl;
+    </script>
+  </body>
+</html>