screenwright 0.1.0

package/dist/src/timeline/schema.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+const sceneEventSchema = z.object({
+    type: z.literal('scene'),
+    id: z.string(),
+    timestampMs: z.number().nonnegative(),
+    title: z.string(),
+    description: z.string().optional(),
+});
+const actionEventSchema = z.object({
+    type: z.literal('action'),
+    id: z.string(),
+    timestampMs: z.number().nonnegative(),
+    action: z.enum(['click', 'fill', 'hover', 'select', 'press', 'navigate']),
+    selector: z.string(),
+    value: z.string().optional(),
+    durationMs: z.number().nonnegative(),
+    boundingBox: z.object({
+        x: z.number(),
+        y: z.number(),
+        width: z.number().positive(),
+        height: z.number().positive(),
+    }).nullable(),
+});
+const cursorTargetEventSchema = z.object({
+    type: z.literal('cursor_target'),
+    id: z.string(),
+    timestampMs: z.number().nonnegative(),
+    fromX: z.number(),
+    fromY: z.number(),
+    toX: z.number(),
+    toY: z.number(),
+    moveDurationMs: z.number().positive(),
+    easing: z.literal('bezier'),
+});
+const narrationEventSchema = z.object({
+    type: z.literal('narration'),
+    id: z.string(),
+    timestampMs: z.number().nonnegative(),
+    text: z.string().min(1),
+    audioDurationMs: z.number().positive().optional(),
+    audioFile: z.string().optional(),
+});
+const waitEventSchema = z.object({
+    type: z.literal('wait'),
+    id: z.string(),
+    timestampMs: z.number().nonnegative(),
+    durationMs: z.number().positive(),
+    reason: z.enum(['pacing', 'narration_sync', 'page_load']),
+});
+const timelineEventSchema = z.discriminatedUnion('type', [
+    sceneEventSchema,
+    actionEventSchema,
+    cursorTargetEventSchema,
+    narrationEventSchema,
+    waitEventSchema,
+]);
+export const timelineSchema = z.object({
+    version: z.literal(1),
+    metadata: z.object({
+        testFile: z.string(),
+        scenarioFile: z.string(),
+        recordedAt: z.string().datetime(),
+        viewport: z.object({
+            width: z.number().int().positive(),
+            height: z.number().int().positive(),
+        }),
+        videoDurationMs: z.number().nonnegative(),
+        videoFile: z.string(),
+    }),
+    events: z.array(timelineEventSchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/timeline/schema.js.map

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

package/dist/src/timeline/types.d.ts

@@ -0,0 +1,67 @@
+export interface Timeline {
+    version: 1;
+    metadata: TimelineMetadata;
+    events: TimelineEvent[];
+}
+export interface TimelineMetadata {
+    testFile: string;
+    scenarioFile: string;
+    recordedAt: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    videoDurationMs: number;
+    videoFile: string;
+}
+export type TimelineEvent = SceneEvent | ActionEvent | CursorTargetEvent | NarrationEvent | WaitEvent;
+export interface SceneEvent {
+    type: 'scene';
+    id: string;
+    timestampMs: number;
+    title: string;
+    description?: string;
+}
+export type ActionType = 'click' | 'fill' | 'hover' | 'select' | 'press' | 'navigate';
+export interface ActionEvent {
+    type: 'action';
+    id: string;
+    timestampMs: number;
+    action: ActionType;
+    selector: string;
+    value?: string;
+    durationMs: number;
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+}
+export interface CursorTargetEvent {
+    type: 'cursor_target';
+    id: string;
+    timestampMs: number;
+    fromX: number;
+    fromY: number;
+    toX: number;
+    toY: number;
+    moveDurationMs: number;
+    easing: 'bezier';
+}
+export interface NarrationEvent {
+    type: 'narration';
+    id: string;
+    timestampMs: number;
+    text: string;
+    audioDurationMs?: number;
+    audioFile?: string;
+}
+export interface WaitEvent {
+    type: 'wait';
+    id: string;
+    timestampMs: number;
+    durationMs: number;
+    reason: 'pacing' | 'narration_sync' | 'page_load';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/timeline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/timeline/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,WAAW,CAAC;CACnD"}

package/dist/src/timeline/types.js

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

package/dist/src/timeline/types.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/src/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/src/voiceover/narration-timing.d.ts

@@ -0,0 +1,12 @@
+import type { Timeline } from '../timeline/types.js';
+export interface NarrationOptions {
+    modelPath?: string;
+    tempDir: string;
+}
+/**
+ * Generate voiceover WAV files for all narration events in a timeline.
+ * Updates each narration event with the audioFile path and actual duration.
+ * Returns a new timeline with updated narration events.
+ */
+export declare function generateNarration(timeline: Timeline, opts: NarrationOptions): Promise<Timeline>;
+//# sourceMappingURL=narration-timing.d.ts.map

package/dist/src/voiceover/narration-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-timing.d.ts","sourceRoot":"","sources":["../../../src/voiceover/narration-timing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,sBAAsB,CAAC;AAGrE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC,CAoBnB"}

package/dist/src/voiceover/narration-timing.js

@@ -0,0 +1,25 @@
+import { join } from 'node:path';
+import { synthesize } from './piper-engine.js';
+/**
+ * Generate voiceover WAV files for all narration events in a timeline.
+ * Updates each narration event with the audioFile path and actual duration.
+ * Returns a new timeline with updated narration events.
+ */
+export async function generateNarration(timeline, opts) {
+    const events = [...timeline.events];
+    for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        if (event.type !== 'narration')
+            continue;
+        const narration = event;
+        const outputPath = join(opts.tempDir, `narration-${narration.id}.wav`);
+        const result = await synthesize(narration.text, outputPath, opts.modelPath);
+        events[i] = {
+            ...narration,
+            audioFile: result.wavPath,
+            audioDurationMs: result.durationMs,
+        };
+    }
+    return { ...timeline, events };
+}
+//# sourceMappingURL=narration-timing.js.map

package/dist/src/voiceover/narration-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-timing.js","sourceRoot":"","sources":["../../../src/voiceover/narration-timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAkB,EAClB,IAAsB;IAEtB,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAEzC,MAAM,SAAS,GAAG,KAAuB,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5E,MAAM,CAAC,CAAC,CAAC,GAAG;YACV,GAAG,SAAS;YACZ,SAAS,EAAE,MAAM,CAAC,OAAO;YACzB,eAAe,EAAE,MAAM,CAAC,UAAU;SACnC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC"}

package/dist/src/voiceover/piper-engine.d.ts

@@ -0,0 +1,6 @@
+export interface SynthesizeResult {
+    wavPath: string;
+    durationMs: number;
+}
+export declare function synthesize(text: string, outputPath: string, modelPath?: string, piperBinOverride?: string): Promise<SynthesizeResult>;
+//# sourceMappingURL=piper-engine.d.ts.map

package/dist/src/voiceover/piper-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"piper-engine.d.ts","sourceRoot":"","sources":["../../../src/voiceover/piper-engine.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/dist/src/voiceover/piper-engine.js

@@ -0,0 +1,48 @@
+import { spawn } from 'node:child_process';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getVoiceModelPath, downloadPiper } from './voice-models.js';
+const execFileAsync = promisify(execFile);
+export async function synthesize(text, outputPath, modelPath, piperBinOverride) {
+    const piperBin = piperBinOverride ?? await downloadPiper();
+    const model = modelPath ?? getVoiceModelPath('en_US-amy-medium');
+    return new Promise((resolve, reject) => {
+        const proc = spawn(piperBin, [
+            '--model', model,
+            '--output_file', outputPath,
+        ]);
+        let stderr = '';
+        proc.stderr.on('data', (data) => { stderr += data; });
+        proc.on('close', async (code) => {
+            if (code !== 0) {
+                reject(new Error(`Piper exited with code ${code}: ${stderr}`));
+                return;
+            }
+            const durationMs = await measureDuration(outputPath);
+            resolve({ wavPath: outputPath, durationMs });
+        });
+        proc.stdin.write(text);
+        proc.stdin.end();
+    });
+}
+async function measureDuration(wavPath) {
+    try {
+        const { stdout } = await execFileAsync('ffprobe', [
+            '-v', 'quiet',
+            '-show_entries', 'format=duration',
+            '-of', 'csv=p=0',
+            wavPath,
+        ]);
+        return Math.round(parseFloat(stdout.trim()) * 1000);
+    }
+    catch {
+        // Fallback: estimate from file size (16kHz 16-bit mono WAV)
+        const { stat } = await import('node:fs/promises');
+        const stats = await stat(wavPath);
+        const dataBytes = stats.size - 44; // WAV header
+        const samplesPerSec = 22050;
+        const bytesPerSample = 2;
+        return Math.round((dataBytes / (samplesPerSec * bytesPerSample)) * 1000);
+    }
+}
+//# sourceMappingURL=piper-engine.js.map

package/dist/src/voiceover/piper-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piper-engine.js","sourceRoot":"","sources":["../../../src/voiceover/piper-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAO1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,UAAkB,EAClB,SAAkB,EAClB,gBAAyB;IAEzB,MAAM,QAAQ,GAAG,gBAAgB,IAAI,MAAM,aAAa,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,IAAI,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAEjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE;YAC3B,SAAS,EAAE,KAAK;YAChB,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC9B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;YACrD,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE;YAChD,IAAI,EAAE,OAAO;YACb,eAAe,EAAE,iBAAiB;YAClC,KAAK,EAAE,SAAS;YAChB,OAAO;SACR,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,aAAa;QAChD,MAAM,aAAa,GAAG,KAAK,CAAC;QAC5B,MAAM,cAAc,GAAG,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/src/voiceover/voice-models.d.ts

@@ -0,0 +1,18 @@
+export interface VoiceModel {
+    name: string;
+    onnxUrl: string;
+    configUrl: string;
+}
+export declare const DEFAULT_VOICE: VoiceModel;
+export declare function getScreenwrightDir(): string;
+export declare function getPiperBinPath(): string;
+export declare function getVoiceModelPath(modelName: string): string;
+export declare function getVoiceConfigPath(modelName: string): string;
+export declare function exists(path: string): Promise<boolean>;
+export declare function downloadPiper(): Promise<string>;
+export declare function downloadVoiceModel(model?: VoiceModel): Promise<string>;
+export declare function ensureDependencies(modelName?: string): Promise<{
+    piperBin: string;
+    modelPath: string;
+}>;
+//# sourceMappingURL=voice-models.d.ts.map

package/dist/src/voiceover/voice-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-models.d.ts","sourceRoot":"","sources":["../../../src/voiceover/voice-models.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,UAI3B,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3D;AAmED,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CASrD;AAED,wBAAsB,kBAAkB,CAAC,KAAK,GAAE,UAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3F;AAED,wBAAsB,kBAAkB,CAAC,SAAS,SAAqB,GAAG,OAAO,CAAC;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CASD"}

package/dist/src/voiceover/voice-models.js

@@ -0,0 +1,123 @@
+import { mkdir, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const PIPER_GITHUB = 'https://github.com/rhasspy/piper/releases/download';
+const PIPER_VERSION = '2023.11.14-2';
+const VOICE_BASE_URL = 'https://huggingface.co/rhasspy/piper-voices/resolve/v1.0.0';
+export const DEFAULT_VOICE = {
+    name: 'en_US-amy-medium',
+    onnxUrl: `${VOICE_BASE_URL}/en/en_US/amy/medium/en_US-amy-medium.onnx`,
+    configUrl: `${VOICE_BASE_URL}/en/en_US/amy/medium/en_US-amy-medium.onnx.json`,
+};
+export function getScreenwrightDir() {
+    return join(homedir(), '.screenwright');
+}
+export function getPiperBinPath() {
+    return join(getScreenwrightDir(), 'bin', 'piper');
+}
+export function getVoiceModelPath(modelName) {
+    return join(getScreenwrightDir(), 'voices', `${modelName}.onnx`);
+}
+export function getVoiceConfigPath(modelName) {
+    return join(getScreenwrightDir(), 'voices', `${modelName}.onnx.json`);
+}
+export async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// The official Piper aarch64 macOS release is mispackaged (ships x86_64 binary).
+// On macOS ARM64, use the Python piper-tts package which has native onnxruntime.
+function needsPythonFallback() {
+    return process.platform === 'darwin' && process.arch === 'arm64';
+}
+function getNativePiperUrl() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === 'linux') {
+        return `${PIPER_GITHUB}/${PIPER_VERSION}/piper_linux_${arch === 'arm64' ? 'aarch64' : 'x86_64'}.tar.gz`;
+    }
+    if (platform === 'darwin') {
+        return `${PIPER_GITHUB}/${PIPER_VERSION}/piper_macos_x64.tar.gz`;
+    }
+    throw new Error(`Unsupported platform: ${platform}`);
+}
+async function findPythonPiper() {
+    for (const cmd of ['piper', `${homedir()}/Library/Python/3.9/bin/piper`]) {
+        try {
+            await execFileAsync(cmd, ['--help']);
+            return cmd;
+        }
+        catch {
+            // not found
+        }
+    }
+    return null;
+}
+async function installPythonPiper() {
+    const existing = await findPythonPiper();
+    if (existing)
+        return existing;
+    console.log('Installing piper-tts via pip3...');
+    await execFileAsync('pip3', ['install', 'piper-tts', 'pathvalidate']);
+    const bin = await findPythonPiper();
+    if (!bin) {
+        throw new Error('pip3 install piper-tts succeeded but piper not found on PATH. ' +
+            'Add your pip bin directory to PATH.');
+    }
+    return bin;
+}
+async function downloadNativePiper() {
+    const binPath = getPiperBinPath();
+    if (await exists(binPath))
+        return binPath;
+    const binDir = join(getScreenwrightDir(), 'bin');
+    await mkdir(binDir, { recursive: true });
+    const url = getNativePiperUrl();
+    console.log(`Downloading Piper from ${url}...`);
+    await execFileAsync('bash', ['-c', `curl -sL "${url}" | tar xz -C "${binDir}" --strip-components=1`]);
+    await execFileAsync('chmod', ['+x', binPath]);
+    console.log('Piper installed successfully.');
+    return binPath;
+}
+export async function downloadPiper() {
+    // If piper is already on PATH (e.g. pip install in CI), use it
+    const existing = await findPythonPiper();
+    if (existing)
+        return existing;
+    if (needsPythonFallback()) {
+        return installPythonPiper();
+    }
+    return downloadNativePiper();
+}
+export async function downloadVoiceModel(model = DEFAULT_VOICE) {
+    const modelPath = getVoiceModelPath(model.name);
+    const configPath = getVoiceConfigPath(model.name);
+    if (await exists(modelPath) && await exists(configPath))
+        return modelPath;
+    const voicesDir = join(getScreenwrightDir(), 'voices');
+    await mkdir(voicesDir, { recursive: true });
+    console.log(`Downloading voice model: ${model.name}...`);
+    await execFileAsync('curl', ['-sL', '-o', modelPath, model.onnxUrl]);
+    await execFileAsync('curl', ['-sL', '-o', configPath, model.configUrl]);
+    console.log('Voice model downloaded.');
+    return modelPath;
+}
+export async function ensureDependencies(modelName = 'en_US-amy-medium') {
+    const piperBin = await downloadPiper();
+    const model = modelName === DEFAULT_VOICE.name ? DEFAULT_VOICE : {
+        name: modelName,
+        onnxUrl: `${VOICE_BASE_URL}/en/en_US/${modelName.split('-')[1]}/${modelName.split('-')[2]}/${modelName}.onnx`,
+        configUrl: `${VOICE_BASE_URL}/en/en_US/${modelName.split('-')[1]}/${modelName.split('-')[2]}/${modelName}.onnx.json`,
+    };
+    const modelPath = await downloadVoiceModel(model);
+    return { piperBin, modelPath };
+}
+//# sourceMappingURL=voice-models.js.map

package/dist/src/voiceover/voice-models.js.map

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