@scenar/sdk 0.10.0 → 0.11.1

package/author/createScenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createScenario.d.ts","sourceRoot":"","sources":["../../src/author/createScenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EAEb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,YAAY,EACvD,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,GAC1B,gBAAgB,CAAC,KAAK,CAAC,CA+BzB"}
+{"version":3,"file":"createScenario.d.ts","sourceRoot":"","sources":["../../src/author/createScenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EAEb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,YAAY,EACvD,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,GAC1B,gBAAgB,CAAC,KAAK,CAAC,CAkCzB"}

package/author/createScenario.js

@@ -35,12 +35,15 @@ export function createScenario(input) {
             data: { view: step.view, props: step.props },
             narration: step.narrationText,
             interactions: step.interactions,
+            presenter: step.presenter,
         });
     }
     return {
         viewport: input.viewport,
         views: input.views,
         steps,
+        soundtrack: input.soundtrack,
+        titleCards: input.titleCards,
     };
 }
 //# sourceMappingURL=createScenario.js.map

package/author/createScenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"createScenario.js","sourceRoot":"","sources":["../../src/author/createScenario.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA2B;IAE3B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAqB,CAAC;QAEhD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,iCAAiC,CAAC,WAAW,IAAI,CAAC,IAAI,kCAAkC;gBACxF,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAA6B;YACvE,SAAS,EAAE,IAAI,CAAC,aAAa;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createScenario.js","sourceRoot":"","sources":["../../src/author/createScenario.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA2B;IAE3B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAqB,CAAC;QAEhD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,iCAAiC,CAAC,WAAW,IAAI,CAAC,IAAI,kCAAkC;gBACxF,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAA6B;YACvE,SAAS,EAAE,IAAI,CAAC,aAAa;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/author/types.d.ts

@@ -1,4 +1,4 @@
-import type { ScenarioStep, StepAction } from "@scenar/core";
+import type { ScenarioStep, Soundtrack, StepAction, TitleCards } from "@scenar/core";
 /**
  * A view registry maps opaque view identifiers (strings) to
  * "anything that accepts props." The SDK is framework-agnostic:
@@ -44,6 +44,12 @@ export type StepInput<Views extends ViewRegistry> = {
         readonly narrationText?: string;
         readonly props: PropsOf<Views[K]>;
         readonly interactions?: readonly StepAction[];
+        /**
+         * Marks this step for the presenter track: `scenar presenter`
+         * generates an avatar clip from the step's narration audio, shown
+         * picture-in-picture in both outputs. Requires `narrationText`.
+         */
+        readonly presenter?: boolean;
     };
 }[keyof Views & string];
 /**
@@ -56,6 +62,23 @@ export interface ScenarioInput<Views extends ViewRegistry> {
     readonly views: Views;
     /** Ordered sequence of steps. Must contain at least one entry. */
     readonly steps: readonly StepInput<Views>[];
+    /**
+     * Audio treatment: background music with narration ducking and
+     * interaction sound effects. Optional — omitted means silent apart
+     * from narration.
+     */
+    readonly soundtrack?: Soundtrack;
+    /**
+     * Intro/outro title cards framing the scenario. Optional — omitted
+     * means the scenario plays exactly as authored.
+     *
+     * Carried through untouched, like `soundtrack`: card steps are
+     * synthesized at bundle assembly by `applyTitleCards` (from
+     * `@scenar/core`), which the CLI's render/pack pipelines call for
+     * you. When embedding directly, apply it between `createScenario()`
+     * and the player.
+     */
+    readonly titleCards?: TitleCards;
 }
 /**
  * The output of `createScenario()` — ready to feed into
@@ -65,5 +88,7 @@ export interface AuthoredScenario<Views extends ViewRegistry> {
     readonly viewport: ViewportConfig | undefined;
     readonly views: Views;
     readonly steps: readonly ScenarioStep<AuthoredStepData<Views>>[];
+    readonly soundtrack: Soundtrack | undefined;
+    readonly titleCards: TitleCards | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/author/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/author/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3F,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,YAAY,IAAI;KACxD,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG;QAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC;CACF,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,YAAY,IAAI;KACjD,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG;QAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;KAC/C;CACF,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,YAAY;IACvD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,YAAY;IAC1D,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;CAClE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/author/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3F,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,YAAY,IAAI;KACxD,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG;QAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnC;CACF,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,YAAY,IAAI;KACjD,CAAC,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG;QAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;QAC9C;;;;WAIG;QACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;KAC9B;CACF,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,YAAY;IACvD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,YAAY;IAC1D,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;CAC7C"}

package/index.d.ts

@@ -4,5 +4,5 @@ export { loadScenarioFromProto } from "./proto/load-scenario.js";
 export type { LoadScenarioOptions } from "./proto/load-scenario.js";
 export { InvalidScenarioError } from "./proto/errors.js";
 export { PROTO_ACTION_TYPE } from "./proto/proto-types.js";
-export type { ProtoActionTypeValue, ProtoScenarioSpec, ProtoStep, ProtoStepAction, ProtoStepActionConfig, ProtoViewportConfig, } from "./proto/proto-types.js";
+export type { ProtoActionTypeValue, ProtoScenarioSpec, ProtoSoundtrackConfig, ProtoStep, ProtoStepAction, ProtoStepActionConfig, ProtoTitleCard, ProtoTitleCardsConfig, ProtoViewportConfig, } from "./proto/proto-types.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenar/sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Typed authoring surface for Scenar scenarios — createScenario() builder and proto adapter.",
   "license": "Apache-2.0",
   "type": "module",
@@ -28,6 +28,6 @@
     }
   },
   "dependencies": {
-    "@scenar/core": "0.10.0"
+    "@scenar/core": "0.11.1"
   }
 }

package/proto/load-scenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-scenario.d.ts","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,YAAY;IAC7D,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,YAAY,EAC9D,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAClC,gBAAgB,CAAC,KAAK,CAAC,CA4CzB"}
+{"version":3,"file":"load-scenario.d.ts","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,YAAY;IAC7D,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,YAAY,EAC9D,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAClC,gBAAgB,CAAC,KAAK,CAAC,CA8DzB"}

package/proto/load-scenario.js

@@ -1,5 +1,7 @@
 import { InvalidScenarioError } from "./errors.js";
 import { mapProtoAction } from "./action-mapper.js";
+import { mapProtoSoundtrack } from "./soundtrack-mapper.js";
+import { mapProtoTitleCards } from "./title-cards-mapper.js";
 /**
  * Convert a proto `ScenarioSpec` message into an `AuthoredScenario`
  * ready for `<ScenarioPlayer>`.
@@ -31,6 +33,13 @@ export function loadScenarioFromProto(spec, options) {
                 `Registered views: ${[...viewNames].join(", ")}.`);
         }
         const interactions = protoStep.interactions.map((protoAction, j) => mapProtoAction(protoAction, `${stepPath}.interactions[${j}]`));
+        // Cross-field rule from the proto doc contract: a presenter clip is
+        // derived from the step's narration audio, so opting in without a
+        // script is an authoring contradiction — caught here, before the
+        // paid `scenar presenter` command ever runs.
+        if (protoStep.presenter && !protoStep.narrationText) {
+            throw new InvalidScenarioError(`${stepPath}.presenter`, "presenter requires narration_text — a presenter clip is derived from the step's narration audio.");
+        }
         steps.push({
             delayMs: protoStep.delayMs,
             data: {
@@ -39,12 +48,19 @@ export function loadScenarioFromProto(spec, options) {
             },
             narration: protoStep.narrationText || undefined,
             interactions: interactions.length > 0 ? interactions : undefined,
+            presenter: protoStep.presenter || undefined,
         });
     }
     return {
         viewport: spec.viewport ? { width: spec.viewport.width, height: spec.viewport.height } : undefined,
         views: options.views,
         steps,
+        soundtrack: spec.soundtrack
+            ? mapProtoSoundtrack(spec.soundtrack, "soundtrack")
+            : undefined,
+        titleCards: spec.titleCards
+            ? mapProtoTitleCards(spec.titleCards, "titleCards")
+            : undefined,
     };
 }
 //# sourceMappingURL=load-scenario.js.map

package/proto/load-scenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-scenario.js","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,OAAmC;IAEnC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC;QAE/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,GAAG,QAAQ,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,oBAAoB,CAC5B,GAAG,QAAQ,OAAO,EAClB,IAAI,SAAS,CAAC,IAAI,kCAAkC;gBACpD,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CACjE,cAAc,CAAC,WAAW,EAAE,GAAG,QAAQ,iBAAiB,CAAC,GAAG,CAAC,CAC9D,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,KAAK,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAqC;aACxC;YAC5B,SAAS,EAAE,SAAS,CAAC,aAAa,IAAI,SAAS;YAC/C,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAClG,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"load-scenario.js","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAU7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,OAAmC;IAEnC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC;QAE/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,GAAG,QAAQ,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,oBAAoB,CAC5B,GAAG,QAAQ,OAAO,EAClB,IAAI,SAAS,CAAC,IAAI,kCAAkC;gBACpD,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CACjE,cAAc,CAAC,WAAW,EAAE,GAAG,QAAQ,iBAAiB,CAAC,GAAG,CAAC,CAC9D,CAAC;QAEF,oEAAoE;QACpE,kEAAkE;QAClE,iEAAiE;QACjE,6CAA6C;QAC7C,IAAI,SAAS,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YACpD,MAAM,IAAI,oBAAoB,CAC5B,GAAG,QAAQ,YAAY,EACvB,kGAAkG,CACnG,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,KAAK,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAqC;aACxC;YAC5B,SAAS,EAAE,SAAS,CAAC,aAAa,IAAI,SAAS;YAC/C,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;YAChE,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,SAAS;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAClG,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK;QACL,UAAU,EAAE,IAAI,CAAC,UAAU;YACzB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;YACnD,CAAC,CAAC,SAAS;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;YACzB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;YACnD,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/proto/proto-types.d.ts

@@ -87,10 +87,40 @@ export interface ProtoStep {
     readonly narrationText: string;
     readonly props?: Record<string, unknown>;
     readonly interactions: readonly ProtoStepAction[];
+    readonly presenter?: boolean;
+}
+/**
+ * Structural shape of a proto `SoundtrackConfig` message.
+ * All fields are proto3 `optional`, so absence is meaningful:
+ * an unset volume means "use the engine default".
+ */
+export interface ProtoSoundtrackConfig {
+    readonly musicSrc?: string;
+    readonly musicVolume?: number;
+    readonly duckingVolume?: number;
+    readonly sfx?: boolean;
+}
+/**
+ * Structural shape of a proto `TitleCard` message.
+ * Optional fields are proto3 `optional`, so absence is meaningful.
+ */
+export interface ProtoTitleCard {
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly logoSrc?: string;
+    readonly ctaText?: string;
+    readonly durationMs?: number;
+}
+/** Structural shape of a proto `TitleCardsConfig` message. */
+export interface ProtoTitleCardsConfig {
+    readonly intro?: ProtoTitleCard;
+    readonly outro?: ProtoTitleCard;
 }
 /** Structural shape of the proto `ScenarioSpec` message. */
 export interface ProtoScenarioSpec {
     readonly viewport?: ProtoViewportConfig;
     readonly steps: readonly ProtoStep[];
+    readonly soundtrack?: ProtoSoundtrackConfig;
+    readonly titleCards?: ProtoTitleCardsConfig;
 }
 //# sourceMappingURL=proto-types.d.ts.map

package/proto/proto-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proto-types.d.ts","sourceRoot":"","sources":["../../src/proto/proto-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE9F,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CACnD;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC"}
+{"version":3,"file":"proto-types.d.ts","sourceRoot":"","sources":["../../src/proto/proto-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE9F,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CAC7C"}

package/proto/soundtrack-mapper.d.ts

@@ -0,0 +1,16 @@
+import type { Soundtrack } from "@scenar/core";
+import type { ProtoSoundtrackConfig } from "./proto-types.js";
+/**
+ * Map a proto `SoundtrackConfig` message to the engine's `Soundtrack`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (musicSrc non-empty when present, volumes within [0, 1]).
+ *
+ * All proto fields are `optional`, so absence passes through as
+ * `undefined` — the engine resolves defaults at playback time, keeping
+ * an authored 0.0 distinguishable from "use the default".
+ *
+ * @param proto - The proto SoundtrackConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export declare function mapProtoSoundtrack(proto: ProtoSoundtrackConfig, path: string): Soundtrack;
+//# sourceMappingURL=soundtrack-mapper.d.ts.map

package/proto/soundtrack-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundtrack-mapper.d.ts","sourceRoot":"","sources":["../../src/proto/soundtrack-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,GACX,UAAU,CAiBZ"}

package/proto/soundtrack-mapper.js

@@ -0,0 +1,34 @@
+import { InvalidScenarioError } from "./errors.js";
+/**
+ * Map a proto `SoundtrackConfig` message to the engine's `Soundtrack`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (musicSrc non-empty when present, volumes within [0, 1]).
+ *
+ * All proto fields are `optional`, so absence passes through as
+ * `undefined` — the engine resolves defaults at playback time, keeping
+ * an authored 0.0 distinguishable from "use the default".
+ *
+ * @param proto - The proto SoundtrackConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export function mapProtoSoundtrack(proto, path) {
+    if (proto.musicSrc !== undefined && proto.musicSrc.length === 0) {
+        throw new InvalidScenarioError(`${path}.musicSrc`, "musicSrc must be a non-empty asset reference when present.");
+    }
+    validateVolume(proto.musicVolume, `${path}.musicVolume`);
+    validateVolume(proto.duckingVolume, `${path}.duckingVolume`);
+    return {
+        musicSrc: proto.musicSrc,
+        musicVolume: proto.musicVolume,
+        duckingVolume: proto.duckingVolume,
+        sfx: proto.sfx,
+    };
+}
+function validateVolume(value, path) {
+    if (value === undefined)
+        return;
+    if (value < 0 || value > 1) {
+        throw new InvalidScenarioError(path, `must be between 0.0 and 1.0, got ${value}.`);
+    }
+}
+//# sourceMappingURL=soundtrack-mapper.js.map

package/proto/soundtrack-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundtrack-mapper.js","sourceRoot":"","sources":["../../src/proto/soundtrack-mapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA4B,EAC5B,IAAY;IAEZ,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAC5B,GAAG,IAAI,WAAW,EAClB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,IAAI,cAAc,CAAC,CAAC;IACzD,cAAc,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,IAAI,gBAAgB,CAAC,CAAC;IAE7D,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB,EAAE,IAAY;IAC7D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,oCAAoC,KAAK,GAAG,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/proto/title-cards-mapper.d.ts

@@ -0,0 +1,17 @@
+import type { TitleCards } from "@scenar/core";
+import type { ProtoTitleCardsConfig } from "./proto-types.js";
+/**
+ * Map a proto `TitleCardsConfig` message to the engine's `TitleCards`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (title required and non-empty; optional strings non-empty when
+ * present; durationMs positive when present).
+ *
+ * Mapping only — card synthesis happens later, at bundle assembly, via
+ * `applyTitleCards`. The loader carries the config through untouched,
+ * exactly like `soundtrack`.
+ *
+ * @param proto - The proto TitleCardsConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export declare function mapProtoTitleCards(proto: ProtoTitleCardsConfig, path: string): TitleCards;
+//# sourceMappingURL=title-cards-mapper.d.ts.map

package/proto/title-cards-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-cards-mapper.d.ts","sourceRoot":"","sources":["../../src/proto/title-cards-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,GACX,UAAU,CAKZ"}

package/proto/title-cards-mapper.js

@@ -0,0 +1,44 @@
+import { InvalidScenarioError } from "./errors.js";
+/**
+ * Map a proto `TitleCardsConfig` message to the engine's `TitleCards`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (title required and non-empty; optional strings non-empty when
+ * present; durationMs positive when present).
+ *
+ * Mapping only — card synthesis happens later, at bundle assembly, via
+ * `applyTitleCards`. The loader carries the config through untouched,
+ * exactly like `soundtrack`.
+ *
+ * @param proto - The proto TitleCardsConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export function mapProtoTitleCards(proto, path) {
+    return {
+        intro: proto.intro ? mapCard(proto.intro, `${path}.intro`) : undefined,
+        outro: proto.outro ? mapCard(proto.outro, `${path}.outro`) : undefined,
+    };
+}
+function mapCard(proto, path) {
+    if (!proto.title) {
+        throw new InvalidScenarioError(`${path}.title`, "title is required.");
+    }
+    validateNonEmpty(proto.subtitle, `${path}.subtitle`);
+    validateNonEmpty(proto.logoSrc, `${path}.logoSrc`);
+    validateNonEmpty(proto.ctaText, `${path}.ctaText`);
+    if (proto.durationMs !== undefined && proto.durationMs <= 0) {
+        throw new InvalidScenarioError(`${path}.durationMs`, `must be greater than 0, got ${proto.durationMs}.`);
+    }
+    return {
+        title: proto.title,
+        subtitle: proto.subtitle,
+        logoSrc: proto.logoSrc,
+        ctaText: proto.ctaText,
+        durationMs: proto.durationMs,
+    };
+}
+function validateNonEmpty(value, path) {
+    if (value !== undefined && value.length === 0) {
+        throw new InvalidScenarioError(path, "must be non-empty when present.");
+    }
+}
+//# sourceMappingURL=title-cards-mapper.js.map

package/proto/title-cards-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-cards-mapper.js","sourceRoot":"","sources":["../../src/proto/title-cards-mapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA4B,EAC5B,IAAY;IAEZ,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QACtE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB,EAAE,IAAY;IAClD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACxE,CAAC;IACD,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC;IACrD,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC;IACnD,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,oBAAoB,CAC5B,GAAG,IAAI,aAAa,EACpB,+BAA+B,KAAK,CAAC,UAAU,GAAG,CACnD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB,EAAE,IAAY;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/src/__tests__/createScenario.test.ts

@@ -53,6 +53,32 @@ describe("createScenario", () => {
     expect(scenario.steps[1]!.interactions![0]!.text).toBe("quickstart");
   });
 
+  it("carries presenter through to the built step", () => {
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [
+        {
+          view: "settings",
+          delayMs: 0,
+          narrationText: "Welcome.",
+          props: { org: "acme" },
+          presenter: true,
+        },
+      ],
+    });
+
+    expect(scenario.steps[0]!.presenter).toBe(true);
+  });
+
+  it("leaves presenter undefined when not authored", () => {
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [{ view: "settings", delayMs: 0, props: { org: "a" } }],
+    });
+
+    expect(scenario.steps[0]!.presenter).toBeUndefined();
+  });
+
   it("preserves view registry on the output", () => {
     const views = { settings: SettingsView };
     const scenario = createScenario({
@@ -103,4 +129,46 @@ describe("createScenario", () => {
 
     expect(scenario.steps[0]!.narration).toBe("Hello");
   });
+
+  it("carries the soundtrack through to the authored scenario", () => {
+    const soundtrack = { musicSrc: "./soundtrack/music.mp3", sfx: true };
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [{ view: "settings", delayMs: 0, props: { org: "a" } }],
+      soundtrack,
+    });
+
+    expect(scenario.soundtrack).toBe(soundtrack);
+  });
+
+  it("carries title cards through without synthesizing card steps", () => {
+    const titleCards = { intro: { title: "Acme" }, outro: { title: "Try it" } };
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [{ view: "settings", delayMs: 0, props: { org: "a" } }],
+      titleCards,
+    });
+
+    // Config is carried, not applied: still exactly the authored steps.
+    expect(scenario.titleCards).toBe(titleCards);
+    expect(scenario.steps).toHaveLength(1);
+  });
+
+  it("leaves titleCards undefined when not authored", () => {
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [{ view: "settings", delayMs: 0, props: { org: "a" } }],
+    });
+
+    expect(scenario.titleCards).toBeUndefined();
+  });
+
+  it("leaves soundtrack undefined when not authored", () => {
+    const scenario = createScenario({
+      views: { settings: SettingsView },
+      steps: [{ view: "settings", delayMs: 0, props: { org: "a" } }],
+    });
+
+    expect(scenario.soundtrack).toBeUndefined();
+  });
 });

package/src/__tests__/load-scenario.test.ts

@@ -181,4 +181,150 @@ describe("loadScenarioFromProto", () => {
     const scenario = loadScenarioFromProto(modified, { views });
     expect(scenario.steps[0]!.narration).toBeUndefined();
   });
+
+  it("maps the soundtrack through, preserving explicit zeros", () => {
+    const modified: ProtoScenarioSpec = {
+      ...makeValidScenario(),
+      soundtrack: {
+        musicSrc: "./soundtrack/music.mp3",
+        musicVolume: 0.3,
+        duckingVolume: 0,
+        sfx: true,
+      },
+    };
+
+    const scenario = loadScenarioFromProto(modified, { views });
+    expect(scenario.soundtrack).toEqual({
+      musicSrc: "./soundtrack/music.mp3",
+      musicVolume: 0.3,
+      duckingVolume: 0,
+      sfx: true,
+    });
+  });
+
+  it("leaves soundtrack undefined when the spec has none", () => {
+    const scenario = loadScenarioFromProto(makeValidScenario(), { views });
+    expect(scenario.soundtrack).toBeUndefined();
+  });
+
+  it("preserves unset soundtrack fields as undefined (engine defaults apply)", () => {
+    const modified: ProtoScenarioSpec = {
+      ...makeValidScenario(),
+      soundtrack: { musicSrc: "./music.mp3" },
+    };
+
+    const scenario = loadScenarioFromProto(modified, { views });
+    expect(scenario.soundtrack?.musicVolume).toBeUndefined();
+    expect(scenario.soundtrack?.duckingVolume).toBeUndefined();
+    expect(scenario.soundtrack?.sfx).toBeUndefined();
+  });
+
+  it.each([
+    ["musicVolume", { musicVolume: 1.5 }, "soundtrack.musicVolume"],
+    ["duckingVolume", { duckingVolume: -0.1 }, "soundtrack.duckingVolume"],
+  ])("throws when %s is out of range", (_name, soundtrack, expectedPath) => {
+    const modified: ProtoScenarioSpec = { ...makeValidScenario(), soundtrack };
+
+    try {
+      loadScenarioFromProto(modified, { views });
+      expect.fail("should have thrown");
+    } catch (e) {
+      const err = e as InvalidScenarioError;
+      expect(err.path).toBe(expectedPath);
+    }
+  });
+
+  it("throws when musicSrc is present but empty", () => {
+    const modified: ProtoScenarioSpec = {
+      ...makeValidScenario(),
+      soundtrack: { musicSrc: "" },
+    };
+
+    try {
+      loadScenarioFromProto(modified, { views });
+      expect.fail("should have thrown");
+    } catch (e) {
+      const err = e as InvalidScenarioError;
+      expect(err.path).toBe("soundtrack.musicSrc");
+    }
+  });
+
+  it("carries title cards through without synthesizing card steps", () => {
+    const modified: ProtoScenarioSpec = {
+      ...makeValidScenario(),
+      titleCards: {
+        intro: { title: "Acme", subtitle: "Ship fast" },
+        outro: { title: "Try it", ctaText: "acme.dev" },
+      },
+    };
+
+    const scenario = loadScenarioFromProto(modified, { views });
+    // Config is carried, not applied: still exactly the authored steps.
+    expect(scenario.steps).toHaveLength(2);
+    expect(scenario.titleCards?.intro?.title).toBe("Acme");
+    expect(scenario.titleCards?.outro?.ctaText).toBe("acme.dev");
+  });
+
+  it("leaves titleCards undefined when the spec has none", () => {
+    const scenario = loadScenarioFromProto(makeValidScenario(), { views });
+    expect(scenario.titleCards).toBeUndefined();
+  });
+
+  it("throws when a title card's title is empty", () => {
+    const modified: ProtoScenarioSpec = {
+      ...makeValidScenario(),
+      titleCards: { intro: { title: "" } },
+    };
+
+    try {
+      loadScenarioFromProto(modified, { views });
+      expect.fail("should have thrown");
+    } catch (e) {
+      const err = e as InvalidScenarioError;
+      expect(err.path).toBe("titleCards.intro.title");
+    }
+  });
+
+  it("maps presenter through on a narrated step", () => {
+    const proto = makeValidScenario();
+    const modified: ProtoScenarioSpec = {
+      ...proto,
+      steps: [{ ...proto.steps[0]!, presenter: true }, proto.steps[1]!],
+    };
+
+    const scenario = loadScenarioFromProto(modified, { views });
+    expect(scenario.steps[0]!.presenter).toBe(true);
+    expect(scenario.steps[1]!.presenter).toBeUndefined();
+  });
+
+  it("normalizes presenter: false to undefined (absence and false mean the same)", () => {
+    const proto = makeValidScenario();
+    const modified: ProtoScenarioSpec = {
+      ...proto,
+      steps: [{ ...proto.steps[0]!, presenter: false }, proto.steps[1]!],
+    };
+
+    const scenario = loadScenarioFromProto(modified, { views });
+    expect(scenario.steps[0]!.presenter).toBeUndefined();
+  });
+
+  it("throws when presenter is set on a step without narration", () => {
+    const proto = makeValidScenario();
+    // Step 1 has narrationText: "" — opting it in is the contradiction.
+    const modified: ProtoScenarioSpec = {
+      ...proto,
+      steps: [proto.steps[0]!, { ...proto.steps[1]!, presenter: true }],
+    };
+
+    try {
+      loadScenarioFromProto(modified, { views });
+      expect.fail("should have thrown");
+    } catch (e) {
+      const err = e as InvalidScenarioError;
+      expect(err.path).toBe("steps[1].presenter");
+      expect(err.reason).toBe(
+        "presenter requires narration_text — a presenter clip is derived from the step's narration audio.",
+      );
+    }
+  });
 });

package/src/__tests__/title-cards-mapper.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+import { InvalidScenarioError } from "../proto/errors.js";
+import { mapProtoTitleCards } from "../proto/title-cards-mapper.js";
+
+describe("mapProtoTitleCards", () => {
+  it("maps a full config field for field", () => {
+    const cards = mapProtoTitleCards(
+      {
+        intro: {
+          title: "Acme Deploy",
+          subtitle: "Ship in seconds",
+          logoSrc: "./logo.png",
+          durationMs: 4000,
+        },
+        outro: { title: "Try it today", ctaText: "acme.dev/start" },
+      },
+      "titleCards",
+    );
+
+    expect(cards.intro).toEqual({
+      title: "Acme Deploy",
+      subtitle: "Ship in seconds",
+      logoSrc: "./logo.png",
+      ctaText: undefined,
+      durationMs: 4000,
+    });
+    expect(cards.outro).toEqual({
+      title: "Try it today",
+      subtitle: undefined,
+      logoSrc: undefined,
+      ctaText: "acme.dev/start",
+      durationMs: undefined,
+    });
+  });
+
+  it("maps a config with only one side set", () => {
+    const cards = mapProtoTitleCards({ outro: { title: "Bye" } }, "titleCards");
+    expect(cards.intro).toBeUndefined();
+    expect(cards.outro?.title).toBe("Bye");
+  });
+
+  it.each([
+    ["intro", { intro: { title: "" } }, /titleCards\.intro\.title.*required/],
+    ["outro", { outro: { title: "" } }, /titleCards\.outro\.title.*required/],
+  ])("rejects an empty title on the %s card", (_side, proto, message) => {
+    expect(() => mapProtoTitleCards(proto, "titleCards")).toThrowError(message);
+    expect(() => mapProtoTitleCards(proto, "titleCards")).toThrowError(InvalidScenarioError);
+  });
+
+  it.each([
+    ["subtitle", { intro: { title: "T", subtitle: "" } }, /subtitle.*non-empty/],
+    ["logoSrc", { intro: { title: "T", logoSrc: "" } }, /logoSrc.*non-empty/],
+    ["ctaText", { intro: { title: "T", ctaText: "" } }, /ctaText.*non-empty/],
+  ])("rejects an empty %s when present", (_field, proto, message) => {
+    expect(() => mapProtoTitleCards(proto, "titleCards")).toThrowError(message);
+  });
+
+  it.each([0, -1000])("rejects a non-positive durationMs (%d)", (durationMs) => {
+    expect(() =>
+      mapProtoTitleCards({ intro: { title: "T", durationMs } }, "titleCards"),
+    ).toThrowError(/durationMs.*greater than 0/);
+  });
+});

package/src/author/createScenario.ts

@@ -52,6 +52,7 @@ export function createScenario<Views extends ViewRegistry>(
       data: { view: step.view, props: step.props } as AuthoredStepData<Views>,
       narration: step.narrationText,
       interactions: step.interactions,
+      presenter: step.presenter,
     });
   }
 
@@ -59,5 +60,7 @@ export function createScenario<Views extends ViewRegistry>(
     viewport: input.viewport,
     views: input.views,
     steps,
+    soundtrack: input.soundtrack,
+    titleCards: input.titleCards,
   };
 }

package/src/author/types.ts

@@ -1,4 +1,4 @@
-import type { ScenarioStep, StepAction } from "@scenar/core";
+import type { ScenarioStep, Soundtrack, StepAction, TitleCards } from "@scenar/core";
 
 /**
  * A view registry maps opaque view identifiers (strings) to
@@ -49,6 +49,12 @@ export type StepInput<Views extends ViewRegistry> = {
     readonly narrationText?: string;
     readonly props: PropsOf<Views[K]>;
     readonly interactions?: readonly StepAction[];
+    /**
+     * Marks this step for the presenter track: `scenar presenter`
+     * generates an avatar clip from the step's narration audio, shown
+     * picture-in-picture in both outputs. Requires `narrationText`.
+     */
+    readonly presenter?: boolean;
   };
 }[keyof Views & string];
 
@@ -62,6 +68,23 @@ export interface ScenarioInput<Views extends ViewRegistry> {
   readonly views: Views;
   /** Ordered sequence of steps. Must contain at least one entry. */
   readonly steps: readonly StepInput<Views>[];
+  /**
+   * Audio treatment: background music with narration ducking and
+   * interaction sound effects. Optional — omitted means silent apart
+   * from narration.
+   */
+  readonly soundtrack?: Soundtrack;
+  /**
+   * Intro/outro title cards framing the scenario. Optional — omitted
+   * means the scenario plays exactly as authored.
+   *
+   * Carried through untouched, like `soundtrack`: card steps are
+   * synthesized at bundle assembly by `applyTitleCards` (from
+   * `@scenar/core`), which the CLI's render/pack pipelines call for
+   * you. When embedding directly, apply it between `createScenario()`
+   * and the player.
+   */
+  readonly titleCards?: TitleCards;
 }
 
 /**
@@ -72,4 +95,6 @@ export interface AuthoredScenario<Views extends ViewRegistry> {
   readonly viewport: ViewportConfig | undefined;
   readonly views: Views;
   readonly steps: readonly ScenarioStep<AuthoredStepData<Views>>[];
+  readonly soundtrack: Soundtrack | undefined;
+  readonly titleCards: TitleCards | undefined;
 }

package/src/index.ts

@@ -23,8 +23,11 @@ export { PROTO_ACTION_TYPE } from "./proto/proto-types.js";
 export type {
   ProtoActionTypeValue,
   ProtoScenarioSpec,
+  ProtoSoundtrackConfig,
   ProtoStep,
   ProtoStepAction,
   ProtoStepActionConfig,
+  ProtoTitleCard,
+  ProtoTitleCardsConfig,
   ProtoViewportConfig,
 } from "./proto/proto-types.js";

package/src/proto/load-scenario.ts

@@ -7,6 +7,8 @@ import type {
 import { InvalidScenarioError } from "./errors.js";
 import type { ProtoScenarioSpec } from "./proto-types.js";
 import { mapProtoAction } from "./action-mapper.js";
+import { mapProtoSoundtrack } from "./soundtrack-mapper.js";
+import { mapProtoTitleCards } from "./title-cards-mapper.js";
 
 /**
  * Options for {@link loadScenarioFromProto}.
@@ -61,6 +63,17 @@ export function loadScenarioFromProto<Views extends ViewRegistry>(
       mapProtoAction(protoAction, `${stepPath}.interactions[${j}]`),
     );
 
+    // Cross-field rule from the proto doc contract: a presenter clip is
+    // derived from the step's narration audio, so opting in without a
+    // script is an authoring contradiction — caught here, before the
+    // paid `scenar presenter` command ever runs.
+    if (protoStep.presenter && !protoStep.narrationText) {
+      throw new InvalidScenarioError(
+        `${stepPath}.presenter`,
+        "presenter requires narration_text — a presenter clip is derived from the step's narration audio.",
+      );
+    }
+
     steps.push({
       delayMs: protoStep.delayMs,
       data: {
@@ -69,6 +82,7 @@ export function loadScenarioFromProto<Views extends ViewRegistry>(
       } as AuthoredStepData<Views>,
       narration: protoStep.narrationText || undefined,
       interactions: interactions.length > 0 ? interactions : undefined,
+      presenter: protoStep.presenter || undefined,
     });
   }
 
@@ -76,5 +90,11 @@ export function loadScenarioFromProto<Views extends ViewRegistry>(
     viewport: spec.viewport ? { width: spec.viewport.width, height: spec.viewport.height } : undefined,
     views: options.views,
     steps,
+    soundtrack: spec.soundtrack
+      ? mapProtoSoundtrack(spec.soundtrack, "soundtrack")
+      : undefined,
+    titleCards: spec.titleCards
+      ? mapProtoTitleCards(spec.titleCards, "titleCards")
+      : undefined,
   };
 }

package/src/proto/proto-types.ts

@@ -83,10 +83,43 @@ export interface ProtoStep {
   readonly narrationText: string;
   readonly props?: Record<string, unknown>;
   readonly interactions: readonly ProtoStepAction[];
+  readonly presenter?: boolean;
+}
+
+/**
+ * Structural shape of a proto `SoundtrackConfig` message.
+ * All fields are proto3 `optional`, so absence is meaningful:
+ * an unset volume means "use the engine default".
+ */
+export interface ProtoSoundtrackConfig {
+  readonly musicSrc?: string;
+  readonly musicVolume?: number;
+  readonly duckingVolume?: number;
+  readonly sfx?: boolean;
+}
+
+/**
+ * Structural shape of a proto `TitleCard` message.
+ * Optional fields are proto3 `optional`, so absence is meaningful.
+ */
+export interface ProtoTitleCard {
+  readonly title: string;
+  readonly subtitle?: string;
+  readonly logoSrc?: string;
+  readonly ctaText?: string;
+  readonly durationMs?: number;
+}
+
+/** Structural shape of a proto `TitleCardsConfig` message. */
+export interface ProtoTitleCardsConfig {
+  readonly intro?: ProtoTitleCard;
+  readonly outro?: ProtoTitleCard;
 }
 
 /** Structural shape of the proto `ScenarioSpec` message. */
 export interface ProtoScenarioSpec {
   readonly viewport?: ProtoViewportConfig;
   readonly steps: readonly ProtoStep[];
+  readonly soundtrack?: ProtoSoundtrackConfig;
+  readonly titleCards?: ProtoTitleCardsConfig;
 }

package/src/proto/soundtrack-mapper.ts

@@ -0,0 +1,44 @@
+import type { Soundtrack } from "@scenar/core";
+import { InvalidScenarioError } from "./errors.js";
+import type { ProtoSoundtrackConfig } from "./proto-types.js";
+
+/**
+ * Map a proto `SoundtrackConfig` message to the engine's `Soundtrack`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (musicSrc non-empty when present, volumes within [0, 1]).
+ *
+ * All proto fields are `optional`, so absence passes through as
+ * `undefined` — the engine resolves defaults at playback time, keeping
+ * an authored 0.0 distinguishable from "use the default".
+ *
+ * @param proto - The proto SoundtrackConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export function mapProtoSoundtrack(
+  proto: ProtoSoundtrackConfig,
+  path: string,
+): Soundtrack {
+  if (proto.musicSrc !== undefined && proto.musicSrc.length === 0) {
+    throw new InvalidScenarioError(
+      `${path}.musicSrc`,
+      "musicSrc must be a non-empty asset reference when present.",
+    );
+  }
+
+  validateVolume(proto.musicVolume, `${path}.musicVolume`);
+  validateVolume(proto.duckingVolume, `${path}.duckingVolume`);
+
+  return {
+    musicSrc: proto.musicSrc,
+    musicVolume: proto.musicVolume,
+    duckingVolume: proto.duckingVolume,
+    sfx: proto.sfx,
+  };
+}
+
+function validateVolume(value: number | undefined, path: string): void {
+  if (value === undefined) return;
+  if (value < 0 || value > 1) {
+    throw new InvalidScenarioError(path, `must be between 0.0 and 1.0, got ${value}.`);
+  }
+}

package/src/proto/title-cards-mapper.ts

@@ -0,0 +1,55 @@
+import type { TitleCard, TitleCards } from "@scenar/core";
+import { InvalidScenarioError } from "./errors.js";
+import type { ProtoTitleCard, ProtoTitleCardsConfig } from "./proto-types.js";
+
+/**
+ * Map a proto `TitleCardsConfig` message to the engine's `TitleCards`
+ * type, enforcing the same rules the proto declares via `buf.validate`
+ * (title required and non-empty; optional strings non-empty when
+ * present; durationMs positive when present).
+ *
+ * Mapping only — card synthesis happens later, at bundle assembly, via
+ * `applyTitleCards`. The loader carries the config through untouched,
+ * exactly like `soundtrack`.
+ *
+ * @param proto - The proto TitleCardsConfig message (structural shape).
+ * @param path  - JSON-path prefix for error reporting.
+ */
+export function mapProtoTitleCards(
+  proto: ProtoTitleCardsConfig,
+  path: string,
+): TitleCards {
+  return {
+    intro: proto.intro ? mapCard(proto.intro, `${path}.intro`) : undefined,
+    outro: proto.outro ? mapCard(proto.outro, `${path}.outro`) : undefined,
+  };
+}
+
+function mapCard(proto: ProtoTitleCard, path: string): TitleCard {
+  if (!proto.title) {
+    throw new InvalidScenarioError(`${path}.title`, "title is required.");
+  }
+  validateNonEmpty(proto.subtitle, `${path}.subtitle`);
+  validateNonEmpty(proto.logoSrc, `${path}.logoSrc`);
+  validateNonEmpty(proto.ctaText, `${path}.ctaText`);
+  if (proto.durationMs !== undefined && proto.durationMs <= 0) {
+    throw new InvalidScenarioError(
+      `${path}.durationMs`,
+      `must be greater than 0, got ${proto.durationMs}.`,
+    );
+  }
+
+  return {
+    title: proto.title,
+    subtitle: proto.subtitle,
+    logoSrc: proto.logoSrc,
+    ctaText: proto.ctaText,
+    durationMs: proto.durationMs,
+  };
+}
+
+function validateNonEmpty(value: string | undefined, path: string): void {
+  if (value !== undefined && value.length === 0) {
+    throw new InvalidScenarioError(path, "must be non-empty when present.");
+  }
+}