@scenar/core 0.10.0 → 0.11.1

package/src/timeline/music-envelope.ts

@@ -0,0 +1,131 @@
+import type { NarrationManifest } from "../narration/types.js";
+import {
+  DUCKING_VOLUME_DEFAULT,
+  MUSIC_VOLUME_DEFAULT,
+  type Soundtrack,
+} from "../scenario/soundtrack.js";
+import { computeStepTimeline } from "./compute-step-timeline.js";
+
+/**
+ * Milliseconds over which the music fades in from silence at scenario
+ * start. Long enough to feel intentional, short enough that the opening
+ * step is never dry.
+ */
+export const MUSIC_FADE_IN_MS = 1_000;
+
+/**
+ * Milliseconds over which the music fades out at the end of the
+ * scenario. Matches the final-dwell window the timeline already reserves
+ * after the last step, so the video never ends on a hard musical cut.
+ */
+export const MUSIC_FADE_OUT_MS = 3_000;
+
+/**
+ * Milliseconds the music takes to ramp between its base level and its
+ * ducked level at each narration boundary. The ramp completes as the
+ * voice starts (pre-duck) so narration onset is never fighting the ramp;
+ * felt, not heard as a cut.
+ */
+export const DUCKING_RAMP_MS = 300;
+
+/** A span of the scenario timeline during which a narration clip plays. */
+export interface DuckingWindow {
+  readonly startMs: number;
+  readonly endMs: number;
+}
+
+/**
+ * Everything needed to compute the music level at any point on the
+ * scenario timeline. Precomputed once per scenario; `musicGainAt` reads
+ * it per sample/frame without allocating.
+ */
+export interface MusicEnvelope {
+  /** Resolved base music level (0–1). */
+  readonly musicVolume: number;
+  /** Resolved ducked music level while narration plays (0–1). */
+  readonly duckingVolume: number;
+  /** Total scenario duration, from `computeStepTimeline`. */
+  readonly totalDurationMs: number;
+  /** Narration clip spans on the timeline, in step order. */
+  readonly duckingWindows: readonly DuckingWindow[];
+}
+
+/**
+ * Precompute the music envelope for a scenario: resolved volume levels
+ * plus the narration windows the music ducks under.
+ *
+ * The windows derive from the same `computeStepTimeline` both output
+ * paths already share — a clip for step N spans from that step's start
+ * for the clip's duration — so ducking agrees with narration placement
+ * by construction, in browser playback and video export alike.
+ */
+export function computeMusicEnvelope(
+  steps: readonly { delayMs: number }[],
+  manifest: NarrationManifest | null | undefined,
+  soundtrack: Soundtrack,
+): MusicEnvelope {
+  const { stepStartTimesMs, totalDurationMs } = computeStepTimeline(steps, manifest);
+
+  const duckingWindows: DuckingWindow[] = [];
+  if (manifest) {
+    for (let i = 0; i < steps.length; i++) {
+      const durationMs = manifest.steps[i]?.durationMs ?? 0;
+      if (durationMs > 0) {
+        const startMs = stepStartTimesMs[i] ?? 0;
+        duckingWindows.push({ startMs, endMs: startMs + durationMs });
+      }
+    }
+  }
+
+  return {
+    musicVolume: soundtrack.musicVolume ?? MUSIC_VOLUME_DEFAULT,
+    duckingVolume: soundtrack.duckingVolume ?? DUCKING_VOLUME_DEFAULT,
+    totalDurationMs,
+    duckingWindows,
+  };
+}
+
+/**
+ * The music level at a point on the scenario timeline (0–1).
+ *
+ * Composed of three factors:
+ * - a fade-in from silence over {@link MUSIC_FADE_IN_MS} at the start,
+ * - a fade-out to silence over {@link MUSIC_FADE_OUT_MS} at the end,
+ * - narration ducking: at the base level away from narration, at the
+ *   ducked level while a clip plays, ramping over {@link DUCKING_RAMP_MS}
+ *   into each window (completing at voice onset) and out after it ends.
+ *
+ * Pure and allocation-free: the browser applies it through Web Audio
+ * gain automation, video export as a per-frame volume function. Outside
+ * the scenario ([0, totalDurationMs]) the level is 0.
+ */
+export function musicGainAt(envelope: MusicEnvelope, timeMs: number): number {
+  const { musicVolume, duckingVolume, totalDurationMs, duckingWindows } = envelope;
+  if (timeMs < 0 || timeMs > totalDurationMs) return 0;
+
+  // Ducked-ness in [0, 1]: 0 at the base level, 1 fully ducked. Overlapping
+  // windows take the deepest value.
+  let ducked = 0;
+  for (const window of duckingWindows) {
+    const rampInStart = window.startMs - DUCKING_RAMP_MS;
+    if (timeMs < rampInStart || timeMs > window.endMs + DUCKING_RAMP_MS) continue;
+
+    let d: number;
+    if (timeMs < window.startMs) {
+      d = (timeMs - rampInStart) / DUCKING_RAMP_MS;
+    } else if (timeMs <= window.endMs) {
+      d = 1;
+    } else {
+      d = 1 - (timeMs - window.endMs) / DUCKING_RAMP_MS;
+    }
+    if (d > ducked) ducked = d;
+    if (ducked === 1) break;
+  }
+
+  const level = musicVolume + (duckingVolume - musicVolume) * ducked;
+
+  const fadeIn = Math.min(1, timeMs / MUSIC_FADE_IN_MS);
+  const fadeOut = Math.min(1, (totalDurationMs - timeMs) / MUSIC_FADE_OUT_MS);
+
+  return level * fadeIn * fadeOut;
+}

package/timeline/compute-step-timeline.d.ts

@@ -1,11 +1,36 @@
-import type { NarrationManifest } from "../narration/types.js";
 /**
  * Minimal step shape for timeline computation. Accepts any
- * ScenarioStep<T> without caring about the data payload.
+ * ScenarioStep<T> without caring about the data payload. The optional
+ * `card` marker participates because a synthesized outro card's
+ * duration IS the closing dwell (see below).
  */
 interface StepTiming {
     delayMs: number;
+    card?: {
+        durationMs?: number;
+    };
 }
+/**
+ * Minimal manifest shape for timeline computation: any positional
+ * manifest whose entries carry a duration. Accepts the narration
+ * manifest, and — while the player is muted with a presenter track —
+ * the presenter manifest, whose clip durations equal the narration's
+ * for the same steps (the clip is derived from that audio). Feeding
+ * the presenter manifest to the muted timeline keeps the progress
+ * bar, scrubbing, and step advancement in agreement on presenter
+ * steps, and converges muted timing on the export timeline there.
+ */
+interface ManifestTiming {
+    readonly steps: readonly ({
+        readonly durationMs: number;
+    } | null | undefined)[];
+}
+/**
+ * Dwell time on the final step so viewers can absorb the result.
+ * Also the delay `applyTitleCards` gives a synthesized outro card, so
+ * the last authored step keeps exactly this dwell before the card.
+ */
+export declare const FINAL_DWELL_MS = 3000;
 export interface StepTimeline {
     /** Start time of each step in milliseconds (index 0 is always 0). */
     stepStartTimesMs: number[];
@@ -22,6 +47,6 @@ export interface StepTimeline {
  * Shared between browser ScenarioPlayer (progress bar) and Remotion
  * video export (frame-based timeline).
  */
-export declare function computeStepTimeline(steps: readonly StepTiming[], manifest: NarrationManifest | null | undefined): StepTimeline;
+export declare function computeStepTimeline(steps: readonly StepTiming[], manifest: ManifestTiming | null | undefined): StepTimeline;
 export {};
 //# sourceMappingURL=compute-step-timeline.d.ts.map

package/timeline/compute-step-timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute-step-timeline.d.ts","sourceRoot":"","sources":["../../src/timeline/compute-step-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;GAGG;AACH,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC7C,YAAY,CAed"}
+{"version":3,"file":"compute-step-timeline.d.ts","sourceRoot":"","sources":["../../src/timeline/compute-step-timeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CACjF;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAQ,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAC1C,YAAY,CAmBd"}

package/timeline/compute-step-timeline.js

@@ -1,5 +1,9 @@
-/** Dwell time on the final step so viewers can absorb the result. */
-const FINAL_DWELL_MS = 3_000;
+/**
+ * Dwell time on the final step so viewers can absorb the result.
+ * Also the delay `applyTitleCards` gives a synthesized outro card, so
+ * the last authored step keeps exactly this dwell before the card.
+ */
+export const FINAL_DWELL_MS = 3_000;
 /**
  * Pre-compute step start times and total duration from step definitions
  * and an optional narration manifest.
@@ -20,7 +24,11 @@ export function computeStepTimeline(steps, manifest) {
     }
     const lastStepStart = stepStartTimesMs[stepStartTimesMs.length - 1] ?? 0;
     const lastNarrationMs = manifest?.steps[steps.length - 1]?.durationMs ?? 0;
-    const totalDurationMs = lastStepStart + Math.max(FINAL_DWELL_MS, lastNarrationMs);
+    // A final card step (a synthesized outro) dwells for its configured
+    // duration instead of the fixed default — cards are silent, so the
+    // narration max is a no-op for them but kept for uniformity.
+    const closingDwellMs = steps[steps.length - 1]?.card?.durationMs ?? FINAL_DWELL_MS;
+    const totalDurationMs = lastStepStart + Math.max(closingDwellMs, lastNarrationMs);
     return { stepStartTimesMs, totalDurationMs };
 }
 //# sourceMappingURL=compute-step-timeline.js.map

package/timeline/compute-step-timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"compute-step-timeline.js","sourceRoot":"","sources":["../../src/timeline/compute-step-timeline.ts"],"names":[],"mappings":"AAUA,qEAAqE;AACrE,MAAM,cAAc,GAAG,KAAK,CAAC;AAS7B;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA4B,EAC5B,QAA8C;IAE9C,MAAM,gBAAgB,GAAa,CAAC,CAAC,CAAC,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;QACpC,MAAM,WAAW,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5D,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAElF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"compute-step-timeline.js","sourceRoot":"","sources":["../../src/timeline/compute-step-timeline.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AASpC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA4B,EAC5B,QAA2C;IAE3C,MAAM,gBAAgB,GAAa,CAAC,CAAC,CAAC,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;QACpC,MAAM,WAAW,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5D,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;IAC3E,oEAAoE;IACpE,mEAAmE;IACnE,6DAA6D;IAC7D,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,IAAI,cAAc,CAAC;IACnF,MAAM,eAAe,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAElF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAC/C,CAAC"}

package/timeline/derive-action-events.d.ts

@@ -0,0 +1,40 @@
+import type { StepAction } from "../scenario/step-action.js";
+/**
+ * The observable sub-events of a step interaction, in the vocabulary the
+ * engine's effect layer uses: a `click` action is a cursor move followed
+ * by a click dispatch; a `type` action is a cursor move followed by one
+ * keystroke per character; and so on.
+ */
+export type ActionEventKind = "cursor-move" | "click-dispatch" | "keystroke" | "hover-enter" | "hover-leave" | "drag-press" | "drag-move" | "drag-release" | "viewport-transition" | "simple-dispatch";
+/** One timed sub-event of a step interaction. */
+export interface ActionEvent {
+    readonly kind: ActionEventKind;
+    /**
+     * When this event fires, in milliseconds relative to the step's entry,
+     * at playback rate 1. Consumers scale for playback rate (the browser
+     * scheduler divides by rate; video export always runs at rate 1).
+     */
+    readonly offsetMs: number;
+    /** Zero-based character index. Present only on `keystroke` events. */
+    readonly charIndex?: number;
+}
+/**
+ * Derive the timed sub-events of a single step interaction — the
+ * canonical statement of the engine's event-offset math.
+ *
+ * The offsets below are the exact times at which the interaction
+ * schedulers in `@scenar/react` (`useBrowserStepInteractions`,
+ * `useTimeSourceStepInteractions`) dispatch their effects; parity tests
+ * in that package pin the schedulers to this derivation. Sound-effect
+ * placement (`deriveSfxTimeline`) is built on it, so a sound can never
+ * drift from the visual it accompanies.
+ *
+ * Pure function of its arguments: same action and duration, same events,
+ * in both browser playback and video export.
+ *
+ * @param action - The interaction to derive events for.
+ * @param stepDurationMs - The step's effective duration (see
+ *   `getStepDurationMs`); `atPercent` anchors against it.
+ */
+export declare function deriveActionEvents(action: StepAction, stepDurationMs: number): ActionEvent[];
+//# sourceMappingURL=derive-action-events.d.ts.map

package/timeline/derive-action-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-action-events.d.ts","sourceRoot":"","sources":["../../src/timeline/derive-action-events.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,GACrB,WAAW,EAAE,CAuDf"}

package/timeline/derive-action-events.js

@@ -0,0 +1,71 @@
+import { CLICK_DELAY_MS, DRAG_SETTLE_MS, HOVER_HOLD_MS, TYPE_CHAR_DELAY_MS, } from "../timing/constants.js";
+/**
+ * Derive the timed sub-events of a single step interaction — the
+ * canonical statement of the engine's event-offset math.
+ *
+ * The offsets below are the exact times at which the interaction
+ * schedulers in `@scenar/react` (`useBrowserStepInteractions`,
+ * `useTimeSourceStepInteractions`) dispatch their effects; parity tests
+ * in that package pin the schedulers to this derivation. Sound-effect
+ * placement (`deriveSfxTimeline`) is built on it, so a sound can never
+ * drift from the visual it accompanies.
+ *
+ * Pure function of its arguments: same action and duration, same events,
+ * in both browser playback and video export.
+ *
+ * @param action - The interaction to derive events for.
+ * @param stepDurationMs - The step's effective duration (see
+ *   `getStepDurationMs`); `atPercent` anchors against it.
+ */
+export function deriveActionEvents(action, stepDurationMs) {
+    const fireAt = action.atPercent * stepDurationMs;
+    switch (action.type) {
+        case "click":
+            return [
+                { kind: "cursor-move", offsetMs: fireAt },
+                { kind: "click-dispatch", offsetMs: fireAt + CLICK_DELAY_MS },
+            ];
+        case "type": {
+            const text = action.text ?? "";
+            // An empty type action is a no-op in the schedulers (not even a
+            // cursor move), so it derives no events.
+            if (text.length === 0)
+                return [];
+            const charDelay = action.typeDelay ?? TYPE_CHAR_DELAY_MS;
+            const typingStart = fireAt + CLICK_DELAY_MS;
+            const events = [{ kind: "cursor-move", offsetMs: fireAt }];
+            for (let i = 0; i < text.length; i++) {
+                events.push({
+                    kind: "keystroke",
+                    offsetMs: typingStart + i * charDelay,
+                    charIndex: i,
+                });
+            }
+            return events;
+        }
+        case "hover": {
+            const holdMs = action.hoverDuration ?? HOVER_HOLD_MS;
+            return [
+                { kind: "cursor-move", offsetMs: fireAt },
+                { kind: "hover-enter", offsetMs: fireAt + CLICK_DELAY_MS },
+                { kind: "hover-leave", offsetMs: fireAt + CLICK_DELAY_MS + holdMs },
+            ];
+        }
+        case "drag":
+            return [
+                { kind: "cursor-move", offsetMs: fireAt },
+                { kind: "drag-press", offsetMs: fireAt + CLICK_DELAY_MS },
+                { kind: "drag-move", offsetMs: fireAt + CLICK_DELAY_MS + DRAG_SETTLE_MS },
+                {
+                    kind: "drag-release",
+                    offsetMs: fireAt + CLICK_DELAY_MS + DRAG_SETTLE_MS + CLICK_DELAY_MS,
+                },
+            ];
+        case "viewport_transition":
+            return [{ kind: "viewport-transition", offsetMs: fireAt }];
+        // scroll_to, set_cursor, clear_cursor: a single dispatch at fireAt.
+        default:
+            return [{ kind: "simple-dispatch", offsetMs: fireAt }];
+    }
+}
+//# sourceMappingURL=derive-action-events.js.map

package/timeline/derive-action-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-action-events.js","sourceRoot":"","sources":["../../src/timeline/derive-action-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAkChC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,cAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC;IAEjD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO;gBACL,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE;gBACzC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;aAC9D,CAAC;QAEJ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YAC/B,gEAAgE;YAChE,yCAAyC;YACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;YACzD,MAAM,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;YAC5C,MAAM,MAAM,GAAkB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,WAAW,GAAG,CAAC,GAAG,SAAS;oBACrC,SAAS,EAAE,CAAC;iBACb,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,IAAI,aAAa,CAAC;YACrD,OAAO;gBACL,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE;gBACzC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;gBAC1D,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,EAAE;aACpE,CAAC;QACJ,CAAC;QAED,KAAK,MAAM;YACT,OAAO;gBACL,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE;gBACzC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;gBACzD,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE;gBACzE;oBACE,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc;iBACpE;aACF,CAAC;QAEJ,KAAK,qBAAqB;YACxB,OAAO,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7D,oEAAoE;QACpE;YACE,OAAO,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/timeline/derive-sfx-timeline.d.ts

@@ -0,0 +1,36 @@
+import type { NarrationManifest } from "../narration/types.js";
+import type { ScenarioStep } from "../scenario/types.js";
+/**
+ * The engine's built-in sound-effect vocabulary. Deliberately minimal:
+ * a click sound and a keystroke sound sell realism; everything else
+ * (hover, scroll, camera moves) stays silent.
+ */
+export type SfxSound = "click" | "keystroke";
+/** One sound effect placed on the scenario timeline. */
+export interface SfxEvent {
+    /** The step during which this sound fires. */
+    readonly stepIndex: number;
+    /**
+     * When the sound fires, in milliseconds relative to the step's entry,
+     * at playback rate 1 — the same time base as `ActionEvent.offsetMs`,
+     * so the sound and the visual it accompanies share one clock.
+     */
+    readonly offsetMs: number;
+    readonly sound: SfxSound;
+}
+/**
+ * Derive every sound effect in the scenario from its interactions —
+ * placement is computed, never authored.
+ *
+ * Built on `deriveActionEvents`, so each sound fires at the exact moment
+ * its interaction dispatches: the click sound when the DOM click fires
+ * (after the cursor's travel window), one keystroke sound per typed
+ * character at the typing cadence, click sounds at drag press and
+ * release. Consumers place the events: video export converts offsets to
+ * absolute frames via the step timeline; browser playback schedules them
+ * on step entry, exactly like the interaction schedulers.
+ *
+ * Events are ordered by step, then by offset within the step.
+ */
+export declare function deriveSfxTimeline<T>(steps: readonly ScenarioStep<T>[], manifest: NarrationManifest | undefined): SfxEvent[];
+//# sourceMappingURL=derive-sfx-timeline.d.ts.map

package/timeline/derive-sfx-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-sfx-timeline.d.ts","sourceRoot":"","sources":["../../src/timeline/derive-sfx-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAE7C,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EACjC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,QAAQ,EAAE,CAwBZ"}

package/timeline/derive-sfx-timeline.js

@@ -0,0 +1,49 @@
+import { getStepDurationMs } from "./step-duration.js";
+import { deriveActionEvents } from "./derive-action-events.js";
+/**
+ * Which action sub-events make a sound. Click dispatches and drag
+ * press/release share the click sound (a drag is a press and a release);
+ * each typed character gets a keystroke sound.
+ */
+const SOUND_BY_EVENT_KIND = {
+    "click-dispatch": "click",
+    "drag-press": "click",
+    "drag-release": "click",
+    keystroke: "keystroke",
+};
+/**
+ * Derive every sound effect in the scenario from its interactions —
+ * placement is computed, never authored.
+ *
+ * Built on `deriveActionEvents`, so each sound fires at the exact moment
+ * its interaction dispatches: the click sound when the DOM click fires
+ * (after the cursor's travel window), one keystroke sound per typed
+ * character at the typing cadence, click sounds at drag press and
+ * release. Consumers place the events: video export converts offsets to
+ * absolute frames via the step timeline; browser playback schedules them
+ * on step entry, exactly like the interaction schedulers.
+ *
+ * Events are ordered by step, then by offset within the step.
+ */
+export function deriveSfxTimeline(steps, manifest) {
+    const events = [];
+    for (let stepIndex = 0; stepIndex < steps.length; stepIndex++) {
+        const actions = steps[stepIndex]?.interactions;
+        if (!actions || actions.length === 0)
+            continue;
+        const duration = getStepDurationMs(stepIndex, manifest, steps);
+        const stepEvents = [];
+        for (const action of actions) {
+            for (const event of deriveActionEvents(action, duration)) {
+                const sound = SOUND_BY_EVENT_KIND[event.kind];
+                if (sound) {
+                    stepEvents.push({ stepIndex, offsetMs: event.offsetMs, sound });
+                }
+            }
+        }
+        stepEvents.sort((a, b) => a.offsetMs - b.offsetMs);
+        events.push(...stepEvents);
+    }
+    return events;
+}
+//# sourceMappingURL=derive-sfx-timeline.js.map

package/timeline/derive-sfx-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-sfx-timeline.js","sourceRoot":"","sources":["../../src/timeline/derive-sfx-timeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAwB,MAAM,2BAA2B,CAAC;AAsBrF;;;;GAIG;AACH,MAAM,mBAAmB,GAA+C;IACtE,gBAAgB,EAAE,OAAO;IACzB,YAAY,EAAE,OAAO;IACrB,cAAc,EAAE,OAAO;IACvB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiC,EACjC,QAAuC;IAEvC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;QAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAE/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAe,EAAE,CAAC;QAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACzD,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,KAAK,EAAE,CAAC;oBACV,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/timeline/music-envelope.d.ts

@@ -0,0 +1,69 @@
+import type { NarrationManifest } from "../narration/types.js";
+import { type Soundtrack } from "../scenario/soundtrack.js";
+/**
+ * Milliseconds over which the music fades in from silence at scenario
+ * start. Long enough to feel intentional, short enough that the opening
+ * step is never dry.
+ */
+export declare const MUSIC_FADE_IN_MS = 1000;
+/**
+ * Milliseconds over which the music fades out at the end of the
+ * scenario. Matches the final-dwell window the timeline already reserves
+ * after the last step, so the video never ends on a hard musical cut.
+ */
+export declare const MUSIC_FADE_OUT_MS = 3000;
+/**
+ * Milliseconds the music takes to ramp between its base level and its
+ * ducked level at each narration boundary. The ramp completes as the
+ * voice starts (pre-duck) so narration onset is never fighting the ramp;
+ * felt, not heard as a cut.
+ */
+export declare const DUCKING_RAMP_MS = 300;
+/** A span of the scenario timeline during which a narration clip plays. */
+export interface DuckingWindow {
+    readonly startMs: number;
+    readonly endMs: number;
+}
+/**
+ * Everything needed to compute the music level at any point on the
+ * scenario timeline. Precomputed once per scenario; `musicGainAt` reads
+ * it per sample/frame without allocating.
+ */
+export interface MusicEnvelope {
+    /** Resolved base music level (0–1). */
+    readonly musicVolume: number;
+    /** Resolved ducked music level while narration plays (0–1). */
+    readonly duckingVolume: number;
+    /** Total scenario duration, from `computeStepTimeline`. */
+    readonly totalDurationMs: number;
+    /** Narration clip spans on the timeline, in step order. */
+    readonly duckingWindows: readonly DuckingWindow[];
+}
+/**
+ * Precompute the music envelope for a scenario: resolved volume levels
+ * plus the narration windows the music ducks under.
+ *
+ * The windows derive from the same `computeStepTimeline` both output
+ * paths already share — a clip for step N spans from that step's start
+ * for the clip's duration — so ducking agrees with narration placement
+ * by construction, in browser playback and video export alike.
+ */
+export declare function computeMusicEnvelope(steps: readonly {
+    delayMs: number;
+}[], manifest: NarrationManifest | null | undefined, soundtrack: Soundtrack): MusicEnvelope;
+/**
+ * The music level at a point on the scenario timeline (0–1).
+ *
+ * Composed of three factors:
+ * - a fade-in from silence over {@link MUSIC_FADE_IN_MS} at the start,
+ * - a fade-out to silence over {@link MUSIC_FADE_OUT_MS} at the end,
+ * - narration ducking: at the base level away from narration, at the
+ *   ducked level while a clip plays, ramping over {@link DUCKING_RAMP_MS}
+ *   into each window (completing at voice onset) and out after it ends.
+ *
+ * Pure and allocation-free: the browser applies it through Web Audio
+ * gain automation, video export as a per-frame volume function. Outside
+ * the scenario ([0, totalDurationMs]) the level is 0.
+ */
+export declare function musicGainAt(envelope: MusicEnvelope, timeMs: number): number;
+//# sourceMappingURL=music-envelope.d.ts.map

package/timeline/music-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-envelope.d.ts","sourceRoot":"","sources":["../../src/timeline/music-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAGnC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EACrC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC9C,UAAU,EAAE,UAAU,GACrB,aAAa,CAoBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6B3E"}

package/timeline/music-envelope.js

@@ -0,0 +1,95 @@
+import { DUCKING_VOLUME_DEFAULT, MUSIC_VOLUME_DEFAULT, } from "../scenario/soundtrack.js";
+import { computeStepTimeline } from "./compute-step-timeline.js";
+/**
+ * Milliseconds over which the music fades in from silence at scenario
+ * start. Long enough to feel intentional, short enough that the opening
+ * step is never dry.
+ */
+export const MUSIC_FADE_IN_MS = 1_000;
+/**
+ * Milliseconds over which the music fades out at the end of the
+ * scenario. Matches the final-dwell window the timeline already reserves
+ * after the last step, so the video never ends on a hard musical cut.
+ */
+export const MUSIC_FADE_OUT_MS = 3_000;
+/**
+ * Milliseconds the music takes to ramp between its base level and its
+ * ducked level at each narration boundary. The ramp completes as the
+ * voice starts (pre-duck) so narration onset is never fighting the ramp;
+ * felt, not heard as a cut.
+ */
+export const DUCKING_RAMP_MS = 300;
+/**
+ * Precompute the music envelope for a scenario: resolved volume levels
+ * plus the narration windows the music ducks under.
+ *
+ * The windows derive from the same `computeStepTimeline` both output
+ * paths already share — a clip for step N spans from that step's start
+ * for the clip's duration — so ducking agrees with narration placement
+ * by construction, in browser playback and video export alike.
+ */
+export function computeMusicEnvelope(steps, manifest, soundtrack) {
+    const { stepStartTimesMs, totalDurationMs } = computeStepTimeline(steps, manifest);
+    const duckingWindows = [];
+    if (manifest) {
+        for (let i = 0; i < steps.length; i++) {
+            const durationMs = manifest.steps[i]?.durationMs ?? 0;
+            if (durationMs > 0) {
+                const startMs = stepStartTimesMs[i] ?? 0;
+                duckingWindows.push({ startMs, endMs: startMs + durationMs });
+            }
+        }
+    }
+    return {
+        musicVolume: soundtrack.musicVolume ?? MUSIC_VOLUME_DEFAULT,
+        duckingVolume: soundtrack.duckingVolume ?? DUCKING_VOLUME_DEFAULT,
+        totalDurationMs,
+        duckingWindows,
+    };
+}
+/**
+ * The music level at a point on the scenario timeline (0–1).
+ *
+ * Composed of three factors:
+ * - a fade-in from silence over {@link MUSIC_FADE_IN_MS} at the start,
+ * - a fade-out to silence over {@link MUSIC_FADE_OUT_MS} at the end,
+ * - narration ducking: at the base level away from narration, at the
+ *   ducked level while a clip plays, ramping over {@link DUCKING_RAMP_MS}
+ *   into each window (completing at voice onset) and out after it ends.
+ *
+ * Pure and allocation-free: the browser applies it through Web Audio
+ * gain automation, video export as a per-frame volume function. Outside
+ * the scenario ([0, totalDurationMs]) the level is 0.
+ */
+export function musicGainAt(envelope, timeMs) {
+    const { musicVolume, duckingVolume, totalDurationMs, duckingWindows } = envelope;
+    if (timeMs < 0 || timeMs > totalDurationMs)
+        return 0;
+    // Ducked-ness in [0, 1]: 0 at the base level, 1 fully ducked. Overlapping
+    // windows take the deepest value.
+    let ducked = 0;
+    for (const window of duckingWindows) {
+        const rampInStart = window.startMs - DUCKING_RAMP_MS;
+        if (timeMs < rampInStart || timeMs > window.endMs + DUCKING_RAMP_MS)
+            continue;
+        let d;
+        if (timeMs < window.startMs) {
+            d = (timeMs - rampInStart) / DUCKING_RAMP_MS;
+        }
+        else if (timeMs <= window.endMs) {
+            d = 1;
+        }
+        else {
+            d = 1 - (timeMs - window.endMs) / DUCKING_RAMP_MS;
+        }
+        if (d > ducked)
+            ducked = d;
+        if (ducked === 1)
+            break;
+    }
+    const level = musicVolume + (duckingVolume - musicVolume) * ducked;
+    const fadeIn = Math.min(1, timeMs / MUSIC_FADE_IN_MS);
+    const fadeOut = Math.min(1, (totalDurationMs - timeMs) / MUSIC_FADE_OUT_MS);
+    return level * fadeIn * fadeOut;
+}
+//# sourceMappingURL=music-envelope.js.map

package/timeline/music-envelope.js.map

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