@hyperframes/producer 0.8.223 → 0.8.224

package/dist/index.js

@@ -4884,6 +4884,7 @@ async function validateCompletedSegments(manifest, expectedHash, probeFrames) {
 import {
   analyzeCompositionHdr,
   formatHdrAutoPromotionWarning,
+  gradingKeepsSdr,
   HDR_AUTO_PROMOTION_PIPELINE,
   isHdrColorSpace,
   sanitizeHdrAutoPromotionAsset
@@ -4901,13 +4902,28 @@ function findRenderHdrAutoPromotionTrigger(input) {
   }
   return input.images.find(({ id }) => input.nativeHdrImageIds.has(id))?.src;
 }
-function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources) {
+function logGradingResolution(input, hdrMode, effectiveHdr, hasHdrSource) {
+  const keptSdr = hasHdrSource && gradingKeepsSdr(hdrMode, input.media);
+  if (keptSdr) {
+    input.log.warn(
+      "[Render] HDR source detected, but color grading is SDR-only, so rendering SDR: HDR sources are tone-mapped before the grade. Use --hdr to force HDR output (grades stay SDR)."
+    );
+  } else if (effectiveHdr && [...input.media.videos, ...input.media.images].some((m) => m.graded)) {
+    input.log.warn(
+      "[Render] HDR output with graded media: color grading is SDR-only, so graded elements are graded in SDR and placed in the HDR output."
+    );
+  }
+  return keptSdr;
+}
+function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources, hasHdrSource) {
+  const keptSdrForGrading = logGradingResolution(input, hdrMode, effectiveHdr, hasHdrSource);
   if (forcedHdrWithoutSources) {
     input.log.warn(
       "[Render] HDR forced by --hdr flag, but no HDR sources were detected, defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
     );
   }
   if (!effectiveHdr) {
+    if (keptSdrForGrading) return;
     input.log.info(
       hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected, rendering SDR"
     );
@@ -4932,8 +4948,8 @@ function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources)
 function formatCarriesHdr(format) {
   return format === "mp4";
 }
-function rendersSdrOnly(config) {
-  return config.hdrMode === "force-sdr" || !formatCarriesHdr(config.format ?? "mp4");
+function rendersSdrOnly(config, media) {
+  return config.hdrMode === "force-sdr" || gradingKeepsSdr(config.hdrMode, media) || !formatCarriesHdr(config.format ?? "mp4");
 }
 function resolveEffectiveHdrMode(input) {
   const hdrMode = input.hdrMode ?? "auto";
@@ -4944,7 +4960,7 @@ function resolveEffectiveHdrMode(input) {
   const info = allColorSpaces.length > 0 ? analyzeCompositionHdr(allColorSpaces) : null;
   let effectiveHdr;
   let forcedHdrWithoutSources = false;
-  if (hdrMode === "force-sdr") {
+  if (hdrMode === "force-sdr" || gradingKeepsSdr(hdrMode, input.media)) {
     effectiveHdr = void 0;
   } else if (hdrMode === "force-hdr") {
     if (info?.hasHdr && info.dominantTransfer) {
@@ -4960,7 +4976,7 @@ function resolveEffectiveHdrMode(input) {
     input.log.warn(formatDowngradeWarning(input.outputFormat, forcedHdrWithoutSources));
     effectiveHdr = void 0;
   }
-  logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources);
+  logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources, info?.hasHdr === true);
   return effectiveHdr;
 }
 
@@ -5825,6 +5841,7 @@ import {
 } from "@hyperframes/core/media-timing";
 import {
   parseVideoElements,
+  hasGradedCanvas,
   parseImageElements,
   parseAudioElements,
   isSelfOrAncestorHidden,
@@ -5959,7 +5976,7 @@ function collectRenderMedia(html) {
     if (placed) audios.push(placed);
     else droppedMediaIds.add(elementId);
   }
-  return { videos, audios, images, droppedMediaIds };
+  return { videos, audios, images, droppedMediaIds, gradedCanvas: hasGradedCanvas(html) };
 }
 function placeAudio(audio, window2) {
   const authoredEnd = audio.end > 0 ? audio.end : Infinity;
@@ -8014,7 +8031,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
   for (const [relPath, absPath] of preparedHeifAssets) {
     externalAssets.set(relPath, absPath);
   }
-  const { videos, audios, images, droppedMediaIds } = collectRenderMedia(html);
+  const { videos, audios, images, droppedMediaIds, gradedCanvas } = collectRenderMedia(html);
   const masterFxChain = parseMasterFxChain(html);
   const advised = /* @__PURE__ */ new Set();
   for (const video of videos) {
@@ -8053,6 +8070,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     audios,
     images,
     droppedMediaIds,
+    gradedCanvas,
     ...masterFxChain ? { masterFxChain } : {},
     unresolvedCompositions,
     externalAssets,
@@ -8506,6 +8524,7 @@ async function runCompileStage(input) {
     videos: compiled.videos,
     audios: compiled.audios,
     images: compiled.images,
+    gradedCanvas: compiled.gradedCanvas,
     masterFxChain: compiled.masterFxChain,
     width: compiled.width,
     height: compiled.height
@@ -9284,6 +9303,7 @@ import {
   detectTransfer,
   extractAllVideoFrames,
   extractMediaMetadata as extractMediaMetadata3,
+  gradingKeepsSdr as gradingKeepsSdr2,
   isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
   rebaseVideoToWindow,
@@ -9524,10 +9544,11 @@ async function runExtractVideosStage(input) {
   let failureToEnforce = null;
   let videoReadinessSkipIds = [];
   let videoMetadataHints = [];
+  const probesHdr = job.config.hdrMode !== "force-sdr" && !gradingKeepsSdr2(job.config.hdrMode, composition);
   const nativeHdrVideoIds = /* @__PURE__ */ new Set();
   const videoTransfers = /* @__PURE__ */ new Map();
   let hdrProbeTransientRetries = 0;
-  if (job.config.hdrMode !== "force-sdr" && composition.videos.length > 0) {
+  if (probesHdr && composition.videos.length > 0) {
     log?.info("Probing video color spaces...", { videoCount: composition.videos.length });
     const probeFailures = await Promise.all(
       composition.videos.map(async (v) => {
@@ -9566,7 +9587,7 @@ async function runExtractVideosStage(input) {
   const imageTransfers = /* @__PURE__ */ new Map();
   const hdrImageSrcPaths = /* @__PURE__ */ new Map();
   const imageColorSpaces = [];
-  if (job.config.hdrMode !== "force-sdr" && composition.images.length > 0) {
+  if (probesHdr && composition.images.length > 0) {
     const probed = await Promise.all(
       composition.images.map(async (img) => {
         const imgPath = resolveProjectRelativeSrc3(img.src, projectDir, compiledDir);
@@ -9603,7 +9624,7 @@ async function runExtractVideosStage(input) {
         fps: job.config.fps,
         outputDir: join18(compiledDir, "__hyperframes_video_frames"),
         format: job.config.videoFrameFormat ?? "auto",
-        toneMapHdrToSdr: rendersSdrOnly(job.config),
+        toneMapHdrToSdr: rendersSdrOnly(job.config, composition),
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce",
@@ -13532,6 +13553,7 @@ async function executeRenderPipeline(input) {
     });
     const effectiveHdr = resolveEffectiveHdrMode({
       hdrMode: job.config.hdrMode,
+      media: composition,
       outputFormat,
       extractionResult,
       imageColorSpaces,

package/dist/public-server.js

@@ -4901,6 +4901,7 @@ async function validateCompletedSegments(manifest, expectedHash, probeFrames) {
 import {
   analyzeCompositionHdr,
   formatHdrAutoPromotionWarning,
+  gradingKeepsSdr,
   HDR_AUTO_PROMOTION_PIPELINE,
   isHdrColorSpace,
   sanitizeHdrAutoPromotionAsset
@@ -4918,13 +4919,28 @@ function findRenderHdrAutoPromotionTrigger(input) {
   }
   return input.images.find(({ id }) => input.nativeHdrImageIds.has(id))?.src;
 }
-function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources) {
+function logGradingResolution(input, hdrMode, effectiveHdr, hasHdrSource) {
+  const keptSdr = hasHdrSource && gradingKeepsSdr(hdrMode, input.media);
+  if (keptSdr) {
+    input.log.warn(
+      "[Render] HDR source detected, but color grading is SDR-only, so rendering SDR: HDR sources are tone-mapped before the grade. Use --hdr to force HDR output (grades stay SDR)."
+    );
+  } else if (effectiveHdr && [...input.media.videos, ...input.media.images].some((m) => m.graded)) {
+    input.log.warn(
+      "[Render] HDR output with graded media: color grading is SDR-only, so graded elements are graded in SDR and placed in the HDR output."
+    );
+  }
+  return keptSdr;
+}
+function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources, hasHdrSource) {
+  const keptSdrForGrading = logGradingResolution(input, hdrMode, effectiveHdr, hasHdrSource);
   if (forcedHdrWithoutSources) {
     input.log.warn(
       "[Render] HDR forced by --hdr flag, but no HDR sources were detected, defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
     );
   }
   if (!effectiveHdr) {
+    if (keptSdrForGrading) return;
     input.log.info(
       hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected, rendering SDR"
     );
@@ -4949,8 +4965,8 @@ function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources)
 function formatCarriesHdr(format) {
   return format === "mp4";
 }
-function rendersSdrOnly(config) {
-  return config.hdrMode === "force-sdr" || !formatCarriesHdr(config.format ?? "mp4");
+function rendersSdrOnly(config, media) {
+  return config.hdrMode === "force-sdr" || gradingKeepsSdr(config.hdrMode, media) || !formatCarriesHdr(config.format ?? "mp4");
 }
 function resolveEffectiveHdrMode(input) {
   const hdrMode = input.hdrMode ?? "auto";
@@ -4961,7 +4977,7 @@ function resolveEffectiveHdrMode(input) {
   const info = allColorSpaces.length > 0 ? analyzeCompositionHdr(allColorSpaces) : null;
   let effectiveHdr;
   let forcedHdrWithoutSources = false;
-  if (hdrMode === "force-sdr") {
+  if (hdrMode === "force-sdr" || gradingKeepsSdr(hdrMode, input.media)) {
     effectiveHdr = void 0;
   } else if (hdrMode === "force-hdr") {
     if (info?.hasHdr && info.dominantTransfer) {
@@ -4977,7 +4993,7 @@ function resolveEffectiveHdrMode(input) {
     input.log.warn(formatDowngradeWarning(input.outputFormat, forcedHdrWithoutSources));
     effectiveHdr = void 0;
   }
-  logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources);
+  logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources, info?.hasHdr === true);
   return effectiveHdr;
 }
 
@@ -5842,6 +5858,7 @@ import {
 } from "@hyperframes/core/media-timing";
 import {
   parseVideoElements,
+  hasGradedCanvas,
   parseImageElements,
   parseAudioElements,
   isSelfOrAncestorHidden,
@@ -5976,7 +5993,7 @@ function collectRenderMedia(html) {
     if (placed) audios.push(placed);
     else droppedMediaIds.add(elementId);
   }
-  return { videos, audios, images, droppedMediaIds };
+  return { videos, audios, images, droppedMediaIds, gradedCanvas: hasGradedCanvas(html) };
 }
 function placeAudio(audio, window2) {
   const authoredEnd = audio.end > 0 ? audio.end : Infinity;
@@ -8031,7 +8048,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
   for (const [relPath, absPath] of preparedHeifAssets) {
     externalAssets.set(relPath, absPath);
   }
-  const { videos, audios, images, droppedMediaIds } = collectRenderMedia(html);
+  const { videos, audios, images, droppedMediaIds, gradedCanvas } = collectRenderMedia(html);
   const masterFxChain = parseMasterFxChain(html);
   const advised = /* @__PURE__ */ new Set();
   for (const video of videos) {
@@ -8070,6 +8087,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     audios,
     images,
     droppedMediaIds,
+    gradedCanvas,
     ...masterFxChain ? { masterFxChain } : {},
     unresolvedCompositions,
     externalAssets,
@@ -8523,6 +8541,7 @@ async function runCompileStage(input) {
     videos: compiled.videos,
     audios: compiled.audios,
     images: compiled.images,
+    gradedCanvas: compiled.gradedCanvas,
     masterFxChain: compiled.masterFxChain,
     width: compiled.width,
     height: compiled.height
@@ -9269,6 +9288,7 @@ import {
   detectTransfer,
   extractAllVideoFrames,
   extractMediaMetadata as extractMediaMetadata3,
+  gradingKeepsSdr as gradingKeepsSdr2,
   isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
   rebaseVideoToWindow,
@@ -9504,10 +9524,11 @@ async function runExtractVideosStage(input) {
   let failureToEnforce = null;
   let videoReadinessSkipIds = [];
   let videoMetadataHints = [];
+  const probesHdr = job.config.hdrMode !== "force-sdr" && !gradingKeepsSdr2(job.config.hdrMode, composition);
   const nativeHdrVideoIds = /* @__PURE__ */ new Set();
   const videoTransfers = /* @__PURE__ */ new Map();
   let hdrProbeTransientRetries = 0;
-  if (job.config.hdrMode !== "force-sdr" && composition.videos.length > 0) {
+  if (probesHdr && composition.videos.length > 0) {
     log?.info("Probing video color spaces...", { videoCount: composition.videos.length });
     const probeFailures = await Promise.all(
       composition.videos.map(async (v) => {
@@ -9546,7 +9567,7 @@ async function runExtractVideosStage(input) {
   const imageTransfers = /* @__PURE__ */ new Map();
   const hdrImageSrcPaths = /* @__PURE__ */ new Map();
   const imageColorSpaces = [];
-  if (job.config.hdrMode !== "force-sdr" && composition.images.length > 0) {
+  if (probesHdr && composition.images.length > 0) {
     const probed = await Promise.all(
       composition.images.map(async (img) => {
         const imgPath = resolveProjectRelativeSrc3(img.src, projectDir, compiledDir);
@@ -9583,7 +9604,7 @@ async function runExtractVideosStage(input) {
         fps: job.config.fps,
         outputDir: join18(compiledDir, "__hyperframes_video_frames"),
         format: job.config.videoFrameFormat ?? "auto",
-        toneMapHdrToSdr: rendersSdrOnly(job.config),
+        toneMapHdrToSdr: rendersSdrOnly(job.config, composition),
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce",
@@ -13512,6 +13533,7 @@ async function executeRenderPipeline(input) {
     });
     const effectiveHdr = resolveEffectiveHdrMode({
       hdrMode: job.config.hdrMode,
+      media: composition,
       outputFormat,
       extractionResult,
       imageColorSpaces,

package/dist/services/htmlCompiler.d.ts

@@ -9,6 +9,7 @@ export interface CompiledComposition {
     audios: AudioElement[];
     images: ImageElement[];
     droppedMediaIds: Set<string>;
+    gradedCanvas: boolean;
     masterFxChain?: string;
     unresolvedCompositions: UnresolvedElement[];
     /** Assets that resolve outside projectDir. Keys are the path used in HTML, values are absolute filesystem paths. */

package/dist/services/render/hdrMode.d.ts

@@ -8,14 +8,17 @@
  * SDR) lives here too so the sequencer doesn't need to know which
  * formats can carry an HDR signal.
  */
+import { gradingKeepsSdr } from "@hyperframes/engine";
 import type { ExtractionResult, HdrTransfer, VideoColorSpace } from "@hyperframes/engine";
 import type { ProducerLogger } from "../../logger.js";
 import type { RenderConfig } from "../renderOrchestrator.js";
 type EffectiveHdr = {
     transfer: HdrTransfer;
 } | undefined;
+type RenderMedia = Parameters<typeof gradingKeepsSdr>[1];
 type HdrModeInput = {
     hdrMode: RenderConfig["hdrMode"];
+    media: RenderMedia;
     outputFormat: NonNullable<RenderConfig["format"]>;
     extractionResult: ExtractionResult | null | undefined;
     imageColorSpaces: (VideoColorSpace | null)[];
@@ -34,6 +37,6 @@ export declare function findRenderHdrAutoPromotionTrigger(input: {
     }[];
     nativeHdrImageIds: ReadonlySet<string>;
 }): string | undefined;
-export declare function rendersSdrOnly(config: Pick<RenderConfig, "hdrMode" | "format">): boolean;
+export declare function rendersSdrOnly(config: Pick<RenderConfig, "hdrMode" | "format">, media: RenderMedia): boolean;
 export declare function resolveEffectiveHdrMode(input: HdrModeInput): EffectiveHdr;
 export {};

package/dist/services/render/shared.d.ts

@@ -19,6 +19,7 @@ export interface CompositionMetadata {
     videos: VideoElement[];
     audios: AudioElement[];
     images: ImageElement[];
+    gradedCanvas?: boolean;
     masterFxChain?: string;
     width: number;
     height: number;

package/dist/services/render/stages/extractVideosStage.d.ts

@@ -16,7 +16,7 @@
  *   - `perfStages.videoExtractMs` is set at the same end-of-stage point.
  *   - `materializeExtractedFramesForCompiledDir` is still called once
  *     when `extractionResult.extracted` is non-empty.
- *   - `force-sdr` mode still skips ALL ffprobe overhead.
+ *   - `force-sdr` mode, and auto mode with graded media, still skip ALL ffprobe overhead.
  *
  * New for distributed mode:
  *   - `materializeSymlinks` (default `false`) — when `true`, the stage

package/dist/services/renderMediaCollector.d.ts

@@ -14,6 +14,7 @@ export interface RenderMedia {
     images: ImageElement[];
     /** Ids of clips in the document that never play; the browser probe must not add them back. */
     droppedMediaIds: Set<string>;
+    gradedCanvas: boolean;
 }
 /**
  * Parse every media element in the inlined render document, with each clip's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.223",
+  "version": "0.8.224",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
-    "@hyperframes/core": "0.8.223",
-    "@hyperframes/engine": "0.8.223",
-    "@hyperframes/lint": "0.8.223",
-    "@hyperframes/parsers": "0.8.223",
-    "@hyperframes/studio-server": "0.8.223"
+    "@hyperframes/lint": "0.8.224",
+    "@hyperframes/engine": "0.8.224",
+    "@hyperframes/studio-server": "0.8.224",
+    "@hyperframes/core": "0.8.224",
+    "@hyperframes/parsers": "0.8.224"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.223"
+    "@hyperframes/aws-lambda": "0.8.224"
   },
   "engines": {
     "node": ">=22"