demowright 2.1.0 → 2.3.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/index.d.mts

@@ -1,5 +1,5 @@
 import { installAutoAnnotate } from "./auto-annotate.mjs";
-import { a as AudioWriter, n as TtsProvider, r as applyHud, t as QaHudOptions } from "./setup-Dwx0Dt54.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, 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";

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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";

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/dist/video-script.d.mts

@@ -10,6 +10,9 @@ interface TitleStep {
   kind: "title";
   text: string;
   subtitle?: string;
+  /** Optional TTS narration read aloud over the card. When set, card
+   *  duration becomes max(durationMs, narration audio length). */
+  narration?: string;
   durationMs: number;
   background?: string;
 }
@@ -27,6 +30,9 @@ interface OutroStep {
   kind: "outro";
   text: string;
   subtitle?: string;
+  /** Optional TTS narration read aloud over the card. When set, card
+   *  duration becomes max(durationMs, narration audio length). */
+  narration?: string;
   durationMs: number;
   background?: string;
 }
@@ -53,6 +59,8 @@ interface VideoScriptResult {
 }
 interface TitleOptions {
   subtitle?: string;
+  /** TTS narration read aloud over the card overlay. Duration auto-extends to fit. */
+  narration?: string;
   durationMs?: number;
   /** CSS background — default: radial gradient */
   background?: string;
@@ -60,6 +68,8 @@ interface TitleOptions {
 interface OutroOptions {
   text?: string;
   subtitle?: string;
+  /** TTS narration read aloud over the card overlay. Duration auto-extends to fit. */
+  narration?: string;
   durationMs?: number;
   background?: string;
 }
@@ -89,7 +99,7 @@ declare class VideoScriptImpl {
   private static ttsCache;
   /**
    * Add a title card — full-screen overlay with text + optional subtitle.
-   * No TTS narration by default (silent title card).
+   * Pass `narration` in opts to have TTS voiceover during the card.
    */
   title(text: string, opts?: TitleOptions): this;
   /**
@@ -104,6 +114,7 @@ declare class VideoScriptImpl {
   transition(type?: TransitionType, durationMs?: number): this;
   /**
    * Add an outro card — full-screen overlay, similar to title.
+   * Pass `narration` in opts to have TTS voiceover during the card.
    */
   outro(opts?: OutroOptions): this;
   /**

package/dist/video-script.mjs

@@ -267,13 +267,14 @@ var init_video_script = __esmMin((() => {
 		static ttsCache = /* @__PURE__ */ new Map();
 		/**
 		* Add a title card — full-screen overlay with text + optional subtitle.
-		* No TTS narration by default (silent title card).
+		* Pass `narration` in opts to have TTS voiceover during the card.
 		*/
 		title(text, opts) {
 			this.steps.push({
 				kind: "title",
 				text,
 				subtitle: opts?.subtitle,
+				narration: opts?.narration,
 				durationMs: opts?.durationMs ?? 4e3,
 				background: opts?.background
 			});
@@ -305,12 +306,14 @@ var init_video_script = __esmMin((() => {
 		}
 		/**
 		* Add an outro card — full-screen overlay, similar to title.
+		* Pass `narration` in opts to have TTS voiceover during the card.
 		*/
 		outro(opts) {
 			this.steps.push({
 				kind: "outro",
 				text: opts?.text ?? "Thanks for watching!",
 				subtitle: opts?.subtitle,
+				narration: opts?.narration,
 				durationMs: opts?.durationMs ?? 4e3,
 				background: opts?.background
 			});
@@ -326,11 +329,20 @@ var init_video_script = __esmMin((() => {
 			else if (typeof pageOrProvider === "function" || typeof pageOrProvider === "string") provider = pageOrProvider;
 			else provider = getTtsProvider(pageOrProvider);
 			if (!provider) return;
-			const segmentSteps = this.steps.filter((s) => s.kind === "segment").map((s, i) => ({
-				...s,
-				id: `step-${i}`
-			}));
-			const results = await Promise.allSettled(segmentSteps.map(async (step) => {
+			const ttsSteps = [];
+			let segIdx2 = 0;
+			for (let i = 0; i < this.steps.length; i++) {
+				const s = this.steps[i];
+				if (s.kind === "segment") ttsSteps.push({
+					id: `step-${segIdx2++}`,
+					text: s.text
+				});
+				else if ((s.kind === "title" || s.kind === "outro") && s.narration) ttsSteps.push({
+					id: `card-${i}`,
+					text: s.narration
+				});
+			}
+			const results = await Promise.allSettled(ttsSteps.map(async (step) => {
 				const cached = VideoScriptImpl.ttsCache.get(step.text);
 				if (cached) return {
 					id: step.id,
@@ -352,7 +364,7 @@ var init_video_script = __esmMin((() => {
 						durationMs: r.value.durationMs
 					};
 					this.prepared.set(r.value.id, seg);
-					const step = segmentSteps[idx];
+					const step = ttsSteps[idx];
 					if (step) VideoScriptImpl.ttsCache.set(step.text, seg);
 				}
 				idx++;
@@ -450,14 +462,28 @@ var init_video_script = __esmMin((() => {
 				const stepStartMs = Date.now();
 				if (step.kind === "title" || step.kind === "outro") {
 					const bg = step.background ?? DEFAULT_BG;
-					if (active) showCard(page, step.text, step.subtitle, step.durationMs, bg).catch(() => {});
-					await page.waitForTimeout(step.durationMs);
+					const cardTts = step.narration ? this.prepared.get(`card-${i}`) : void 0;
+					const effectiveDuration = cardTts ? Math.max(step.durationMs, cardTts.durationMs + 500) : step.durationMs;
+					if (active) showCard(page, step.text, step.subtitle, effectiveDuration, bg).catch(() => {});
+					if (active && cardTts) {
+						const offsetMs = Date.now() - planStartMs;
+						audioSegments.push({
+							offsetMs,
+							wavBuf: cardTts.wavBuf
+						});
+						storeAudioSegment(page, {
+							timestampMs: Date.now(),
+							wavBuf: cardTts.wavBuf
+						});
+						showCaption(page, step.narration, cardTts.durationMs).catch(() => {});
+					}
+					await page.waitForTimeout(effectiveDuration);
 					timeline.push({
 						id: stepIds[i],
 						kind: step.kind,
-						text: step.text,
+						text: step.narration ?? step.text,
 						startMs: stepStartMs - planStartMs,
-						durationMs: step.durationMs,
+						durationMs: effectiveDuration,
 						actionMs: 0,
 						overrunMs: 0
 					});

package/package.json

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