@maravilla-labs/frames 0.3.3 → 0.5.0

package/README.md

@@ -115,15 +115,25 @@ a WAAPI `Animation` object via `Element.getAnimations()`, and drives
 its `currentTime` exactly like every other slot. The visual is the
 class's native CSS animation; the timing is yours to control.
 
-The stylesheet that defines the keyframes must be loaded before
-`defineTimeline` runs. The simplest pattern is to `await` the page
-`load` event first inside a `<script type="module">`:
+The stylesheet that defines the keyframes must be loaded before the
+animations are materialised — but **you don't need to do anything for
+that**. `defineTimeline` waits internally for render-blocking
+stylesheets and fonts to be ready before it reads the keyframes, so you
+can just call it as soon as your module runs:
 
 ```ts
-await new Promise(r => addEventListener("load", r, { once: true }));
 defineTimeline({ /* ... */ });
 ```
 
+> **Do not** gate `defineTimeline` behind the window `load` event
+> (`await new Promise(r => addEventListener("load", r))`). `load` is also
+> held open by `<video preload>` and `<img>`, which on a media-heavy page
+> can take long enough to blow past the Maravilla renderer's readiness
+> budget and fail the render with "timeline never became available."
+> `defineTimeline` already waits for exactly what it needs (stylesheets +
+> fonts) and nothing it doesn't (media). If you need that signal yourself,
+> import `stylesheetsReady()`.
+
 This works for any library that exposes its motion as CSS classes
 plus shipped `@keyframes` — Animate.css, Magic, your own custom
 keyframes — not just Animate.css specifically.

package/dist/index.d.ts

@@ -30,6 +30,15 @@ export type VideoInstr = {
     seek?: number;
     /** CSS selector for the `<video>` element. */
     selector: string;
+    /**
+     * Storage key of a pre-extracted frame-set manifest for this clip (the
+     * `output_key` returned by `platform.env.TRANSFORMS.extractFrames`). When
+     * present, the headless renderer swaps the live `<video>` for the matching
+     * frame image per captured frame (required under begin-frame-control, which
+     * can't seek a live video). Optional — without it the renderer falls back to
+     * extracting frames at render time, and the screenshot path seeks live video.
+     */
+    frameset?: string;
 };
 /**
  * Drive a CSS-class-triggered animation (Animate.css, Magic, your own
@@ -59,13 +68,61 @@ export type TimelineSchema = {
     duration: number;
     instructions: Instr[];
 };
+/** 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
+ * seeked under begin-frame-control (which crashes headless Chromium). */
+export type VideoSlotInfo = {
+    /** CSS selector for the `<video>`. */
+    selector: string;
+    /** Timeline start, ms. */
+    at: number;
+    /** How long the clip plays on the timeline, ms. */
+    duration: number;
+    /** Start offset within the clip, ms. */
+    seek: number;
+    /** Resolved clip URL (`currentSrc` || `src`). */
+    src: string;
+    /** Pre-extracted frame-set manifest storage key, if the app provided one. */
+    frameset?: string;
+};
 declare global {
     interface Window {
         __mvFrames: {
             applyState(t: number): Promise<void>;
+            /** Video slots in this timeline — read by the renderer engine to
+             * swap video frames out-of-band. Empty when no video. */
+            videos: VideoSlotInfo[];
         };
+        /** Set true by the headless renderer when it captures (`__mvFramesRendererPresent`). */
         __mvFramesRendererPresent?: boolean;
+        /** Set true by the renderer ONLY on the begin-frame-control capture path,
+         * where the live `<video>` must not be seeked (the engine swaps in
+         * pre-extracted frame images instead). When unset — the screenshot capture
+         * path and the live editor/preview — `applyState` seeks the live video. */
+        __mvFramesNoVideoSeek?: boolean;
     }
 }
+/**
+ * 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
+ * (so CSS keyframes, e.g. Animate.css, are present before animations are
+ * materialised) and only then registers `window.__mvFrames`.
+ *
+ * It deliberately does **NOT** wait for the window `load` event or for media
+ * (`<video preload>`, `<img>`). Those can take a long time — long enough to
+ * blow past the Maravilla renderer's readiness budget — and aren't needed to
+ * build the timeline. **Do not** gate this behind
+ * `window.addEventListener('load', …)`; that was an old recommendation and is
+ * the classic cause of "renderer timed out waiting for the timeline" on pages
+ * with video. `defineTimeline` now owns that readiness so every app gets it
+ * right by default.
+ */
 export declare function defineTimeline(schema: TimelineSchema): void;
+/**
+ * Resolve once the document's render-blocking stylesheets are applied and web
+ * fonts are ready — **without** waiting on the window `load` event or media.
+ * Exposed for advanced callers; [`defineTimeline`] already awaits it.
+ */
+export declare function stylesheetsReady(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

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;CAClB,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,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE;YAAE,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE,CAAC;QACrD,yBAAyB,CAAC,EAAE,OAAO,CAAC;KACrC;CACF;AAaD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAsI3D"}
+{"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"}

package/dist/index.js

@@ -7,7 +7,60 @@
  * - Inside the Maravilla renderer, the timeline is stepped frame by
  *   frame to produce deterministic video output.
  */
+/**
+ * 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
+ * (so CSS keyframes, e.g. Animate.css, are present before animations are
+ * materialised) and only then registers `window.__mvFrames`.
+ *
+ * It deliberately does **NOT** wait for the window `load` event or for media
+ * (`<video preload>`, `<img>`). Those can take a long time — long enough to
+ * blow past the Maravilla renderer's readiness budget — and aren't needed to
+ * build the timeline. **Do not** gate this behind
+ * `window.addEventListener('load', …)`; that was an old recommendation and is
+ * the classic cause of "renderer timed out waiting for the timeline" on pages
+ * with video. `defineTimeline` now owns that readiness so every app gets it
+ * right by default.
+ */
 export function defineTimeline(schema) {
+    stylesheetsReady()
+        .then(() => installTimeline(schema))
+        .catch((err) => {
+        // Surface in the page console (the renderer captures console output) so
+        // a bad selector / missing keyframes is debuggable. On failure
+        // `__mvFrames` simply never registers and the renderer reports a clean
+        // readiness timeout rather than hanging.
+        // eslint-disable-next-line no-console
+        console.error("[@maravilla-labs/frames] defineTimeline failed:", err);
+    });
+}
+/**
+ * Resolve once the document's render-blocking stylesheets are applied and web
+ * fonts are ready — **without** waiting on the window `load` event or media.
+ * Exposed for advanced callers; [`defineTimeline`] already awaits it.
+ */
+export function stylesheetsReady() {
+    if (typeof document === "undefined")
+        return Promise.resolve();
+    const domReady = document.readyState === "loading"
+        ? new Promise((resolve) => document.addEventListener("DOMContentLoaded", () => resolve(), { once: true }))
+        : Promise.resolve();
+    return domReady
+        .then(() => {
+        // A <link rel="stylesheet"> has a null `.sheet` until it has loaded +
+        // parsed. Wait for any still-pending ones; `error` resolves too so a
+        // missing/broken stylesheet can't hang the timeline.
+        const pending = Array.from(document.querySelectorAll('link[rel="stylesheet"]'))
+            .filter((link) => !link.sheet)
+            .map((link) => new Promise((resolve) => {
+            link.addEventListener("load", () => resolve(), { once: true });
+            link.addEventListener("error", () => resolve(), { once: true });
+        }));
+        return Promise.all(pending);
+    })
+        .then(() => (document.fonts ? document.fonts.ready.then(() => undefined) : undefined));
+}
+function installTimeline(schema) {
     const rendererPresent = typeof window !== "undefined" && window.__mvFramesRendererPresent === true;
     const slots = schema.instructions.flatMap((i) => {
         const el = document.querySelector(i.selector);
@@ -21,8 +74,25 @@ export function defineTimeline(schema) {
             const naturalMs = isFinite(el.duration) ? el.duration * 1000 : Infinity;
             const duration = i.duration ?? Math.min(naturalMs, schema.duration - i.at);
             el.pause();
-            el.currentTime = seek / 1000;
-            return [{ kind: "video", at: i.at, duration, seek, el }];
+            // In renderer mode the engine drives video by swapping in pre-extracted
+            // frame images; we must NOT seek the live <video> (seeking under
+            // begin-frame-control crashes headless Chromium). In browser preview the
+            // setTimeout scheduler below plays it normally.
+            if (!rendererPresent) {
+                el.currentTime = seek / 1000;
+            }
+            return [
+                {
+                    kind: "video",
+                    at: i.at,
+                    duration,
+                    seek,
+                    el,
+                    selector: i.selector,
+                    src: el.currentSrc || el.src,
+                    frameset: i.frameset,
+                },
+            ];
         }
         if (i.kind === "css") {
             if (!(el instanceof HTMLElement)) {
@@ -78,30 +148,40 @@ export function defineTimeline(schema) {
         anim.pause();
         return [{ kind: "animation", at: i.at, duration, anim }];
     });
+    // Metadata for the renderer engine: which `<video>`s to pre-extract + swap.
+    const videos = slots
+        .filter((s) => s.kind === "video")
+        .map((s) => ({
+        selector: s.selector,
+        at: s.at,
+        duration: s.duration,
+        seek: s.seek,
+        src: s.src,
+        frameset: s.frameset,
+    }));
     window.__mvFrames = {
+        videos,
         async applyState(t) {
-            const videoWaits = [];
             for (const s of slots) {
                 if (s.kind === "css-pending")
                     continue; // only relevant in browser preview
-                const local = clamp(t - s.at, 0, s.duration);
                 if (s.kind === "video") {
-                    s.el.pause();
-                    const target = (s.seek + local) / 1000;
-                    // Seeking is async: the decoded frame for `target` is NOT ready the
-                    // instant we assign `currentTime`. The renderer captures each frame
-                    // with a synchronous CDP `beginFrame` right after `applyState`
-                    // resolves, so we MUST wait for the seek to land and the frame to
-                    // decode — otherwise we capture a stale/blank frame, or (under
-                    // deterministic `--enable-begin-frame-control`) race the media
-                    // pipeline and wedge/crash the headless tab.
-                    videoWaits.push(seekVideo(s.el, target));
-                }
-                else {
-                    s.anim.currentTime = local;
+                    const local = clamp(t - s.at, 0, s.duration);
+                    // 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).
+                    if (!window.__mvFramesNoVideoSeek) {
+                        s.el.currentTime = (s.seek + local) / 1000;
+                    }
+                    continue;
                 }
+                const local = clamp(t - s.at, 0, s.duration);
+                s.anim.currentTime = local;
             }
-            await Promise.all([document.fonts.ready, ...videoWaits]);
+            await document.fonts.ready;
         },
     };
     if (!rendererPresent) {
@@ -141,51 +221,4 @@ export function defineTimeline(schema) {
 function clamp(v, lo, hi) {
     return v < lo ? lo : v > hi ? hi : v;
 }
-/**
- * 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);
-    });
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyEH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,eAAe,GACnB,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,yBAAyB,KAAK,IAAI,CAAC;IAE7E,MAAM,KAAK,GAAW,MAAM,CAAC,YAAY,CAAC,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;QAC5D,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,EAAE,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;YAC7B,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,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,MAAM,CAAC,UAAU,GAAG;QAClB,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,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACvB,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBACb,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;oBACvC,oEAAoE;oBACpE,oEAAoE;oBACpE,+DAA+D;oBAC/D,kEAAkE;oBAClE,+DAA+D;oBAC/D,+DAA+D;oBAC/D,6CAA6C;oBAC7C,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC3C,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC7B,CAAC;YACH,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;QAC3D,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;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,GAAI,EAEZ,CAAC,yBAAyB,CAAC;YAC7B,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maravilla-labs/frames",
-  "version": "0.3.3",
+  "version": "0.5.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/index.ts

@@ -32,6 +32,15 @@ export type VideoInstr = {
   seek?: number;
   /** CSS selector for the `<video>` element. */
   selector: string;
+  /**
+   * Storage key of a pre-extracted frame-set manifest for this clip (the
+   * `output_key` returned by `platform.env.TRANSFORMS.extractFrames`). When
+   * present, the headless renderer swaps the live `<video>` for the matching
+   * frame image per captured frame (required under begin-frame-control, which
+   * can't seek a live video). Optional — without it the renderer falls back to
+   * extracting frames at render time, and the screenshot path seeks live video.
+   */
+  frameset?: string;
 };
 
 /**
@@ -61,15 +70,54 @@ export type CssClassInstr = {
 export type Instr = AnimationInstr | VideoInstr | CssClassInstr;
 export type TimelineSchema = { duration: number; instructions: Instr[] };
 
+/** 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
+ * seeked under begin-frame-control (which crashes headless Chromium). */
+export type VideoSlotInfo = {
+  /** CSS selector for the `<video>`. */
+  selector: string;
+  /** Timeline start, ms. */
+  at: number;
+  /** How long the clip plays on the timeline, ms. */
+  duration: number;
+  /** Start offset within the clip, ms. */
+  seek: number;
+  /** Resolved clip URL (`currentSrc` || `src`). */
+  src: string;
+  /** Pre-extracted frame-set manifest storage key, if the app provided one. */
+  frameset?: string;
+};
+
 declare global {
   interface Window {
-    __mvFrames: { applyState(t: number): Promise<void> };
+    __mvFrames: {
+      applyState(t: number): Promise<void>;
+      /** Video slots in this timeline — read by the renderer engine to
+       * swap video frames out-of-band. Empty when no video. */
+      videos: VideoSlotInfo[];
+    };
+    /** Set true by the headless renderer when it captures (`__mvFramesRendererPresent`). */
     __mvFramesRendererPresent?: boolean;
+    /** Set true by the renderer ONLY on the begin-frame-control capture path,
+     * where the live `<video>` must not be seeked (the engine swaps in
+     * pre-extracted frame images instead). When unset — the screenshot capture
+     * path and the live editor/preview — `applyState` seeks the live video. */
+    __mvFramesNoVideoSeek?: boolean;
   }
 }
 
 type AnimSlot = { kind: "animation"; at: number; duration: number; anim: Animation };
-type VideoSlot = { kind: "video"; at: number; duration: number; seek: number; el: HTMLVideoElement };
+type VideoSlot = {
+  kind: "video";
+  at: number;
+  duration: number;
+  seek: number;
+  el: HTMLVideoElement;
+  selector: string;
+  src: string;
+  frameset?: string;
+};
 type CssPendingSlot = {
   kind: "css-pending";
   at: number;
@@ -79,7 +127,69 @@ type CssPendingSlot = {
 };
 type Slot = AnimSlot | VideoSlot | CssPendingSlot;
 
+/**
+ * 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
+ * (so CSS keyframes, e.g. Animate.css, are present before animations are
+ * materialised) and only then registers `window.__mvFrames`.
+ *
+ * It deliberately does **NOT** wait for the window `load` event or for media
+ * (`<video preload>`, `<img>`). Those can take a long time — long enough to
+ * blow past the Maravilla renderer's readiness budget — and aren't needed to
+ * build the timeline. **Do not** gate this behind
+ * `window.addEventListener('load', …)`; that was an old recommendation and is
+ * the classic cause of "renderer timed out waiting for the timeline" on pages
+ * with video. `defineTimeline` now owns that readiness so every app gets it
+ * right by default.
+ */
 export function defineTimeline(schema: TimelineSchema): void {
+  stylesheetsReady()
+    .then(() => installTimeline(schema))
+    .catch((err) => {
+      // Surface in the page console (the renderer captures console output) so
+      // a bad selector / missing keyframes is debuggable. On failure
+      // `__mvFrames` simply never registers and the renderer reports a clean
+      // readiness timeout rather than hanging.
+      // eslint-disable-next-line no-console
+      console.error("[@maravilla-labs/frames] defineTimeline failed:", err);
+    });
+}
+
+/**
+ * Resolve once the document's render-blocking stylesheets are applied and web
+ * fonts are ready — **without** waiting on the window `load` event or media.
+ * Exposed for advanced callers; [`defineTimeline`] already awaits it.
+ */
+export function stylesheetsReady(): Promise<void> {
+  if (typeof document === "undefined") return Promise.resolve();
+  const domReady =
+    document.readyState === "loading"
+      ? new Promise<void>((resolve) =>
+          document.addEventListener("DOMContentLoaded", () => resolve(), { once: true }),
+        )
+      : Promise.resolve();
+  return domReady
+    .then(() => {
+      // A <link rel="stylesheet"> has a null `.sheet` until it has loaded +
+      // parsed. Wait for any still-pending ones; `error` resolves too so a
+      // missing/broken stylesheet can't hang the timeline.
+      const pending = Array.from(
+        document.querySelectorAll<HTMLLinkElement>('link[rel="stylesheet"]'),
+      )
+        .filter((link) => !link.sheet)
+        .map(
+          (link) =>
+            new Promise<void>((resolve) => {
+              link.addEventListener("load", () => resolve(), { once: true });
+              link.addEventListener("error", () => resolve(), { once: true });
+            }),
+        );
+      return Promise.all(pending);
+    })
+    .then(() => (document.fonts ? document.fonts.ready.then(() => undefined) : undefined));
+}
+
+function installTimeline(schema: TimelineSchema): void {
   const rendererPresent =
     typeof window !== "undefined" && window.__mvFramesRendererPresent === true;
 
@@ -95,8 +205,25 @@ export function defineTimeline(schema: TimelineSchema): void {
       const naturalMs = isFinite(el.duration) ? el.duration * 1000 : Infinity;
       const duration = i.duration ?? Math.min(naturalMs, schema.duration - i.at);
       el.pause();
-      el.currentTime = seek / 1000;
-      return [{ kind: "video", at: i.at, duration, seek, el }];
+      // In renderer mode the engine drives video by swapping in pre-extracted
+      // frame images; we must NOT seek the live <video> (seeking under
+      // begin-frame-control crashes headless Chromium). In browser preview the
+      // setTimeout scheduler below plays it normally.
+      if (!rendererPresent) {
+        el.currentTime = seek / 1000;
+      }
+      return [
+        {
+          kind: "video",
+          at: i.at,
+          duration,
+          seek,
+          el,
+          selector: i.selector,
+          src: el.currentSrc || el.src,
+          frameset: i.frameset,
+        },
+      ];
     }
 
     if (i.kind === "css") {
@@ -157,28 +284,40 @@ export function defineTimeline(schema: TimelineSchema): void {
     return [{ kind: "animation", at: i.at, duration, anim }];
   });
 
+  // Metadata for the renderer engine: which `<video>`s to pre-extract + swap.
+  const videos: VideoSlotInfo[] = slots
+    .filter((s): s is VideoSlot => s.kind === "video")
+    .map((s) => ({
+      selector: s.selector,
+      at: s.at,
+      duration: s.duration,
+      seek: s.seek,
+      src: s.src,
+      frameset: s.frameset,
+    }));
+
   window.__mvFrames = {
+    videos,
     async applyState(t: number) {
-      const videoWaits: Promise<void>[] = [];
       for (const s of slots) {
         if (s.kind === "css-pending") continue; // only relevant in browser preview
-        const local = clamp(t - s.at, 0, s.duration);
         if (s.kind === "video") {
-          s.el.pause();
-          const target = (s.seek + local) / 1000;
-          // Seeking is async: the decoded frame for `target` is NOT ready the
-          // instant we assign `currentTime`. The renderer captures each frame
-          // with a synchronous CDP `beginFrame` right after `applyState`
-          // resolves, so we MUST wait for the seek to land and the frame to
-          // decode — otherwise we capture a stale/blank frame, or (under
-          // deterministic `--enable-begin-frame-control`) race the media
-          // pipeline and wedge/crash the headless tab.
-          videoWaits.push(seekVideo(s.el, target));
-        } else {
-          s.anim.currentTime = local;
+          const local = clamp(t - s.at, 0, s.duration);
+          // 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).
+          if (!window.__mvFramesNoVideoSeek) {
+            s.el.currentTime = (s.seek + local) / 1000;
+          }
+          continue;
         }
+        const local = clamp(t - s.at, 0, s.duration);
+        s.anim.currentTime = local;
       }
-      await Promise.all([document.fonts.ready, ...videoWaits]);
+      await document.fonts.ready;
     },
   };
 
@@ -218,52 +357,3 @@ export function defineTimeline(schema: TimelineSchema): void {
 function clamp(v: number, lo: number, hi: number): number {
   return v < lo ? lo : v > hi ? hi : v;
 }
-
-/**
- * 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: HTMLVideoElement, targetSec: number): Promise<void> {
-  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<void>((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 as unknown as {
-        requestVideoFrameCallback?: (cb: () => void) => number;
-      }).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);
-  });
-}