videoclaw 3.0.0-alpha.1

package/dist/video/assemble/audio-concat.js.map

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

package/dist/video/assemble/audio-mix-plan.d.ts

@@ -0,0 +1,84 @@
+/**
+ * audio-mix-plan.ts — PURE multi-layer audio mix-plan helper.
+ *
+ * Composes project audio inputs (music, narration, dialogue, sfx) into the
+ * {@link AudioLayer}[] shape consumed by {@link buildMultiLayerMixArgs} in
+ * stitch.ts. No filesystem access, no network calls, no side-effects.
+ *
+ * stitch.ts's `AudioLayer.role` union natively includes `'sfx'`, so this module
+ * re-exports the base type directly — `'sfx'` layers produced here are mixed in
+ * (never used as a ducking sidechain) by `buildMultiLayerMixArgs`.
+ */
+import type { AudioLayer as BaseAudioLayer } from './stitch.js';
+/**
+ * Re-export of stitch.ts's {@link AudioLayer} (whose `role` union already
+ * includes `'sfx'`). Output of {@link buildAudioLayers} is therefore directly
+ * assignable to {@link buildMultiLayerMixArgs}'s `layers` parameter.
+ */
+export type AudioLayer = BaseAudioLayer;
+/**
+ * All optional audio paths for a single project mix.
+ * Absent fields are simply skipped when building the layer list.
+ */
+export interface AudioMixInputs {
+    /** Path to background-music bed (looped at low volume). */
+    musicPath?: string;
+    /** Path to voice-over narration track. */
+    narrationPath?: string;
+    /** Paths to on-screen dialogue tracks (one entry per track). */
+    dialoguePaths?: string[];
+    /** Paths to sound-effect tracks. */
+    sfxPaths?: string[];
+}
+export interface AudioMixPlanOptions {
+    /**
+     * Volume for music layers (0..1).
+     * Passed through to {@link BuildMultiLayerMixOptions}.musicVolume.
+     * Default: 0.05 (matches stitch.ts DEFAULT_MUSIC_VOLUME).
+     */
+    musicVolume?: number;
+    /**
+     * Volume for sfx layers (0..1).
+     * Default: 0.6.
+     */
+    sfxVolume?: number;
+    /**
+     * When true, music will be sidechained under narration/dialogue.
+     * Forwarded to {@link BuildMultiLayerMixOptions}.duckMusicUnderVoice.
+     * Default: false.
+     */
+    duckMusicUnderVoice?: boolean;
+}
+/**
+ * Convert a flat {@link AudioMixInputs} map into the ordered {@link AudioLayer}[]
+ * that {@link buildMultiLayerMixArgs} consumes.
+ *
+ * Layer ordering: music → narration → dialogue (in order) → sfx (in order).
+ * Absent inputs produce no layers. Deterministic and side-effect-free.
+ */
+export declare function buildAudioLayers(inputs: AudioMixInputs, opts?: AudioMixPlanOptions): AudioLayer[];
+export interface MultiLayerMixPlan {
+    /** Ordered layers ready to pass to buildMultiLayerMixArgs. */
+    layers: AudioLayer[];
+    /**
+     * Whether music ducking is requested.
+     * Pass as BuildMultiLayerMixOptions.duckMusicUnderVoice.
+     */
+    duckMusicUnderVoice: boolean;
+}
+/**
+ * Convenience wrapper that returns both the layer list and the ducking flag
+ * so a future assemble-wiring is a single destructure.
+ *
+ * ```ts
+ * const { layers, duckMusicUnderVoice } = planMultiLayerMix(videoPath, inputs, opts);
+ * const args = buildMultiLayerMixArgs(videoPath, layers, outputPath, {
+ *   duckMusicUnderVoice,
+ *   musicVolume: opts?.musicVolume,
+ * });
+ * ```
+ *
+ * **Not wired into assemble.ts** — called only by future callers.
+ */
+export declare function planMultiLayerMix(_videoPath: string, inputs: AudioMixInputs, opts?: AudioMixPlanOptions): MultiLayerMixPlan;
+//# sourceMappingURL=audio-mix-plan.d.ts.map

package/dist/video/assemble/audio-mix-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix-plan.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/audio-mix-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AAMxC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,mBAAwB,GAC7B,UAAU,EAAE,CAoCd;AAMD,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB;;;OAGG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,mBAAwB,GAC7B,iBAAiB,CAKnB"}

package/dist/video/assemble/audio-mix-plan.js

@@ -0,0 +1,74 @@
+/**
+ * audio-mix-plan.ts — PURE multi-layer audio mix-plan helper.
+ *
+ * Composes project audio inputs (music, narration, dialogue, sfx) into the
+ * {@link AudioLayer}[] shape consumed by {@link buildMultiLayerMixArgs} in
+ * stitch.ts. No filesystem access, no network calls, no side-effects.
+ *
+ * stitch.ts's `AudioLayer.role` union natively includes `'sfx'`, so this module
+ * re-exports the base type directly — `'sfx'` layers produced here are mixed in
+ * (never used as a ducking sidechain) by `buildMultiLayerMixArgs`.
+ */
+// ---------------------------------------------------------------------------
+// buildAudioLayers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a flat {@link AudioMixInputs} map into the ordered {@link AudioLayer}[]
+ * that {@link buildMultiLayerMixArgs} consumes.
+ *
+ * Layer ordering: music → narration → dialogue (in order) → sfx (in order).
+ * Absent inputs produce no layers. Deterministic and side-effect-free.
+ */
+export function buildAudioLayers(inputs, opts = {}) {
+    const { musicVolume = 0.05, sfxVolume = 0.6 } = opts;
+    const layers = [];
+    if (inputs.musicPath) {
+        layers.push({
+            trackPath: inputs.musicPath,
+            role: 'music',
+            volume: musicVolume,
+            loop: true,
+        });
+    }
+    if (inputs.narrationPath) {
+        layers.push({
+            trackPath: inputs.narrationPath,
+            role: 'narration',
+        });
+    }
+    for (const dp of inputs.dialoguePaths ?? []) {
+        layers.push({
+            trackPath: dp,
+            role: 'dialogue',
+        });
+    }
+    for (const sp of inputs.sfxPaths ?? []) {
+        layers.push({
+            trackPath: sp,
+            role: 'sfx',
+            volume: sfxVolume,
+        });
+    }
+    return layers;
+}
+/**
+ * Convenience wrapper that returns both the layer list and the ducking flag
+ * so a future assemble-wiring is a single destructure.
+ *
+ * ```ts
+ * const { layers, duckMusicUnderVoice } = planMultiLayerMix(videoPath, inputs, opts);
+ * const args = buildMultiLayerMixArgs(videoPath, layers, outputPath, {
+ *   duckMusicUnderVoice,
+ *   musicVolume: opts?.musicVolume,
+ * });
+ * ```
+ *
+ * **Not wired into assemble.ts** — called only by future callers.
+ */
+export function planMultiLayerMix(_videoPath, inputs, opts = {}) {
+    return {
+        layers: buildAudioLayers(inputs, opts),
+        duckMusicUnderVoice: opts.duckMusicUnderVoice ?? false,
+    };
+}
+//# sourceMappingURL=audio-mix-plan.js.map

package/dist/video/assemble/audio-mix-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix-plan.js","sourceRoot":"","sources":["../../../src/video/assemble/audio-mix-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkDH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,OAA4B,EAAE;IAE9B,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;IACrD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,MAAM,CAAC,aAAa;YAC/B,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAgBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,MAAsB,EACtB,OAA4B,EAAE;IAE9B,OAAO;QACL,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC;QACtC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,IAAI,KAAK;KACvD,CAAC;AACJ,CAAC"}

package/dist/video/assemble/audio-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ElevenLabs `output_format` values we accept. Each maps to a container/
+ * codec + sample-rate + bitrate. The Python CLI takes a free string, but we
+ * validate against the documented ElevenLabs set so a typo surfaces as a
+ * clean `invalid_audio_format` error rather than an opaque API 4xx.
+ */
+export declare const VALID_OUTPUT_FORMATS: readonly ["mp3_22050_32", "mp3_44100_32", "mp3_44100_64", "mp3_44100_96", "mp3_44100_128", "mp3_44100_192", "pcm_8000", "pcm_16000", "pcm_22050", "pcm_24000", "pcm_44100", "pcm_48000", "ulaw_8000", "alaw_8000", "opus_48000_32", "opus_48000_64", "opus_48000_96", "opus_48000_128", "opus_48000_192"];
+export type OutputFormat = typeof VALID_OUTPUT_FORMATS[number];
+export declare const DEFAULT_OUTPUT_FORMAT: OutputFormat;
+/**
+ * Validate an ElevenLabs output-format string. Returns the normalized format
+ * on success; throws `VclawError('invalid_audio_format', ...)` otherwise.
+ */
+export declare function validateOutputFormat(format: string): OutputFormat;
+/**
+ * The file extension that corresponds to a given output format
+ * (mp3 -> mp3, pcm/ulaw/alaw -> wav, opus -> opus).
+ */
+export declare function extensionForFormat(format: string): string;
+/**
+ * Derive a per-scene audio filename. Scene indexes are 1-based in the
+ * transcript / on disk to mirror the Python pipeline's `scene_NN` naming.
+ */
+export declare function sceneAudioFilename(sceneIndex: number, format: string): string;
+/** Filename for the combined narration track. */
+export declare function combinedNarrationFilename(format: string): string;
+/**
+ * Format a duration (milliseconds) as `MM:SS.mmm` for human-readable logs
+ * and report entries.
+ */
+export declare function formatDuration(durationMs: number): string;
+//# sourceMappingURL=audio-utils.d.ts.map

package/dist/video/assemble/audio-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-utils.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/audio-utils.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,2SAoBvB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,qBAAqB,EAAE,YAA8B,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CASjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAczD"}

package/dist/video/assemble/audio-utils.js

@@ -0,0 +1,91 @@
+/**
+ * Pure audio helpers for the assemble stage (no I/O).
+ *
+ * Ported from the validation/derivation logic in
+ * `skills/video-replicator/scripts/generate_tts.py`. Everything here is
+ * deterministic + unit-testable; network and filesystem work lives in
+ * `tts.ts` / `tts-elevenlabs.ts`.
+ */
+import { VclawError } from '../errors.js';
+/**
+ * ElevenLabs `output_format` values we accept. Each maps to a container/
+ * codec + sample-rate + bitrate. The Python CLI takes a free string, but we
+ * validate against the documented ElevenLabs set so a typo surfaces as a
+ * clean `invalid_audio_format` error rather than an opaque API 4xx.
+ */
+export const VALID_OUTPUT_FORMATS = [
+    'mp3_22050_32',
+    'mp3_44100_32',
+    'mp3_44100_64',
+    'mp3_44100_96',
+    'mp3_44100_128',
+    'mp3_44100_192',
+    'pcm_8000',
+    'pcm_16000',
+    'pcm_22050',
+    'pcm_24000',
+    'pcm_44100',
+    'pcm_48000',
+    'ulaw_8000',
+    'alaw_8000',
+    'opus_48000_32',
+    'opus_48000_64',
+    'opus_48000_96',
+    'opus_48000_128',
+    'opus_48000_192',
+];
+export const DEFAULT_OUTPUT_FORMAT = 'mp3_44100_128';
+/**
+ * Validate an ElevenLabs output-format string. Returns the normalized format
+ * on success; throws `VclawError('invalid_audio_format', ...)` otherwise.
+ */
+export function validateOutputFormat(format) {
+    if (VALID_OUTPUT_FORMATS.includes(format)) {
+        return format;
+    }
+    throw new VclawError('invalid_audio_format', `Unsupported audio output format: "${format}". Valid formats: ${VALID_OUTPUT_FORMATS.join(', ')}`, { format, valid: VALID_OUTPUT_FORMATS });
+}
+/**
+ * The file extension that corresponds to a given output format
+ * (mp3 -> mp3, pcm/ulaw/alaw -> wav, opus -> opus).
+ */
+export function extensionForFormat(format) {
+    if (format.startsWith('mp3_'))
+        return 'mp3';
+    if (format.startsWith('opus_'))
+        return 'opus';
+    // pcm / ulaw / alaw are raw; we wrap them as wav on disk.
+    return 'wav';
+}
+/**
+ * Derive a per-scene audio filename. Scene indexes are 1-based in the
+ * transcript / on disk to mirror the Python pipeline's `scene_NN` naming.
+ */
+export function sceneAudioFilename(sceneIndex, format) {
+    const padded = String(sceneIndex).padStart(2, '0');
+    return `scene_${padded}.${extensionForFormat(format)}`;
+}
+/** Filename for the combined narration track. */
+export function combinedNarrationFilename(format) {
+    return `narration.${extensionForFormat(format)}`;
+}
+/**
+ * Format a duration (milliseconds) as `MM:SS.mmm` for human-readable logs
+ * and report entries.
+ */
+export function formatDuration(durationMs) {
+    if (!Number.isFinite(durationMs) || durationMs < 0) {
+        throw new VclawError('invalid_audio_format', `Invalid duration: ${durationMs}`, {
+            durationMs,
+        });
+    }
+    const totalSeconds = durationMs / 1000;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = Math.floor(totalSeconds % 60);
+    const millis = Math.round(durationMs % 1000);
+    const mm = String(minutes).padStart(2, '0');
+    const ss = String(seconds).padStart(2, '0');
+    const mmm = String(millis).padStart(3, '0');
+    return `${mm}:${ss}.${mmm}`;
+}
+//# sourceMappingURL=audio-utils.js.map

package/dist/video/assemble/audio-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-utils.js","sourceRoot":"","sources":["../../../src/video/assemble/audio-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,eAAe;IACf,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAIX,MAAM,CAAC,MAAM,qBAAqB,GAAiB,eAAe,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAK,oBAA0C,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,MAAsB,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,UAAU,CAClB,sBAAsB,EACtB,qCAAqC,MAAM,qBAAqB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACjG,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,CACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,0DAA0D;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,MAAc;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,SAAS,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,OAAO,aAAa,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,qBAAqB,UAAU,EAAE,EAAE;YAC9E,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;AAC9B,CAAC"}

package/dist/video/assemble/cut-segment.d.ts

@@ -0,0 +1,40 @@
+export declare const CUT_DEFAULT_WIDTH = 1280;
+export declare const CUT_DEFAULT_HEIGHT = 720;
+export interface BuildSegmentCutArgsInput {
+    /** Source clip to cut from. */
+    clipPath: string;
+    /** Input-seek point in seconds (the lip-sync scrub offset / B-roll in-point). */
+    inSeconds: number;
+    /** Desired segment duration; quantized to an exact whole number of frames. */
+    durationSec: number;
+    /** Where the cut segment is written. */
+    outputPath: string;
+    /** Output frame width (default 1280). */
+    width?: number;
+    /** Output frame height (default 720). */
+    height?: number;
+    /** Output frame rate (default 24, matching {@link TARGET_FPS}). */
+    fps?: number;
+    /** x264 CRF (default 18). */
+    crf?: number;
+    /** x264 preset (default 'veryfast' — segments are re-graded later in one pass). */
+    preset?: string;
+    /** Keep source audio? Default false (`-an`); montage audio is muxed at the end. */
+    keepAudio?: boolean;
+}
+/** Exact whole-frame count for a segment duration (>= 1). */
+export declare function segmentFrameCount(durationSec: number, fps?: number): number;
+/**
+ * Build the FFmpeg args for one frame-exact segment cut. PURE — the returned
+ * array is everything AFTER `ffmpeg -y`. Outputs exactly
+ * `segmentFrameCount(durationSec, fps)` frames starting at `inSeconds`.
+ */
+export declare function buildSegmentCutArgs(input: BuildSegmentCutArgsInput): string[];
+/**
+ * Assert the built (concatenated) video length matches the planned length to
+ * within one frame. Throws with a descriptive message otherwise. Use this as
+ * the post-build gate on any audio-synced assembly so cumulative drift can never
+ * silently regress.
+ */
+export declare function assertNoDrift(plannedSeconds: number, builtSeconds: number, fps?: number): void;
+//# sourceMappingURL=cut-segment.d.ts.map

package/dist/video/assemble/cut-segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-segment.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/cut-segment.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAoC7E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,IAAI,CAWN"}

package/dist/video/assemble/cut-segment.js

@@ -0,0 +1,77 @@
+/**
+ * cut-segment.ts — FRAME-EXACT extraction of one montage segment from a source
+ * clip. PURE arg-builder (no I/O, no spawn) so it is unit-testable like
+ * {@link buildAnimateArgs}; `runFfmpeg` prepends the `ffmpeg -y` and spawns.
+ *
+ * WHY THIS EXISTS — the load-bearing fix for audio-synced montages:
+ *  - Cutting each segment with `-t <seconds>` makes ffmpeg quantize to whole
+ *    frames and bias SHORT (~0.01–0.02s lost per cut). Over ~88 cuts that
+ *    accumulates LINEARLY to ~2s, so a beat-/vocal-synced edit drifts AHEAD of
+ *    its muxed audio by the end (lips/hits land early). The cure is to emit an
+ *    EXACT integer frame count via `-frames:v round(dur*fps)` (same trick as
+ *    {@link buildAnimateArgs}) so cumulative video-time == planned time.
+ *  - `-nostdin` so ffmpeg never consumes a caller's stdin (a `while read` loop
+ *    fed from a seg list otherwise loses bytes and corrupts the next path).
+ *  - Full-frame `scale=…:force_original_aspect_ratio=increase,crop=W:H` (never a
+ *    2.39 crop — that chops heads on close-ups) + `setsar=1` so heterogeneous
+ *    source clips (different fps/SAR) concat cleanly.
+ *  - `-ss` BEFORE `-i` (fast input seek; ffmpeg's default `accurate_seek` makes
+ *    the first output frame land on the exact requested frame).
+ *
+ * The companion {@link assertNoDrift} lets the assembler verify, after building,
+ * that the concatenated video length equals the planner total within one frame.
+ */
+import { TARGET_FPS } from './animate-slides.js';
+export const CUT_DEFAULT_WIDTH = 1280;
+export const CUT_DEFAULT_HEIGHT = 720;
+/** Exact whole-frame count for a segment duration (>= 1). */
+export function segmentFrameCount(durationSec, fps = TARGET_FPS) {
+    return Math.max(1, Math.round(durationSec * fps));
+}
+/**
+ * Build the FFmpeg args for one frame-exact segment cut. PURE — the returned
+ * array is everything AFTER `ffmpeg -y`. Outputs exactly
+ * `segmentFrameCount(durationSec, fps)` frames starting at `inSeconds`.
+ */
+export function buildSegmentCutArgs(input) {
+    const width = input.width ?? CUT_DEFAULT_WIDTH;
+    const height = input.height ?? CUT_DEFAULT_HEIGHT;
+    const fps = input.fps ?? TARGET_FPS;
+    const crf = input.crf ?? 18;
+    const preset = input.preset ?? 'veryfast';
+    const frames = segmentFrameCount(input.durationSec, fps);
+    const vf = `scale=${width}:${height}:force_original_aspect_ratio=increase,` +
+        `crop=${width}:${height},fps=${fps},setsar=1`;
+    const args = [
+        '-nostdin',
+        '-ss',
+        input.inSeconds.toFixed(4),
+        '-i',
+        input.clipPath,
+        '-vf',
+        vf,
+        '-frames:v',
+        String(frames),
+    ];
+    if (!input.keepAudio)
+        args.push('-an');
+    args.push('-c:v', 'libx264', '-crf', String(crf), '-preset', preset, '-pix_fmt', 'yuv420p', input.outputPath);
+    return args;
+}
+/**
+ * Assert the built (concatenated) video length matches the planned length to
+ * within one frame. Throws with a descriptive message otherwise. Use this as
+ * the post-build gate on any audio-synced assembly so cumulative drift can never
+ * silently regress.
+ */
+export function assertNoDrift(plannedSeconds, builtSeconds, fps = TARGET_FPS) {
+    const frameSec = 1 / fps;
+    const driftSec = Math.abs(plannedSeconds - builtSeconds);
+    if (driftSec > frameSec + 1e-6) {
+        const driftFrames = (driftSec * fps).toFixed(2);
+        throw new Error(`assembly drift: built ${builtSeconds.toFixed(3)}s vs planned ` +
+            `${plannedSeconds.toFixed(3)}s (${driftSec.toFixed(3)}s / ${driftFrames} frames > 1 frame). ` +
+            `Every segment must be cut frame-exact (-frames:v), not with -t.`);
+    }
+}
+//# sourceMappingURL=cut-segment.js.map

package/dist/video/assemble/cut-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut-segment.js","sourceRoot":"","sources":["../../../src/video/assemble/cut-segment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAyBtC,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,MAAc,UAAU;IAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,iBAAiB,CAAC;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAC;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC;IAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAEzD,MAAM,EAAE,GACN,SAAS,KAAK,IAAI,MAAM,wCAAwC;QAChE,QAAQ,KAAK,IAAI,MAAM,QAAQ,GAAG,WAAW,CAAC;IAEhD,MAAM,IAAI,GAAG;QACX,UAAU;QACV,KAAK;QACL,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1B,IAAI;QACJ,KAAK,CAAC,QAAQ;QACd,KAAK;QACL,EAAE;QACF,WAAW;QACX,MAAM,CAAC,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,CAAC,GAAG,CAAC,EACX,SAAS,EACT,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,CAAC,UAAU,CACjB,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAsB,EACtB,YAAoB,EACpB,MAAc,UAAU;IAExB,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAG,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,YAAY,CAAC,CAAC;IACzD,IAAI,QAAQ,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,yBAAyB,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;YAC7D,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,WAAW,sBAAsB;YAC7F,iEAAiE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/video/assemble/ffmpeg.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Standard H.264 video encoding params — matches the Python encoders
+ * (`-r 24 -c:v libx264 -preset fast -crf 20`). Keeping these uniform across
+ * every segment is what lets the 3h stitch step concat segments cleanly.
+ */
+export declare const STANDARD_VIDEO_ARGS: readonly string[];
+/**
+ * Standard AAC audio encoding params — matches the Python encoders
+ * (`-c:a aac -ar 44100 -ac 2`).
+ */
+export declare const STANDARD_AUDIO_ARGS: readonly string[];
+/** Resolve the ffmpeg binary: explicit opt > VCLAW_FFMPEG_BIN env > `ffmpeg`. */
+export declare function resolveFfmpegBin(explicit?: string): string;
+/** Resolve the ffprobe binary: explicit opt > VCLAW_FFPROBE_BIN env > `ffprobe`. */
+export declare function resolveFfprobeBin(explicit?: string): string;
+/**
+ * Per-clip cut-at-N tail trim (WS9). Returns the ffmpeg `-t <seconds>` flag pair
+ * when `maxSeconds` is a positive number, else `[]` (no trim). PURE — splice the
+ * result into a per-clip ffmpeg arg array just before the output path.
+ */
+export declare function trimTailArgs(maxSeconds?: number): string[];
+/**
+ * Letterbox normalization filter (WS9). Scales the source to the canvas
+ * `width` (preserving aspect via `-2`) and pads it onto a `width`x`height`
+ * black canvas, producing cinematic bars. Mirrors the DHUAAN TITLEFIT pattern
+ * (`scale=W:-2,pad=W:H:0:(oh-ih)/2:black`). Returns '' when no `ratio` is given
+ * (an empty/undefined ratio disables the filter). PURE — no ffmpeg spawned.
+ *
+ * `ratio` is the target aspect ratio label (e.g. '2.39:1'); the actual letterbox
+ * geometry comes from the `width`/`height` canvas the caller already targets.
+ */
+export declare function letterboxFilter(ratio: string | undefined, width: number, height: number): string;
+export interface RunFfmpegOptions {
+    /** Build + return the command string without spawning ffmpeg. */
+    dryRun?: boolean;
+    /** Override the ffmpeg binary (falls back to VCLAW_FFMPEG_BIN, then `ffmpeg`). */
+    ffmpegBin?: string;
+}
+export interface RunFfmpegResult {
+    exitCode: number;
+    stderr: string;
+    /** The fully-resolved command line that was (or would be) run. */
+    command: string;
+}
+/**
+ * Run ffmpeg with the given args. The `-y` flag (overwrite output without
+ * prompting) is prepended automatically, mirroring the Python wrapper, so
+ * callers never block on an interactive prompt.
+ *
+ * On `dryRun`, returns the command string without spawning (exitCode 0,
+ * empty stderr). On a non-zero exit, throws `VclawError('ffmpeg_failed', ...)`.
+ *
+ * NOTE: This is the real-spawn path. Unit tests must use `dryRun: true` — we do
+ * NOT run ffmpeg in tests.
+ */
+export declare function runFfmpeg(args: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult>;
+export interface FfprobeDurationOptions {
+    /** Return 0 without spawning (dry-run friendly, mirrors callers). */
+    dryRun?: boolean;
+    /** Override the ffprobe binary (falls back to VCLAW_FFPROBE_BIN, then `ffprobe`). */
+    ffprobeBin?: string;
+}
+/**
+ * Probe a media file's duration, returned in **milliseconds**.
+ *
+ * Mirrors `FFmpegWrapper.probe(entries="format=duration")` + `get_duration`:
+ *   ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 <path>
+ *
+ * On `dryRun`, returns 0 without spawning. Throws `VclawError('ffmpeg_failed', ...)`
+ * if ffprobe fails or emits an unparseable duration.
+ */
+export declare function ffprobeDuration(path: string, opts?: FfprobeDurationOptions): Promise<number>;
+export interface IsValidMp4Options {
+    /** Override the ffprobe binary (falls back to VCLAW_FFPROBE_BIN, then `ffprobe`). */
+    ffprobeBin?: string;
+    /** Probe timeout in ms; on expiry the probe is killed and false is returned. Default 15000. */
+    timeoutMs?: number;
+}
+/**
+ * True iff ffprobe can read a positive duration from `path`. Catches
+ * truncated/no-moov MP4s that pass existence+size checks but fail at
+ * stitch. Ported from parallel_video_gen._ffprobe_is_valid_mp4. Never
+ * throws — returns false on any probe failure / missing file / timeout.
+ *
+ * Mirrors the Python guard's args exactly:
+ *   ffprobe -v error -show_entries format=duration -of csv=p=0 <path>
+ * returning true only when ffprobe exits 0 AND stdout trims to a finite
+ * number > 0.
+ */
+export declare function isValidMp4(path: string, opts?: IsValidMp4Options): Promise<boolean>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/video/assemble/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/ffmpeg.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAShD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAOhD,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAGR;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA2C1B;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,MAAM,CAAC,CA8DjB;AAED,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqD7F"}