@maravilla-labs/frames 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -7,6 +7,9 @@
  * - Inside the Maravilla renderer, the timeline is stepped frame by
  *   frame to produce deterministic video output.
  */
+export { AudioEngine } from "./audio.js";
+export type { PreviewAudioTrack } from "./audio.js";
+export { DEFAULT_DUCK, duckAutomation, duckMultiplier, mergeSegments, type DuckParams, type Segment, } from "./ducking.js";
 export type AnimationInstr = {
     /** Optional discriminator. Defaults to `"animation"`. */
     kind?: "animation";
@@ -63,11 +66,85 @@ export type CssClassInstr = {
     /** Class names to add, e.g. `["animate__animated", "animate__bounceInDown"]`. */
     classes: string[];
 };
-export type Instr = AnimationInstr | VideoInstr | CssClassInstr;
+/** Role of an audio track. `"voiceover"` is what music ducks *under*;
+ * `"music"` is the background bed that gets ducked; `"sfx"` is a one-shot
+ * that is neither ducked nor a ducking trigger. */
+export type AudioRole = "voiceover" | "music" | "sfx";
+/**
+ * A per-track audio effect. `"radio"` is a band-limited, saturated "deep
+ * radio/telephone voice" — applied identically in the browser preview (Web
+ * Audio filter chain, [`audio.ts`]) and in the render (ffmpeg, worker-side), so
+ * preview matches export. All knobs are 0..1.
+ */
+export type AudioEffect = {
+    kind: "radio";
+    /** Overdrive / saturation amount (0 = clean, 1 = crunchy). Default 0.4. */
+    drive?: number;
+    /** Band brightness (0 = narrow telephone band, 1 = wide/open). Default 0.4. */
+    tone?: number;
+    /** Low-end "depth" boost for a deeper voice. Default 0.5. */
+    depth?: number;
+};
+/**
+ * An audio track on the timeline. Unlike the visual instructions it owns no
+ * DOM element — it's mixed into the final video by the render worker (ffmpeg)
+ * and played in the browser preview by the Web Audio engine ([`audio.ts`]).
+ * Multiple tracks coexist (e.g. an intro bed + a voiceover); music tracks
+ * dip under voiceover via static-envelope ducking (see [`ducking.ts`]).
+ */
+export type AudioInstr = {
+    /** Discriminator — required. */
+    kind: "audio";
+    /** When on the timeline the track starts, in milliseconds. */
+    at: number;
+    /** How long it plays from `at`, in ms. Defaults to the clip's natural length. */
+    duration?: number;
+    /** Start offset WITHIN the source file, in ms. Defaults to 0. */
+    seek?: number;
+    /**
+     * Playable URL for the browser preview (fetched + decoded via Web Audio).
+     * For a stored asset, a URL that resolves to it (e.g. `/_assets/<key>`).
+     */
+    src: string;
+    /**
+     * Storage key the render worker fetches + stages to mix into the final
+     * video. Without it the track is preview-only (it can't be rendered).
+     */
+    key?: string;
+    /** Track role. Defaults to `"music"`. */
+    role?: AudioRole;
+    /** Linear gain (1 = unity). Defaults to 1. */
+    gain?: number;
+    /** Fade-in / fade-out length from the clip edges, ms. Default 0. */
+    fadeIn?: number;
+    fadeOut?: number;
+    /** Whether a music track ducks under voiceover. Defaults to `role === "music"`. */
+    duck?: boolean;
+    /** Optional per-track effect (e.g. a "radio voice"). */
+    effect?: AudioEffect;
+};
+export type Instr = AnimationInstr | VideoInstr | CssClassInstr | AudioInstr;
 export type TimelineSchema = {
     duration: number;
     instructions: Instr[];
 };
+/** An audio track as exposed to the render worker via `window.__mvFrames.audio`.
+ * The worker stages `key` and builds the ffmpeg mix; `duration === null`
+ * means "use the source's natural length". Mirrors [`AudioInstr`] with
+ * defaults resolved. */
+export type AudioSlotInfo = {
+    /** Storage key the worker stages (absent ⇒ preview-only, not rendered). */
+    key?: string;
+    at: number;
+    duration: number | null;
+    seek: number;
+    gain: number;
+    role: AudioRole;
+    duck: boolean;
+    fadeIn: number;
+    fadeOut: number;
+    effect?: AudioEffect;
+};
 /** A `<video>` slot as exposed to the renderer engine (worker). The engine
  * pre-extracts each clip to frames with ffmpeg and swaps the live `<video>`
  * for the matching frame image per captured frame — so the live video is never
@@ -93,6 +170,17 @@ declare global {
             /** Video slots in this timeline — read by the renderer engine to
              * swap video frames out-of-band. Empty when no video. */
             videos: VideoSlotInfo[];
+            /** Audio tracks in this timeline — read by the render worker to build
+             * the ffmpeg mix. Empty when no audio. */
+            audio: AudioSlotInfo[];
+            /** Preview transport (browser only; no-ops under the renderer). Start
+             * the audio mix from timeline position `fromMs`. The preview host calls
+             * this on play; scrubbing via `applyState` stays silent. */
+            playAudio(fromMs: number): void;
+            /** Stop preview audio playback. */
+            stopAudio(): void;
+            /** Mute / unmute preview audio without tearing down playback. */
+            setAudioMuted(muted: boolean): void;
         };
         /** Set true by the headless renderer when it captures (`__mvFramesRendererPresent`). */
         __mvFramesRendererPresent?: boolean;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,yDAAyD;IACzD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,gCAAgC;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC;AAEzE;;;yEAGyE;AACzE,MAAM,MAAM,aAAa,GAAG;IAC1B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE;YACV,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC;qEACyD;YACzD,MAAM,EAAE,aAAa,EAAE,CAAC;SACzB,CAAC;QACF,wFAAwF;QACxF,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACpC;;;mFAG2E;QAC3E,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC;CACF;AAsBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAW3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,6 +7,9 @@
  * - Inside the Maravilla renderer, the timeline is stepped frame by
  *   frame to produce deterministic video output.
  */
+import { AudioEngine } from "./audio.js";
+export { AudioEngine } from "./audio.js";
+export { DEFAULT_DUCK, duckAutomation, duckMultiplier, mergeSegments, } from "./ducking.js";
 /**
  * Declare the page's timeline. **Safe to call as soon as your module runs** —
  * it internally waits for render-blocking stylesheets and fonts to be ready
@@ -60,9 +63,61 @@ export function stylesheetsReady() {
     })
         .then(() => (document.fonts ? document.fonts.ready.then(() => undefined) : undefined));
 }
+/**
+ * Seek `el` to `targetSec` and resolve only once the seeked frame has
+ * actually decoded — so a subsequent capture grabs the right frame instead
+ * of racing an in-flight seek.
+ *
+ * Resolution waits for the `seeked` event, then for one decoded video frame
+ * via `requestVideoFrameCallback` where available (fallback: a microtask, so
+ * we still yield to the decode). A timeout guards against `seeked` never
+ * firing (e.g. seeking to the exact current position, or an unsupported
+ * codec) so `applyState` can't hang the whole render. Already-satisfied
+ * seeks (`readyState` high enough and time already at target) resolve fast.
+ */
+function seekVideo(el, targetSec) {
+    const HAVE_CURRENT_DATA = 2;
+    // If we're already at (or within a frame of) the target with data ready,
+    // there's nothing to wait for — assigning currentTime won't fire `seeked`.
+    const alreadyThere = Math.abs(el.currentTime - targetSec) < 1e-3 && el.readyState >= HAVE_CURRENT_DATA;
+    el.currentTime = targetSec;
+    if (alreadyThere)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            el.removeEventListener("seeked", onSeeked);
+            clearTimeout(timer);
+            resolve();
+        };
+        const afterSeeked = () => {
+            // Wait for one decoded frame to be presented when the API exists.
+            const rvfc = el.requestVideoFrameCallback;
+            if (typeof rvfc === "function") {
+                rvfc.call(el, () => finish());
+            }
+            else {
+                // No rVFC: yield a microtask so the decode can settle, then finish.
+                Promise.resolve().then(finish);
+            }
+        };
+        const onSeeked = () => afterSeeked();
+        el.addEventListener("seeked", onSeeked, { once: true });
+        // Guard: never let a missing `seeked` stall the render.
+        const timer = setTimeout(finish, 2000);
+    });
+}
 function installTimeline(schema) {
     const rendererPresent = typeof window !== "undefined" && window.__mvFramesRendererPresent === true;
-    const slots = schema.instructions.flatMap((i) => {
+    // Audio tracks own no DOM element — split them out before the visual
+    // instructions hit `querySelector`. They're mixed by the worker (which
+    // reads `__mvFrames.audio`) and previewed by the Web Audio engine below.
+    const audioInstrs = schema.instructions.filter((i) => i.kind === "audio");
+    const visualInstrs = schema.instructions.filter((i) => i.kind !== "audio");
+    const slots = visualInstrs.flatMap((i) => {
         const el = document.querySelector(i.selector);
         if (!el)
             throw new Error(`defineTimeline: no element matches ${i.selector}`);
@@ -159,9 +214,64 @@ function installTimeline(schema) {
         src: s.src,
         frameset: s.frameset,
     }));
+    // Resolve audio instruction defaults once — shared by the worker-facing
+    // slot list and the browser preview engine so both see the same mix.
+    const audioResolved = audioInstrs.map((a) => {
+        const role = a.role ?? "music";
+        return {
+            src: a.src,
+            key: a.key,
+            at: a.at,
+            duration: a.duration ?? null,
+            seek: a.seek ?? 0,
+            gain: a.gain ?? 1,
+            role,
+            duck: a.duck ?? role === "music",
+            fadeIn: a.fadeIn ?? 0,
+            fadeOut: a.fadeOut ?? 0,
+            effect: a.effect,
+        };
+    });
+    // Worker-facing slots (read via CDP to build the ffmpeg mix). Drop tracks
+    // with no storage key — those are preview-only and can't be rendered.
+    const audio = audioResolved
+        .filter((a) => typeof a.key === "string" && a.key.length > 0)
+        .map(({ src: _src, ...slot }) => slot);
+    // Browser preview engine. Constructed whenever there are tracks AND we're in
+    // a real browser — INCLUDING under `__mvFramesRendererPresent` (the Studio
+    // preview iframe sets that flag so it can drive `applyState`, yet still wants
+    // audible playback). It's lazy — no AudioContext, no fetch until `playFrom`
+    // is called — so in the *headless* renderer (which only ever calls
+    // `applyState`, never `playAudio`) it stays completely inert and the real mix
+    // is done by ffmpeg. Construction is just field storage.
+    const audioEngine = typeof window !== "undefined" && typeof AudioContext !== "undefined" && audioResolved.length > 0
+        ? new AudioEngine(audioResolved.map((a) => ({
+            src: a.src,
+            at: a.at,
+            duration: a.duration,
+            seek: a.seek,
+            gain: a.gain,
+            fadeIn: a.fadeIn,
+            fadeOut: a.fadeOut,
+            role: a.role,
+            duck: a.duck,
+            effect: a.effect,
+        })))
+        : null;
     window.__mvFrames = {
         videos,
+        audio,
+        playAudio(fromMs) {
+            void audioEngine?.playFrom(fromMs);
+        },
+        stopAudio() {
+            audioEngine?.stop();
+        },
+        setAudioMuted(muted) {
+            audioEngine?.setMuted(muted);
+        },
         async applyState(t) {
+            const videoWaits = [];
             for (const s of slots) {
                 if (s.kind === "css-pending")
                     continue; // only relevant in browser preview
@@ -170,18 +280,24 @@ function installTimeline(schema) {
                     // Seek the live <video> EXCEPT on the renderer's begin-frame-control
                     // capture path (where seeking crashes the headless tab — the engine
                     // swaps in pre-extracted frame images instead, flagged via
-                    // `__mvFramesNoVideoSeek`). So the editor, live preview, AND the
-                    // renderer's screenshot path all seek normally — frame-accurate
-                    // "time travel" (StagePreview drives this via applyState).
+                    // `__mvFramesNoVideoSeek`). On every live-seek path (editor, live
+                    // preview, AND the renderer's screenshot capture) we must AWAIT the
+                    // seeked frame's decode before resolving — otherwise a capture races
+                    // an in-flight seek and grabs a stale/blank frame (and the per-frame
+                    // loop spins, hitting the render wall-clock budget). `seekVideo`
+                    // guards with a timeout so a missing `seeked` can't hang the render.
                     if (!window.__mvFramesNoVideoSeek) {
-                        s.el.currentTime = (s.seek + local) / 1000;
+                        videoWaits.push(seekVideo(s.el, (s.seek + local) / 1000));
                     }
                     continue;
                 }
                 const local = clamp(t - s.at, 0, s.duration);
                 s.anim.currentTime = local;
             }
-            await document.fonts.ready;
+            await Promise.all([
+                document.fonts ? document.fonts.ready.then(() => undefined) : Promise.resolve(),
+                ...videoWaits,
+            ]);
         },
     };
     if (!rendererPresent) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,GAGd,MAAM,cAAc,CAAC;AAkNtB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,gBAAgB,EAAE;SACf,IAAI,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;SACnC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,wEAAwE;QACxE,+DAA+D;QAC/D,uEAAuE;QACvE,yCAAyC;QACzC,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9D,MAAM,QAAQ,GACZ,QAAQ,CAAC,UAAU,KAAK,SAAS;QAC/B,CAAC,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAC5B,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAC/E;QACH,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,OAAO,QAAQ;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,sEAAsE;QACtE,qEAAqE;QACrE,qDAAqD;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,QAAQ,CAAC,gBAAgB,CAAkB,wBAAwB,CAAC,CACrE;aACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;aAC7B,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CACL,CAAC;QACJ,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,SAAS,CAAC,EAAoB,EAAE,SAAiB;IACxD,MAAM,iBAAiB,GAAG,CAAC,CAAC;IAC5B,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,YAAY,GAChB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,UAAU,IAAI,iBAAiB,CAAC;IACpF,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC;IAC3B,IAAI,YAAY;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAE3C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC3C,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,kEAAkE;YAClE,MAAM,IAAI,GACR,EAGD,CAAC,yBAAyB,CAAC;YAC5B,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,oEAAoE;gBACpE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,wDAAwD;QACxD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,MAAsB;IAC7C,MAAM,eAAe,GACnB,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,yBAAyB,KAAK,IAAI,CAAC;IAE7E,qEAAqE;IACrE,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAC5C,CAAC,CAAC,EAAmB,EAAE,CAAE,CAAuB,CAAC,IAAI,KAAK,OAAO,CAClE,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAmC,EAAE,CACpC,CAAuB,CAAC,IAAI,KAAK,OAAO,CAC5C,CAAC;IAEF,MAAM,KAAK,GAAW,YAAY,CAAC,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;QACrD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7E,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,CAAC,EAAE,YAAY,gBAAgB,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,2BAA2B,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxE,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3E,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,wEAAwE;YACxE,iEAAiE;YACjE,yEAAyE;YACzE,gDAAgD;YAChD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,EAAE,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;YAC/B,CAAC;YACD,OAAO;gBACL;oBACE,IAAI,EAAE,OAAO;oBACb,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,QAAQ;oBACR,IAAI;oBACJ,EAAE;oBACF,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,GAAG,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,GAAG;oBAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,CAAC,EAAE,YAAY,WAAW,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,yCAAyC,CAAC,CAAC;YAC1F,CAAC;YACD,mEAAmE;YACnE,0DAA0D;YAC1D,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,OAAO,CAAC;wBACN,IAAI,EAAE,aAAa;wBACnB,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,EAAE;wBACF,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;qBAC7B,CAAC,CAAC;YACL,CAAC;YACD,+DAA+D;YAC/D,mEAAmE;YACnE,kBAAkB;YAClB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3C,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,4BAA4B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,QAAQ,IAAI;oBAC1F,mFAAmF,CACtF,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACzC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC,CAAC,CAAC;YACN,oEAAoE;YACpE,iEAAiE;YACjE,2CAA2C;YAC3C,qEAAqE;YACrE,qEAAqE;YACrE,iEAAiE;YACjE,kEAAkE;YAClE,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7F,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;YACzE,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;YAChC,OAAO,QAAQ,CAAC,GAAG,CAAW,CAAC,IAAI,EAAE,EAAE;gBACrC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACxC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,MAAM,GAAoB,KAAK;SAClC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC,CAAC;IAEN,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAc,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;QAC1C,OAAO;YACL,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YACjB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YACjB,IAAI;YACJ,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,OAAO;YAChC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC;YACvB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,sEAAsE;IACtE,MAAM,KAAK,GAAoB,aAAa;SACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;SAC5D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzC,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,4EAA4E;IAC5E,mEAAmE;IACnE,8EAA8E;IAC9E,yDAAyD;IACzD,MAAM,WAAW,GACf,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,YAAY,KAAK,WAAW,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;QAC9F,CAAC,CAAC,IAAI,WAAW,CACb,aAAa,CAAC,GAAG,CAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC,CACJ;QACH,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,CAAC,UAAU,GAAG;QAClB,MAAM;QACN,KAAK;QACL,SAAS,CAAC,MAAc;YACtB,KAAK,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,SAAS;YACP,WAAW,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,aAAa,CAAC,KAAc;YAC1B,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,CAAS;YACxB,MAAM,UAAU,GAAoB,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa;oBAAE,SAAS,CAAC,mCAAmC;gBAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC7C,qEAAqE;oBACrE,oEAAoE;oBACpE,2DAA2D;oBAC3D,kEAAkE;oBAClE,oEAAoE;oBACpE,qEAAqE;oBACrE,qEAAqE;oBACrE,iEAAiE;oBACjE,qEAAqE;oBACrE,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;wBAClC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;oBAC5D,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAC7C,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC7B,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE;gBAC/E,GAAG,UAAU;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACvB,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;oBACjC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBACnB,CAAC;qBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACpC,6DAA6D;oBAC7D,iDAAiD;oBACjD,8DAA8D;oBAC9D,6DAA6D;oBAC7D,6DAA6D;oBAC7D,iBAAiB;oBACjB,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;wBACxB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;oBAC/E,CAAC;oBACD,mDAAmD;oBACnD,6DAA6D;oBAC7D,wDAAwD;oBACxD,yDAAyD;oBACzD,2DAA2D;oBAC3D,yDAAyD;oBACzD,gDAAgD;oBAChD,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;oBAClC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACX,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IAC9C,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maravilla-labs/frames",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Tiny vanilla helper for declaring Web Animations API timelines that the Maravilla runtime renderer drives frame-accurately.",
   "type": "module",
   "main": "./dist/index.js",

package/src/audio.ts

@@ -0,0 +1,313 @@
+/**
+ * Browser-side audio preview for a frames timeline.
+ *
+ * The render worker mixes audio with ffmpeg (the browser can't expose
+ * decoded audio to the capture pipeline), so this engine exists purely so
+ * the **editor / preview** plays the same mix the final video will have:
+ * multiple time-bound tracks (voiceover, background music, sfx), per-track
+ * gain + fades, and static-envelope ducking of music under voiceover (see
+ * [`ducking.ts`] — the exact curve the worker bakes in).
+ *
+ * Scrubbing (`applyState(t)`) stays silent by design — like every real NLE,
+ * audio is heard only during continuous playback. The preview host calls
+ * [`AudioEngine.playFrom`] on play and [`AudioEngine.stop`] on pause.
+ */
+
+import {
+  DEFAULT_DUCK,
+  duckAutomation,
+  mergeSegments,
+  type DuckParams,
+  type Segment,
+} from "./ducking.js";
+
+/** A timeline audio track, resolved for browser playback. Times in ms. */
+export type PreviewAudioTrack = {
+  /** Playable URL fetched + decoded for preview. */
+  src: string;
+  /** Timeline start, ms. */
+  at: number;
+  /** Play length on the timeline, ms. `null` = natural clip length. */
+  duration: number | null;
+  /** Start offset within the source, ms. */
+  seek: number;
+  /** Linear base gain (1 = unity). */
+  gain: number;
+  /** Fade-in / fade-out, ms. */
+  fadeIn: number;
+  fadeOut: number;
+  /** "voiceover" drives ducking; "music" gets ducked when `duck`. */
+  role: "voiceover" | "music" | "sfx";
+  /** Whether this (music) track dips under voiceover. */
+  duck: boolean;
+  /** Optional per-track effect (structurally matches `AudioEffect`). */
+  effect?: { kind: "radio"; drive?: number; tone?: number; depth?: number };
+};
+
+type WindowAudioContext = typeof AudioContext;
+
+function getAudioContextCtor(): WindowAudioContext | null {
+  if (typeof window === "undefined") return null;
+  return (
+    window.AudioContext ||
+    (window as unknown as { webkitAudioContext?: WindowAudioContext })
+      .webkitAudioContext ||
+    null
+  );
+}
+
+export class AudioEngine {
+  private tracks: PreviewAudioTrack[];
+  private duck: DuckParams;
+  private ctx: AudioContext | null = null;
+  private master: GainNode | null = null;
+  private buffers = new Map<string, AudioBuffer>();
+  private active: AudioBufferSourceNode[] = [];
+  private muted = false;
+
+  constructor(tracks: PreviewAudioTrack[], duck: DuckParams = DEFAULT_DUCK) {
+    this.tracks = tracks;
+    this.duck = duck;
+  }
+
+  /** Merged voiceover regions (seconds) — what music ducks under. */
+  private voiceoverSegments(): Segment[] {
+    const segs = this.tracks
+      .filter((t) => t.role === "voiceover")
+      .map((t) => ({
+        start: t.at / 1000,
+        end: (t.at + (t.duration ?? 0)) / 1000,
+      }))
+      .filter((s) => s.end > s.start);
+    return mergeSegments(segs);
+  }
+
+  /** Fetch + decode every track's source (idempotent, cached by URL). */
+  private async ensureBuffers(): Promise<void> {
+    const Ctor = getAudioContextCtor();
+    if (!Ctor) return;
+    if (!this.ctx) {
+      this.ctx = new Ctor();
+      this.master = this.ctx.createGain();
+      this.master.connect(this.ctx.destination);
+    }
+    const ctx = this.ctx;
+    await Promise.all(
+      this.tracks.map(async (t) => {
+        if (this.buffers.has(t.src)) return;
+        try {
+          const resp = await fetch(t.src);
+          const raw = await resp.arrayBuffer();
+          const buf = await ctx.decodeAudioData(raw);
+          this.buffers.set(t.src, buf);
+        } catch (err) {
+          // A bad/missing audio URL must never wedge the preview — skip it.
+          // eslint-disable-next-line no-console
+          console.warn(`[@maravilla-labs/frames] audio decode failed for ${t.src}:`, err);
+        }
+      }),
+    );
+  }
+
+  /** Start (or restart) playback from timeline position `fromMs`. */
+  async playFrom(fromMs: number): Promise<void> {
+    await this.ensureBuffers();
+    if (!this.ctx || !this.master) return;
+    this.stop();
+    // Resume may reject if there's no user activation (autoplay policy). Don't
+    // let that abort scheduling — the caller invokes this from a click handler,
+    // so activation is usually present; if not, the context stays suspended and
+    // simply produces no sound rather than throwing.
+    if (this.ctx.state === "suspended") {
+      try {
+        await this.ctx.resume();
+      } catch {
+        /* no user activation yet — stay silent, don't throw */
+      }
+    }
+
+    const ctx = this.ctx;
+    const t0 = fromMs / 1000;
+    const startCtx = ctx.currentTime + 0.05; // small lead so scheduling lands
+    const segments = this.voiceoverSegments();
+    this.master.gain.value = this.muted ? 0 : 1;
+
+    for (const track of this.tracks) {
+      const buf = this.buffers.get(track.src);
+      if (!buf) continue;
+
+      const naturalMs = buf.duration * 1000 - track.seek;
+      const durMs = track.duration ?? Math.max(0, naturalMs);
+      const trackEnd = track.at + durMs;
+      if (t0 * 1000 >= trackEnd) continue; // already past this clip
+
+      // When (timeline ms) the clip actually begins sounding from the playhead.
+      const playStart = Math.max(t0 * 1000, track.at);
+      const delaySec = (playStart - t0 * 1000) / 1000;
+      const offsetInClip = (track.seek + (playStart - track.at)) / 1000;
+      const remainingSec = (trackEnd - playStart) / 1000;
+      if (remainingSec <= 0) continue;
+
+      // Map a timeline time (seconds) to this AudioContext's clock.
+      const toCtx = (timelineSec: number) =>
+        Math.max(startCtx, startCtx + (timelineSec - t0));
+
+      const fadeGain = ctx.createGain();
+      this.applyFades(fadeGain, track, toCtx);
+
+      let tail: AudioNode = fadeGain;
+      if (track.role === "music" && track.duck && segments.length) {
+        const duckGain = ctx.createGain();
+        this.applyDuck(duckGain, track.gain, segments, toCtx);
+        fadeGain.connect(duckGain);
+        tail = duckGain;
+      }
+      tail.connect(this.master);
+
+      // Optional effect (e.g. radio voice) sits between the source and the
+      // fade/duck gains, so it shapes the dry signal exactly like the ffmpeg
+      // render does.
+      const node = ctx.createBufferSource();
+      node.buffer = buf;
+      const radio = track.effect?.kind === "radio" ? buildRadioChain(ctx, track.effect) : null;
+      if (radio) {
+        node.connect(radio.input);
+        radio.output.connect(fadeGain);
+      } else {
+        node.connect(fadeGain);
+      }
+      node.start(startCtx + delaySec, offsetInClip, remainingSec);
+      this.active.push(node);
+    }
+  }
+
+  /** Per-track base gain + fade-in/out automation on `g`. */
+  private applyFades(
+    g: GainNode,
+    track: PreviewAudioTrack,
+    toCtx: (timelineSec: number) => number,
+  ): void {
+    const base = track.role === "music" && track.duck ? 1 : track.gain;
+    const startSec = track.at / 1000;
+    const fadeInSec = track.fadeIn / 1000;
+    const fadeOutSec = track.fadeOut / 1000;
+    const durMs = track.duration ?? 0;
+    const endSec = (track.at + durMs) / 1000;
+
+    g.gain.setValueAtTime(track.fadeIn > 0 ? 0 : base, toCtx(startSec));
+    if (track.fadeIn > 0) {
+      g.gain.linearRampToValueAtTime(base, toCtx(startSec + fadeInSec));
+    }
+    if (track.fadeOut > 0 && durMs > 0) {
+      g.gain.setValueAtTime(base, toCtx(Math.max(startSec, endSec - fadeOutSec)));
+      g.gain.linearRampToValueAtTime(0, toCtx(endSec));
+    }
+  }
+
+  /** Ducking automation (scaled by the music track's base gain) on `g`. */
+  private applyDuck(
+    g: GainNode,
+    base: number,
+    segments: Segment[],
+    toCtx: (timelineSec: number) => number,
+  ): void {
+    const points = duckAutomation(segments, base, this.duck);
+    let first = true;
+    for (const [timeSec, value] of points) {
+      if (first) {
+        g.gain.setValueAtTime(value, toCtx(timeSec));
+        first = false;
+      } else {
+        g.gain.linearRampToValueAtTime(value, toCtx(timeSec));
+      }
+    }
+  }
+
+  /** Stop all currently-playing sources (idempotent). */
+  stop(): void {
+    for (const node of this.active) {
+      try {
+        node.stop();
+      } catch {
+        /* already stopped */
+      }
+    }
+    this.active = [];
+  }
+
+  setMuted(muted: boolean): void {
+    this.muted = muted;
+    if (this.master) this.master.gain.value = muted ? 0 : 1;
+  }
+}
+
+function clamp01(v: number): number {
+  return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+
+/**
+ * Resolved "radio voice" parameters. The exact same formulas are mirrored by
+ * the ffmpeg render (worker `audio_mix.rs`) so preview == export:
+ * a band-pass (high-pass + low-pass) for the radio band, a low-shelf for
+ * "depth", and a tanh waveshaper (pushed by `pre`, tamed by `post`) for drive.
+ */
+export function radioParams(effect: { drive?: number; tone?: number; depth?: number }): {
+  hp: number;
+  lp: number;
+  shelfGainDb: number;
+  pre: number;
+  post: number;
+  k: number;
+} {
+  const drive = clamp01(effect.drive ?? 0.4);
+  const tone = clamp01(effect.tone ?? 0.4);
+  const depth = clamp01(effect.depth ?? 0.5);
+  return {
+    hp: 500 - 350 * tone, // 500Hz (telephone) → 150Hz (open)
+    lp: 2400 + 2800 * tone, // 2400Hz (narrow) → 5200Hz (bright)
+    shelfGainDb: depth * 12, // up to +12 dB low-shelf
+    pre: 1 + drive * 3, // drive into the saturator
+    post: 1 / (1 + drive * 1.6), // make-up / tame
+    k: 1 + drive * 5, // tanh steepness
+  };
+}
+
+function tanhCurve(k: number) {
+  const n = 1024;
+  const curve = new Float32Array(n);
+  for (let i = 0; i < n; i++) {
+    const x = (i / (n - 1)) * 2 - 1;
+    curve[i] = Math.tanh(k * x);
+  }
+  return curve;
+}
+
+function buildRadioChain(
+  ctx: AudioContext,
+  effect: { drive?: number; tone?: number; depth?: number },
+): { input: AudioNode; output: AudioNode } {
+  const p = radioParams(effect);
+  const hp = ctx.createBiquadFilter();
+  hp.type = "highpass";
+  hp.frequency.value = p.hp;
+  const lp = ctx.createBiquadFilter();
+  lp.type = "lowpass";
+  lp.frequency.value = p.lp;
+  const shelf = ctx.createBiquadFilter();
+  shelf.type = "lowshelf";
+  shelf.frequency.value = 180;
+  shelf.gain.value = p.shelfGainDb;
+  const pre = ctx.createGain();
+  pre.gain.value = p.pre;
+  const shaper = ctx.createWaveShaper();
+  shaper.curve = tanhCurve(p.k);
+  shaper.oversample = "2x";
+  const post = ctx.createGain();
+  post.gain.value = p.post;
+  hp.connect(lp);
+  lp.connect(shelf);
+  shelf.connect(pre);
+  pre.connect(shaper);
+  shaper.connect(post);
+  return { input: hp, output: post };
+}