@scenar/cli 0.10.0 → 0.11.1

package/src/render/stage-assets.js.map

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

package/src/render/stage-assets.ts

@@ -0,0 +1,130 @@
+import { copyFile, mkdir, readdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import type { AuthoredSoundtrack, AuthoredTitleCards } from "../util/load-ts.js";
+import {
+  SFX_DEST_PATHS,
+  type SfxAssetPaths,
+  resolveMusicAsset,
+} from "../util/soundtrack-assets.js";
+import { resolveLogoAsset } from "../util/scenario-assets.js";
+
+export interface StageRenderAssetsInput {
+  /** Absolute path to the scenario directory. */
+  readonly scenarioDir: string;
+  /** Absolute path of the Remotion public dir to stage into (created). */
+  readonly publicDir: string;
+  /** Whether the scenario has a narration manifest (+ clips to stage). */
+  readonly hasNarration: boolean;
+  /** Whether the scenario has a presenter manifest (+ clips to stage). */
+  readonly hasPresenter?: boolean;
+  /** The scenario's authored soundtrack, if any. */
+  readonly soundtrack?: AuthoredSoundtrack;
+  /**
+   * Absolute locations of the built-in SFX assets — required when
+   * `soundtrack.sfx` is enabled (the caller resolves them from
+   * `@scenar/react` via `resolveSfxAssetPaths`).
+   */
+  readonly sfxPaths?: SfxAssetPaths;
+  /** The scenario's authored title cards, if any (logo assets to stage). */
+  readonly titleCards?: AuthoredTitleCards;
+}
+
+/**
+ * Stage every local asset a render needs into a Remotion public dir, so
+ * `staticFile()` resolution inside `ScenarioComposition` finds real files.
+ *
+ * The layout mirrors how each src is written:
+ * - Narration clips: manifest srcs are manifest-relative (`./step-N.mp3`),
+ *   so the clips stage flat at the public root.
+ * - Presenter clips: same convention (`./step-N.mp4`), staged flat at the
+ *   public root beside the narration clips — the extensions never collide.
+ * - Music: `musicSrc` is scenario-relative (`./soundtrack/music.mp3`), so
+ *   the file stages at that same relative path. Remote URLs stage nothing.
+ * - Built-in SFX: staged at {@link SFX_DEST_PATHS}, the composition's
+ *   default `sfxSrcs`.
+ * - Title-card logos: `logoSrc` is scenario-relative like music, staged
+ *   at its relative path (intro and outro may share one file — it stages
+ *   once). Remote URLs stage nothing.
+ *
+ * Returns the number of files staged. Zero means the render needs no
+ * local assets and the caller can skip the public dir entirely.
+ */
+export async function stageRenderAssets(input: StageRenderAssetsInput): Promise<number> {
+  let staged = 0;
+
+  if (input.hasNarration) {
+    staged += await stageClipDirectory(input.scenarioDir, "narration", ".mp3", input.publicDir);
+  }
+
+  if (input.hasPresenter) {
+    staged += await stageClipDirectory(input.scenarioDir, "presenter", ".mp4", input.publicDir);
+  }
+
+  const musicSrc = input.soundtrack?.musicSrc;
+  if (musicSrc) {
+    const music = await resolveMusicAsset(input.scenarioDir, musicSrc);
+    if (music) {
+      const dest = join(input.publicDir, music.destRelPath);
+      await mkdir(dirname(dest), { recursive: true });
+      await copyFile(music.sourcePath, dest);
+      staged += 1;
+    }
+  }
+
+  if (input.soundtrack?.sfx && input.sfxPaths) {
+    for (const sound of ["click", "keystroke"] as const) {
+      const dest = join(input.publicDir, SFX_DEST_PATHS[sound]);
+      await mkdir(dirname(dest), { recursive: true });
+      await copyFile(input.sfxPaths[sound], dest);
+      staged += 1;
+    }
+  }
+
+  const stagedLogos = new Set<string>();
+  for (const side of ["intro", "outro"] as const) {
+    const logoSrc = input.titleCards?.[side]?.logoSrc;
+    if (!logoSrc) continue;
+    const logo = await resolveLogoAsset(
+      input.scenarioDir,
+      logoSrc,
+      `titleCards.${side}.logoSrc`,
+    );
+    if (!logo || stagedLogos.has(logo.destRelPath)) continue;
+    const dest = join(input.publicDir, logo.destRelPath);
+    await mkdir(dirname(dest), { recursive: true });
+    await copyFile(logo.sourcePath, dest);
+    stagedLogos.add(logo.destRelPath);
+    staged += 1;
+  }
+
+  return staged;
+}
+
+/**
+ * Copy every clip of one track (narration mp3s, presenter mp4s) flat into
+ * the public root — manifest srcs are manifest-relative (`./step-N.<ext>`),
+ * which `staticFile()` resolves at the root.
+ */
+async function stageClipDirectory(
+  scenarioDir: string,
+  trackDir: string,
+  extension: string,
+  publicDir: string,
+): Promise<number> {
+  const sourceDir = join(scenarioDir, trackDir);
+  let entries;
+  try {
+    entries = await readdir(sourceDir, { withFileTypes: true });
+  } catch {
+    return 0;
+  }
+
+  let staged = 0;
+  await mkdir(publicDir, { recursive: true });
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.toLowerCase().endsWith(extension)) continue;
+    await copyFile(join(sourceDir, entry.name), join(publicDir, entry.name));
+    staged += 1;
+  }
+  return staged;
+}

package/src/tts/echogarden.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"echogarden.d.ts","sourceRoot":"","sources":["../../../src/tts/echogarden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAmCtD"}
+{"version":3,"file":"echogarden.d.ts","sourceRoot":"","sources":["../../../src/tts/echogarden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAIrE;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAoCtD"}

package/src/tts/echogarden.js

@@ -1,3 +1,4 @@
+const ENGINE = "vits";
 /**
  * Checks whether the `echogarden` package is available at runtime.
  * Returns `true` if it can be imported, `false` otherwise.
@@ -24,6 +25,7 @@ export async function isEchogardenAvailable() {
 export function createEchogardenProvider() {
     return {
         name: "echogarden",
+        fingerprint: `echogarden/${ENGINE}`,
         async synthesize(text, options) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             let echogarden;
@@ -33,10 +35,10 @@ export function createEchogardenProvider() {
             catch {
                 throw new Error("Echogarden is not installed. Install it with:\n\n" +
                     "  pnpm add echogarden\n\n" +
-                    "Or use a different TTS provider: --tts edge-tts, --tts openai");
+                    "Or use a different TTS provider: --tts edge-tts, --tts openai, --tts elevenlabs");
             }
             const result = await echogarden.synthesize(text, {
-                engine: "vits",
+                engine: ENGINE,
                 voice: options.voice,
             });
             const rawAudio = result.audio;

package/src/tts/echogarden.js.map

@@ -1 +1 @@
-{"version":3,"file":"echogarden.js","sourceRoot":"","sources":["../../../src/tts/echogarden.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,YAAY;QAElB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,UAAe,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,mDAAmD;oBACnD,2BAA2B;oBAC3B,+DAA+D,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;YAC9B,MAAM,UAAU,GAAW,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC;YACxD,MAAM,OAAO,GAAW,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAe,MAAM,UAAU,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE5E,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC5B,UAAU;aACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"echogarden.js","sourceRoot":"","sources":["../../../src/tts/echogarden.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,MAAM,CAAC;AAEtB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc,MAAM,EAAE;QAEnC,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,UAAe,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,mDAAmD;oBACnD,2BAA2B;oBAC3B,iFAAiF,CAClF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;YAC9B,MAAM,UAAU,GAAW,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC;YACxD,MAAM,OAAO,GAAW,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAe,MAAM,UAAU,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE5E,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC5B,UAAU;aACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/src/tts/echogarden.ts

@@ -1,5 +1,7 @@
 import type { TtsProvider, TtsOptions, TtsResult } from "./types.js";
 
+const ENGINE = "vits";
+
 /**
  * Checks whether the `echogarden` package is available at runtime.
  * Returns `true` if it can be imported, `false` otherwise.
@@ -26,6 +28,7 @@ export async function isEchogardenAvailable(): Promise<boolean> {
 export function createEchogardenProvider(): TtsProvider {
   return {
     name: "echogarden",
+    fingerprint: `echogarden/${ENGINE}`,
 
     async synthesize(text: string, options: TtsOptions): Promise<TtsResult> {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -36,12 +39,12 @@ export function createEchogardenProvider(): TtsProvider {
         throw new Error(
           "Echogarden is not installed. Install it with:\n\n" +
           "  pnpm add echogarden\n\n" +
-          "Or use a different TTS provider: --tts edge-tts, --tts openai",
+          "Or use a different TTS provider: --tts edge-tts, --tts openai, --tts elevenlabs",
         );
       }
 
       const result = await echogarden.synthesize(text, {
-        engine: "vits",
+        engine: ENGINE,
         voice: options.voice,
       });
 

package/src/tts/edge-tts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-tts.d.ts","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAsCnD"}
+{"version":3,"file":"edge-tts.d.ts","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAuCnD"}

package/src/tts/edge-tts.js

@@ -39,6 +39,7 @@ export async function isEdgeTtsAvailable() {
 export function createEdgeTtsProvider() {
     return {
         name: "edge-tts",
+        fingerprint: `edge-tts/${DEFAULT_VOICE}`,
         async synthesize(text, options) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             let IsomorphicEdgeTTS;
@@ -49,7 +50,7 @@ export function createEdgeTtsProvider() {
             catch {
                 throw new Error("edge-tts-universal is not installed. Install it with:\n\n" +
                     "  pnpm add edge-tts-universal\n\n" +
-                    "Or use a different TTS provider: --tts echogarden, --tts openai");
+                    "Or use a different TTS provider: --tts echogarden, --tts openai, --tts elevenlabs");
             }
             const voice = options.voice ?? DEFAULT_VOICE;
             const tts = new IsomorphicEdgeTTS(text, voice);

package/src/tts/edge-tts.js.map

@@ -1 +1 @@
-{"version":3,"file":"edge-tts.js","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAEvD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,UAAU;QAEhB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,iBAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC/C,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,2DAA2D;oBACzD,mCAAmC;oBACnC,iEAAiE,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAElE,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzD,kDAAkD;gBAClD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"edge-tts.js","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAEvD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,YAAY,aAAa,EAAE;QAExC,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,iBAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC/C,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,2DAA2D;oBACzD,mCAAmC;oBACnC,mFAAmF,CACtF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAElE,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzD,kDAAkD;gBAClD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/src/tts/edge-tts.ts

@@ -43,6 +43,7 @@ export async function isEdgeTtsAvailable(): Promise<boolean> {
 export function createEdgeTtsProvider(): TtsProvider {
   return {
     name: "edge-tts",
+    fingerprint: `edge-tts/${DEFAULT_VOICE}`,
 
     async synthesize(text: string, options: TtsOptions): Promise<TtsResult> {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -54,7 +55,7 @@ export function createEdgeTtsProvider(): TtsProvider {
         throw new Error(
           "edge-tts-universal is not installed. Install it with:\n\n" +
             "  pnpm add edge-tts-universal\n\n" +
-            "Or use a different TTS provider: --tts echogarden, --tts openai",
+            "Or use a different TTS provider: --tts echogarden, --tts openai, --tts elevenlabs",
         );
       }
 

package/src/tts/elevenlabs.d.ts

@@ -0,0 +1,15 @@
+import type { TtsProvider } from "./types.js";
+/**
+ * TTS provider backed by ElevenLabs' text-to-speech API.
+ * Requires the `ELEVENLABS_API_KEY` environment variable.
+ *
+ * Uses the `with-timestamps` endpoint variant so the audio duration comes
+ * from the API's character alignment data (exact) rather than a bitrate
+ * estimate. Duration drives step timing — `atPercent` interactions are
+ * measured against it — so precision here keeps narration and motion in sync.
+ *
+ * Model defaults to Multilingual v2 (~$0.10 per finished minute) and can be
+ * overridden with the `ELEVENLABS_MODEL_ID` environment variable.
+ */
+export declare function createElevenLabsProvider(): TtsProvider;
+//# sourceMappingURL=elevenlabs.d.ts.map

package/src/tts/elevenlabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../../src/tts/elevenlabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AA6BrE;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAsDtD"}

package/src/tts/elevenlabs.js

@@ -0,0 +1,73 @@
+const ELEVENLABS_TTS_URL = "https://api.elevenlabs.io/v1/text-to-speech";
+const DEFAULT_MODEL = "eleven_multilingual_v2";
+/** Rachel — an ElevenLabs stock voice available to every account. */
+const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+/**
+ * Requested output format: MP3, 44.1 kHz, 128 kbps. Available on the
+ * ElevenLabs free tier (192 kbps requires Creator+). The bitrate doubles
+ * as the fallback duration estimate when alignment data is unavailable.
+ */
+const OUTPUT_FORMAT = "mp3_44100_128";
+const OUTPUT_BITRATE_KBPS = 128;
+/**
+ * TTS provider backed by ElevenLabs' text-to-speech API.
+ * Requires the `ELEVENLABS_API_KEY` environment variable.
+ *
+ * Uses the `with-timestamps` endpoint variant so the audio duration comes
+ * from the API's character alignment data (exact) rather than a bitrate
+ * estimate. Duration drives step timing — `atPercent` interactions are
+ * measured against it — so precision here keeps narration and motion in sync.
+ *
+ * Model defaults to Multilingual v2 (~$0.10 per finished minute) and can be
+ * overridden with the `ELEVENLABS_MODEL_ID` environment variable.
+ */
+export function createElevenLabsProvider() {
+    const model = process.env["ELEVENLABS_MODEL_ID"] ?? DEFAULT_MODEL;
+    return {
+        name: "elevenlabs",
+        fingerprint: `elevenlabs/${model}/${DEFAULT_VOICE_ID}`,
+        async synthesize(text, options) {
+            const apiKey = process.env["ELEVENLABS_API_KEY"];
+            if (!apiKey) {
+                throw new Error("ELEVENLABS_API_KEY environment variable is not set.\n\n" +
+                    "Set it before running narrate:\n" +
+                    "  export ELEVENLABS_API_KEY=...\n\n" +
+                    "Or use a different TTS provider: --tts openai");
+            }
+            const voiceId = options.voice ?? DEFAULT_VOICE_ID;
+            const url = `${ELEVENLABS_TTS_URL}/${voiceId}/with-timestamps` +
+                `?output_format=${OUTPUT_FORMAT}`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "xi-api-key": apiKey,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    text,
+                    model_id: model,
+                }),
+            });
+            if (!response.ok) {
+                const body = await response.text();
+                throw new Error(`ElevenLabs TTS API error (${response.status}): ${body}`);
+            }
+            const payload = (await response.json());
+            const audio = Buffer.from(payload.audio_base64, "base64");
+            const endTimes = payload.alignment?.character_end_times_seconds;
+            const durationMs = endTimes && endTimes.length > 0
+                ? Math.ceil(endTimes[endTimes.length - 1] * 1000)
+                : estimateMp3DurationMs(audio);
+            return { audio, durationMs };
+        },
+    };
+}
+/**
+ * Rough MP3 duration estimate from file size and the requested bitrate.
+ * Only used as a fallback when the API returns no alignment data.
+ */
+function estimateMp3DurationMs(mp3) {
+    const bytes = mp3.byteLength;
+    return Math.round((bytes * 8) / OUTPUT_BITRATE_KBPS);
+}
+//# sourceMappingURL=elevenlabs.js.map

package/src/tts/elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.js","sourceRoot":"","sources":["../../../src/tts/elevenlabs.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,6CAA6C,CAAC;AACzE,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAE/C,qEAAqE;AACrE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAehC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,aAAa,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc,KAAK,IAAI,gBAAgB,EAAE;QAEtD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,yDAAyD;oBACzD,kCAAkC;oBAClC,qCAAqC;oBACrC,+CAA+C,CAChD,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC;YAClD,MAAM,GAAG,GACP,GAAG,kBAAkB,IAAI,OAAO,kBAAkB;gBAClD,kBAAkB,aAAa,EAAE,CAAC;YAEpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,YAAY,EAAE,MAAM;oBACpB,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,IAAI;oBACJ,QAAQ,EAAE,KAAK;iBAChB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACzD,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;YAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,2BAA2B,CAAC;YAChE,MAAM,UAAU,GACd,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAC7B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC;gBAClD,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAEnC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC;AACvD,CAAC"}

package/src/tts/elevenlabs.ts

@@ -0,0 +1,105 @@
+import type { TtsProvider, TtsOptions, TtsResult } from "./types.js";
+
+const ELEVENLABS_TTS_URL = "https://api.elevenlabs.io/v1/text-to-speech";
+const DEFAULT_MODEL = "eleven_multilingual_v2";
+
+/** Rachel — an ElevenLabs stock voice available to every account. */
+const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+
+/**
+ * Requested output format: MP3, 44.1 kHz, 128 kbps. Available on the
+ * ElevenLabs free tier (192 kbps requires Creator+). The bitrate doubles
+ * as the fallback duration estimate when alignment data is unavailable.
+ */
+const OUTPUT_FORMAT = "mp3_44100_128";
+const OUTPUT_BITRATE_KBPS = 128;
+
+/**
+ * Response shape of the `with-timestamps` endpoint variant: audio arrives
+ * base64-encoded alongside character-level timing alignment.
+ */
+interface TimestampsResponse {
+  audio_base64: string;
+  alignment: {
+    characters: string[];
+    character_start_times_seconds: number[];
+    character_end_times_seconds: number[];
+  } | null;
+}
+
+/**
+ * TTS provider backed by ElevenLabs' text-to-speech API.
+ * Requires the `ELEVENLABS_API_KEY` environment variable.
+ *
+ * Uses the `with-timestamps` endpoint variant so the audio duration comes
+ * from the API's character alignment data (exact) rather than a bitrate
+ * estimate. Duration drives step timing — `atPercent` interactions are
+ * measured against it — so precision here keeps narration and motion in sync.
+ *
+ * Model defaults to Multilingual v2 (~$0.10 per finished minute) and can be
+ * overridden with the `ELEVENLABS_MODEL_ID` environment variable.
+ */
+export function createElevenLabsProvider(): TtsProvider {
+  const model = process.env["ELEVENLABS_MODEL_ID"] ?? DEFAULT_MODEL;
+
+  return {
+    name: "elevenlabs",
+    fingerprint: `elevenlabs/${model}/${DEFAULT_VOICE_ID}`,
+
+    async synthesize(text: string, options: TtsOptions): Promise<TtsResult> {
+      const apiKey = process.env["ELEVENLABS_API_KEY"];
+      if (!apiKey) {
+        throw new Error(
+          "ELEVENLABS_API_KEY environment variable is not set.\n\n" +
+          "Set it before running narrate:\n" +
+          "  export ELEVENLABS_API_KEY=...\n\n" +
+          "Or use a different TTS provider: --tts openai",
+        );
+      }
+
+      const voiceId = options.voice ?? DEFAULT_VOICE_ID;
+      const url =
+        `${ELEVENLABS_TTS_URL}/${voiceId}/with-timestamps` +
+        `?output_format=${OUTPUT_FORMAT}`;
+
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "xi-api-key": apiKey,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          text,
+          model_id: model,
+        }),
+      });
+
+      if (!response.ok) {
+        const body = await response.text();
+        throw new Error(
+          `ElevenLabs TTS API error (${response.status}): ${body}`,
+        );
+      }
+
+      const payload = (await response.json()) as TimestampsResponse;
+      const audio = Buffer.from(payload.audio_base64, "base64");
+
+      const endTimes = payload.alignment?.character_end_times_seconds;
+      const durationMs =
+        endTimes && endTimes.length > 0
+          ? Math.ceil(endTimes[endTimes.length - 1]! * 1000)
+          : estimateMp3DurationMs(audio);
+
+      return { audio, durationMs };
+    },
+  };
+}
+
+/**
+ * Rough MP3 duration estimate from file size and the requested bitrate.
+ * Only used as a fallback when the API returns no alignment data.
+ */
+function estimateMp3DurationMs(mp3: Buffer): number {
+  const bytes = mp3.byteLength;
+  return Math.round((bytes * 8) / OUTPUT_BITRATE_KBPS);
+}

package/src/tts/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/tts/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAMrE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CA8ClD"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/tts/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAMrE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CA+ClD"}

package/src/tts/openai.js

@@ -8,13 +8,14 @@ const DEFAULT_VOICE = "alloy";
 export function createOpenAIProvider() {
     return {
         name: "openai",
+        fingerprint: `openai/${DEFAULT_MODEL}/${DEFAULT_VOICE}`,
         async synthesize(text, options) {
             const apiKey = process.env["OPENAI_API_KEY"];
             if (!apiKey) {
                 throw new Error("OPENAI_API_KEY environment variable is not set.\n\n" +
                     "Set it before running narrate:\n" +
                     "  export OPENAI_API_KEY=sk-...\n\n" +
-                    "Or use a different TTS provider: --tts echogarden");
+                    "Or use a different TTS provider: --tts echogarden, --tts elevenlabs");
             }
             const voice = options.voice ?? DEFAULT_VOICE;
             const response = await fetch(OPENAI_TTS_URL, {

package/src/tts/openai.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/tts/openai.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAChE,MAAM,aAAa,GAAG,OAAO,CAAC;AAC9B,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,QAAQ;QAEd,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,qDAAqD;oBACrD,kCAAkC;oBAClC,oCAAoC;oBACpC,mDAAmD,CACpD,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAE7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,MAAM,EAAE;oBACnC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,aAAa;oBACpB,KAAK,EAAE,IAAI;oBACX,KAAK;oBACL,eAAe,EAAE,KAAK;iBACvB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACrD,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEvC,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAEhD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,GAAW;IACxC,MAAM,oBAAoB,GAAG,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/tts/openai.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAChE,MAAM,aAAa,GAAG,OAAO,CAAC;AAC9B,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,UAAU,aAAa,IAAI,aAAa,EAAE;QAEvD,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,qDAAqD;oBACrD,kCAAkC;oBAClC,oCAAoC;oBACpC,qEAAqE,CACtE,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAE7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,MAAM,EAAE;oBACnC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,aAAa;oBACpB,KAAK,EAAE,IAAI;oBACX,KAAK;oBACL,eAAe,EAAE,KAAK;iBACvB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACrD,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEvC,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAEhD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,GAAW;IACxC,MAAM,oBAAoB,GAAG,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC;AACxD,CAAC"}

package/src/tts/openai.ts

@@ -11,6 +11,7 @@ const DEFAULT_VOICE = "alloy";
 export function createOpenAIProvider(): TtsProvider {
   return {
     name: "openai",
+    fingerprint: `openai/${DEFAULT_MODEL}/${DEFAULT_VOICE}`,
 
     async synthesize(text: string, options: TtsOptions): Promise<TtsResult> {
       const apiKey = process.env["OPENAI_API_KEY"];
@@ -19,7 +20,7 @@ export function createOpenAIProvider(): TtsProvider {
           "OPENAI_API_KEY environment variable is not set.\n\n" +
           "Set it before running narrate:\n" +
           "  export OPENAI_API_KEY=sk-...\n\n" +
-          "Or use a different TTS provider: --tts echogarden",
+          "Or use a different TTS provider: --tts echogarden, --tts elevenlabs",
         );
       }
 

package/src/tts/resolve-provider.d.ts

@@ -1,5 +1,5 @@
 import type { TtsProvider } from "./types.js";
-export type TtsProviderName = "echogarden" | "edge-tts" | "openai";
+export type TtsProviderName = "echogarden" | "edge-tts" | "openai" | "elevenlabs";
 /**
  * Resolve a TTS provider by name.
  *

package/src/tts/resolve-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-provider.d.ts","sourceRoot":"","sources":["../../../src/tts/resolve-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAQnE;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwChF"}
+{"version":3,"file":"resolve-provider.d.ts","sourceRoot":"","sources":["../../../src/tts/resolve-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;AASlF;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8ChF"}

package/src/tts/resolve-provider.js

@@ -1,10 +1,12 @@
 import { createEchogardenProvider, isEchogardenAvailable } from "./echogarden.js";
 import { createEdgeTtsProvider, isEdgeTtsAvailable } from "./edge-tts.js";
+import { createElevenLabsProvider } from "./elevenlabs.js";
 import { createOpenAIProvider } from "./openai.js";
 const KNOWN_PROVIDERS = new Set([
     "echogarden",
     "edge-tts",
     "openai",
+    "elevenlabs",
 ]);
 /**
  * Resolve a TTS provider by name.
@@ -21,6 +23,9 @@ export async function resolveProvider(providerName) {
     if (providerName === "openai") {
         return createOpenAIProvider();
     }
+    if (providerName === "elevenlabs") {
+        return createElevenLabsProvider();
+    }
     if (providerName === "edge-tts") {
         const available = await isEdgeTtsAvailable();
         if (!available) {
@@ -28,7 +33,8 @@ export async function resolveProvider(providerName) {
                 "  pnpm add edge-tts-universal\n\n" +
                 "Or use a different provider:\n\n" +
                 "  scenar narrate <file> --tts echogarden   (offline, pnpm add echogarden)\n" +
-                "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)");
+                "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)\n" +
+                "  scenar narrate <file> --tts elevenlabs    (requires ELEVENLABS_API_KEY)");
         }
         return createEdgeTtsProvider();
     }
@@ -39,8 +45,9 @@ export async function resolveProvider(providerName) {
             "Or use free online TTS (requires network):\n\n" +
             "  scenar narrate <file> --tts edge-tts\n" +
             "  pnpm add edge-tts-universal\n\n" +
-            "Or use OpenAI TTS (requires API key):\n\n" +
-            "  scenar narrate <file> --tts openai");
+            "Or use an API-key TTS provider:\n\n" +
+            "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)\n" +
+            "  scenar narrate <file> --tts elevenlabs    (requires ELEVENLABS_API_KEY)");
     }
     return createEchogardenProvider();
 }

package/src/tts/resolve-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-provider.js","sourceRoot":"","sources":["../../../src/tts/resolve-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAkB;IACpE,YAAY;IACZ,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoB;IACxD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,0BAA0B,YAAY,KAAK;YAC3C,wBAAwB,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3D,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,kEAAkE;gBAClE,mCAAmC;gBACnC,kCAAkC;gBAClC,6EAA6E;gBAC7E,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,2DAA2D;YAC3D,2BAA2B;YAC3B,gDAAgD;YAChD,0CAA0C;YAC1C,mCAAmC;YACnC,2CAA2C;YAC3C,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAED,OAAO,wBAAwB,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"resolve-provider.js","sourceRoot":"","sources":["../../../src/tts/resolve-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAkB;IACpE,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,YAAY;CACb,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoB;IACxD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,0BAA0B,YAAY,KAAK;YAC3C,wBAAwB,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3D,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,oBAAoB,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,wBAAwB,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,kEAAkE;gBAClE,mCAAmC;gBACnC,kCAAkC;gBAClC,6EAA6E;gBAC7E,yEAAyE;gBACzE,2EAA2E,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,2DAA2D;YAC3D,2BAA2B;YAC3B,gDAAgD;YAChD,0CAA0C;YAC1C,mCAAmC;YACnC,qCAAqC;YACrC,yEAAyE;YACzE,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO,wBAAwB,EAAE,CAAC;AACpC,CAAC"}

package/src/tts/resolve-provider.ts

@@ -1,14 +1,16 @@
 import type { TtsProvider } from "./types.js";
 import { createEchogardenProvider, isEchogardenAvailable } from "./echogarden.js";
 import { createEdgeTtsProvider, isEdgeTtsAvailable } from "./edge-tts.js";
+import { createElevenLabsProvider } from "./elevenlabs.js";
 import { createOpenAIProvider } from "./openai.js";
 
-export type TtsProviderName = "echogarden" | "edge-tts" | "openai";
+export type TtsProviderName = "echogarden" | "edge-tts" | "openai" | "elevenlabs";
 
 const KNOWN_PROVIDERS: ReadonlySet<string> = new Set<TtsProviderName>([
   "echogarden",
   "edge-tts",
   "openai",
+  "elevenlabs",
 ]);
 
 /**
@@ -30,6 +32,10 @@ export async function resolveProvider(providerName: string): Promise<TtsProvider
     return createOpenAIProvider();
   }
 
+  if (providerName === "elevenlabs") {
+    return createElevenLabsProvider();
+  }
+
   if (providerName === "edge-tts") {
     const available = await isEdgeTtsAvailable();
     if (!available) {
@@ -38,7 +44,8 @@ export async function resolveProvider(providerName: string): Promise<TtsProvider
         "  pnpm add edge-tts-universal\n\n" +
         "Or use a different provider:\n\n" +
         "  scenar narrate <file> --tts echogarden   (offline, pnpm add echogarden)\n" +
-        "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)",
+        "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)\n" +
+        "  scenar narrate <file> --tts elevenlabs    (requires ELEVENLABS_API_KEY)",
       );
     }
     return createEdgeTtsProvider();
@@ -52,8 +59,9 @@ export async function resolveProvider(providerName: string): Promise<TtsProvider
       "Or use free online TTS (requires network):\n\n" +
       "  scenar narrate <file> --tts edge-tts\n" +
       "  pnpm add edge-tts-universal\n\n" +
-      "Or use OpenAI TTS (requires API key):\n\n" +
-      "  scenar narrate <file> --tts openai",
+      "Or use an API-key TTS provider:\n\n" +
+      "  scenar narrate <file> --tts openai        (requires OPENAI_API_KEY)\n" +
+      "  scenar narrate <file> --tts elevenlabs    (requires ELEVENLABS_API_KEY)",
     );
   }