@hyperframes/producer 0.8.150 → 0.8.151

package/dist/index.js

@@ -4304,7 +4304,8 @@ function computeSegmentPlanHash(input) {
     input.imageFormat,
     input.useGpu ? "gpu" : "cpu",
     `${input.outputWidth}x${input.outputHeight}`,
-    input.motionBlur
+    input.motionBlur,
+    input.captureQuality === void 0 ? "" : String(input.captureQuality)
   ].join(" ");
   return createHash2("sha256").update(ordered).digest("hex").slice(0, 16);
 }
@@ -7617,6 +7618,9 @@ function isActionableProbeFailure(line) {
 function resolveCaptureImageFormat(input) {
   return input.needsAlpha || input.motionBlur ? "png" : "jpeg";
 }
+function resolveCaptureJpegQuality(quality) {
+  return quality === "draft" ? 80 : 100;
+}
 
 // src/services/render/stages/probeStage.ts
 var FRAME_BOUNDARY_EPSILON = 1e-3;
@@ -7772,7 +7776,7 @@ async function runProbeStage(input) {
         height,
         fps: job.config.fps,
         format: captureFormat,
-        quality: captureFormat === "png" ? void 0 : 80,
+        quality: captureFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
         variables: job.config.variables,
         deviceScaleFactor,
         motionBlur,
@@ -8756,13 +8760,16 @@ function shouldAllowAdaptiveCaptureRetry(workerCount, _explicitlyConfigured) {
   return workerCount > 1;
 }
 var JPEG_RAW_RGBA_DIVISOR = 8;
+var HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR = 4;
 var DISK_PROJECTION_SAMPLE_FRAMES = 10;
 function estimateDiskCaptureBytes(totalFrames, captureOptions) {
   const scale = captureOptions.deviceScaleFactor ?? 1;
   const outputWidth = Math.ceil(captureOptions.width * scale);
   const outputHeight = Math.ceil(captureOptions.height * scale);
   const rawBytes = Math.ceil(totalFrames) * outputWidth * outputHeight * 4;
-  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(rawBytes / JPEG_RAW_RGBA_DIVISOR) : rawBytes;
+  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(
+    rawBytes / ((captureOptions.quality ?? 80) > 80 ? HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR : JPEG_RAW_RGBA_DIVISOR)
+  ) : rawBytes;
 }
 function freeDiskBytesAt(path) {
   try {
@@ -12224,7 +12231,7 @@ async function executeRenderPipeline(input) {
       height,
       fps: job.config.fps,
       format: captureImageFormat,
-      quality: captureImageFormat === "png" ? void 0 : job.config.quality === "draft" ? 80 : 95,
+      quality: captureImageFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
       variables: job.config.variables,
       deviceScaleFactor,
       motionBlur: job.config.motionBlur,
@@ -12852,7 +12859,8 @@ async function executeRenderPipeline(input) {
           // Device-scaled: the capture buffer, not the CSS composition size.
           outputWidth: captureCompositionWidth ?? width,
           outputHeight: captureCompositionHeight ?? height,
-          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : ""
+          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : "",
+          captureQuality: captureOptions.quality
         });
         const segmentDir = segmentDirFor(join26(projectDir, "renders"), segmentPlanHash);
         let completedSegments = /* @__PURE__ */ new Set();
@@ -17724,7 +17732,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
       height: plan2.dimensions.height,
       fps: { num: plan2.dimensions.fpsNum, den: plan2.dimensions.fpsDen },
       format: plan2.dimensions.format === "mp4" ? "jpeg" : "png",
-      quality: plan2.dimensions.format === "mp4" ? 80 : void 0,
+      quality: plan2.dimensions.format === "mp4" ? resolveCaptureJpegQuality(job.config.quality) : void 0,
       deviceScaleFactor: encoder.deviceScaleFactor,
       // Re-inject the controller's snapshotted variables so the chunk's
       // first capture sees the same `window.__hfVariables` the in-process

package/dist/public-server.js

@@ -4323,7 +4323,8 @@ function computeSegmentPlanHash(input) {
     input.imageFormat,
     input.useGpu ? "gpu" : "cpu",
     `${input.outputWidth}x${input.outputHeight}`,
-    input.motionBlur
+    input.motionBlur,
+    input.captureQuality === void 0 ? "" : String(input.captureQuality)
   ].join(" ");
   return createHash2("sha256").update(ordered).digest("hex").slice(0, 16);
 }
@@ -7636,6 +7637,9 @@ function isActionableProbeFailure(line) {
 function resolveCaptureImageFormat(input) {
   return input.needsAlpha || input.motionBlur ? "png" : "jpeg";
 }
+function resolveCaptureJpegQuality(quality) {
+  return quality === "draft" ? 80 : 100;
+}
 
 // src/services/render/stages/probeStage.ts
 var FRAME_BOUNDARY_EPSILON = 1e-3;
@@ -7791,7 +7795,7 @@ async function runProbeStage(input) {
         height,
         fps: job.config.fps,
         format: captureFormat,
-        quality: captureFormat === "png" ? void 0 : 80,
+        quality: captureFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
         variables: job.config.variables,
         deviceScaleFactor,
         motionBlur,
@@ -8739,13 +8743,16 @@ function shouldAllowAdaptiveCaptureRetry(workerCount, _explicitlyConfigured) {
   return workerCount > 1;
 }
 var JPEG_RAW_RGBA_DIVISOR = 8;
+var HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR = 4;
 var DISK_PROJECTION_SAMPLE_FRAMES = 10;
 function estimateDiskCaptureBytes(totalFrames, captureOptions) {
   const scale = captureOptions.deviceScaleFactor ?? 1;
   const outputWidth = Math.ceil(captureOptions.width * scale);
   const outputHeight = Math.ceil(captureOptions.height * scale);
   const rawBytes = Math.ceil(totalFrames) * outputWidth * outputHeight * 4;
-  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(rawBytes / JPEG_RAW_RGBA_DIVISOR) : rawBytes;
+  return frameFileExtension(captureOptions.format) === "jpg" ? Math.ceil(
+    rawBytes / ((captureOptions.quality ?? 80) > 80 ? HIGH_QUALITY_JPEG_RAW_RGBA_DIVISOR : JPEG_RAW_RGBA_DIVISOR)
+  ) : rawBytes;
 }
 function freeDiskBytesAt(path) {
   try {
@@ -12207,7 +12214,7 @@ async function executeRenderPipeline(input) {
       height,
       fps: job.config.fps,
       format: captureImageFormat,
-      quality: captureImageFormat === "png" ? void 0 : job.config.quality === "draft" ? 80 : 95,
+      quality: captureImageFormat === "png" ? void 0 : resolveCaptureJpegQuality(job.config.quality),
       variables: job.config.variables,
       deviceScaleFactor,
       motionBlur: job.config.motionBlur,
@@ -12835,7 +12842,8 @@ async function executeRenderPipeline(input) {
           // Device-scaled: the capture buffer, not the CSS composition size.
           outputWidth: captureCompositionWidth ?? width,
           outputHeight: captureCompositionHeight ?? height,
-          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : ""
+          motionBlur: job.config.motionBlur ? JSON.stringify(job.config.motionBlur) : "",
+          captureQuality: captureOptions.quality
         });
         const segmentDir = segmentDirFor(join26(projectDir, "renders"), segmentPlanHash);
         let completedSegments = /* @__PURE__ */ new Set();

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

@@ -1,4 +1,4 @@
-import type { MotionBlurOptions } from "@hyperframes/engine";
+import type { EngineConfig, MotionBlurOptions } from "@hyperframes/engine";
 /**
  * The format a render captures its frames in.
  *
@@ -16,3 +16,8 @@ export declare function resolveCaptureImageFormat(input: {
     needsAlpha: boolean;
     motionBlur: MotionBlurOptions | undefined;
 }): "jpeg" | "png";
+/**
+ * Below 100, Chrome's JPEG turns graded colour and grain into 8x8 chroma blotches that survive
+ * the final encode. Draft keeps the smaller, faster frames.
+ */
+export declare function resolveCaptureJpegQuality(quality: EngineConfig["quality"]): number;

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

@@ -37,6 +37,7 @@ export interface SegmentPlanHashInput {
     outputHeight: number;
     /** Serialised motion-blur options, or "" when off; sample count and shutter change every pixel. */
     motionBlur: string;
+    captureQuality: number | undefined;
 }
 /** Everything that determines segment bytes. Key order is fixed by construction. */
 export declare function computeSegmentPlanHash(input: SegmentPlanHashInput): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.150",
+  "version": "0.8.151",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "^25.2.1",
     "puppeteer-core": "^25.2.1",
-    "@hyperframes/lint": "0.8.150",
-    "@hyperframes/engine": "0.8.150",
-    "@hyperframes/core": "0.8.150",
-    "@hyperframes/studio-server": "0.8.150",
-    "@hyperframes/parsers": "0.8.150"
+    "@hyperframes/lint": "0.8.151",
+    "@hyperframes/engine": "0.8.151",
+    "@hyperframes/studio-server": "0.8.151",
+    "@hyperframes/parsers": "0.8.151",
+    "@hyperframes/core": "0.8.151"
   },
   "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.150"
+    "@hyperframes/aws-lambda": "0.8.151"
   },
   "engines": {
     "node": ">=22"