demowright 2.0.9 → 2.2.0

package/dist/config.mjs

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { r as AudioWriter, t as applyHud } from "./setup-BwdzChHS.mjs";
+import { r as AudioWriter, t as applyHud } from "./setup-Ce4X1N16.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-BwdzChHS.mjs → setup-Ce4X1N16.mjs}

@@ -622,7 +622,6 @@ function buildAndSaveAudioTrack(segments, outputPath, contextStartMs, browserAud
 	for (const seg of segments) {
 		const dOff = seg.wavBuf.indexOf("data") + 8;
 		if (dOff < 8) continue;
-		seg.wavBuf.readUInt32LE(24);
 		const ch = seg.wavBuf.readUInt16LE(22);
 		const pcmData = seg.wavBuf.subarray(dOff);
 		const sampleCount = pcmData.length / 2;

package/dist/setup.mjs

@@ -1,2 +1,2 @@
-import { n as defaultOptions, t as applyHud } from "./setup-BwdzChHS.mjs";
+import { n as defaultOptions, t as applyHud } from "./setup-Ce4X1N16.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

@@ -170,8 +170,6 @@ function generateSrt(timeline) {
 }
 function generateChapters(timeline) {
 	return timeline.filter((e) => e.kind === "segment" || e.kind === "title" || e.kind === "outro").map((entry) => {
-		(entry.startMs / 1e3).toFixed(3);
-		((entry.startMs + entry.durationMs) / 1e3).toFixed(3);
 		return `[CHAPTER]\nTIMEBASE=1/1000\nSTART=${Math.round(entry.startMs)}\nEND=${Math.round(entry.startMs + entry.durationMs)}\ntitle=${entry.text.slice(0, 80)}`;
 	}).join("\n\n");
 }
@@ -269,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
 			});
@@ -307,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
 			});
@@ -328,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,
@@ -354,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++;
@@ -366,7 +376,7 @@ var init_video_script = __esmMin((() => {
 		* for deferred track building at context close (setup.ts).
 		*/
 		async run(page) {
-			const { timeline, totalMs, audioSegments } = await this.executeSteps(page);
+			const { timeline, totalMs } = await this.executeSteps(page);
 			return {
 				timeline,
 				totalMs,
@@ -452,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.0.9",
+  "version": "2.2.0",
   "description": "Playwright video production plugin — cursor overlay, keystroke badges, TTS narration, and narration-driven video scripts for test recordings",
   "license": "MIT",
   "repository": {
@@ -42,13 +42,17 @@
     "build": "tsdown",
     "test": "bunx playwright test",
     "demo": "bunx playwright test tests/demo.spec.ts --headed",
-    "prepublishOnly": "tsdown"
+    "prepublishOnly": "tsdown",
+    "lint": "oxlint src",
+    "typecheck": "tsgo --noEmit"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
     "@typescript/native-preview": "^7.0.0-dev.20260405.1",
+    "oxlint": "^1.59.0",
     "semantic-release": "^25.0.3",
-    "tsdown": "^0.21.7"
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.40.0"