venice-video-harness 2.4.0

package/dist/mini-drama/assembler.d.ts

@@ -0,0 +1,61 @@
+import type { ShotScript, MusicCueSpec } from '../series/types.js';
+import { type PlacementMap } from './music-cues.js';
+import type { AudioMixDefaults } from '../series/types.js';
+export interface ShotTrim {
+    shotNumber: number;
+    trimStart?: number;
+    trimEnd?: number;
+    flip?: boolean;
+}
+export interface AssemblyOptions {
+    videoFiles: string[];
+    outputPath: string;
+    srtPath?: string;
+    musicPath?: string;
+    musicVolume?: number;
+    /**
+     * ordered list of per-act music cues. When supplied (and non-empty),
+     * the assembler renders them with crossfades and uses the resulting track
+     * as the music bed in place of `musicPath`. The legacy single-bed path is
+     * preserved for back-compat.
+     */
+    musicCues?: MusicCueSpec[];
+    /**
+     * Optional shot-id placement map (string keys, zero-padded for numeric
+     * ids per ). When omitted, the assembler derives it from the
+     * normalized clip durations using each clip's filename as the shot id.
+     * Caller can pass an explicit map when the clip order doesn't match the
+     * shot ids (e.g. multi-shot bundles).
+     */
+    placementMap?: PlacementMap;
+    /**
+     * shot list used to derive musicHold automation. When omitted,
+     * automation is skipped.
+     */
+    shots?: ShotScript[];
+    /** Continuous ambient bed (e.g. rain loop) mixed under all clips for audio continuity */
+    ambientBedPath?: string;
+    ambientBedVolume?: number;
+    dialogueDir?: string;
+    nativeAudioVolume?: number;
+    /** Per-shot trim/flip metadata from script.json */
+    shotTrims?: ShotTrim[];
+    /** Optional title that fades in over the ending of the assembled episode */
+    endingTitleOverlay?: {
+        text: string;
+        fadeInSec?: number;
+        holdSec?: number;
+    };
+    /**
+     * audio-mix defaults. When supplied, a final loudnorm pass runs
+     * over the assembled master targeting `lufsTarget` integrated LUFS and
+     * `truePeakDb` dBTP. Default targets: -16 LUFS / -1 dBTP.
+     *
+     * Set to `false` (not undefined) to disable the pass explicitly — used
+     * by tests that don't want a re-encode they have to clean up.
+     */
+    audioMix?: AudioMixDefaults | false;
+}
+export declare function assembleEpisode(options: AssemblyOptions): Promise<string>;
+export declare function collectShotVideos(sceneDir: string): Promise<string[]>;
+//# sourceMappingURL=assembler.d.ts.map

package/dist/mini-drama/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/mini-drama/assembler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;CACrC;AAiJD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA8W/E;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW3E"}

package/dist/mini-drama/assembler.js

@@ -0,0 +1,466 @@
+import { readdir, mkdir } from 'node:fs/promises';
+import { join, dirname, basename } from 'node:path';
+import { existsSync, writeFileSync, unlinkSync, rmSync, copyFileSync, statSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { renderMusicCuesTrack, resolveMusicCues, buildMusicHoldExpr, applyMusicHoldAutomation, } from './music-cues.js';
+import { loudnessNormalize, resolveAudioMix } from './audio-mix.js';
+import { renameSync } from 'node:fs';
+import { dialogueFileForShot, shotKey } from './shot-paths.js';
+function runCommand(command, args) {
+    const result = spawnSync(command, args, {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    });
+    if (result.error)
+        throw result.error;
+    if (result.status !== 0) {
+        const stderr = typeof result.stderr === 'string' ? result.stderr.trim() : '';
+        const stdout = typeof result.stdout === 'string' ? result.stdout.trim() : '';
+        const detail = stderr || stdout || `exit code ${result.status}`;
+        throw new Error(`${command} failed: ${detail}`);
+    }
+    return typeof result.stdout === 'string' ? result.stdout : '';
+}
+function getVideoDuration(path) {
+    const out = runCommand('ffprobe', [
+        '-v',
+        'error',
+        '-show_entries',
+        'format=duration',
+        '-of',
+        'csv=p=0',
+        path,
+    ]).trim();
+    return parseFloat(out);
+}
+/**
+ *  fallback: derive a placement map from the post-normalization clip
+ * list when the caller didn't supply an explicit one. Each clip is expected
+ * to be named `shot-NNN.mp4` or `shot-NNNb.mp4` per  conventions.
+ *
+ * If the filename can't be parsed as a shot id, the clip is given an
+ * auto-incremented numeric key so the assembler still emits *something*
+ * rather than skipping a cue silently.
+ */
+function derivePlacementMapFromClips(clipPaths) {
+    const map = {};
+    let cursor = 0;
+    for (let i = 0; i < clipPaths.length; i++) {
+        const filename = basename(clipPaths[i], '.mp4');
+        const dur = getVideoDuration(clipPaths[i]);
+        let key;
+        const match = filename.match(/^shot-(\d+)([a-zA-Z]*)/);
+        if (match) {
+            key = String(match[1]).padStart(3, '0') + match[2];
+        }
+        else {
+            key = String(i + 1).padStart(3, '0');
+        }
+        map[key] = { startSec: cursor, endSec: cursor + dur };
+        cursor += dur;
+    }
+    return map;
+}
+/**
+ * Normalize a single clip to consistent encoding params.
+ * Kling outputs can have subtle codec/container differences that cause
+ * concat duration errors when using `-c copy`. Re-encoding to identical
+ * params (h264/aac, 24fps, 44100Hz stereo) eliminates this.
+ *
+ * Also applies trimStart, trimEnd, and flip if specified.
+ */
+function normalizeClip(inputPath, outputPath, trim) {
+    const filters = [];
+    const ffmpegArgs = ['-y'];
+    if (trim?.trimStart && trim.trimStart > 0) {
+        ffmpegArgs.push('-ss', String(trim.trimStart));
+    }
+    ffmpegArgs.push('-i', inputPath);
+    if (trim?.trimEnd && trim.trimEnd > 0) {
+        const duration = getVideoDuration(inputPath);
+        const endTime = duration - trim.trimEnd - (trim.trimStart ?? 0);
+        if (endTime > 0) {
+            ffmpegArgs.push('-t', String(endTime));
+        }
+    }
+    if (trim?.flip) {
+        filters.push('hflip');
+    }
+    if (filters.length > 0) {
+        ffmpegArgs.push('-vf', filters.join(','));
+    }
+    ffmpegArgs.push('-c:v', 'libx264', '-preset', 'fast', '-crf', '18', '-r', '24', '-c:a', 'aac', '-ar', '44100', '-ac', '2', '-b:a', '192k', outputPath);
+    runCommand('ffmpeg', ffmpegArgs);
+}
+function replaceDialogueInShot(videoPath, dialoguePath, outputPath, nativeVolume) {
+    runCommand('ffmpeg', [
+        '-y',
+        '-i',
+        videoPath,
+        '-i',
+        dialoguePath,
+        '-filter_complex',
+        `[0:a]volume=${nativeVolume}[native];[1:a]volume=1.0[tts];[native][tts]amix=inputs=2:duration=first:dropout_transition=0.5[aout]`,
+        '-map',
+        '0:v',
+        '-map',
+        '[aout]',
+        '-c:v',
+        'copy',
+        '-c:a',
+        'aac',
+        '-shortest',
+        outputPath,
+    ]);
+}
+export async function assembleEpisode(options) {
+    const { videoFiles, outputPath, srtPath, musicPath, musicVolume = 0.15, ambientBedPath, ambientBedVolume = 0.3, dialogueDir, nativeAudioVolume = 0.2, shotTrims = [], endingTitleOverlay, } = options;
+    await mkdir(dirname(outputPath), { recursive: true });
+    const trimMap = new Map(shotTrims.map(t => [t.shotNumber, t]));
+    // ── Step 1: Normalize all clips to identical encoding ──
+    const normDir = join(dirname(outputPath), '.tmp-norm');
+    await mkdir(normDir, { recursive: true });
+    console.log(`  Normalizing ${videoFiles.length} clips...`);
+    const normalizedFiles = [];
+    for (const videoPath of videoFiles) {
+        const shotName = basename(videoPath, '.mp4');
+        const shotNumStr = shotName.replace('shot-', '');
+        const shotNum = parseInt(shotNumStr, 10);
+        const normPath = join(normDir, `${shotName}.mp4`);
+        const trim = trimMap.get(shotNum);
+        const trimInfo = [];
+        if (trim?.trimStart)
+            trimInfo.push(`trim start ${trim.trimStart}s`);
+        if (trim?.trimEnd)
+            trimInfo.push(`trim end ${trim.trimEnd}s`);
+        if (trim?.flip)
+            trimInfo.push('flip');
+        normalizeClip(videoPath, normPath, trim);
+        normalizedFiles.push(normPath);
+        const info = trimInfo.length > 0 ? ` (${trimInfo.join(', ')})` : '';
+        console.log(`    ${shotName}${info}`);
+    }
+    // ── Step 2: Replace dialogue if TTS files exist ──
+    let processedFiles = normalizedFiles;
+    if (dialogueDir && existsSync(dialogueDir)) {
+        console.log(`  Replacing dialogue with Venice TTS (native audio default ${Math.round(nativeAudioVolume * 100)}%; per-shot shot.nativeAudio overrides)...`);
+        const tmpDir = join(dirname(outputPath), '.tmp-dialogue-mix');
+        await mkdir(tmpDir, { recursive: true });
+        // Build a quick lookup so per-shot `nativeAudio` overrides win.
+        const shotByKey = new Map();
+        if (options.shots) {
+            for (const s of options.shots) {
+                shotByKey.set(shotKey(s.shotNumber), s);
+                if (s.shotIdSuffix) {
+                    shotByKey.set(shotKey(`${s.shotNumber}${s.shotIdSuffix}`), s);
+                }
+            }
+        }
+        processedFiles = [];
+        let missing = 0;
+        for (const videoPath of normalizedFiles) {
+            const shotName = basename(videoPath, '.mp4');
+            // use the canonical path builder so suffixed inserts like
+            // "3b" / "3c" map to dialogue-shot-003b.mp3 / 003c.mp3. Filenames
+            // emitted by the planner are already padded, but go through the
+            // builder anyway so the contract is enforced everywhere.
+            const shotNum = shotName.replace('shot-', '');
+            const dialoguePath = dialogueFileForShot(dialogueDir, shotNum);
+            const matchingShot = shotByKey.get(shotKey(shotNum));
+            let effectiveNative = nativeAudioVolume;
+            let nativeLabel;
+            if (matchingShot?.nativeAudio === 'mute') {
+                effectiveNative = 0;
+                nativeLabel = 'mute';
+            }
+            else if (matchingShot?.nativeAudio === 'duck') {
+                effectiveNative = 0.2;
+                nativeLabel = 'duck';
+            }
+            else if (matchingShot?.nativeAudio === 'keep') {
+                effectiveNative = 1.0;
+                nativeLabel = 'keep';
+            }
+            if (existsSync(dialoguePath)) {
+                const processedPath = join(tmpDir, `${shotName}-voiced.mp4`);
+                replaceDialogueInShot(videoPath, dialoguePath, processedPath, effectiveNative);
+                processedFiles.push(processedPath);
+                const label = nativeLabel ? ` native=${nativeLabel}` : '';
+                console.log(`    ${shotName}: dialogue replaced (${shotKey(shotNum)})${label}`);
+            }
+            else {
+                processedFiles.push(videoPath);
+                // Warn loudly on fall-through. Without this, every `existsSync`
+                // returning false silently lets the master ship with the
+                // corresponding narration missing — a class of silent-failure bug
+                // that's only caught by a human reviewing the rendered audio.
+                console.warn(`    ${shotName}: no dialogue file at ${dialoguePath} — using native audio`);
+                missing += 1;
+            }
+        }
+        if (missing > 0) {
+            console.warn(`  ${missing} shot(s) had no dialogue track. Verify intent — the placement loop falls through silently otherwise.`);
+        }
+    }
+    // ── Step 3: Concatenate ──
+    const concatPath = join(normDir, 'concat.txt');
+    const lines = processedFiles.map(f => `file '${f}'`).join('\n');
+    writeFileSync(concatPath, lines, 'utf-8');
+    const concatenatedPath = outputPath.replace(/\.mp4$/, '-raw.mp4');
+    runCommand('ffmpeg', [
+        '-y',
+        '-f',
+        'concat',
+        '-safe',
+        '0',
+        '-i',
+        concatPath,
+        '-c',
+        'copy',
+        '-movflags',
+        '+faststart',
+        concatenatedPath,
+    ]);
+    const concatDur = getVideoDuration(concatenatedPath);
+    console.log(`  Concatenated ${processedFiles.length} clips -> ${concatDur.toFixed(1)}s`);
+    let currentInput = concatenatedPath;
+    // ── Step 3.5: Build the per-act music bed ( / ) ──
+    // When `musicCues` are supplied, render an ordered ffmpeg crossfade track
+    // and use it as the music bed in place of `musicPath`. The legacy single-
+    // bed path is preserved when no cues are supplied. musicHold automation is
+    // layered on top via a `volume=` expression so cue audio doesn't have to
+    // be re-rendered when only the automation changes.
+    let effectiveMusicPath = musicPath;
+    if (options.musicCues && options.musicCues.length > 0) {
+        const placementMap = options.placementMap ?? derivePlacementMapFromClips(processedFiles);
+        const resolved = resolveMusicCues(options.musicCues, placementMap, cue => cue.audioPath);
+        if (resolved.length > 0) {
+            const cuesTrackPath = outputPath.replace(/\.mp4$/, '-music-cues.mp3');
+            await renderMusicCuesTrack({
+                cues: resolved,
+                outputPath: cuesTrackPath,
+                totalDurationSec: concatDur,
+                placementMap,
+            });
+            let bedPath = cuesTrackPath;
+            if (options.shots) {
+                const holdExpr = buildMusicHoldExpr(options.shots, placementMap);
+                if (holdExpr) {
+                    const automatedPath = outputPath.replace(/\.mp4$/, '-music-cues-auto.mp3');
+                    await applyMusicHoldAutomation({
+                        inputPath: cuesTrackPath,
+                        outputPath: automatedPath,
+                        volumeExpr: holdExpr,
+                    });
+                    bedPath = automatedPath;
+                    console.log(`  Applied musicHold automation (${holdExpr.length} chars)`);
+                }
+            }
+            effectiveMusicPath = bedPath;
+            console.log(`  Music cues: ${resolved.length} segment(s) crossfaded -> ${basename(bedPath)}`);
+        }
+        else {
+            console.warn('  Music cues: no cues resolved against placement map; falling back to musicPath.');
+        }
+    }
+    // ── Step 4: Mix in ambient bed (looped to duration) ──
+    if (ambientBedPath && existsSync(ambientBedPath)) {
+        const withAmbientPath = outputPath.replace(/\.mp4$/, '-with-ambient.mp4');
+        // Loop the ambient clip to cover full video duration, mix under native audio
+        runCommand('ffmpeg', [
+            '-y',
+            '-i',
+            currentInput,
+            '-stream_loop',
+            '-1',
+            '-i',
+            ambientBedPath,
+            '-filter_complex',
+            `[1:a]volume=${ambientBedVolume}[ambient];[0:a][ambient]amix=inputs=2:duration=first:dropout_transition=2[aout]`,
+            '-map',
+            '0:v',
+            '-map',
+            '[aout]',
+            '-c:v',
+            'copy',
+            '-c:a',
+            'aac',
+            withAmbientPath,
+        ]);
+        console.log(`  Mixed in ambient bed at ${Math.round(ambientBedVolume * 100)}% volume (looped)`);
+        currentInput = withAmbientPath;
+    }
+    // ── Step 5: Mix in background music ──
+    // Per , when music cues were used, their per-cue gain (-22 dB by
+    // default) is already baked into `effectiveMusicPath`. Skip the extra
+    // `volume=musicVolume` multiplier in that case to avoid double-attenuating.
+    if (effectiveMusicPath && existsSync(effectiveMusicPath)) {
+        const withMusicPath = outputPath.replace(/\.mp4$/, '-with-music.mp4');
+        const cuesBaked = effectiveMusicPath !== musicPath;
+        const musicFilter = cuesBaked
+            ? `[0:a][1:a]amix=inputs=2:duration=first:dropout_transition=2[aout]`
+            : `[1:a]volume=${musicVolume}[music];[0:a][music]amix=inputs=2:duration=first:dropout_transition=2[aout]`;
+        runCommand('ffmpeg', [
+            '-y',
+            '-i',
+            currentInput,
+            '-i',
+            effectiveMusicPath,
+            '-filter_complex',
+            musicFilter,
+            '-map',
+            '0:v',
+            '-map',
+            '[aout]',
+            '-c:v',
+            'copy',
+            '-c:a',
+            'aac',
+            withMusicPath,
+        ]);
+        const label = cuesBaked ? 'cues-baked' : `${Math.round(musicVolume * 100)}% volume`;
+        console.log(`  Mixed in background music (${label})`);
+        currentInput = withMusicPath;
+    }
+    // ── Step 5.5: Fade title over the ending of the last shot ──
+    if (endingTitleOverlay?.text?.trim()) {
+        const withTitlePath = outputPath.replace(/\.mp4$/, '-with-title.mp4');
+        const totalDuration = getVideoDuration(currentInput);
+        const fadeInSec = endingTitleOverlay.fadeInSec ?? 1.2;
+        const holdSec = endingTitleOverlay.holdSec ?? 1.8;
+        const overlayStart = Math.max(0, totalDuration - holdSec);
+        const escapedText = endingTitleOverlay.text.replace(/'/g, "\\'").replace(/:/g, '\\:');
+        const fontPath = '/System/Library/Fonts/Supplemental/Arial Bold.ttf';
+        const titleFilter = [
+            `drawtext=fontfile='${fontPath}':text='${escapedText}':fontcolor=0xD66BFF@0.22:fontsize=104:x=(w-text_w)/2:y=(h-text_h)/2:alpha='if(lt(t,${overlayStart}),0,if(lt(t,${overlayStart + fadeInSec}),(t-${overlayStart})/${fadeInSec},1))'`,
+            `drawtext=fontfile='${fontPath}':text='${escapedText}':fontcolor=0x7EF9FF@0.35:fontsize=98:x=(w-text_w)/2:y=(h-text_h)/2:alpha='if(lt(t,${overlayStart}),0,if(lt(t,${overlayStart + fadeInSec}),(t-${overlayStart})/${fadeInSec},1))'`,
+            `drawtext=fontfile='${fontPath}':text='${escapedText}':fontcolor=white:fontsize=92:x=(w-text_w)/2:y=(h-text_h)/2:alpha='if(lt(t,${overlayStart}),0,if(lt(t,${overlayStart + fadeInSec}),(t-${overlayStart})/${fadeInSec},1))'`,
+        ].join(',');
+        runCommand('ffmpeg', [
+            '-y',
+            '-i',
+            currentInput,
+            '-vf',
+            titleFilter,
+            '-c:v',
+            'libx264',
+            '-preset',
+            'fast',
+            '-crf',
+            '18',
+            '-c:a',
+            'copy',
+            withTitlePath,
+        ]);
+        console.log(`  Faded in ending title "${endingTitleOverlay.text}" over final ${holdSec.toFixed(1)}s`);
+        currentInput = withTitlePath;
+    }
+    // ── Step 6: Burn subtitles ──
+    if (srtPath && existsSync(srtPath)) {
+        // Save no-subtitles version as backup
+        const noSubsPath = outputPath.replace(/\.mp4$/, '-nosubs.mp4');
+        copyFileSync(currentInput, noSubsPath);
+        const escapedSrt = srtPath.replace(/'/g, "'\\''").replace(/:/g, '\\:');
+        const subtitleFilter = [
+            `subtitles='${escapedSrt}'`,
+            `:force_style='`,
+            `FontName=D-DIN Condensed,`,
+            `FontSize=11,`,
+            `PrimaryColour=&H00FFFFFF,`,
+            `OutlineColour=&H00000000,`,
+            `BorderStyle=1,`,
+            `Outline=0.8,`,
+            `Shadow=0,`,
+            `Alignment=2,`,
+            `MarginV=100,`,
+            `Spacing=0.5`,
+            `'`,
+        ].join('');
+        runCommand('ffmpeg', [
+            '-y',
+            '-i',
+            currentInput,
+            '-vf',
+            subtitleFilter,
+            '-c:v',
+            'libx264',
+            '-preset',
+            'fast',
+            '-crf',
+            '18',
+            '-c:a',
+            'copy',
+            outputPath,
+        ]);
+        console.log(`  Burned subtitles (backup at ${basename(noSubsPath)})`);
+    }
+    else {
+        if (currentInput !== outputPath) {
+            copyFileSync(currentInput, outputPath);
+        }
+    }
+    // ── Cleanup ──
+    try {
+        if (existsSync(normDir))
+            rmSync(normDir, { recursive: true, force: true });
+        if (existsSync(concatenatedPath))
+            unlinkSync(concatenatedPath);
+        const withAmbientPath = outputPath.replace(/\.mp4$/, '-with-ambient.mp4');
+        if (existsSync(withAmbientPath))
+            unlinkSync(withAmbientPath);
+        const withMusicPath = outputPath.replace(/\.mp4$/, '-with-music.mp4');
+        if (existsSync(withMusicPath))
+            unlinkSync(withMusicPath);
+        const withTitlePath = outputPath.replace(/\.mp4$/, '-with-title.mp4');
+        if (existsSync(withTitlePath))
+            unlinkSync(withTitlePath);
+        const tmpDialogue = join(dirname(outputPath), '.tmp-dialogue-mix');
+        if (existsSync(tmpDialogue))
+            rmSync(tmpDialogue, { recursive: true, force: true });
+    }
+    catch { /* best-effort */ }
+    // ── Step 7:  final loudness pass ──
+    // Targets -16 LUFS / -1 dBTP by default. Skipped when audioMix === false.
+    if (options.audioMix !== false) {
+        const mix = resolveAudioMix(options.audioMix);
+        const preLoudPath = outputPath.replace(/\.mp4$/, '-pre-loudnorm.mp4');
+        try {
+            renameSync(outputPath, preLoudPath);
+            await loudnessNormalize({
+                inputPath: preLoudPath,
+                outputPath,
+                audioMix: options.audioMix,
+                videoInput: true,
+            });
+            unlinkSync(preLoudPath);
+            console.log(`  Loudness normalized to ${mix.lufsTarget} LUFS / TP ${mix.truePeakDb} dBTP`);
+        }
+        catch (err) {
+            // If loudnorm fails (e.g. ffmpeg lacks the filter on this system),
+            // restore the pre-loudnorm master rather than leaving a half-rename
+            // mess. Surface the error so the user knows to install a newer ffmpeg.
+            if (existsSync(preLoudPath) && !existsSync(outputPath)) {
+                renameSync(preLoudPath, outputPath);
+            }
+            console.warn(`  ⚠ Loudness pass failed: ${err.message}. Delivered un-normalized master.`);
+        }
+    }
+    const finalDur = getVideoDuration(outputPath);
+    const finalBytes = statSync(outputPath).size;
+    const finalSizeMb = (finalBytes / (1024 * 1024)).toFixed(1);
+    console.log(`  Final episode: ${outputPath} (${finalDur.toFixed(1)}s, ${finalSizeMb} MB)`);
+    return outputPath;
+}
+export async function collectShotVideos(sceneDir) {
+    if (!existsSync(sceneDir))
+        return [];
+    const entries = await readdir(sceneDir);
+    // Suffixed inserts (shot-003b.mp4) must be included and sort correctly:
+    // "shot-003" < "shot-003b" < "shot-004" lexicographically, so a plain
+    // sort keeps episode order.
+    return entries
+        .filter(f => /^shot-\d{3}[a-z]?\.mp4$/.test(f))
+        .sort()
+        .map(f => join(sceneDir, f));
+}
+//# sourceMappingURL=assembler.js.map

package/dist/mini-drama/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../../src/mini-drama/assembler.ts"],"names":[],"mappings":"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"}

package/dist/mini-drama/audio-mix.d.ts

@@ -0,0 +1,65 @@
+import type { AudioMixDefaults } from '../series/types.js';
+export declare const DEFAULT_SFX_MAX_DURATION_SEC = 2;
+export declare const DEFAULT_SFX_FADE_OUT_SEC = 0.3;
+export declare const DEFAULT_DIALOGUE_GAIN_DB = 0;
+export declare const DEFAULT_MUSIC_GAIN_DB = -22;
+export declare const DEFAULT_SFX_GAIN_DB = -16;
+export declare const DEFAULT_LUFS_TARGET = -16;
+export declare const DEFAULT_TRUE_PEAK_DB = -1;
+/** Resolve a partial audio-mix config to a fully populated one. */
+export declare function resolveAudioMix(defaults?: AudioMixDefaults): Required<AudioMixDefaults>;
+export interface SfxTrimOptions {
+    /** Override the global max duration for this specific clip (e.g. ambient SFX). */
+    maxDurationSec?: number;
+    /** Override the fade-out duration for this clip. */
+    fadeOutSec?: number;
+}
+/**
+ * Trim a single SFX clip and apply a fade-out.
+ *
+ * Raw SFX clips from elevenlabs-sound-effects-v2 are 3-6 seconds long.
+ * Without trimming, fire crackle bleeds across cuts and panic shouts overlap
+ * dialogue. The fade-out is short (0.3s) — long enough to avoid a click,
+ * short enough to keep the SFX feeling punchy.
+ */
+export declare function trimAndFadeSfx(opts: {
+    inputPath: string;
+    outputPath: string;
+    options?: SfxTrimOptions;
+    globalDefaults?: AudioMixDefaults;
+}): Promise<string>;
+/**
+ * Apply trim+fade to every SFX clip in a directory.
+ *
+ * - The output directory mirrors the input layout.
+ * - Per-clip overrides can be supplied via the `perFile` map keyed on the
+ *   clip basename (e.g. `"fire-crackle.mp3"`) — useful for ambient SFX that
+ *   need a longer max duration than the global default.
+ * - Returns the list of output paths in input order.
+ */
+export declare function trimAndFadeSfxBatch(opts: {
+    inputPaths: string[];
+    outputDir: string;
+    perFile?: Record<string, SfxTrimOptions>;
+    globalDefaults?: AudioMixDefaults;
+}): Promise<string[]>;
+/**
+ * Final loudness normalization to a target integrated LUFS and true-peak
+ * ceiling. Uses ffmpeg's `loudnorm` filter (EBU R128 implementation).
+ *
+ * Two-pass loudnorm is more accurate but the single-pass form is fine for
+ * a final delivery encode — the input is already at a reasonable level
+ * after upstream gain decisions, and `loudnorm` will only nudge the
+ * envelope, not crush it.
+ */
+export declare function loudnessNormalize(opts: {
+    inputPath: string;
+    outputPath: string;
+    audioMix?: AudioMixDefaults;
+    /**
+     * When the input is a video file, set this to copy the video stream
+     * instead of re-encoding it. Defaults to false (input treated as audio).
+     */
+    videoInput?: boolean;
+}): Promise<string>;
+//# sourceMappingURL=audio-mix.d.ts.map

package/dist/mini-drama/audio-mix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.d.ts","sourceRoot":"","sources":["../../src/mini-drama/audio-mix.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,eAAO,MAAM,4BAA4B,IAAM,CAAC;AAChD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAWvF;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalB"}