@vibeframe/cli 0.53.0 → 0.55.0

package/dist/commands/_shared/scene-audio-mux.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module _shared/scene-audio-mux
+ *
+ * Lay every `<audio>` element discovered by `scene-audio-scan.ts` onto a
+ * single audio track and mux it into the producer's silent video output.
+ *
+ * Why this exists: `@hyperframes/producer` renders frames + assembles the
+ * MP4 but does not embed audio from sub-composition `<audio>` elements
+ * (verified against the upstream Hyperframes reference example). We do the
+ * mux ourselves with one ffmpeg pass, copying the producer's video stream
+ * untouched so we don't pay a re-encode tax.
+ *
+ * The filter graph for N audio inputs is:
+ *
+ *   [1:a]adelay=Sms:all=1,volume=V[a1];
+ *   [2:a]adelay=Sms:all=1,volume=V[a2];
+ *   ...
+ *   [a1][a2]...amix=inputs=N:dropout_transition=0:normalize=0[mixed]
+ *
+ * Single-input case skips the amix (cheaper and avoids amix's auto-gain).
+ *
+ * Pure construction lives in `buildAudioMuxFilter`. The async `muxAudioIntoVideo`
+ * shells out to ffmpeg via the project's existing `execSafe` wrapper.
+ */
+import type { SceneAudioElement } from "./scene-audio-scan.js";
+export interface AudioMuxFilter {
+    /** ffmpeg `-filter_complex` string. */
+    filterComplex: string;
+    /** Output stream label inside the graph (e.g. `[mixed]` or `[a0]`). */
+    outLabel: string;
+    /** Number of audio inputs the caller must `-i` before this filter. */
+    inputCount: number;
+}
+/**
+ * Build a filter_complex for the given audio elements. Pure — no I/O.
+ *
+ * Each element becomes one ffmpeg input (input index 1, 2, ... — input 0 is
+ * the silent video). `adelay` shifts the audio to its absolute timeline
+ * start, `volume` applies per-element gain, and `amix` blends them. When
+ * there's only one element we skip `amix` entirely.
+ */
+export declare function buildAudioMuxFilter(audios: SceneAudioElement[]): AudioMuxFilter | null;
+export interface AudioMuxOptions {
+    /** Producer's silent video output (will be replaced with the mux'd file). */
+    videoPath: string;
+    /** Audio elements with absolute timing, from `scanSceneAudio`. */
+    audios: SceneAudioElement[];
+    /** Final output container — drives the audio codec choice. */
+    format: "mp4" | "webm" | "mov";
+    /** Cap output to this many seconds via ffmpeg `-t`. Falls back to `videoDuration`. */
+    totalDuration?: number;
+    /** Producer's video duration (probed by ffprobe). Used as default cap. */
+    videoDuration?: number;
+    /** Callback for ffmpeg stderr lines (progress / errors). */
+    onProgress?: (line: string) => void;
+}
+export interface AudioMuxResult {
+    /** True when ffmpeg succeeded. */
+    success: boolean;
+    /** Absolute path of the produced file (overwrites the input on success). */
+    outputPath: string;
+    /** ffmpeg stderr tail when success === false. */
+    error?: string;
+    /** Number of audio inputs muxed. */
+    audioCount: number;
+}
+/**
+ * Run ffmpeg to overlay every `<audio>` element onto the producer's silent
+ * video. Replaces the input file on success. Idempotent — re-running on the
+ * same project repeats the work but produces an equivalent result.
+ *
+ * No-op (`success: true, audioCount: 0`) when `audios` is empty.
+ */
+export declare function muxAudioIntoVideo(opts: AudioMuxOptions): Promise<AudioMuxResult>;
+//# sourceMappingURL=scene-audio-mux.d.ts.map

package/dist/commands/_shared/scene-audio-mux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-mux.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-mux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,cAAc,GAAG,IAAI,CAwCtF;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC/B,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAmFtF"}

package/dist/commands/_shared/scene-audio-mux.js

@@ -0,0 +1,159 @@
+/**
+ * @module _shared/scene-audio-mux
+ *
+ * Lay every `<audio>` element discovered by `scene-audio-scan.ts` onto a
+ * single audio track and mux it into the producer's silent video output.
+ *
+ * Why this exists: `@hyperframes/producer` renders frames + assembles the
+ * MP4 but does not embed audio from sub-composition `<audio>` elements
+ * (verified against the upstream Hyperframes reference example). We do the
+ * mux ourselves with one ffmpeg pass, copying the producer's video stream
+ * untouched so we don't pay a re-encode tax.
+ *
+ * The filter graph for N audio inputs is:
+ *
+ *   [1:a]adelay=Sms:all=1,volume=V[a1];
+ *   [2:a]adelay=Sms:all=1,volume=V[a2];
+ *   ...
+ *   [a1][a2]...amix=inputs=N:dropout_transition=0:normalize=0[mixed]
+ *
+ * Single-input case skips the amix (cheaper and avoids amix's auto-gain).
+ *
+ * Pure construction lives in `buildAudioMuxFilter`. The async `muxAudioIntoVideo`
+ * shells out to ffmpeg via the project's existing `execSafe` wrapper.
+ */
+import { rename, unlink } from "node:fs/promises";
+import { resolve, dirname, extname, basename } from "node:path";
+import { execSafe, commandExists } from "../../utils/exec-safe.js";
+/**
+ * Build a filter_complex for the given audio elements. Pure — no I/O.
+ *
+ * Each element becomes one ffmpeg input (input index 1, 2, ... — input 0 is
+ * the silent video). `adelay` shifts the audio to its absolute timeline
+ * start, `volume` applies per-element gain, and `amix` blends them. When
+ * there's only one element we skip `amix` entirely.
+ */
+export function buildAudioMuxFilter(audios) {
+    if (audios.length === 0)
+        return null;
+    const labels = [];
+    const stages = [];
+    audios.forEach((a, i) => {
+        const inputIdx = i + 1; // input 0 is the video
+        const delayMs = Math.max(0, Math.round(a.absoluteStart * 1000));
+        const volume = Number.isFinite(a.volume) ? a.volume : 1;
+        // Hard-cap audio length at the parent clip's duration so a long wav
+        // doesn't bleed past its scene. Use atrim+asetpts for a clean cut.
+        const trimSec = Math.max(0, a.clipDurationCap);
+        const label = `a${i}`;
+        const stage = [
+            `[${inputIdx}:a]`,
+            `atrim=duration=${trimSec.toFixed(3)},`,
+            `asetpts=PTS-STARTPTS,`,
+            `adelay=${delayMs}:all=1,`,
+            `volume=${volume}`,
+            `[${label}]`,
+        ].join("");
+        stages.push(stage);
+        labels.push(`[${label}]`);
+    });
+    if (audios.length === 1) {
+        return {
+            filterComplex: stages.join(";"),
+            outLabel: labels[0],
+            inputCount: 1,
+        };
+    }
+    const mix = `${labels.join("")}amix=inputs=${audios.length}:dropout_transition=0:normalize=0[mixed]`;
+    return {
+        filterComplex: `${stages.join(";")};${mix}`,
+        outLabel: "[mixed]",
+        inputCount: audios.length,
+    };
+}
+/**
+ * Audio codec for each container. Stays in sync with what the upstream
+ * producer chose for video so the file stays playable.
+ */
+function audioCodecForFormat(format) {
+    if (format === "webm")
+        return "libopus";
+    if (format === "mov")
+        return "pcm_s16le"; // ProRes-friendly
+    return "aac";
+}
+/**
+ * Run ffmpeg to overlay every `<audio>` element onto the producer's silent
+ * video. Replaces the input file on success. Idempotent — re-running on the
+ * same project repeats the work but produces an equivalent result.
+ *
+ * No-op (`success: true, audioCount: 0`) when `audios` is empty.
+ */
+export async function muxAudioIntoVideo(opts) {
+    if (opts.audios.length === 0) {
+        return { success: true, outputPath: opts.videoPath, audioCount: 0 };
+    }
+    if (!commandExists("ffmpeg")) {
+        return {
+            success: false,
+            outputPath: opts.videoPath,
+            audioCount: opts.audios.length,
+            error: "ffmpeg not found in PATH — install via `brew install ffmpeg` (mac) or your package manager",
+        };
+    }
+    const filter = buildAudioMuxFilter(opts.audios);
+    if (!filter) {
+        return { success: true, outputPath: opts.videoPath, audioCount: 0 };
+    }
+    // Write to a sibling temp file then atomic-rename over the original. Avoids
+    // corrupting the producer's MP4 if ffmpeg crashes mid-write.
+    const ext = extname(opts.videoPath) || `.${opts.format}`;
+    const tmpPath = resolve(dirname(opts.videoPath), `.${basename(opts.videoPath, ext)}.muxing${ext}`);
+    const args = ["-y", "-loglevel", "error", "-i", opts.videoPath];
+    for (const a of opts.audios) {
+        args.push("-i", a.srcAbs);
+    }
+    args.push("-filter_complex", filter.filterComplex, "-map", "0:v", "-map", filter.outLabel, "-c:v", "copy", "-c:a", audioCodecForFormat(opts.format), 
+    // Cap on the video duration so audio that overruns the producer's render
+    // (e.g. a long Kokoro wav on a short scene) doesn't extend the output.
+    // Video drives the timeline because the producer already counted frames.
+    "-t", (opts.totalDuration && opts.totalDuration > 0
+        ? opts.totalDuration.toFixed(3)
+        : opts.videoDuration?.toFixed(3) ?? ""));
+    // Drop trailing empty -t value if neither override nor probe-supplied
+    // duration was provided. ffmpeg without -t falls back to its default
+    // (longest input) which is fine when -c:v copy keeps the video stream.
+    if (args[args.length - 1] === "") {
+        args.pop();
+        args.pop(); // also drop the "-t" flag
+    }
+    args.push("-movflags", "+faststart", tmpPath);
+    try {
+        const { stderr } = await execSafe("ffmpeg", args);
+        if (stderr && opts.onProgress) {
+            stderr.split(/\r?\n/).forEach((line) => opts.onProgress?.(line));
+        }
+    }
+    catch (err) {
+        // execSafe throws on non-zero exit. Surface ffmpeg's stderr if present.
+        const msg = err instanceof Error ? err.message : String(err);
+        // Best-effort cleanup of the half-written temp.
+        try {
+            await unlink(tmpPath);
+        }
+        catch { /* ignore */ }
+        return {
+            success: false,
+            outputPath: opts.videoPath,
+            audioCount: opts.audios.length,
+            error: `ffmpeg mux failed: ${msg}`,
+        };
+    }
+    await rename(tmpPath, opts.videoPath);
+    return {
+        success: true,
+        outputPath: opts.videoPath,
+        audioCount: opts.audios.length,
+    };
+}
+//# sourceMappingURL=scene-audio-mux.js.map

package/dist/commands/_shared/scene-audio-mux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-mux.js","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-mux.ts"],"names":[],"mappings":"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"}

package/dist/commands/_shared/scene-audio-mux.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for scene-audio-mux. Pure construction only — `muxAudioIntoVideo`
+ * is exercised by the C3 smoke test, not here, so CI doesn't depend on
+ * ffmpeg installation.
+ */
+export {};
+//# sourceMappingURL=scene-audio-mux.test.d.ts.map

package/dist/commands/_shared/scene-audio-mux.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-mux.test.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-mux.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/commands/_shared/scene-audio-mux.test.js

@@ -0,0 +1,94 @@
+/**
+ * Unit tests for scene-audio-mux. Pure construction only — `muxAudioIntoVideo`
+ * is exercised by the C3 smoke test, not here, so CI doesn't depend on
+ * ffmpeg installation.
+ */
+import { describe, expect, it } from "vitest";
+import { buildAudioMuxFilter } from "./scene-audio-mux.js";
+function makeAudio(overrides = {}) {
+    return {
+        srcRel: "assets/narration-1.wav",
+        srcAbs: "/proj/assets/narration-1.wav",
+        absoluteStart: 0,
+        durationHint: "auto",
+        clipDurationCap: 5,
+        volume: 1,
+        trackIndex: 2,
+        compositionSrc: "compositions/scene-1.html",
+        ...overrides,
+    };
+}
+describe("buildAudioMuxFilter", () => {
+    it("returns null for an empty list", () => {
+        expect(buildAudioMuxFilter([])).toBeNull();
+    });
+    it("single input: trim + delay + volume → labelled stream, no amix", () => {
+        const filter = buildAudioMuxFilter([makeAudio()]);
+        expect(filter).not.toBeNull();
+        expect(filter.inputCount).toBe(1);
+        expect(filter.outLabel).toBe("[a0]");
+        // Per-stage construction
+        expect(filter.filterComplex).toBe("[1:a]atrim=duration=5.000,asetpts=PTS-STARTPTS,adelay=0:all=1,volume=1[a0]");
+        // No amix
+        expect(filter.filterComplex).not.toContain("amix");
+    });
+    it("converts absoluteStart to milliseconds for adelay", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ absoluteStart: 1.234, clipDurationCap: 3 }),
+        ]);
+        expect(filter.filterComplex).toContain("adelay=1234:all=1");
+    });
+    it("preserves volume in the filter", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ volume: 0.6 }),
+        ]);
+        expect(filter.filterComplex).toContain("volume=0.6");
+    });
+    it("multi-input: builds per-stream stages plus an amix", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ absoluteStart: 0, clipDurationCap: 3 }),
+            makeAudio({
+                absoluteStart: 3,
+                clipDurationCap: 4,
+                volume: 0.8,
+                srcRel: "assets/narration-2.wav",
+                srcAbs: "/proj/assets/narration-2.wav",
+            }),
+        ]);
+        expect(filter.inputCount).toBe(2);
+        expect(filter.outLabel).toBe("[mixed]");
+        expect(filter.filterComplex).toContain("[1:a]atrim=duration=3.000,asetpts=PTS-STARTPTS,adelay=0:all=1,volume=1[a0]");
+        expect(filter.filterComplex).toContain("[2:a]atrim=duration=4.000,asetpts=PTS-STARTPTS,adelay=3000:all=1,volume=0.8[a1]");
+        expect(filter.filterComplex).toContain("[a0][a1]amix=inputs=2:dropout_transition=0:normalize=0[mixed]");
+    });
+    it("clamps negative clipDurationCap to 0", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ clipDurationCap: -1 }),
+        ]);
+        expect(filter.filterComplex).toContain("atrim=duration=0.000");
+    });
+    it("clamps negative absoluteStart to 0 in adelay", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ absoluteStart: -0.05 }),
+        ]);
+        expect(filter.filterComplex).toContain("adelay=0:all=1");
+    });
+    it("falls back to volume=1 when value is non-finite", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio({ volume: NaN }),
+        ]);
+        expect(filter.filterComplex).toContain("volume=1");
+    });
+    it("emits a deterministic label sequence (a0, a1, a2, ...)", () => {
+        const filter = buildAudioMuxFilter([
+            makeAudio(),
+            makeAudio({ absoluteStart: 1 }),
+            makeAudio({ absoluteStart: 2 }),
+        ]);
+        expect(filter.filterComplex).toContain("[a0]");
+        expect(filter.filterComplex).toContain("[a1]");
+        expect(filter.filterComplex).toContain("[a2]");
+        expect(filter.outLabel).toBe("[mixed]");
+    });
+});
+//# sourceMappingURL=scene-audio-mux.test.js.map

package/dist/commands/_shared/scene-audio-mux.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-mux.test.js","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-mux.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/_shared/scene-audio-scan.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @module _shared/scene-audio-scan
+ *
+ * Reads a scene project's root + sub-composition HTML and returns a flat list
+ * of audio elements with **absolute** timeline positions. Used by `executeSceneRender`
+ * to mux narration / background-audio tracks into the producer's silent video
+ * output via ffmpeg.
+ *
+ * Why a post-render scanner: at time of writing, `@hyperframes/producer`
+ * renders frames + assembles the MP4 but does not embed audio from
+ * `<audio>` elements that live inside sub-compositions. We pick up the slack
+ * here without touching the producer.
+ *
+ * Pure module — no I/O beyond the explicit `loadCompositionHtml` reader the
+ * orchestrator passes in. Easy to unit-test with fixture strings.
+ */
+/**
+ * One `<audio>` element resolved into an absolute-timeline entry.
+ */
+export interface SceneAudioElement {
+    /** Project-relative `src` from the audio tag (e.g. `assets/narration-intro.wav`). */
+    srcRel: string;
+    /** Absolute path on disk — `resolve(projectDir, srcRel)`. */
+    srcAbs: string;
+    /** Seconds from the start of the root timeline at which playback begins. */
+    absoluteStart: number;
+    /**
+     * Composition-supplied duration. `"auto"` means "use the file's natural
+     * duration"; the mux pass probes the file. Numeric means a hard cap.
+     */
+    durationHint: "auto" | number;
+    /** Cap from the parent scene clip — audio is trimmed to fit this many seconds. */
+    clipDurationCap: number;
+    /** `data-volume`. Defaults to `1`. */
+    volume: number;
+    /** `data-track-index` — used so callers can group narration vs music vs etc. */
+    trackIndex: number;
+    /** Composition that owns this audio element (debug aid). */
+    compositionSrc: string;
+}
+/**
+ * Parsed view of a single `<div class="clip" data-composition-src="...">`
+ * reference inside the root composition.
+ */
+export interface SceneClipRef {
+    compositionId: string;
+    compositionSrc: string;
+    start: number;
+    duration: number;
+    trackIndex: number;
+}
+/**
+ * Walk the root HTML for clip references. Returns one entry per
+ * `<div class="clip">` with the four attributes we care about. Pure: a
+ * regex-based scan, not a full DOM parser. The root file is generated by
+ * VibeFrame so the markup is predictable; if a user hand-edits it into
+ * something unparseable, the scanner simply finds fewer clips.
+ */
+export declare function parseRootClips(rootHtml: string): SceneClipRef[];
+/**
+ * Walk a single composition's HTML for `<audio>` elements. Returns one entry
+ * per element with attributes resolved into our shape. Composition-local —
+ * caller adds the parent clip's start to compute absolute timing.
+ */
+export declare function parseSceneAudios(compositionHtml: string): Array<{
+    srcRel: string;
+    localStart: number;
+    durationHint: "auto" | number;
+    volume: number;
+    trackIndex: number;
+}>;
+/** Reader hook so the scanner stays unit-testable without touching the FS. */
+export type CompositionReader = (compositionSrcRel: string) => Promise<string | null>;
+/**
+ * Default reader: read the composition file from disk relative to the
+ * project directory. Returns `null` for missing files so the scanner can
+ * skip them and continue.
+ */
+export declare function makeFsCompositionReader(projectDir: string): CompositionReader;
+/**
+ * Top-level scan. Parses every clip in the root, loads each composition,
+ * pulls every audio element, and resolves absolute timeline positions.
+ *
+ * Audio absolute start = clip.start + audio.localStart. The `clipDurationCap`
+ * is filled in from the clip's own duration so the mux pass can trim audio
+ * that runs past the visual end of its parent scene.
+ */
+export declare function scanSceneAudio(opts: {
+    projectDir: string;
+    rootHtml: string;
+    /** Override the default FS reader (testing). */
+    readComposition?: CompositionReader;
+}): Promise<SceneAudioElement[]>;
+//# sourceMappingURL=scene-audio-scan.d.ts.map

package/dist/commands/_shared/scene-audio-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-scan.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,kFAAkF;IAClF,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAmB/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,GACtB,KAAK,CAAC;IACP,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA4BD;AAED,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEtF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAS7E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,eAAe,CAAC,EAAE,iBAAiB,CAAC;CACrC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyB/B"}

package/dist/commands/_shared/scene-audio-scan.js

@@ -0,0 +1,144 @@
+/**
+ * @module _shared/scene-audio-scan
+ *
+ * Reads a scene project's root + sub-composition HTML and returns a flat list
+ * of audio elements with **absolute** timeline positions. Used by `executeSceneRender`
+ * to mux narration / background-audio tracks into the producer's silent video
+ * output via ffmpeg.
+ *
+ * Why a post-render scanner: at time of writing, `@hyperframes/producer`
+ * renders frames + assembles the MP4 but does not embed audio from
+ * `<audio>` elements that live inside sub-compositions. We pick up the slack
+ * here without touching the producer.
+ *
+ * Pure module — no I/O beyond the explicit `loadCompositionHtml` reader the
+ * orchestrator passes in. Easy to unit-test with fixture strings.
+ */
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+/**
+ * Walk the root HTML for clip references. Returns one entry per
+ * `<div class="clip">` with the four attributes we care about. Pure: a
+ * regex-based scan, not a full DOM parser. The root file is generated by
+ * VibeFrame so the markup is predictable; if a user hand-edits it into
+ * something unparseable, the scanner simply finds fewer clips.
+ */
+export function parseRootClips(rootHtml) {
+    const clips = [];
+    // Anchor on `class="clip"` and pull every relevant data attribute that
+    // appears in the same opening tag. Attribute order is not assumed.
+    const clipRegex = /<div\b[^>]*class="clip"[^>]*>/gi;
+    let match;
+    while ((match = clipRegex.exec(rootHtml)) !== null) {
+        const tag = match[0];
+        const compositionId = pickAttr(tag, "data-composition-id");
+        const compositionSrc = pickAttr(tag, "data-composition-src");
+        const start = pickNumberAttr(tag, "data-start");
+        const duration = pickNumberAttr(tag, "data-duration");
+        const trackIndex = pickNumberAttr(tag, "data-track-index") ?? 1;
+        if (!compositionId || !compositionSrc || start === null || duration === null) {
+            continue;
+        }
+        clips.push({ compositionId, compositionSrc, start, duration, trackIndex });
+    }
+    return clips;
+}
+/**
+ * Walk a single composition's HTML for `<audio>` elements. Returns one entry
+ * per element with attributes resolved into our shape. Composition-local —
+ * caller adds the parent clip's start to compute absolute timing.
+ */
+export function parseSceneAudios(compositionHtml) {
+    const out = [];
+    // `<audio>` opens may span multiple lines in our emitted HTML; capture the
+    // full open tag (everything up to `>`).
+    const audioRegex = /<audio\b([^>]*)>/gi;
+    let match;
+    while ((match = audioRegex.exec(compositionHtml)) !== null) {
+        const attrs = match[1];
+        const src = pickAttr(attrs, "src");
+        if (!src)
+            continue;
+        const localStart = pickNumberAttr(attrs, "data-start") ?? 0;
+        const durationRaw = pickAttr(attrs, "data-duration");
+        const durationHint = !durationRaw || durationRaw === "auto"
+            ? "auto"
+            : Number(durationRaw);
+        const volume = pickNumberAttr(attrs, "data-volume") ?? 1;
+        const trackIndex = pickNumberAttr(attrs, "data-track-index") ?? 2;
+        out.push({ srcRel: src, localStart, durationHint, volume, trackIndex });
+    }
+    return out;
+}
+/**
+ * Default reader: read the composition file from disk relative to the
+ * project directory. Returns `null` for missing files so the scanner can
+ * skip them and continue.
+ */
+export function makeFsCompositionReader(projectDir) {
+    return async (compositionSrcRel) => {
+        const abs = resolve(projectDir, compositionSrcRel);
+        try {
+            return await readFile(abs, "utf-8");
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/**
+ * Top-level scan. Parses every clip in the root, loads each composition,
+ * pulls every audio element, and resolves absolute timeline positions.
+ *
+ * Audio absolute start = clip.start + audio.localStart. The `clipDurationCap`
+ * is filled in from the clip's own duration so the mux pass can trim audio
+ * that runs past the visual end of its parent scene.
+ */
+export async function scanSceneAudio(opts) {
+    const reader = opts.readComposition ?? makeFsCompositionReader(opts.projectDir);
+    const clips = parseRootClips(opts.rootHtml);
+    const out = [];
+    for (const clip of clips) {
+        const html = await reader(clip.compositionSrc);
+        if (!html)
+            continue;
+        const audios = parseSceneAudios(html);
+        for (const audio of audios) {
+            out.push({
+                srcRel: audio.srcRel,
+                srcAbs: resolve(opts.projectDir, audio.srcRel),
+                absoluteStart: clip.start + audio.localStart,
+                durationHint: audio.durationHint,
+                clipDurationCap: clip.duration - audio.localStart,
+                volume: audio.volume,
+                trackIndex: audio.trackIndex,
+                compositionSrc: clip.compositionSrc,
+            });
+        }
+    }
+    // Stable sort by absolute start so downstream filter graphs are deterministic.
+    out.sort((a, b) => a.absoluteStart - b.absoluteStart);
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function pickAttr(tag, name) {
+    // Allow either single or double quotes; tolerate whitespace around `=`.
+    const re = new RegExp(`\\b${escapeRegex(name)}\\s*=\\s*("([^"]*)"|'([^']*)')`);
+    const m = tag.match(re);
+    if (!m)
+        return null;
+    return m[2] ?? m[3] ?? null;
+}
+function pickNumberAttr(tag, name) {
+    const raw = pickAttr(tag, name);
+    if (raw === null)
+        return null;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=scene-audio-scan.js.map

package/dist/commands/_shared/scene-audio-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-scan.js","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-scan.ts"],"names":[],"mappings":"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"}

package/dist/commands/_shared/scene-audio-scan.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for scene-audio-scan. Pure parsing — no fs touches via the
+ * injected `readComposition` reader.
+ */
+export {};
+//# sourceMappingURL=scene-audio-scan.test.d.ts.map

package/dist/commands/_shared/scene-audio-scan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-audio-scan.test.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-audio-scan.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}