playwright-recast 0.1.0

package/dist/types/trace.d.ts.map

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

package/dist/types/trace.js

@@ -0,0 +1,4 @@
+export function toMonotonic(ms) {
+    return ms;
+}
+//# sourceMappingURL=trace.js.map

package/dist/types/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/types/trace.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAiB,CAAA;AAC1B,CAAC"}

package/dist/types/voiceover.d.ts

@@ -0,0 +1,42 @@
+import type { SubtitleEntry, SubtitledTrace } from './subtitle';
+/** A chunk of synthesized audio */
+export interface AudioSegment {
+    data: Buffer;
+    durationMs: number;
+    format: {
+        sampleRate: number;
+        channels: number;
+        codec: string;
+    };
+}
+/** Options for a single TTS synthesis call */
+export interface TtsOptions {
+    voice?: string;
+    speed?: number;
+    format?: 'mp3' | 'wav' | 'opus' | 'pcm';
+    locale?: string;
+}
+/** The contract every TTS provider must implement */
+export interface TtsProvider {
+    readonly name: string;
+    synthesize(text: string, options?: TtsOptions): Promise<AudioSegment>;
+    estimateDurationMs(text: string, options?: TtsOptions): number;
+    isAvailable(): Promise<boolean>;
+    dispose(): Promise<void>;
+}
+/** A voiceover entry matched to a subtitle */
+export interface VoiceoverEntry {
+    subtitle: SubtitleEntry;
+    audio: AudioSegment;
+    outputStartMs: number;
+    outputEndMs: number;
+}
+/** Trace after voiceover has been generated */
+export interface VoiceoveredTrace extends SubtitledTrace {
+    voiceover: {
+        entries: VoiceoverEntry[];
+        audioTrackPath: string;
+        totalDurationMs: number;
+    };
+}
+//# sourceMappingURL=voiceover.d.ts.map

package/dist/types/voiceover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceover.d.ts","sourceRoot":"","sources":["../../src/types/voiceover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE/D,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACrE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAC9D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,SAAS,EAAE;QACT,OAAO,EAAE,cAAc,EAAE,CAAA;QACzB,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;CACF"}

package/dist/types/voiceover.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=voiceover.js.map

package/dist/types/voiceover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceover.js","sourceRoot":"","sources":["../../src/types/voiceover.ts"],"names":[],"mappings":""}

package/dist/utils/ffmpeg.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Assert that both `ffmpeg` and `ffprobe` are available on the system PATH.
+ * Throws a descriptive error if either binary is missing, so the user gets
+ * a clear message instead of a cryptic ENOENT later in the pipeline.
+ */
+export declare function assertFfmpegAvailable(): void;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/utils/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/utils/ffmpeg.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAiB5C"}

package/dist/utils/ffmpeg.js

@@ -0,0 +1,24 @@
+import { execFileSync } from 'node:child_process';
+/**
+ * Assert that both `ffmpeg` and `ffprobe` are available on the system PATH.
+ * Throws a descriptive error if either binary is missing, so the user gets
+ * a clear message instead of a cryptic ENOENT later in the pipeline.
+ */
+export function assertFfmpegAvailable() {
+    for (const bin of ['ffmpeg', 'ffprobe']) {
+        try {
+            execFileSync(bin, ['-version'], { stdio: 'pipe' });
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'ENOENT') {
+                throw new Error(`"${bin}" is not installed or not on PATH. ` +
+                    `Install ffmpeg (https://ffmpeg.org/download.html) and ensure both ffmpeg and ffprobe are accessible.`);
+            }
+            // If the binary exists but returned a non-zero exit code, that's fine —
+            // it means the binary is present. Some ffmpeg builds exit(1) for -version
+            // on certain platforms, which is acceptable.
+        }
+    }
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/utils/ffmpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/utils/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,YAAY,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;YAClD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,IAAI,GAAG,qCAAqC;oBAC1C,sGAAsG,CACzG,CAAA;YACH,CAAC;YACD,wEAAwE;YACxE,0EAA0E;YAC1E,6CAA6C;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/voiceover/providers/elevenlabs.d.ts

@@ -0,0 +1,12 @@
+import type { TtsProvider } from '../../types/voiceover';
+export interface ElevenLabsProviderConfig {
+    apiKey?: string;
+    voiceId?: string;
+    modelId?: string;
+}
+/**
+ * ElevenLabs TTS provider.
+ * Requires `@elevenlabs/elevenlabs-js` as a peer dependency.
+ */
+export declare function ElevenLabsProvider(config?: ElevenLabsProviderConfig): TtsProvider;
+//# sourceMappingURL=elevenlabs.d.ts.map

package/dist/voiceover/providers/elevenlabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../../src/voiceover/providers/elevenlabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA4B,MAAM,uBAAuB,CAAA;AAElF,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAgBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,wBAA6B,GAAG,WAAW,CAsDrF"}

package/dist/voiceover/providers/elevenlabs.js

@@ -0,0 +1,55 @@
+const DEFAULT_VOICE_ID = 'onwK4e9ZLuTAKqWW03F9'; // Daniel
+const DEFAULT_MODEL_ID = 'eleven_multilingual_v2';
+/**
+ * ElevenLabs TTS provider.
+ * Requires `@elevenlabs/elevenlabs-js` as a peer dependency.
+ */
+export function ElevenLabsProvider(config = {}) {
+    const apiKey = config.apiKey ?? process.env.ELEVENLABS_API_KEY;
+    const voiceId = config.voiceId ?? DEFAULT_VOICE_ID;
+    const modelId = config.modelId ?? DEFAULT_MODEL_ID;
+    let client = null;
+    async function getClient() {
+        if (client)
+            return client;
+        const { ElevenLabsClient: ELClient } = await import('@elevenlabs/elevenlabs-js');
+        client = new ELClient({ apiKey });
+        return client;
+    }
+    return {
+        name: 'elevenlabs',
+        async synthesize(text, _options) {
+            const el = await getClient();
+            const audio = await el.textToSpeech.convert(voiceId, {
+                text,
+                modelId,
+                outputFormat: 'mp3_44100_128',
+            });
+            const reader = audio.getReader();
+            const chunks = [];
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+            }
+            const data = Buffer.concat(chunks);
+            return {
+                data,
+                durationMs: 0, // Will be measured by voiceover-processor via ffprobe
+                format: { sampleRate: 44100, channels: 1, codec: 'mp3' },
+            };
+        },
+        estimateDurationMs(text) {
+            const words = text.split(/\s+/).length;
+            return (words / 150) * 60_000;
+        },
+        async isAvailable() {
+            return !!apiKey;
+        },
+        async dispose() {
+            client = null;
+        },
+    };
+}
+//# sourceMappingURL=elevenlabs.js.map

package/dist/voiceover/providers/elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.js","sourceRoot":"","sources":["../../../src/voiceover/providers/elevenlabs.ts"],"names":[],"mappings":"AAQA,MAAM,gBAAgB,GAAG,sBAAsB,CAAA,CAAC,SAAS;AACzD,MAAM,gBAAgB,GAAG,wBAAwB,CAAA;AAajD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAmC,EAAE;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAA;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAA;IAElD,IAAI,MAAM,GAA4B,IAAI,CAAA;IAE1C,KAAK,UAAU,SAAS;QACtB,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAA;QAChF,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAgC,CAAA;QAChE,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAElB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,QAAqB;YAClD,MAAM,EAAE,GAAG,MAAM,SAAS,EAAE,CAAA;YAC5B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE;gBACnD,IAAI;gBACJ,OAAO;gBACP,YAAY,EAAE,eAAe;aAC9B,CAAC,CAAA;YAEF,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;YAChC,MAAM,MAAM,GAAiB,EAAE,CAAA;YAC/B,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC3C,IAAI,IAAI;oBAAE,MAAK;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAClC,OAAO;gBACL,IAAI;gBACJ,UAAU,EAAE,CAAC,EAAE,sDAAsD;gBACrE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;aACzD,CAAA;QACH,CAAC;QAED,kBAAkB,CAAC,IAAY;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;YACtC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,MAAM,CAAA;QAC/B,CAAC;QAED,KAAK,CAAC,WAAW;YACf,OAAO,CAAC,CAAC,MAAM,CAAA;QACjB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/voiceover/providers/openai.d.ts

@@ -0,0 +1,14 @@
+import type { TtsProvider } from '../../types/voiceover';
+export interface OpenAIProviderConfig {
+    apiKey?: string;
+    voice?: string;
+    model?: string;
+    speed?: number;
+    instructions?: string;
+}
+/**
+ * OpenAI TTS provider.
+ * Requires `openai` as a peer dependency.
+ */
+export declare function OpenAIProvider(config?: OpenAIProviderConfig): TtsProvider;
+//# sourceMappingURL=openai.d.ts.map

package/dist/voiceover/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/voiceover/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA4B,MAAM,uBAAuB,CAAA;AAElF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,WAAW,CAsD7E"}

package/dist/voiceover/providers/openai.js

@@ -0,0 +1,53 @@
+/**
+ * OpenAI TTS provider.
+ * Requires `openai` as a peer dependency.
+ */
+export function OpenAIProvider(config = {}) {
+    const apiKey = config.apiKey ?? process.env.OPENAI_API_KEY;
+    const voice = config.voice ?? 'nova';
+    const model = config.model ?? 'gpt-4o-mini-tts';
+    const speed = config.speed ?? 1.0;
+    const instructions = config.instructions;
+    let client = null;
+    async function getClient() {
+        if (client)
+            return client;
+        const OpenAI = (await import('openai')).default;
+        client = new OpenAI({ apiKey });
+        return client;
+    }
+    return {
+        name: 'openai',
+        async synthesize(text, options) {
+            const openai = await getClient();
+            const params = {
+                model,
+                voice: options?.voice ?? voice,
+                input: text,
+                speed: options?.speed ?? speed,
+                response_format: 'mp3',
+            };
+            if (instructions)
+                params.instructions = instructions;
+            const response = await openai.audio.speech.create(params);
+            const data = Buffer.from(await response.arrayBuffer());
+            return {
+                data,
+                durationMs: 0,
+                format: { sampleRate: 24000, channels: 1, codec: 'mp3' },
+            };
+        },
+        estimateDurationMs(text, options) {
+            const spd = options?.speed ?? speed;
+            const words = text.split(/\s+/).length;
+            return (words / (150 * spd)) * 60_000;
+        },
+        async isAvailable() {
+            return !!apiKey;
+        },
+        async dispose() {
+            client = null;
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/voiceover/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/voiceover/providers/openai.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA+B,EAAE;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAA;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,iBAAiB,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAA;IACjC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;IAExC,IAAI,MAAM,GAAwB,IAAI,CAAA;IAEtC,KAAK,UAAU,SAAS;QACtB,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAA;QAC/C,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAA4B,CAAA;QAC1D,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QAEd,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAoB;YACjD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAA;YAChC,MAAM,MAAM,GAA4B;gBACtC,KAAK;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;gBAC9B,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;gBAC9B,eAAe,EAAE,KAAK;aACvB,CAAA;YACD,IAAI,YAAY;gBAAE,MAAM,CAAC,YAAY,GAAG,YAAY,CAAA;YAEpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;YAEtD,OAAO;gBACL,IAAI;gBACJ,UAAU,EAAE,CAAC;gBACb,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;aACzD,CAAA;QACH,CAAC;QAED,kBAAkB,CAAC,IAAY,EAAE,OAAoB;YACnD,MAAM,GAAG,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAA;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;YACtC,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,WAAW;YACf,OAAO,CAAC,CAAC,MAAM,CAAA;QACjB,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/voiceover/voiceover-processor.d.ts

@@ -0,0 +1,9 @@
+import type { SubtitledTrace } from '../types/subtitle';
+import type { TtsProvider, VoiceoveredTrace } from '../types/voiceover';
+/**
+ * Generate voiceover audio from subtitles using a TTS provider.
+ * Produces individual audio segments, pads with silence to match timing,
+ * and concatenates into a single audio track.
+ */
+export declare function generateVoiceover(trace: SubtitledTrace, provider: TtsProvider, tmpDir: string): Promise<VoiceoveredTrace>;
+//# sourceMappingURL=voiceover-processor.d.ts.map

package/dist/voiceover/voiceover-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceover-processor.d.ts","sourceRoot":"","sources":["../../src/voiceover/voiceover-processor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAkB,MAAM,oBAAoB,CAAA;AAuBvF;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAuE3B"}

package/dist/voiceover/voiceover-processor.js

@@ -0,0 +1,88 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+function getAudioDurationMs(filePath) {
+    const output = execFileSync('ffprobe', [
+        '-v', 'quiet',
+        '-show_entries', 'format=duration',
+        '-of', 'csv=p=0',
+        filePath,
+    ]).toString().trim();
+    return Math.round(Number(output) * 1000);
+}
+function generateSilence(durationMs, outputPath, sampleRate = 24000) {
+    const durationSec = Math.max(0.01, durationMs / 1000);
+    execFileSync('ffmpeg', [
+        '-y', '-f', 'lavfi',
+        '-i', `anullsrc=r=${sampleRate}:cl=mono`,
+        '-t', String(durationSec),
+        '-c:a', 'libmp3lame', '-q:a', '9',
+        outputPath,
+    ], { stdio: 'pipe' });
+}
+/**
+ * Generate voiceover audio from subtitles using a TTS provider.
+ * Produces individual audio segments, pads with silence to match timing,
+ * and concatenates into a single audio track.
+ */
+export async function generateVoiceover(trace, provider, tmpDir) {
+    fs.mkdirSync(tmpDir, { recursive: true });
+    const entries = [];
+    const segmentFiles = [];
+    let cursor = 0;
+    for (const subtitle of trace.subtitles) {
+        // Insert silence for gap before this segment
+        if (subtitle.startMs > cursor) {
+            const silencePath = path.join(tmpDir, `silence-${subtitle.index}.mp3`);
+            generateSilence(subtitle.startMs - cursor, silencePath);
+            segmentFiles.push(silencePath);
+        }
+        // Generate TTS
+        const segPath = path.join(tmpDir, `seg-${subtitle.index}.mp3`);
+        const audio = await provider.synthesize(subtitle.text);
+        fs.writeFileSync(segPath, audio.data);
+        const audioDuration = getAudioDurationMs(segPath);
+        const windowDuration = subtitle.endMs - subtitle.startMs;
+        if (audioDuration < windowDuration) {
+            segmentFiles.push(segPath);
+            const padPath = path.join(tmpDir, `pad-${subtitle.index}.mp3`);
+            generateSilence(windowDuration - audioDuration, padPath);
+            segmentFiles.push(padPath);
+            cursor = subtitle.endMs;
+        }
+        else {
+            segmentFiles.push(segPath);
+            cursor = subtitle.startMs + audioDuration;
+        }
+        entries.push({
+            subtitle,
+            audio,
+            outputStartMs: subtitle.startMs,
+            outputEndMs: Math.max(subtitle.endMs, subtitle.startMs + audioDuration),
+        });
+    }
+    // Concat all segments into single audio track
+    const concatList = path.join(tmpDir, 'concat.txt');
+    fs.writeFileSync(concatList, segmentFiles.map((f) => `file '${f}'`).join('\n'));
+    const audioTrackPath = path.join(tmpDir, 'voiceover.mp3');
+    if (segmentFiles.length > 0) {
+        execFileSync('ffmpeg', [
+            '-y', '-f', 'concat', '-safe', '0',
+            '-i', concatList,
+            '-c:a', 'libmp3lame', '-q:a', '2',
+            audioTrackPath,
+        ], { stdio: 'pipe' });
+    }
+    const totalDurationMs = segmentFiles.length > 0
+        ? getAudioDurationMs(audioTrackPath)
+        : 0;
+    return {
+        ...trace,
+        voiceover: {
+            entries,
+            audioTrackPath,
+            totalDurationMs,
+        },
+    };
+}
+//# sourceMappingURL=voiceover-processor.js.map

package/dist/voiceover/voiceover-processor.js.map

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

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "playwright-recast",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Fluent pipeline library for processing Playwright traces into polished demo videos — TTS voiceover, subtitles, speed control, and zoom.",
+  "license": "MIT",
+  "author": "Patrik Szewczyk <Patrik.Szewczyk@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ThePatriczek/playwright-recast.git"
+  },
+  "homepage": "https://github.com/ThePatriczek/playwright-recast",
+  "keywords": [
+    "playwright",
+    "trace",
+    "video",
+    "demo",
+    "tts",
+    "voiceover",
+    "subtitles",
+    "srt",
+    "bdd",
+    "automation"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "playwright-recast": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers.d.ts",
+      "default": "./dist/helpers.js"
+    },
+    "./providers/openai": {
+      "types": "./dist/voiceover/providers/openai.d.ts",
+      "default": "./dist/voiceover/providers/openai.js"
+    },
+    "./providers/elevenlabs": {
+      "types": "./dist/voiceover/providers/elevenlabs.d.ts",
+      "default": "./dist/voiceover/providers/elevenlabs.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0",
+    "openai": ">=5.0.0",
+    "@elevenlabs/elevenlabs-js": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "@elevenlabs/elevenlabs-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@elevenlabs/elevenlabs-js": "^2.40.0",
+    "@playwright/test": "^1.58.0",
+    "@types/node": "^22.0.0",
+    "openai": "^6.32.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.0"
+  }
+}