@scenar/cli 0.10.0 → 0.11.0

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tts/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tts/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/src/tts/types.ts

@@ -9,6 +9,16 @@ export interface TtsProvider {
   /** Human-readable name shown in logs and the narration manifest. */
   readonly name: string;
 
+  /**
+   * Cache identity: the provider name plus every piece of static
+   * configuration that changes the audio bytes (model, default voice,
+   * engine). The narration cache keys on this, so audio regenerates
+   * whenever any of those inputs change — switching providers or models
+   * must never serve stale audio from a previous configuration.
+   * Per-call inputs (requested voice, text) are hashed separately.
+   */
+  readonly fingerprint: string;
+
   /**
    * Generate speech audio for the given text.
    * Returns the raw audio bytes and the audio duration.

package/src/util/confirm.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ask a yes/no question on stderr and read the answer from stdin.
+ * Resolves true only on an explicit yes (`y`/`yes`, case-insensitive) —
+ * the safe default for anything that spends money or overwrites work.
+ *
+ * Callers own the non-interactive policy: when stdin is not a TTY,
+ * decide (and message) before calling this — a prompt nobody can
+ * answer just hangs a pipeline.
+ */
+export declare function confirm(question: string): Promise<boolean>;
+//# sourceMappingURL=confirm.d.ts.map

package/src/util/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../src/util/confirm.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWhE"}

package/src/util/confirm.js

@@ -0,0 +1,24 @@
+import { createInterface } from "node:readline";
+/**
+ * Ask a yes/no question on stderr and read the answer from stdin.
+ * Resolves true only on an explicit yes (`y`/`yes`, case-insensitive) —
+ * the safe default for anything that spends money or overwrites work.
+ *
+ * Callers own the non-interactive policy: when stdin is not a TTY,
+ * decide (and message) before calling this — a prompt nobody can
+ * answer just hangs a pipeline.
+ */
+export async function confirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        const answer = await new Promise((resolve) => {
+            rl.question(`${question} [y/N] `, resolve);
+        });
+        const normalized = answer.trim().toLowerCase();
+        return normalized === "y" || normalized === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=confirm.js.map

package/src/util/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/util/confirm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACnD,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;IACpD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/src/util/confirm.ts

@@ -0,0 +1,23 @@
+import { createInterface } from "node:readline";
+
+/**
+ * Ask a yes/no question on stderr and read the answer from stdin.
+ * Resolves true only on an explicit yes (`y`/`yes`, case-insensitive) —
+ * the safe default for anything that spends money or overwrites work.
+ *
+ * Callers own the non-interactive policy: when stdin is not a TTY,
+ * decide (and message) before calling this — a prompt nobody can
+ * answer just hangs a pipeline.
+ */
+export async function confirm(question: string): Promise<boolean> {
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = await new Promise<string>((resolve) => {
+      rl.question(`${question} [y/N] `, resolve);
+    });
+    const normalized = answer.trim().toLowerCase();
+    return normalized === "y" || normalized === "yes";
+  } finally {
+    rl.close();
+  }
+}

package/src/util/load-bundle.d.ts

@@ -1,7 +1,13 @@
+import { type AuthoredSoundtrack, type AuthoredTitleCards } from "./load-ts.js";
 /**
  * Lightweight bundle shape for CLI use. Mirrors the @scenar/core
  * ScenarioBundle interface but uses plain objects (the CLI does not
  * import @scenar/core at runtime to stay lightweight).
+ *
+ * Carries the AUTHORED shape: steps as written, title cards as config.
+ * Card-step synthesis (`applyTitleCards`) happens in the generated
+ * render/pack entries — the true bundle-assembly seam — never here; the
+ * CLI consumes this bundle for staging and inspection only.
  */
 export interface CliBundle {
     id: string;
@@ -15,11 +21,21 @@ export interface CliBundle {
             durationMs: number;
         } | null>;
     };
+    presenterManifest?: {
+        steps: Array<{
+            src: string;
+            durationMs: number;
+        } | null>;
+    };
+    soundtrack?: AuthoredSoundtrack;
+    titleCards?: AuthoredTitleCards;
 }
 /**
  * Load a scenario bundle from a directory.  Expects:
- *   <dir>/steps.ts       — required (step definitions)
+ *   <dir>/steps.ts       — required (step definitions, optional
+ *                          `soundtrack` named export)
  *   <dir>/narration/manifest.json — optional (narration manifest)
+ *   <dir>/presenter/manifest.json — optional (presenter manifest)
  *
  * The scenario id defaults to the directory base name.
  */

package/src/util/load-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-bundle.d.ts","sourceRoot":"","sources":["../../../src/util/load-bundle.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;KAC1D,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAoBhE"}
+{"version":3,"file":"load-bundle.d.ts","sourceRoot":"","sources":["../../../src/util/load-bundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;KAC1D,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;KAC1D,CAAC;IACF,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAehE"}

package/src/util/load-bundle.js

@@ -1,30 +1,38 @@
 import { readFile, access } from "node:fs/promises";
 import { join, basename } from "node:path";
-import { loadStepsFromTs } from "./load-ts.js";
+import { loadSoundtrackFromTs, loadStepsFromTs, loadTitleCardsFromTs, } from "./load-ts.js";
 /**
  * Load a scenario bundle from a directory.  Expects:
- *   <dir>/steps.ts       — required (step definitions)
+ *   <dir>/steps.ts       — required (step definitions, optional
+ *                          `soundtrack` named export)
  *   <dir>/narration/manifest.json — optional (narration manifest)
+ *   <dir>/presenter/manifest.json — optional (presenter manifest)
  *
  * The scenario id defaults to the directory base name.
  */
 export async function loadBundle(dir) {
     const stepsPath = join(dir, "steps.ts");
-    const manifestPath = join(dir, "narration", "manifest.json");
     const steps = await loadStepsFromTs(stepsPath);
-    let narrationManifest;
+    const soundtrack = await loadSoundtrackFromTs(stepsPath);
+    const titleCards = await loadTitleCardsFromTs(stepsPath);
+    return {
+        id: basename(dir),
+        steps,
+        narrationManifest: await readPositionalManifest(join(dir, "narration", "manifest.json")),
+        presenterManifest: await readPositionalManifest(join(dir, "presenter", "manifest.json")),
+        soundtrack: soundtrack ?? undefined,
+        titleCards: titleCards ?? undefined,
+    };
+}
+/** Read a positional clip manifest, or undefined when none exists. */
+async function readPositionalManifest(manifestPath) {
     try {
         await access(manifestPath);
         const raw = await readFile(manifestPath, "utf-8");
-        narrationManifest = JSON.parse(raw);
+        return JSON.parse(raw);
     }
     catch {
-        // No manifest — scenario plays without narration.
+        return undefined; // No manifest — the scenario plays without this track.
     }
-    return {
-        id: basename(dir),
-        steps,
-        narrationManifest,
-    };
 }
 //# sourceMappingURL=load-bundle.js.map

package/src/util/load-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-bundle.js","sourceRoot":"","sources":["../../../src/util/load-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAe/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/C,IAAI,iBAAiD,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC;QACjB,KAAK;QACL,iBAAiB;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"load-bundle.js","sourceRoot":"","sources":["../../../src/util/load-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GAGrB,MAAM,cAAc,CAAC;AAyBtB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEzD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC;QACjB,KAAK;QACL,iBAAiB,EAAE,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACxF,iBAAiB,EAAE,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACxF,UAAU,EAAE,UAAU,IAAI,SAAS;QACnC,UAAU,EAAE,UAAU,IAAI,SAAS;KACpC,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,KAAK,UAAU,sBAAsB,CACnC,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,uDAAuD;IAC3E,CAAC;AACH,CAAC"}

package/src/util/load-bundle.ts

@@ -1,11 +1,22 @@
 import { readFile, access } from "node:fs/promises";
 import { join, basename } from "node:path";
-import { loadStepsFromTs } from "./load-ts.js";
+import {
+  loadSoundtrackFromTs,
+  loadStepsFromTs,
+  loadTitleCardsFromTs,
+  type AuthoredSoundtrack,
+  type AuthoredTitleCards,
+} from "./load-ts.js";
 
 /**
  * Lightweight bundle shape for CLI use. Mirrors the @scenar/core
  * ScenarioBundle interface but uses plain objects (the CLI does not
  * import @scenar/core at runtime to stay lightweight).
+ *
+ * Carries the AUTHORED shape: steps as written, title cards as config.
+ * Card-step synthesis (`applyTitleCards`) happens in the generated
+ * render/pack entries — the true bundle-assembly seam — never here; the
+ * CLI consumes this bundle for staging and inspection only.
  */
 export interface CliBundle {
   id: string;
@@ -13,33 +24,48 @@ export interface CliBundle {
   narrationManifest?: {
     steps: Array<{ src: string; durationMs: number } | null>;
   };
+  presenterManifest?: {
+    steps: Array<{ src: string; durationMs: number } | null>;
+  };
+  soundtrack?: AuthoredSoundtrack;
+  titleCards?: AuthoredTitleCards;
 }
 
 /**
  * Load a scenario bundle from a directory.  Expects:
- *   <dir>/steps.ts       — required (step definitions)
+ *   <dir>/steps.ts       — required (step definitions, optional
+ *                          `soundtrack` named export)
  *   <dir>/narration/manifest.json — optional (narration manifest)
+ *   <dir>/presenter/manifest.json — optional (presenter manifest)
  *
  * The scenario id defaults to the directory base name.
  */
 export async function loadBundle(dir: string): Promise<CliBundle> {
   const stepsPath = join(dir, "steps.ts");
-  const manifestPath = join(dir, "narration", "manifest.json");
 
   const steps = await loadStepsFromTs(stepsPath);
+  const soundtrack = await loadSoundtrackFromTs(stepsPath);
+  const titleCards = await loadTitleCardsFromTs(stepsPath);
+
+  return {
+    id: basename(dir),
+    steps,
+    narrationManifest: await readPositionalManifest(join(dir, "narration", "manifest.json")),
+    presenterManifest: await readPositionalManifest(join(dir, "presenter", "manifest.json")),
+    soundtrack: soundtrack ?? undefined,
+    titleCards: titleCards ?? undefined,
+  };
+}
 
-  let narrationManifest: CliBundle["narrationManifest"];
+/** Read a positional clip manifest, or undefined when none exists. */
+async function readPositionalManifest(
+  manifestPath: string,
+): Promise<CliBundle["narrationManifest"]> {
   try {
     await access(manifestPath);
     const raw = await readFile(manifestPath, "utf-8");
-    narrationManifest = JSON.parse(raw) as CliBundle["narrationManifest"];
+    return JSON.parse(raw) as CliBundle["narrationManifest"];
   } catch {
-    // No manifest — scenario plays without narration.
+    return undefined; // No manifest — the scenario plays without this track.
   }
-
-  return {
-    id: basename(dir),
-    steps,
-    narrationManifest,
-  };
 }

package/src/util/load-ts.d.ts

@@ -41,6 +41,69 @@ export interface AuthoredViewport {
  * wins, because its viewport is inseparable from the steps it sizes.
  */
 export declare function findAuthoredViewport(exports: Record<string, unknown>): AuthoredViewport | null;
+/**
+ * A scenario-authored soundtrack, mirroring the proto `SoundtrackConfig`
+ * in camelCase (the same shape as `@scenar/core`'s `Soundtrack`).
+ */
+export interface AuthoredSoundtrack {
+    musicSrc?: string;
+    musicVolume?: number;
+    duckingVolume?: number;
+    sfx?: boolean;
+}
+/**
+ * Find the scenario's authored soundtrack in a loaded module's exports,
+ * or null when the module authors none.
+ *
+ * Mirrors {@link findAuthoredViewport}'s two authored forms and
+ * precedence exactly:
+ *
+ * 1. A scenario-shaped export — an object carrying both a `soundtrack`
+ *    and a delayMs-bearing `steps` array (what `createScenario()`
+ *    returns when the author passes a soundtrack).
+ * 2. An export *named* `soundtrack` — the directory-form counterpart,
+ *    for authors of a raw steps array.
+ *
+ * Field validity (volume ranges, non-empty musicSrc) is the validator's
+ * concern, not discovery's — this only locates the authored object.
+ */
+export declare function findAuthoredSoundtrack(exports: Record<string, unknown>): AuthoredSoundtrack | null;
+/**
+ * A scenario-authored title card, mirroring the proto `TitleCard`
+ * in camelCase (the same shape as `@scenar/core`'s `TitleCard`).
+ */
+export interface AuthoredTitleCard {
+    title?: string;
+    subtitle?: string;
+    logoSrc?: string;
+    ctaText?: string;
+    durationMs?: number;
+}
+/**
+ * A scenario-authored title-cards config, mirroring the proto
+ * `TitleCardsConfig` in camelCase.
+ */
+export interface AuthoredTitleCards {
+    intro?: AuthoredTitleCard;
+    outro?: AuthoredTitleCard;
+}
+/**
+ * Find the scenario's authored title cards in a loaded module's exports,
+ * or null when the module authors none.
+ *
+ * Mirrors {@link findAuthoredSoundtrack}'s two authored forms and
+ * precedence exactly:
+ *
+ * 1. A scenario-shaped export — an object carrying both a `titleCards`
+ *    and a delayMs-bearing `steps` array (what `createScenario()`
+ *    returns when the author passes title cards).
+ * 2. An export *named* `titleCards` — the directory-form counterpart,
+ *    for authors of a raw steps array.
+ *
+ * Field validity (non-empty title, positive duration) is the validator's
+ * concern, not discovery's — this only locates the authored object.
+ */
+export declare function findAuthoredTitleCards(exports: Record<string, unknown>): AuthoredTitleCards | null;
 /**
  * Dynamically import a TypeScript steps file and extract the
  * steps array by duck-typing ({@link findStepsArray}).
@@ -50,4 +113,18 @@ export declare function findAuthoredViewport(exports: Record<string, unknown>):
  * on any TS compilation tool.
  */
 export declare function loadStepsFromTs(filePath: string): Promise<ImportedStep[]>;
+/**
+ * Dynamically import a TypeScript steps file and extract the authored
+ * soundtrack ({@link findAuthoredSoundtrack}), or null when the module
+ * authors none. Node caches the module, so calling this alongside
+ * {@link loadStepsFromTs} costs one import.
+ */
+export declare function loadSoundtrackFromTs(filePath: string): Promise<AuthoredSoundtrack | null>;
+/**
+ * Dynamically import a TypeScript steps file and extract the authored
+ * title cards ({@link findAuthoredTitleCards}), or null when the module
+ * authors none. Node caches the module, so calling this alongside
+ * {@link loadStepsFromTs} costs one import.
+ */
+export declare function loadTitleCardsFromTs(filePath: string): Promise<AuthoredTitleCards | null>;
 //# sourceMappingURL=load-ts.d.ts.map

package/src/util/load-ts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-ts.d.ts","sourceRoot":"","sources":["../../../src/util/load-ts.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAatF;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAc9F;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO/E"}
+{"version":3,"file":"load-ts.d.ts","sourceRoot":"","sources":["../../../src/util/load-ts.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,IAAI,CAatF;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAc9F;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAeD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,kBAAkB,GAAG,IAAI,CAY3B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAgCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,kBAAkB,GAAG,IAAI,CAY3B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO/E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAGpC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAGpC"}

package/src/util/load-ts.js

@@ -72,6 +72,111 @@ export function findAuthoredViewport(exports) {
     }
     return null;
 }
+/** The soundtrack's known field names — used to pick a clean copy. */
+const SOUNDTRACK_FIELDS = ["musicSrc", "musicVolume", "duckingVolume", "sfx"];
+function pickSoundtrack(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const record = value;
+    const soundtrack = {};
+    for (const field of SOUNDTRACK_FIELDS) {
+        if (record[field] !== undefined)
+            soundtrack[field] = record[field];
+    }
+    return soundtrack;
+}
+/**
+ * Find the scenario's authored soundtrack in a loaded module's exports,
+ * or null when the module authors none.
+ *
+ * Mirrors {@link findAuthoredViewport}'s two authored forms and
+ * precedence exactly:
+ *
+ * 1. A scenario-shaped export — an object carrying both a `soundtrack`
+ *    and a delayMs-bearing `steps` array (what `createScenario()`
+ *    returns when the author passes a soundtrack).
+ * 2. An export *named* `soundtrack` — the directory-form counterpart,
+ *    for authors of a raw steps array.
+ *
+ * Field validity (volume ranges, non-empty musicSrc) is the validator's
+ * concern, not discovery's — this only locates the authored object.
+ */
+export function findAuthoredSoundtrack(exports) {
+    for (const value of Object.values(exports)) {
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            continue;
+        const record = value;
+        if (record["soundtrack"] !== undefined && isStepsShape(record["steps"])) {
+            return pickSoundtrack(record["soundtrack"]);
+        }
+    }
+    if (exports["soundtrack"] !== undefined) {
+        return pickSoundtrack(exports["soundtrack"]);
+    }
+    return null;
+}
+/** The card's known field names — used to pick a clean copy. */
+const TITLE_CARD_FIELDS = [
+    "title",
+    "subtitle",
+    "logoSrc",
+    "ctaText",
+    "durationMs",
+];
+function pickTitleCard(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const record = value;
+    const card = {};
+    for (const field of TITLE_CARD_FIELDS) {
+        if (record[field] !== undefined)
+            card[field] = record[field];
+    }
+    return card;
+}
+function pickTitleCards(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const record = value;
+    const cards = {};
+    const intro = pickTitleCard(record["intro"]);
+    const outro = pickTitleCard(record["outro"]);
+    if (intro)
+        cards.intro = intro;
+    if (outro)
+        cards.outro = outro;
+    return cards;
+}
+/**
+ * Find the scenario's authored title cards in a loaded module's exports,
+ * or null when the module authors none.
+ *
+ * Mirrors {@link findAuthoredSoundtrack}'s two authored forms and
+ * precedence exactly:
+ *
+ * 1. A scenario-shaped export — an object carrying both a `titleCards`
+ *    and a delayMs-bearing `steps` array (what `createScenario()`
+ *    returns when the author passes title cards).
+ * 2. An export *named* `titleCards` — the directory-form counterpart,
+ *    for authors of a raw steps array.
+ *
+ * Field validity (non-empty title, positive duration) is the validator's
+ * concern, not discovery's — this only locates the authored object.
+ */
+export function findAuthoredTitleCards(exports) {
+    for (const value of Object.values(exports)) {
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            continue;
+        const record = value;
+        if (record["titleCards"] !== undefined && isStepsShape(record["steps"])) {
+            return pickTitleCards(record["titleCards"]);
+        }
+    }
+    if (exports["titleCards"] !== undefined) {
+        return pickTitleCards(exports["titleCards"]);
+    }
+    return null;
+}
 /**
  * Dynamically import a TypeScript steps file and extract the
  * steps array by duck-typing ({@link findStepsArray}).
@@ -88,4 +193,24 @@ export async function loadStepsFromTs(filePath) {
     }
     return steps;
 }
+/**
+ * Dynamically import a TypeScript steps file and extract the authored
+ * soundtrack ({@link findAuthoredSoundtrack}), or null when the module
+ * authors none. Node caches the module, so calling this alongside
+ * {@link loadStepsFromTs} costs one import.
+ */
+export async function loadSoundtrackFromTs(filePath) {
+    const mod = await import(pathToFileURL(filePath).href);
+    return findAuthoredSoundtrack(mod.default ?? mod);
+}
+/**
+ * Dynamically import a TypeScript steps file and extract the authored
+ * title cards ({@link findAuthoredTitleCards}), or null when the module
+ * authors none. Node caches the module, so calling this alongside
+ * {@link loadStepsFromTs} costs one import.
+ */
+export async function loadTitleCardsFromTs(filePath) {
+    const mod = await import(pathToFileURL(filePath).href);
+    return findAuthoredTitleCards(mod.default ?? mod);
+}
 //# sourceMappingURL=load-ts.js.map

package/src/util/load-ts.js.map

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