@scenar/cli 0.1.20 → 0.2.1

package/src/commands/serve.js.map

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

package/src/commands/serve.ts

@@ -0,0 +1,112 @@
+import { spawn } from "node:child_process";
+import { platform } from "node:process";
+import { Command } from "commander";
+import { runServe } from "../serve/run-serve.js";
+import type { BundleServerHandle } from "../serve/static-server.js";
+
+/** Vite's preview port — the conventional "serve a built site" port. */
+const DEFAULT_PORT = 4173;
+
+/** Bind to loopback by default; a preview is a single-developer tool. */
+const DEFAULT_HOST = "localhost";
+
+interface ServeOptions {
+  port?: string;
+  host?: string;
+  open?: boolean;
+}
+
+export function registerServeCommand(program: Command): void {
+  program
+    .command("serve")
+    .description(
+      "Serve a packed bundle locally and print its embed URL.\n\n" +
+        "Takes a bundle directory produced by `scenar pack` and serves it as a\n" +
+        "static site on http://localhost:4173 (override with --port/--host).\n" +
+        "Prints the URL plus a ready-to-paste responsive <iframe> snippet, then\n" +
+        "stays running until you press Ctrl+C.\n\n" +
+        "This is the zero-infrastructure way to view an embed: no backend, no\n" +
+        "account. For a permanent public URL, use `scenar publish` (GitHub\n" +
+        "Pages) or `scenar deploy` (Scenar Cloud).",
+    )
+    .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
+    .option("--port <number>", `port to listen on (default: ${DEFAULT_PORT})`, String(DEFAULT_PORT))
+    .option("--host <host>", `host/interface to bind (default: ${DEFAULT_HOST})`, DEFAULT_HOST)
+    .option("--open", "open the embed in your default browser")
+    .action(async (bundleDir: string, options: ServeOptions) => {
+      try {
+        const port = Number(options.port);
+        if (!Number.isInteger(port) || port < 0 || port > 65535) {
+          throw new Error(`invalid --port "${options.port}"; expected an integer between 0 and 65535.`);
+        }
+        const host = options.host ?? DEFAULT_HOST;
+
+        let result;
+        try {
+          result = await runServe({ bundleDir, port, host });
+        } catch (error) {
+          if (isAddrInUse(error)) {
+            throw new Error(
+              `port ${port} is already in use. Stop the other process or pass --port <number>.`,
+            );
+          }
+          throw error;
+        }
+
+        process.stderr.write(`\n\x1b[32m✓\x1b[0m Serving at ${result.url}\n`);
+        if (!result.recordedViewport) {
+          process.stderr.write(
+            "  Note: no recorded viewport; snippet uses the default " +
+              `${result.viewport.width}x${result.viewport.height}. Re-pack with the current CLI ` +
+              "to embed at the exact aspect ratio.\n",
+          );
+        }
+        process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
+        process.stderr.write(`${indent(result.snippet)}\n`);
+        process.stderr.write("\n  Press Ctrl+C to stop.\n");
+
+        if (options.open) {
+          openInBrowser(result.url);
+        }
+
+        await runUntilInterrupted(result.handle);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+        process.exitCode = 1;
+      }
+    });
+}
+
+/** Block until SIGINT/SIGTERM, then close the server cleanly. */
+function runUntilInterrupted(handle: BundleServerHandle): Promise<void> {
+  return new Promise<void>((resolvePromise) => {
+    const shutdown = () => {
+      process.stderr.write("\nStopping...\n");
+      void handle.close().finally(() => resolvePromise());
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+  });
+}
+
+/** Best-effort: launch the OS default browser. Failures are silent (non-fatal). */
+function openInBrowser(url: string): void {
+  const command = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  try {
+    const child = spawn(command, [url], { stdio: "ignore", detached: true, shell: platform === "win32" });
+    child.on("error", () => {});
+    child.unref();
+  } catch {
+    // Opening a browser is a convenience; never fail the command over it.
+  }
+}
+
+function isAddrInUse(error: unknown): boolean {
+  return typeof error === "object" && error !== null && (error as { code?: string }).code === "EADDRINUSE";
+}
+
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block: string): string {
+  return block.replace(/^/gm, "  ");
+}

package/src/commands/try.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerTryCommand(program: Command): void;
+//# sourceMappingURL=try.d.ts.map

package/src/commands/try.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"try.d.ts","sourceRoot":"","sources":["../../../src/commands/try.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2DzD"}

package/src/commands/try.js

@@ -0,0 +1,99 @@
+import { spawn } from "node:child_process";
+import { platform } from "node:process";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { stat } from "node:fs/promises";
+import { runServe } from "../serve/run-serve.js";
+/** Vite's preview port — the conventional "serve a built site" port. */
+const DEFAULT_PORT = 4173;
+/** Bind to loopback by default; a preview is a single-developer tool. */
+const DEFAULT_HOST = "localhost";
+/**
+ * The example bundle that ships with the CLI. It's generated at build time
+ * (`pack examples/welcome-tour --out dist/example-bundle`, see package.json) and
+ * published as part of dist/, so it's present for npx consumers. This module
+ * compiles to dist/src/commands/try.js, so the bundle sits two levels up.
+ */
+const EXAMPLE_BUNDLE_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "../../example-bundle");
+export function registerTryCommand(program) {
+    program
+        .command("try")
+        .description("Serve the bundled welcome-tour example locally — no app required.\n\n" +
+        "Boots the example embed that ships with the CLI on\n" +
+        "http://localhost:4173 (override with --port/--host) and prints a\n" +
+        "ready-to-paste <iframe> snippet, then stays running until Ctrl+C.\n\n" +
+        "This is the fastest way to see what a Scenar embed looks like before\n" +
+        "wiring up your own app. To build a tour from your components, see\n" +
+        "`scenar preview`; to host one, see `scenar publish`.")
+        .option("--port <number>", `port to listen on (default: ${DEFAULT_PORT})`, String(DEFAULT_PORT))
+        .option("--host <host>", `host/interface to bind (default: ${DEFAULT_HOST})`, DEFAULT_HOST)
+        .option("--open", "open the embed in your default browser")
+        .action(async (options) => {
+        try {
+            const port = Number(options.port);
+            if (!Number.isInteger(port) || port < 0 || port > 65535) {
+                throw new Error(`invalid --port "${options.port}"; expected an integer between 0 and 65535.`);
+            }
+            const host = options.host ?? DEFAULT_HOST;
+            const bundle = await stat(EXAMPLE_BUNDLE_DIR).catch(() => null);
+            if (!bundle || !bundle.isDirectory()) {
+                throw new Error("the bundled example is missing. If you installed @scenar/cli from npm, " +
+                    "reinstall it; if you're running from source, run `pnpm build` first.");
+            }
+            let result;
+            try {
+                result = await runServe({ bundleDir: EXAMPLE_BUNDLE_DIR, port, host });
+            }
+            catch (error) {
+                if (isAddrInUse(error)) {
+                    throw new Error(`port ${port} is already in use. Stop the other process or pass --port <number>.`);
+                }
+                throw error;
+            }
+            process.stderr.write(`\n\x1b[32m✓\x1b[0m Serving the welcome-tour example at ${result.url}\n`);
+            process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
+            process.stderr.write(`${indent(result.snippet)}\n`);
+            process.stderr.write("\n  Press Ctrl+C to stop.\n");
+            if (options.open) {
+                openInBrowser(result.url);
+            }
+            await runUntilInterrupted(result.handle);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+/** Block until SIGINT/SIGTERM, then close the server cleanly. */
+function runUntilInterrupted(handle) {
+    return new Promise((resolvePromise) => {
+        const shutdown = () => {
+            process.stderr.write("\nStopping...\n");
+            void handle.close().finally(() => resolvePromise());
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    });
+}
+/** Best-effort: launch the OS default browser. Failures are silent (non-fatal). */
+function openInBrowser(url) {
+    const command = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+    try {
+        const child = spawn(command, [url], { stdio: "ignore", detached: true, shell: platform === "win32" });
+        child.on("error", () => { });
+        child.unref();
+    }
+    catch {
+        // Opening a browser is a convenience; never fail the command over it.
+    }
+}
+function isAddrInUse(error) {
+    return typeof error === "object" && error !== null && error.code === "EADDRINUSE";
+}
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block) {
+    return block.replace(/^/gm, "  ");
+}
+//# sourceMappingURL=try.js.map

package/src/commands/try.js.map

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

package/src/commands/try.ts

@@ -0,0 +1,122 @@
+import { spawn } from "node:child_process";
+import { platform } from "node:process";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { stat } from "node:fs/promises";
+import { Command } from "commander";
+import { runServe } from "../serve/run-serve.js";
+import type { BundleServerHandle } from "../serve/static-server.js";
+
+/** Vite's preview port — the conventional "serve a built site" port. */
+const DEFAULT_PORT = 4173;
+
+/** Bind to loopback by default; a preview is a single-developer tool. */
+const DEFAULT_HOST = "localhost";
+
+/**
+ * The example bundle that ships with the CLI. It's generated at build time
+ * (`pack examples/welcome-tour --out dist/example-bundle`, see package.json) and
+ * published as part of dist/, so it's present for npx consumers. This module
+ * compiles to dist/src/commands/try.js, so the bundle sits two levels up.
+ */
+const EXAMPLE_BUNDLE_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "../../example-bundle");
+
+interface TryOptions {
+  port?: string;
+  host?: string;
+  open?: boolean;
+}
+
+export function registerTryCommand(program: Command): void {
+  program
+    .command("try")
+    .description(
+      "Serve the bundled welcome-tour example locally — no app required.\n\n" +
+        "Boots the example embed that ships with the CLI on\n" +
+        "http://localhost:4173 (override with --port/--host) and prints a\n" +
+        "ready-to-paste <iframe> snippet, then stays running until Ctrl+C.\n\n" +
+        "This is the fastest way to see what a Scenar embed looks like before\n" +
+        "wiring up your own app. To build a tour from your components, see\n" +
+        "`scenar preview`; to host one, see `scenar publish`.",
+    )
+    .option("--port <number>", `port to listen on (default: ${DEFAULT_PORT})`, String(DEFAULT_PORT))
+    .option("--host <host>", `host/interface to bind (default: ${DEFAULT_HOST})`, DEFAULT_HOST)
+    .option("--open", "open the embed in your default browser")
+    .action(async (options: TryOptions) => {
+      try {
+        const port = Number(options.port);
+        if (!Number.isInteger(port) || port < 0 || port > 65535) {
+          throw new Error(`invalid --port "${options.port}"; expected an integer between 0 and 65535.`);
+        }
+        const host = options.host ?? DEFAULT_HOST;
+
+        const bundle = await stat(EXAMPLE_BUNDLE_DIR).catch(() => null);
+        if (!bundle || !bundle.isDirectory()) {
+          throw new Error(
+            "the bundled example is missing. If you installed @scenar/cli from npm, " +
+              "reinstall it; if you're running from source, run `pnpm build` first.",
+          );
+        }
+
+        let result;
+        try {
+          result = await runServe({ bundleDir: EXAMPLE_BUNDLE_DIR, port, host });
+        } catch (error) {
+          if (isAddrInUse(error)) {
+            throw new Error(
+              `port ${port} is already in use. Stop the other process or pass --port <number>.`,
+            );
+          }
+          throw error;
+        }
+
+        process.stderr.write(`\n\x1b[32m✓\x1b[0m Serving the welcome-tour example at ${result.url}\n`);
+        process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
+        process.stderr.write(`${indent(result.snippet)}\n`);
+        process.stderr.write("\n  Press Ctrl+C to stop.\n");
+
+        if (options.open) {
+          openInBrowser(result.url);
+        }
+
+        await runUntilInterrupted(result.handle);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
+        process.exitCode = 1;
+      }
+    });
+}
+
+/** Block until SIGINT/SIGTERM, then close the server cleanly. */
+function runUntilInterrupted(handle: BundleServerHandle): Promise<void> {
+  return new Promise<void>((resolvePromise) => {
+    const shutdown = () => {
+      process.stderr.write("\nStopping...\n");
+      void handle.close().finally(() => resolvePromise());
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+  });
+}
+
+/** Best-effort: launch the OS default browser. Failures are silent (non-fatal). */
+function openInBrowser(url: string): void {
+  const command = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  try {
+    const child = spawn(command, [url], { stdio: "ignore", detached: true, shell: platform === "win32" });
+    child.on("error", () => {});
+    child.unref();
+  } catch {
+    // Opening a browser is a convenience; never fail the command over it.
+  }
+}
+
+function isAddrInUse(error: unknown): boolean {
+  return typeof error === "object" && error !== null && (error as { code?: string }).code === "EADDRINUSE";
+}
+
+/** Indent every line by two spaces (for nesting a block under a heading). */
+function indent(block: string): string {
+  return block.replace(/^/gm, "  ");
+}

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,aAAa,IAAI,OAAO,CAgBvC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,aAAa,IAAI,OAAO,CAmBvC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGxC"}

package/src/index.js

@@ -4,6 +4,9 @@ import { registerNarrateCommand } from "./commands/narrate.js";
 import { registerPreviewCommand } from "./commands/preview.js";
 import { registerRenderCommand } from "./commands/render.js";
 import { registerPackCommand } from "./commands/pack.js";
+import { registerServeCommand } from "./commands/serve.js";
+import { registerTryCommand } from "./commands/try.js";
+import { registerPublishCommand } from "./commands/publish.js";
 import { registerDeployCommand } from "./commands/deploy.js";
 export function createProgram() {
     const program = new Command();
@@ -16,6 +19,9 @@ export function createProgram() {
     registerRenderCommand(program);
     registerPreviewCommand(program);
     registerPackCommand(program);
+    registerServeCommand(program);
+    registerTryCommand(program);
+    registerPublishCommand(program);
     registerDeployCommand(program);
     return program;
 }

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,8FAA8F,CAAC;SAC3G,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAc;IAChC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,8FAA8F,CAAC;SAC3G,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAc;IAChC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/src/index.ts

@@ -4,6 +4,9 @@ import { registerNarrateCommand } from "./commands/narrate.js";
 import { registerPreviewCommand } from "./commands/preview.js";
 import { registerRenderCommand } from "./commands/render.js";
 import { registerPackCommand } from "./commands/pack.js";
+import { registerServeCommand } from "./commands/serve.js";
+import { registerTryCommand } from "./commands/try.js";
+import { registerPublishCommand } from "./commands/publish.js";
 import { registerDeployCommand } from "./commands/deploy.js";
 
 export function createProgram(): Command {
@@ -19,6 +22,9 @@ export function createProgram(): Command {
   registerRenderCommand(program);
   registerPreviewCommand(program);
   registerPackCommand(program);
+  registerServeCommand(program);
+  registerTryCommand(program);
+  registerPublishCommand(program);
   registerDeployCommand(program);
 
   return program;

package/src/narrate/run-narrate.d.ts

@@ -0,0 +1,43 @@
+/** Options for {@link runNarrate}. Paths may be relative; resolved here. */
+export interface RunNarrateOptions {
+    /** A scenario YAML file, a .ts steps file, or a directory of scenarios. */
+    readonly target: string;
+    /** TTS provider name: echogarden, edge-tts, or openai (default echogarden). */
+    readonly tts?: string;
+    /** Output directory for audio (default: alongside the scenario). */
+    readonly out?: string;
+    /** Voice name (provider-specific). */
+    readonly voice?: string;
+    /** URL path prefix for the `src` fields written into the manifest. */
+    readonly baseUrl?: string;
+    /** Progress sink for per-step/per-scenario messages. */
+    readonly onLog?: (message: string) => void;
+}
+/** Per-scenario narration outcome. */
+export interface NarratedScenario {
+    readonly id: string;
+    readonly generated: number;
+    readonly cached: number;
+    /** True when the scenario had no narration text (nothing to synthesize). */
+    readonly skipped: boolean;
+}
+/** Aggregate result of a narrate run. */
+export interface NarrateResult {
+    readonly mode: "file" | "directory";
+    readonly scenarios: NarratedScenario[];
+    readonly totalGenerated: number;
+    readonly totalCached: number;
+    readonly totalSkipped: number;
+    readonly errors: Array<{
+        id: string;
+        message: string;
+    }>;
+}
+/**
+ * Generate narration audio for a scenario file or a directory of scenarios —
+ * the pure orchestration behind `scenar narrate`. Resolves the TTS provider,
+ * synthesizes per-step audio (incremental via a content-hash cache), writes each
+ * scenario's manifest, and returns aggregate stats. No process/exit coupling.
+ */
+export declare function runNarrate(options: RunNarrateOptions): Promise<NarrateResult>;
+//# sourceMappingURL=run-narrate.d.ts.map

package/src/narrate/run-narrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-narrate.d.ts","sourceRoot":"","sources":["../../../src/narrate/run-narrate.ts"],"names":[],"mappings":"AAkBA,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAkID;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CASnF"}

package/src/narrate/run-narrate.js

@@ -0,0 +1,174 @@
+import { mkdir, writeFile, stat } from "node:fs/promises";
+import { join, resolve, extname, basename, dirname } from "node:path";
+import { loadScenarioYaml } from "../util/load-yaml.js";
+import { loadStepsFromTs } from "../util/load-ts.js";
+import { discoverScenarios } from "../util/discover-scenarios.js";
+import { computeHash, loadCache, saveCache, fileExists, isCached, getCachedDuration, buildCacheFile, } from "../util/narration-cache.js";
+import { validateScenario } from "../validate/scenario-validator.js";
+import { resolveProvider } from "../tts/resolve-provider.js";
+function extractNarratedSteps(steps) {
+    const result = [];
+    for (let i = 0; i < steps.length; i++) {
+        const text = steps[i].narration ?? steps[i].narrationText;
+        if (typeof text === "string" && text.length > 0) {
+            result.push({ index: i, text });
+        }
+    }
+    return result;
+}
+function buildRuntimeManifest(totalSteps, entries) {
+    const steps = Array.from({ length: totalSteps }, () => null);
+    for (const [idx, entry] of entries) {
+        steps[idx] = entry;
+    }
+    return { steps };
+}
+async function loadStepsFromFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (ext === ".ts" || ext === ".tsx") {
+        const steps = await loadStepsFromTs(filePath);
+        return { steps, totalSteps: steps.length };
+    }
+    const scenario = await loadScenarioYaml(filePath);
+    const validation = validateScenario(scenario);
+    if (!validation.valid) {
+        throw new Error(`Scenario has ${validation.errors.length} error(s). Run 'scenar validate ${filePath}' for details.`);
+    }
+    const steps = scenario["steps"];
+    if (!steps) {
+        throw new Error("No steps found in scenario.");
+    }
+    return { steps: steps, totalSteps: steps.length };
+}
+async function generateNarration(opts) {
+    const { scenarioId, narratedSteps, totalSteps, outDir, voice, baseUrl, provider, onLog } = opts;
+    await mkdir(outDir, { recursive: true });
+    const existingCache = await loadCache(outDir);
+    const stats = { generated: 0, cached: 0 };
+    const manifestEntries = new Map();
+    const cacheEntries = new Map();
+    for (const step of narratedSteps) {
+        const hash = computeHash(step.text, voice);
+        const fileName = `step-${step.index}.mp3`;
+        const mp3Path = join(outDir, fileName);
+        const srcPrefix = baseUrl ? `${baseUrl.replace(/\/$/, "")}/${scenarioId}` : `.`;
+        const src = `${srcPrefix}/${fileName}`;
+        if (isCached(existingCache, step.index, hash, voice) && (await fileExists(mp3Path))) {
+            const durationMs = getCachedDuration(existingCache, step.index);
+            manifestEntries.set(step.index, { src, durationMs });
+            cacheEntries.set(step.index, { hash, durationMs });
+            stats.cached++;
+            onLog(`    step ${step.index}: cached`);
+            continue;
+        }
+        onLog(`    step ${step.index}: generating...`);
+        const result = await provider.synthesize(step.text, { voice: voice || undefined });
+        await writeFile(mp3Path, result.audio);
+        manifestEntries.set(step.index, { src, durationMs: result.durationMs });
+        cacheEntries.set(step.index, { hash, durationMs: result.durationMs });
+        stats.generated++;
+        onLog(`    step ${step.index}: ${result.durationMs}ms (${result.audio.length} bytes)`);
+    }
+    const manifest = buildRuntimeManifest(totalSteps, manifestEntries);
+    await writeFile(join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+    const cache = buildCacheFile(voice, totalSteps, cacheEntries);
+    await saveCache(outDir, cache);
+    onLog(`\x1b[32m+\x1b[0m ${scenarioId}: ${stats.generated} generated, ${stats.cached} cached`);
+    return stats;
+}
+/**
+ * Generate narration audio for a scenario file or a directory of scenarios —
+ * the pure orchestration behind `scenar narrate`. Resolves the TTS provider,
+ * synthesizes per-step audio (incremental via a content-hash cache), writes each
+ * scenario's manifest, and returns aggregate stats. No process/exit coupling.
+ */
+export async function runNarrate(options) {
+    const onLog = options.onLog ?? (() => { });
+    const provider = await resolveProvider(options.tts ?? "echogarden");
+    const resolved = resolve(options.target);
+    const info = await stat(resolved);
+    return info.isDirectory()
+        ? narrateDirectory(resolved, options, provider, onLog)
+        : narrateSingleFile(resolved, options, provider, onLog);
+}
+async function narrateSingleFile(filePath, options, provider, onLog) {
+    const { steps, totalSteps } = await loadStepsFromFile(filePath);
+    const narratedSteps = extractNarratedSteps(steps);
+    const id = basename(dirname(filePath));
+    if (narratedSteps.length === 0) {
+        return {
+            mode: "file",
+            scenarios: [{ id, generated: 0, cached: 0, skipped: true }],
+            totalGenerated: 0,
+            totalCached: 0,
+            totalSkipped: 1,
+            errors: [],
+        };
+    }
+    const outDir = options.out ?? join(dirname(filePath), "narration");
+    const stats = await generateNarration({
+        scenarioId: id,
+        narratedSteps,
+        totalSteps,
+        outDir,
+        voice: options.voice ?? "",
+        baseUrl: options.baseUrl,
+        provider,
+        onLog,
+    });
+    return {
+        mode: "file",
+        scenarios: [{ id, generated: stats.generated, cached: stats.cached, skipped: false }],
+        totalGenerated: stats.generated,
+        totalCached: stats.cached,
+        totalSkipped: 0,
+        errors: [],
+    };
+}
+async function narrateDirectory(dirPath, options, provider, onLog) {
+    const scenarios = await discoverScenarios(dirPath);
+    const result = [];
+    const errors = [];
+    let totalGenerated = 0;
+    let totalCached = 0;
+    let totalSkipped = 0;
+    if (scenarios.length > 0) {
+        onLog(`Discovered ${scenarios.length} scenario(s)`);
+    }
+    for (const scenario of scenarios) {
+        onLog(`  ${scenario.id}`);
+        try {
+            const steps = await loadStepsFromTs(scenario.stepsPath);
+            const narratedSteps = extractNarratedSteps(steps);
+            if (narratedSteps.length === 0) {
+                onLog("    (no narration)");
+                totalSkipped++;
+                result.push({ id: scenario.id, generated: 0, cached: 0, skipped: true });
+                continue;
+            }
+            const outDir = options.out
+                ? join(options.out, scenario.id)
+                : join(dirPath, scenario.id, "narration");
+            const stats = await generateNarration({
+                scenarioId: scenario.id,
+                narratedSteps,
+                totalSteps: steps.length,
+                outDir,
+                voice: options.voice ?? "",
+                baseUrl: options.baseUrl,
+                provider,
+                onLog,
+            });
+            totalGenerated += stats.generated;
+            totalCached += stats.cached;
+            result.push({ id: scenario.id, generated: stats.generated, cached: stats.cached, skipped: false });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            onLog(`    \x1b[31mfailed\x1b[0m: ${message}`);
+            errors.push({ id: scenario.id, message });
+        }
+    }
+    return { mode: "directory", scenarios: result, totalGenerated, totalCached, totalSkipped, errors };
+}
+//# sourceMappingURL=run-narrate.js.map

package/src/narrate/run-narrate.js.map

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