@hyperframes/producer 0.9.14 → 0.9.16

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

@@ -44,6 +44,8 @@ export interface PadTrimAudioInput {
     audioPath: string;
     /** Path the helper writes the duration-corrected audio to. */
     outputPath: string;
+    /** The PCM `audioPath` was encoded from: a pad, trim or peak correction encodes it instead of decoding the AAC. */
+    sourcePath?: string;
     signal?: AbortSignal;
     /** Deadline for each ffmpeg process; defaults to the engine's `ffmpegProcessTimeout`. */
     timeoutMs?: number;
@@ -126,12 +128,16 @@ export declare function constrainAacTruePeak(input: {
     timeoutMs?: number;
     probeTruePeakDbfs?: (audioPath: string, signal?: AbortSignal) => Promise<number>;
     encodeAac?: AacEncoder;
+    rewriteSource?: SourceRewriter;
 }): Promise<{
     success: boolean;
     error?: string;
     failureReason?: "external_interruption";
     loweredDb?: number;
+    sourceStale?: true;
 }>;
+/** Writes `sourcePath` through `filter` to `outputPath` as float PCM. */
+type SourceRewriter = (sourcePath: string, outputPath: string, filter: string) => Promise<StepResult>;
 export declare function defaultProbeVideoFrameInfo(videoPath: string, signal?: AbortSignal): Promise<ProbeVideoFrameInfo>;
 export declare function runFfprobeJson<T>(args: string[], signal?: AbortSignal): Promise<T>;
 export {};

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

@@ -27,6 +27,7 @@ export interface AssembleStageInput {
     videoOnlyPath: string;
     /** Mixed audio path (only read when `hasAudio` is true). */
     audioOutputPath: string;
+    audioPcmPath?: string;
     /** Final on-disk output. A directory when `format` is `"hls"`. */
     outputPath: string;
     hasAudio: boolean;

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

@@ -41,12 +41,16 @@ export interface AudioStageInput {
     assertNotAborted: () => void;
     /** Where a per-track failure's detail goes. Optional so tests need not pass one. */
     log?: ProducerLogger;
+    /** Leave the delivered PCM in `workDir` for the assemble stage; its owner removes the dir. */
+    keepDeliverySource?: boolean;
 }
 export interface AudioStageResult {
     /** Actual delivery attenuation, for the render warning and metadata. */
     audioLoweredDb?: number;
     /** Always `join(workDir, MIXED_AUDIO_FILENAME)`. */
     audioOutputPath: string;
+    /** The PCM `audioOutputPath` encodes, when `keepDeliverySource` asked for it. */
+    deliverySourcePath?: string;
     /** True iff the audio mix actually produced a file. False when there are no audio elements. */
     hasAudio: boolean;
     /** Wall-clock ms for the audio mix phase. Zero-elements path is near-zero but always set. */

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

@@ -42,9 +42,7 @@ import type { RenderJob } from "../../renderOrchestrator.js";
 export interface CompileStageInput {
     projectDir: string;
     workDir: string;
-    /** Absolute path to the entry HTML (already resolved to standalone-entry if needed). */
-    htmlPath: string;
-    /** The relative `entryFile` string, used only for log payloads. */
+    /** Entry HTML relative to `projectDir`; a `<template>` sub-composition is isolated inside the index shell. */
     entryFile: string;
     job: RenderJob;
     /**
@@ -104,4 +102,15 @@ export interface CompileStageResult {
      * `3d` | `ancestor_background_image` | `shader_transitions`. Undefined when none fired. */
     deCompileGate?: string;
 }
+/**
+ * The HTML file to compile for `entryFile`. A `<template>`-wrapped
+ * sub-composition has no live root, timeline or duration of its own, so it is
+ * rendered through the project's index.html shell with only its mount host kept.
+ */
+export declare function resolveEntryHtmlPath(input: {
+    projectDir: string;
+    workDir: string;
+    entryFile: string;
+    log: ProducerLogger;
+}): string;
 export declare function runCompileStage(input: CompileStageInput): Promise<CompileStageResult>;

package/dist/services/renderOrchestrator.d.ts

@@ -1,5 +1,5 @@
 import { type CanvasResolution, type Fps, type FpsInput, type HfVfxCapture } from "@hyperframes/core";
-import { type EngineConfig, type ExtractionPhaseBreakdown, type VideoFrameFormat, type CaptureOptions, type CaptureVideoMetadataHint, type CaptureSession, type BeforeCaptureHook, type ProresProfile, type ParallelProgress, type WorkerTask, type CapturePerfSummary, type CaptureWarning, type SubTimelineWaitOutcome, type WorkerSizing, type StaticVerificationOutcome, explainDrawElementDisabled, type CaptureFailureKind, type MotionBlurOptions } from "@hyperframes/engine";
+import { type EngineConfig, type ExtractionPhaseBreakdown, type VideoFrameFormat, type CaptureOptions, type CaptureVideoMetadataHint, type CaptureSession, type BeforeCaptureHook, type ProresProfile, type ParallelProgress, type WorkerTask, type CapturePerfSummary, type CaptureWarning, type SubTimelineWaitOutcome, type WorkerSizing, type StaticVerificationOutcome, explainDrawElementDisabled, type CaptureFailureKind, displaySize, type MotionBlurOptions } from "@hyperframes/engine";
 import { type ReferenceBackgroundResult } from "@hyperframes/engine";
 import { type ProducerLogger } from "../logger.js";
 import { type RenderOutputFormat } from "./render/renderFormat.js";
@@ -480,10 +480,7 @@ export declare function createRenderFileLogger(logPath: string, base?: ProducerL
 export declare function collectVideoReadinessSkipIds(nativeHdrVideoIds: ReadonlySet<string>, extractedVideos: readonly ExtractedVideoReadinessInput[]): string[];
 interface ExtractedVideoReadinessInput {
     videoId: string;
-    metadata: {
-        width: number;
-        height: number;
-    };
+    metadata: Parameters<typeof displaySize>[0];
 }
 export declare function collectVideoMetadataHints(extractedVideos: readonly ExtractedVideoReadinessInput[]): CaptureVideoMetadataHint[];
 export declare function findMissingFrameRanges(totalFrames: number, framesDir: string, frameExt: "jpg" | "png"): FrameRange[];

package/package.json

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