@hyperframes/producer 0.8.185 → 0.8.188

package/dist/renderRequest.d.ts

@@ -38,6 +38,7 @@ export interface RenderRequestOptions {
     videoBitrate?: string;
     videoFrameFormat?: VideoFrameFormat;
     hdrMode?: RenderConfig["hdrMode"];
+    pageMotionBlur?: RenderConfig["pageMotionBlur"];
     variables?: Record<string, unknown>;
     outputResolution?: CanvasResolution;
     outputResolutionAspectAgnostic?: boolean;

package/dist/server.d.ts

@@ -41,6 +41,7 @@ interface RenderInput {
     quality: "draft" | "standard" | "high";
     format?: "mp4" | "webm" | "mov";
     videoFrameFormat?: RenderConfig["videoFrameFormat"];
+    pageMotionBlur?: RenderConfig["pageMotionBlur"];
     outputDynamicRange?: "auto" | "hdr" | "sdr";
     workers?: number;
     crf?: number;

package/dist/services/distributed/assemble.d.ts

@@ -68,7 +68,7 @@ export declare function assemble(planDir: string, chunkOutputs: AssembleChunkPat
      */
     cfr?: boolean;
 }): Promise<AssembleResult>;
-/** Chunks carrying audio, or with it as a separate file, stitch under one index like S3's. */
+/** Mp4 chunks carrying audio, or with it as a separate file, stitch under one index like S3's. */
 export declare function chunksAreStitchedMp4(planDir: string, cfr: boolean): boolean;
 export declare function stitchesSeparateAudio(planDir: string): boolean;
 export {};

package/dist/services/distributed/chunkFrames.d.ts

@@ -32,7 +32,7 @@ export declare function buildChunkCaptureOptions(input: {
         fpsDen: number;
         format: DistributedFormat;
     };
-    encoder: Pick<LockedRenderConfig, "quality" | "deviceScaleFactor" | "variables">;
+    encoder: Pick<LockedRenderConfig, "quality" | "deviceScaleFactor" | "variables" | "pageMotionBlur">;
     videoCount: number;
     html: string;
     skipReadinessVideoIds?: string[];

package/dist/services/distributed/plan.d.ts

@@ -4,6 +4,7 @@ import { type ProducerLogger } from "../../logger.js";
 import { type RenderJob, type RenderStrictness } from "../renderOrchestrator.js";
 import { type ChunkSliceJson, type PlanFileDigests } from "../render/stages/freezePlan.js";
 import { type DistributedFormat } from "./shared.js";
+import type { RenderRequestOptions } from "../../renderRequest.js";
 import { type PlanProtocolV1Descriptor } from "./planProtocol.js";
 import { type PlanSizeBreakdown } from "./planSize.js";
 /**
@@ -11,7 +12,7 @@ import { type PlanSizeBreakdown } from "./planSize.js";
  * `height`, and `format` are required; everything else carries a default
  * sensible for AWS Lambda fan-out.
  */
-export interface DistributedRenderConfig {
+export interface DistributedRenderConfig extends Pick<RenderRequestOptions, "pageMotionBlur"> {
     /** Integer frame rate. Distributed renders only accept integer fps; the in-process renderer's `Fps` rational handles NTSC. */
     fps: DistributedFps;
     width: number;

package/dist/services/htmlCompiler.d.ts

@@ -26,7 +26,7 @@ export interface CompiledComposition {
     hasAncestorBackgroundImage: boolean;
 }
 export declare function injectSdkPositionEditsRenderScript(html: string): string;
-export type RenderModeHintCode = "iframe" | "requestAnimationFrame" | "htmlInCanvas";
+export type RenderModeHintCode = "iframe" | "requestAnimationFrame" | "htmlInCanvas" | "captureMotionBlur";
 export interface RenderModeHint {
     code: RenderModeHintCode;
     message: string;
@@ -35,7 +35,7 @@ export interface RenderModeHints {
     recommendScreenshot: boolean;
     reasons: RenderModeHint[];
 }
-export declare function detectRenderModeHints(html: string): RenderModeHints;
+export declare function detectRenderModeHints(html: string, pageMotionBlur?: "off"): RenderModeHints;
 export declare function detectThreeDTransformUsage(html: string): boolean;
 /**
  * Background-image signals on ancestors of the composition root.
@@ -191,6 +191,7 @@ export interface CompileForRenderOptions {
      * `window.__hfVariables` injection covers script reads, not var() in CSS.
      */
     variables?: Record<string, unknown>;
+    pageMotionBlur?: "off";
 }
 /**
  * Compile an HTML composition project into a single self-contained HTML string

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

@@ -16,7 +16,7 @@
  * requested on one. There is nothing to reject, and threading it through the frozen plan
  * is a feature rather than a fix.
  */
-import type { MotionBlurOptions } from "@hyperframes/engine";
+import type { MotionBlurOptions, PageMotionBlurOff } from "@hyperframes/engine";
 import type { CapturePlan } from "./capturePlan.js";
 /**
  * Throw a named error when motion blur was asked for on a route that cannot deliver it.
@@ -25,3 +25,13 @@ import type { CapturePlan } from "./capturePlan.js";
  * is a render that accepts `motionBlur` and returns frames with no blur in them.
  */
 export declare function assertMotionBlurSupported(motionBlur: MotionBlurOptions | undefined, route: CapturePlan["kind"]): void;
+/**
+ * Why the page's own capture blur (`data-motion-blur="on"`) must stand down on this route, or
+ * undefined when it can run. The layered compositor screenshots each DOM layer after hiding the
+ * others; blur draws the whole composition into a canvas that those hides do not reach, so a
+ * layer comes out wrong (HDR: backgrounds and overlays lost).
+ */
+export declare function pageMotionBlurForRoute(route: {
+    hasHdrContent: boolean;
+    useLayeredComposite: boolean;
+}): PageMotionBlurOff | undefined;

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;
+    pageMotionBlur: "off" | undefined;
     captureQuality: number | undefined;
 }
 /** Everything that determines segment bytes. Key order is fixed by construction. */

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

@@ -46,4 +46,5 @@ export interface AssembleStageResult {
     /** Wall-clock ms for the assemble phase. */
     assembleMs: number;
 }
+export declare function recordLimiterAttenuation(job: RenderJob, audioLoweredDb: number | undefined): void;
 export declare function runAssembleStage(input: AssembleStageInput): Promise<AssembleStageResult>;

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

@@ -16,6 +16,7 @@
  *     `success: false`.
  *   - `perfStages.audioProcessMs` is set whether or not the call ran.
  */
+import type { Fps } from "@hyperframes/core";
 import { type AudioProcessingFailure } from "@hyperframes/engine";
 import type { CompositionMetadata } from "../shared.js";
 import type { ProducerLogger } from "../../../logger.js";
@@ -24,8 +25,9 @@ export interface AudioStageInput {
     workDir: string;
     /** `join(workDir, "compiled")`; passed through to the audio mixer for asset resolution. */
     compiledDir: string;
-    /** Composition duration (post-probe). Must be > 0 — probeStage guarantees this. */
-    duration: number;
+    /** Probed video frame count and exact frame rate define the delivered audio length. */
+    totalFrames: number;
+    fps: Fps;
     /** Timeout forwarded to ffmpeg subprocesses used by the audio mixer. */
     ffmpegProcessTimeout: number;
     /** Master gain forwarded to the audio mixer. */
@@ -34,14 +36,14 @@ export interface AudioStageInput {
     audios: CompositionMetadata["audios"];
     masterFxChain?: string;
     urlByAbsentLocalPath?: ReadonlyMap<string, string>;
-    /** Keep the float mix the AAC was encoded from here, for a later re-encode from it. */
-    keepEncoderInputAt?: string;
     abortSignal: AbortSignal | undefined;
     assertNotAborted: () => void;
     /** Where a per-track failure's detail goes. Optional so tests need not pass one. */
     log?: ProducerLogger;
 }
 export interface AudioStageResult {
+    /** Actual delivery attenuation, for the render warning and metadata. */
+    audioLoweredDb?: number;
     /** Always `join(workDir, MIXED_AUDIO_FILENAME)`. */
     audioOutputPath: string;
     /** True iff the audio mix actually produced a file. False when there are no audio elements. */

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

@@ -26,13 +26,9 @@
  *   - `job.framesRendered` is updated at every per-frame / per-progress
  *     point; `Capturing frame N/M` goes through `reportFrameProgress`.
  *
- * Known follow-up: this stage imports `executeDiskCaptureWithAdaptiveRetry`
- * from `renderOrchestrator.ts`, which itself imports the stage — a runtime
- * cycle that resolves at module-init time because no stage function is
- * invoked during load. A subsequent PR will consolidate the capture
- * helpers (`executeDiskCaptureWithAdaptiveRetry`, `countFrameRanges`,
- * `safeCleanup`, `sampleDirectoryBytes`, etc.) into a shared module so
- * the stages can import them without reaching back into the orchestrator.
+ * Known follow-up: this stage imports `executeDiskCaptureWithAdaptiveRetry` from
+ * `renderOrchestrator.ts`, which imports the stage (a cycle that resolves at module init). The
+ * capture helpers should move to a shared module so stages stop reaching back into the orchestrator.
  */
 import { type BeforeCaptureHook, type CaptureOptions, type CapturePerfSummary, type CaptureSession, type EngineConfig, type LandedFrame } from "@hyperframes/engine";
 import type { FileServerHandle } from "../../fileServer.js";
@@ -128,7 +124,6 @@ export declare function inspectDiskCaptureHeadroom(framesDir: string, totalFrame
  */
 export declare function diskCaptureRemedy(cfg: EngineConfig, outputFormat: NonNullable<RenderConfig["format"]>, durationSeconds: number, workerCount: number): string;
 export declare function diskCaptureShortfallError(needBytes: number, freeBytes: number, framesDir: string, basis: "estimate" | "measured", remedy: string): Error;
-export declare function assertDiskCaptureHeadroom(framesDir: string, totalFrames: number, captureOptions: CaptureOptions, remedy: string, freeDiskBytes?: (path: string) => number | null): void;
 /** Frame bytes written so far: the merged frames dir plus every capture attempt's worker dirs. */
 export declare function measureCaptureFrameBytes(workDir: string, framesDir: string): number;
 /** Per-frame callback: after the sample frames, throws if the projected remainder exceeds 90% of free space. */

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

@@ -80,6 +80,8 @@ export interface CompileStageInput {
     variables?: Record<string, unknown>;
     /** Absolute project paths not on disk, readable at these URLs instead. */
     urlByAbsentLocalPath?: ReadonlyMap<string, string>;
+    /** See RenderConfig.pageMotionBlur; decides whether the page renders through screenshots. */
+    pageMotionBlur?: "off";
 }
 export interface CompileStageResult {
     compiled: CompiledComposition;

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

@@ -10,11 +10,12 @@
  * has in memory.
  */
 import type { Fps } from "@hyperframes/core";
+import type { RenderRequestOptions } from "../../../renderRequest.js";
 import { type PlanDimensions } from "./planHash.js";
 /**
  * The encoder configuration locked in at plan time.
  */
-export interface LockedRenderConfig {
+export interface LockedRenderConfig extends Pick<RenderRequestOptions, "pageMotionBlur"> {
     captureMode: "beginframe" | "screenshot";
     forceScreenshot: boolean;
     deviceScaleFactor: number;

package/dist/services/renderOrchestrator.d.ts

@@ -94,6 +94,7 @@ export interface RenderConfig {
      * and JPEG samples would be averaged after a lossy quantization.
      */
     motionBlur?: MotionBlurOptions;
+    pageMotionBlur?: "off";
     workers?: number;
     useGpu?: boolean;
     debug?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.185",
+  "version": "0.8.188",
   "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.185",
-    "@hyperframes/parsers": "0.8.185",
-    "@hyperframes/studio-server": "0.8.185",
-    "@hyperframes/engine": "0.8.185",
-    "@hyperframes/core": "0.8.185"
+    "@hyperframes/engine": "0.8.188",
+    "@hyperframes/parsers": "0.8.188",
+    "@hyperframes/lint": "0.8.188",
+    "@hyperframes/core": "0.8.188",
+    "@hyperframes/studio-server": "0.8.188"
   },
   "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.185"
+    "@hyperframes/aws-lambda": "0.8.188"
   },
   "engines": {
     "node": ">=22"