@hyperframes/engine 0.8.174 → 0.8.176

package/dist/utils/alphaBlit.d.ts

@@ -46,17 +46,9 @@ export declare function decodePngToRgb48le(buf: Buffer): {
  * ## Convention
  *
  * "Linear" here means **scene light in [0, 1] relative to SDR reference white**
- * (not absolute nits). The HLG branch applies the OETF directly — no OOTF (no
- * gamma 1.2 scene→display conversion). This is the right choice for DOM
- * overlays that will be composited ON TOP of HLG video pixels (which are
- * already in HLG signal space); we need the overlay to sit in the same space
- * as what it’s blending onto. Applying the OOTF here would double-apply it
- * when the HDR video already carries scene-light semantics.
- *
- * For PQ, SDR white is placed at 203 nits per ITU-R BT.2408 ("SDR white"
- * reference level) and normalized against 10,000-nit peak. This lets SDR
- * content (text, UI) sit at the conventional SDR-white brightness within a
- * PQ frame rather than at peak brightness.
+ * (not absolute nits). Both branches put SDR white at BT.2408 reference white,
+ * below peak: HLG at 75% signal (the OETF takes peak-relative light, so it is
+ * scaled first; no OOTF), PQ at 203 nits of the 10,000-nit peak.
  *
  * Note: converts the transfer function but not the color primaries (bt709 →
  * bt2020). For neutral/near-neutral content (text, UI) the gamut difference

package/dist/utils/alphaBlit.js

@@ -245,17 +245,9 @@ export function decodePngToRgb48le(buf) {
  * ## Convention
  *
  * "Linear" here means **scene light in [0, 1] relative to SDR reference white**
- * (not absolute nits). The HLG branch applies the OETF directly — no OOTF (no
- * gamma 1.2 scene→display conversion). This is the right choice for DOM
- * overlays that will be composited ON TOP of HLG video pixels (which are
- * already in HLG signal space); we need the overlay to sit in the same space
- * as what it’s blending onto. Applying the OOTF here would double-apply it
- * when the HDR video already carries scene-light semantics.
- *
- * For PQ, SDR white is placed at 203 nits per ITU-R BT.2408 ("SDR white"
- * reference level) and normalized against 10,000-nit peak. This lets SDR
- * content (text, UI) sit at the conventional SDR-white brightness within a
- * PQ frame rather than at peak brightness.
+ * (not absolute nits). Both branches put SDR white at BT.2408 reference white,
+ * below peak: HLG at 75% signal (the OETF takes peak-relative light, so it is
+ * scaled first; no OOTF), PQ at 203 nits of the 10,000-nit peak.
  *
  * Note: converts the transfer function but not the color primaries (bt709 →
  * bt2020). For neutral/near-neutral content (text, UI) the gamut difference
@@ -272,6 +264,7 @@ function buildSrgbToSignalLut(transfer) {
     const hlgA = 0.17883277;
     const hlgB = 1 - 4 * hlgA;
     const hlgC = 0.5 - hlgA * Math.log(4 * hlgA);
+    const hlgSdrWhite = (Math.exp((0.75 - hlgC) / hlgA) + hlgB) / 12;
     // PQ (SMPTE 2084) OETF constants
     const pqM1 = 0.1593017578125;
     const pqM2 = 78.84375;
@@ -288,8 +281,8 @@ function buildSrgbToSignalLut(transfer) {
         const linear = srgbByteToLinear(i);
         let signal;
         if (transfer === "hlg") {
-            signal =
-                linear <= 1 / 12 ? Math.sqrt(3 * linear) : hlgA * Math.log(12 * linear - hlgB) + hlgC;
+            const scene = linear * hlgSdrWhite;
+            signal = scene <= 1 / 12 ? Math.sqrt(3 * scene) : hlgA * Math.log(12 * scene - hlgB) + hlgC;
         }
         else {
             // PQ OETF: linear light (in SDR nits) → PQ signal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.174",
+  "version": "0.8.176",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -50,8 +50,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "^0.8.174",
-    "@hyperframes/parsers": "^0.8.174"
+    "@hyperframes/parsers": "^0.8.176",
+    "@hyperframes/core": "^0.8.176"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",