demowright 2.2.0 → 2.4.0

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { t as QaHudOptions } from "./setup-Dwx0Dt54.mjs";
+import { t as QaHudOptions } from "./setup-8X-3F3M7.mjs";
 import { PlaywrightTestConfig } from "@playwright/test";
 
 //#region src/config.d.ts

package/dist/config.mjs

@@ -1,4 +1,4 @@
-import { n as defaultOptions } from "./setup-Ce4X1N16.mjs";
+import { n as defaultOptions } from "./setup-c_UpOQ7a.mjs";
 import { createRequire } from "node:module";
 import { execSync } from "node:child_process";
 import { mkdirSync, readdirSync } from "node:fs";

package/dist/helpers.d.mts

@@ -34,6 +34,23 @@ declare function clickEl(page: Page, selector: string): Promise<void>;
  *   If omitted, uses `document.activeElement`.
  */
 declare function typeKeys(page: Page, text: string, delay?: number, inputSelector?: string): Promise<void>;
+/**
+ * Pre-fetch TTS audio for all narration texts in parallel.
+ * Call this at the start of a test to eliminate per-annotate wait times.
+ *
+ * ```ts
+ * const narrations = [
+ *   "Welcome to the demo",
+ *   "Now clicking the button",
+ *   "That wraps up the tour",
+ * ];
+ * await prefetchTts(page, narrations);
+ *
+ * // All subsequent annotate/narrate calls hit the cache instantly
+ * await annotate(page, narrations[0], async () => { ... });
+ * ```
+ */
+declare function prefetchTts(page: Page, texts: string[]): Promise<void>;
 /**
  * Speak `text` via the configured TTS provider, or fall back to
  * the browser's speechSynthesis API.
@@ -92,4 +109,4 @@ declare function annotate(page: Page, text: string, callbackOrOptions?: (() => P
   voice?: string;
 }, callback?: () => Promise<void>): Promise<void>;
 //#endregion
-export { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, subtitle, typeKeys };
+export { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, prefetchTts, subtitle, typeKeys };

package/dist/helpers.mjs

@@ -129,16 +129,48 @@ async function typeKeys(page, text, delay = 65, inputSelector) {
 		await page.waitForTimeout(delay);
 	}
 }
-/** Fetch audio from a TTS provider. Returns a WAV Buffer. */
+const ttsCache = /* @__PURE__ */ new Map();
+/** Fetch audio from a TTS provider. Returns a WAV Buffer (cached). */
 async function fetchTtsAudio(text, provider) {
+	const cached = ttsCache.get(text);
+	if (cached) return cached;
+	let buf;
 	if (typeof provider === "string") {
 		const url = provider.replace(/%s/g, encodeURIComponent(text));
 		const res = await fetch(url);
 		if (!res.ok) throw new Error(`TTS fetch ${res.status}`);
-		return Buffer.from(await res.arrayBuffer());
+		buf = Buffer.from(await res.arrayBuffer());
+	} else {
+		const result = await provider(text);
+		buf = Buffer.isBuffer(result) ? result : Buffer.from(result);
 	}
-	const result = await provider(text);
-	return Buffer.isBuffer(result) ? result : Buffer.from(result);
+	ttsCache.set(text, buf);
+	return buf;
+}
+/**
+* Pre-fetch TTS audio for all narration texts in parallel.
+* Call this at the start of a test to eliminate per-annotate wait times.
+*
+* ```ts
+* const narrations = [
+*   "Welcome to the demo",
+*   "Now clicking the button",
+*   "That wraps up the tour",
+* ];
+* await prefetchTts(page, narrations);
+*
+* // All subsequent annotate/narrate calls hit the cache instantly
+* await annotate(page, narrations[0], async () => { ... });
+* ```
+*/
+async function prefetchTts(page, texts) {
+	const provider = getTtsProvider(page);
+	if (!provider) return;
+	const uncached = texts.filter((t) => !ttsCache.has(t));
+	if (uncached.length === 0) return;
+	console.log(`[demowright] Prefetching ${uncached.length} TTS segments...`);
+	const failed = (await Promise.allSettled(uncached.map((text) => fetchTtsAudio(text, provider)))).filter((r) => r.status === "rejected").length;
+	if (failed > 0) console.warn(`[demowright] ${failed}/${uncached.length} TTS prefetch failed`);
 }
 /** Parse WAV and return { float32, sampleRate, channels, durationMs }. */
 function parseWav(wavBuf) {
@@ -318,4 +350,4 @@ async function annotate(page, text, callbackOrOptions, callback) {
 	}, cb)]);
 }
 //#endregion
-export { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, subtitle, typeKeys };
+export { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, prefetchTts, subtitle, typeKeys };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { installAutoAnnotate } from "./auto-annotate.mjs";
-import { a as AudioWriter, n as TtsProvider, r as applyHud, t as QaHudOptions } from "./setup-Dwx0Dt54.mjs";
-import { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, subtitle, typeKeys } from "./helpers.mjs";
+import { a as AudioWriter, n as TtsProvider, r as applyHud, t as QaHudOptions } from "./setup-8X-3F3M7.mjs";
+import { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, prefetchTts, subtitle, typeKeys } from "./helpers.mjs";
 import { OutroOptions, PaceFn, RenderOptions, TimelineEntry, TitleOptions, VideoScriptResult, buildFfmpegCommand, createVideoScript } from "./video-script.mjs";
 import { Page as Page$1, expect } from "@playwright/test";
 import * as _$electron from "electron";
@@ -54041,4 +54041,4 @@ declare const test: TestType<PlaywrightTestArgs & PlaywrightTestOptions & {
  */
 declare function getGlobalTtsProvider(): TtsProvider;
 //#endregion
-export { AudioWriter, type OutroOptions, type PaceFn, type QaHudOptions, type RenderOptions, type TimelineEntry, type TitleOptions, type TtsProvider, type VideoScriptResult, annotate, applyHud, buildFfmpegCommand, caption, clickEl, createVideoScript, expect, getGlobalTtsProvider, hudWait, installAutoAnnotate, moveTo, moveToEl, narrate, subtitle, test, typeKeys };
+export { AudioWriter, type OutroOptions, type PaceFn, type QaHudOptions, type RenderOptions, type TimelineEntry, type TitleOptions, type TtsProvider, type VideoScriptResult, annotate, applyHud, buildFfmpegCommand, caption, clickEl, createVideoScript, expect, getGlobalTtsProvider, hudWait, installAutoAnnotate, moveTo, moveToEl, narrate, prefetchTts, subtitle, test, typeKeys };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { r as AudioWriter, t as applyHud } from "./setup-Ce4X1N16.mjs";
+import { r as AudioWriter, t as applyHud } from "./setup-c_UpOQ7a.mjs";
 import { i as getGlobalTtsProvider, s as init_hud_registry } from "./hud-registry-Wfd4b4Nu.mjs";
 import { buildFfmpegCommand, createVideoScript, t as init_video_script } from "./video-script.mjs";
-import { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, subtitle, typeKeys } from "./helpers.mjs";
+import { annotate, caption, clickEl, hudWait, moveTo, moveToEl, narrate, prefetchTts, subtitle, typeKeys } from "./helpers.mjs";
 import { installAutoAnnotate } from "./auto-annotate.mjs";
 import { expect, test as test$1 } from "@playwright/test";
 //#region src/fixture.ts
@@ -26,4 +26,4 @@ const test = test$1.extend({
 init_video_script();
 init_hud_registry();
 //#endregion
-export { AudioWriter, annotate, applyHud, buildFfmpegCommand, caption, clickEl, createVideoScript, expect, getGlobalTtsProvider, hudWait, installAutoAnnotate, moveTo, moveToEl, narrate, subtitle, test, typeKeys };
+export { AudioWriter, annotate, applyHud, buildFfmpegCommand, caption, clickEl, createVideoScript, expect, getGlobalTtsProvider, hudWait, installAutoAnnotate, moveTo, moveToEl, narrate, prefetchTts, subtitle, test, typeKeys };

package/dist/{setup-Dwx0Dt54.d.mts → setup-8X-3F3M7.d.mts}

@@ -24,6 +24,8 @@ declare class AudioWriter {
   /**
    * Called from the browser via page.exposeFunction.
    * Receives interleaved stereo float32 samples.
+   * Each chunk is timestamped with wall-clock time so silence gaps
+   * (e.g. during video pause) are preserved in the output.
    */
   addChunk(samples: number[], sampleRate: number): void;
   /** Wall-clock time when first chunk arrived */
@@ -32,13 +34,15 @@ declare class AudioWriter {
   get rate(): number;
   /** Total samples collected (interleaved, so / channels for per-channel) */
   get totalSamples(): number;
+  /** Total duration including silence gaps (wall-clock based) */
   get duration(): number;
   /**
    * Write collected audio to a WAV file.
    */
   save(filePath: string): void;
   /**
-   * Return all chunks concatenated as interleaved stereo float32.
+   * Return all audio as interleaved stereo float32, preserving silence gaps
+   * between chunks based on their wall-clock timestamps.
    */
   toFloat32(): Float32Array;
   /** Reset for reuse */

package/dist/{setup-Ce4X1N16.mjs → setup-c_UpOQ7a.mjs}

@@ -300,11 +300,17 @@ var AudioWriter = class {
 	/**
 	* Called from the browser via page.exposeFunction.
 	* Receives interleaved stereo float32 samples.
+	* Each chunk is timestamped with wall-clock time so silence gaps
+	* (e.g. during video pause) are preserved in the output.
 	*/
 	addChunk(samples, sampleRate) {
-		if (this.chunks.length === 0) this.startMs = Date.now();
+		const now = Date.now();
+		if (this.chunks.length === 0) this.startMs = now;
 		this.sampleRate = sampleRate;
-		this.chunks.push(new Float32Array(samples));
+		this.chunks.push({
+			samples: new Float32Array(samples),
+			timestampMs: now
+		});
 	}
 	/** Wall-clock time when first chunk arrived */
 	get captureStartMs() {
@@ -316,22 +322,25 @@ var AudioWriter = class {
 	}
 	/** Total samples collected (interleaved, so / channels for per-channel) */
 	get totalSamples() {
-		return this.chunks.reduce((sum, c) => sum + c.length, 0);
+		return this.chunks.reduce((sum, c) => sum + c.samples.length, 0);
 	}
+	/** Total duration including silence gaps (wall-clock based) */
 	get duration() {
-		return this.totalSamples / this.channels / this.sampleRate;
+		if (this.chunks.length === 0) return 0;
+		const last = this.chunks[this.chunks.length - 1];
+		const lastDurMs = last.samples.length / this.channels / this.sampleRate * 1e3;
+		return (last.timestampMs + lastDurMs - this.startMs) / 1e3;
 	}
 	/**
 	* Write collected audio to a WAV file.
 	*/
 	save(filePath) {
-		const totalSamples = this.totalSamples;
-		if (totalSamples === 0) return;
-		const int16 = new Int16Array(totalSamples);
-		let offset = 0;
-		for (const chunk of this.chunks) for (let i = 0; i < chunk.length; i++) {
-			const s = Math.max(-1, Math.min(1, chunk[i]));
-			int16[offset++] = s < 0 ? s * 32768 : s * 32767;
+		const float32 = this.toFloat32();
+		if (float32.length === 0) return;
+		const int16 = new Int16Array(float32.length);
+		for (let i = 0; i < float32.length; i++) {
+			const s = Math.max(-1, Math.min(1, float32[i]));
+			int16[i] = s < 0 ? s * 32768 : s * 32767;
 		}
 		const dataBytes = int16.length * 2;
 		const buffer = Buffer.alloc(44 + dataBytes);
@@ -352,16 +361,20 @@ var AudioWriter = class {
 		writeFileSync(filePath, buffer);
 	}
 	/**
-	* Return all chunks concatenated as interleaved stereo float32.
+	* Return all audio as interleaved stereo float32, preserving silence gaps
+	* between chunks based on their wall-clock timestamps.
 	*/
 	toFloat32() {
-		const total = this.totalSamples;
-		if (total === 0) return new Float32Array(0);
-		const out = new Float32Array(total);
-		let off = 0;
+		if (this.chunks.length === 0) return new Float32Array(0);
+		const last = this.chunks[this.chunks.length - 1];
+		const lastDurMs = last.samples.length / this.channels / this.sampleRate * 1e3;
+		const totalMs = last.timestampMs + lastDurMs - this.startMs;
+		const totalSamples = Math.ceil(totalMs / 1e3 * this.sampleRate) * this.channels;
+		const out = new Float32Array(totalSamples);
 		for (const chunk of this.chunks) {
-			out.set(chunk, off);
-			off += chunk.length;
+			const offsetMs = chunk.timestampMs - this.startMs;
+			const offsetSamples = Math.floor(offsetMs / 1e3 * this.sampleRate) * this.channels;
+			for (let i = 0; i < chunk.samples.length && offsetSamples + i < out.length; i++) out[offsetSamples + i] += chunk.samples[i];
 		}
 		return out;
 	}

package/dist/setup.d.mts

@@ -1,2 +1,2 @@
-import { i as defaultOptions, n as TtsProvider, r as applyHud, t as QaHudOptions } from "./setup-Dwx0Dt54.mjs";
+import { i as defaultOptions, n as TtsProvider, r as applyHud, t as QaHudOptions } from "./setup-8X-3F3M7.mjs";
 export { QaHudOptions, TtsProvider, applyHud, defaultOptions };

package/dist/setup.mjs

@@ -1,2 +1,2 @@
-import { n as defaultOptions, t as applyHud } from "./setup-Ce4X1N16.mjs";
+import { n as defaultOptions, t as applyHud } from "./setup-c_UpOQ7a.mjs";
 export { applyHud, defaultOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demowright",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Playwright video production plugin — cursor overlay, keystroke badges, TTS narration, and narration-driven video scripts for test recordings",
   "license": "MIT",
   "repository": {