@smoove/core 0.1.0

package/dist/media/video/index.js

@@ -0,0 +1,372 @@
+import Konva from "konva";
+import { getComposition } from "../../engine/composition.js";
+import { detectEnvironment, getEnvironment } from "../../engine/environment.js";
+import { getDefaultVideoSourceFactory } from "../../engine/runtime-defaults.js";
+import { createSignal } from "../../engine/signal.js";
+import { applySize, parseSize } from "../../layout/flex/engine.js";
+import { PreviewAudioDriver } from "../audio/audio-for-preview.js";
+import { RenderingAudioDriver } from "../audio/audio-for-rendering.js";
+import { isSchedulable } from "../audio/audio-source-mediabunny.js";
+import { MEDIA_MARK, VIDEO_MARK } from "../media-marker.js";
+import { PreviewVideoDriver } from "./video-for-preview.js";
+import { RenderingVideoDriver } from "./video-for-rendering.js";
+const VIDEO_KEYS = [
+    "src",
+    "trimBefore",
+    "trimAfter",
+    "startFrom",
+    "endAt",
+    "loop",
+    "muted",
+    "volume",
+    "playbackRate",
+    "objectFit",
+    "objectPosition",
+    "flexGrow",
+    "flexShrink",
+    "flexBasis",
+    "alignSelf",
+    "margin",
+    "sourceFactory",
+];
+function pickKonvaConfig(config) {
+    const out = { ...config };
+    for (const k of VIDEO_KEYS)
+        delete out[k];
+    const w = parseSize(config.width);
+    const h = parseSize(config.height);
+    out.width = w?.kind === "px" ? w.value : undefined;
+    out.height = h?.kind === "px" ? h.value : undefined;
+    out.cornerRadius = undefined;
+    return out;
+}
+/**
+ * Timeline-driven video. API mirrors {@link Image} (`new Video({src, ...ImageProps})`)
+ * but the frame source is a runtime-agnostic {@link VideoSource} and playback is
+ * driven by the composition's frame clock. Picks a {@link RenderingVideoDriver}
+ * or {@link PreviewVideoDriver} based on the composition's {@link Environment}.
+ */
+export class Video extends Konva.Group {
+    _kmRole = "leaf";
+    /** Human label for mixer UIs — `config.name`, falling back to `config.src`. */
+    label;
+    /** Intrinsic audio level, 0..1 — scaled by the composition mixer's master. */
+    volume;
+    muted;
+    _img;
+    // Reassigned on suspend/resume, so not readonly; `!` = set via _acquireSource().
+    _source;
+    _env;
+    _factory;
+    _suspended = false;
+    _trimBefore;
+    _trimAfter;
+    _loop;
+    _playbackRate;
+    _volume;
+    _muted;
+    _mixer = null;
+    _driver = null;
+    _audioDriver = null;
+    _src;
+    constructor(config) {
+        super(pickKonvaConfig(config));
+        this.setAttr(MEDIA_MARK, true);
+        this.setAttr(VIDEO_MARK, true);
+        this._src = config.src;
+        this._trimBefore = config.trimBefore ?? config.startFrom ?? 0;
+        this._trimAfter = config.trimAfter ?? config.endAt;
+        this._loop = config.loop ?? false;
+        this._playbackRate = config.playbackRate ?? 1;
+        this.label = config.name ?? config.src;
+        this._volume = createSignal(config.volume ?? 1);
+        this._muted = createSignal(config.muted ?? false);
+        this.volume = this._volume;
+        this.muted = this._muted;
+        this._img = new Konva.Image({ image: undefined, listening: false });
+        super.add(this._img);
+        this.setAttrs({
+            flexGrow: config.flexGrow,
+            flexShrink: config.flexShrink,
+            flexBasis: config.flexBasis,
+            alignSelf: config.alignSelf,
+            margin: config.margin,
+            objectFit: config.objectFit ?? "cover",
+            objectPosition: config.objectPosition ?? "center",
+            cornerRadius: config.cornerRadius,
+            flexWidth: config.width,
+            flexHeight: config.height,
+        });
+        if (config.cornerRadius !== undefined) {
+            const cr = normalizeCorners(config.cornerRadius);
+            this.clipFunc((ctx) => roundRectPath(ctx, 0, 0, this.width(), this.height(), cr));
+        }
+        this.on("widthChange heightChange", () => this._layoutImage());
+        // Build the source eagerly so loading starts immediately. The driver (which
+        // needs the attached stage's composition) is resolved lazily on first tick.
+        this._env = detectEnvironment();
+        this._factory = config.sourceFactory ?? getDefaultVideoSourceFactory();
+        this._acquireSource();
+        this._layoutImage();
+    }
+    /**
+     * Create the media source and start loading it. Called once at construction
+     * and again by {@link _kmResume} after {@link _kmSuspend} dropped it.
+     */
+    _acquireSource() {
+        this._source = this._factory(this._env);
+        this._applyAudio(); // honor config/mixer volume+muted before playback
+        this._source.setPlaybackRate(this._playbackRate);
+        this._source.onReady(() => {
+            const el = this._source.element;
+            if (el)
+                this._img.image(el);
+            this._layoutImage();
+            this.getLayer()?.batchDraw();
+        });
+        this._source.onFrame(() => {
+            this.getLayer()?.batchDraw();
+        });
+        this._source.load(this._src).catch((err) => {
+            console.error("[smoove] Video load failed:", err);
+        });
+    }
+    /** @internal — {@link Composition.suspend}: drop the source to stop downloading/decoding. */
+    _kmSuspend() {
+        if (this._suspended)
+            return;
+        this._suspended = true;
+        this._driver?.dispose();
+        this._driver = null;
+        this._audioDriver?.dispose();
+        this._audioDriver = null;
+        this._source.destroy();
+        this._img.image(undefined);
+        this.getLayer()?.batchDraw();
+    }
+    /** @internal — {@link Composition.resume}: re-acquire the dropped source. */
+    _kmResume() {
+        if (!this._suspended)
+            return;
+        this._suspended = false;
+        this._acquireSource();
+    }
+    /** @internal — called by Sequence on each tick while this video is on-stage. */
+    _kmTick(localFrame) {
+        const driver = this._ensureDriver();
+        driver?.tick(localFrame);
+        this._audioDriver?.tick(localFrame);
+    }
+    /** @internal — called by Sequence when it goes out of range. */
+    _kmDeactivate() {
+        this._driver?.deactivate();
+        this._audioDriver?.deactivate();
+    }
+    /** @internal — {@link KMLayoutNode}: size from explicit width/height (cover/contain handle the rest). */
+    _kmMeasure(node) {
+        applySize(node, this.attrs.flexWidth, this.attrs.flexHeight);
+    }
+    /** @internal — {@link KMLayoutNode}: write the computed box back + re-fit the frame. */
+    _kmPlace(box) {
+        this.x(box.left);
+        this.y(box.top);
+        this.width(box.width);
+        this.height(box.height);
+        this._layoutImage();
+    }
+    _ensureDriver() {
+        if (this._driver)
+            return this._driver;
+        const stage = this.getStage();
+        if (!stage)
+            return null;
+        const comp = getComposition(stage);
+        if (!comp)
+            return null;
+        // Lazy fallback for videos added after their sequence was registered.
+        comp.mixer.register(this);
+        const timing = {
+            fps: comp.fps,
+            trimBefore: this._trimBefore,
+            trimAfter: this._trimAfter,
+            loop: this._loop,
+            playbackRate: this._playbackRate,
+        };
+        const ctx = {
+            source: this._source,
+            timing,
+            comp,
+            redraw: () => {
+                this._layoutImage();
+                this.getLayer()?.batchDraw();
+            },
+        };
+        if (getEnvironment(stage).isRendering) {
+            this._driver = new RenderingVideoDriver(ctx);
+            // Record the file's soundtrack as audio assets so the server mux can decode
+            // and mix it (videos with no audio track simply yield no audible PCM).
+            const audioCtx = {
+                source: this._source,
+                timing,
+                comp,
+                id: this.id() || `video-${this._id}`,
+                src: this._src,
+                effectiveVolume: () => {
+                    const m = this._mixer;
+                    return (m ? m.volume.get() : 1) * this._volume.get();
+                },
+                effectiveMuted: () => {
+                    const m = this._mixer;
+                    return (m ? m.muted.get() : false) || this._muted.get();
+                },
+            };
+            this._audioDriver = new RenderingAudioDriver(audioCtx);
+        }
+        else {
+            this._driver = new PreviewVideoDriver(ctx);
+            // In preview, schedule the file's own soundtrack through the shared Web
+            // Audio context — same scheduler the standalone Audio node uses. (The
+            // rendering branch above records it as audio assets for the server mux.)
+            if (isSchedulable(this._source)) {
+                const audioCtx = {
+                    source: this._source,
+                    timing,
+                    comp,
+                    id: this.id() || `video-${this._id}`,
+                    src: this._src,
+                    effectiveVolume: () => {
+                        const m = this._mixer;
+                        return (m ? m.volume.get() : 1) * this._volume.get();
+                    },
+                    effectiveMuted: () => {
+                        const m = this._mixer;
+                        return (m ? m.muted.get() : false) || this._muted.get();
+                    },
+                };
+                this._audioDriver = new PreviewAudioDriver(audioCtx);
+            }
+        }
+        return this._driver;
+    }
+    setMuted(muted) {
+        this._muted.set(muted);
+        this._applyAudio();
+    }
+    setVolume(volume) {
+        this._volume.set(Math.max(0, Math.min(1, volume)));
+        this._applyAudio();
+    }
+    /** @internal — {@link AudioMixer} hands us the bus (or null on unregister). */
+    _bindMixer(mixer) {
+        this._mixer = mixer;
+        this._applyAudio();
+    }
+    /** @internal — push effective level (master × intrinsic) to the source. */
+    _applyAudio() {
+        const m = this._mixer;
+        const master = m ? m.volume.get() : 1;
+        const masterMuted = m ? m.muted.get() : false;
+        this._source.setVolume(master * this._volume.get());
+        this._source.setMuted(masterMuted || this._muted.get());
+    }
+    setPlaybackRate(rate) {
+        this._source.setPlaybackRate(rate);
+    }
+    destroy() {
+        this._mixer?.unregister(this);
+        this._mixer = null;
+        this._driver?.dispose();
+        this._driver = null;
+        this._audioDriver?.dispose();
+        this._audioDriver = null;
+        this._source.destroy();
+        return super.destroy();
+    }
+    /** @internal */
+    _layoutImage() {
+        const w = this.width();
+        const h = this.height();
+        if (w <= 0 || h <= 0)
+            return;
+        const fit = (this.attrs.objectFit ?? "cover");
+        const pos = (this.attrs.objectPosition ?? "center");
+        const nw = this._source.naturalWidth;
+        const nh = this._source.naturalHeight;
+        if (!this._source.isReady || nw === 0 || nh === 0)
+            return;
+        if (fit === "fill") {
+            this._img.position({ x: 0, y: 0 });
+            this._img.size({ width: w, height: h });
+            this._img.crop({ x: 0, y: 0, width: nw, height: nh });
+            return;
+        }
+        if (fit === "none") {
+            const { x, y } = positionOffset(pos, w - nw, h - nh);
+            this._img.position({ x, y });
+            this._img.size({ width: nw, height: nh });
+            this._img.crop({ x: 0, y: 0, width: nw, height: nh });
+            return;
+        }
+        if (fit === "contain") {
+            const scale = Math.min(w / nw, h / nh);
+            const dw = nw * scale;
+            const dh = nh * scale;
+            const { x, y } = positionOffset(pos, w - dw, h - dh);
+            this._img.position({ x, y });
+            this._img.size({ width: dw, height: dh });
+            this._img.crop({ x: 0, y: 0, width: nw, height: nh });
+            return;
+        }
+        const scale = Math.max(w / nw, h / nh);
+        const cropW = w / scale;
+        const cropH = h / scale;
+        const { x: cx, y: cy } = positionOffset(pos, nw - cropW, nh - cropH);
+        this._img.position({ x: 0, y: 0 });
+        this._img.size({ width: w, height: h });
+        this._img.crop({ x: cx, y: cy, width: cropW, height: cropH });
+    }
+}
+export function isVideoNode(node) {
+    return node.getAttr(VIDEO_MARK) === true;
+}
+function positionOffset(pos, freeX, freeY) {
+    let fx = 0.5;
+    let fy = 0.5;
+    if (pos.includes("left"))
+        fx = 0;
+    else if (pos.includes("right"))
+        fx = 1;
+    if (pos.includes("top"))
+        fy = 0;
+    else if (pos.includes("bottom"))
+        fy = 1;
+    if (pos === "center") {
+        fx = 0.5;
+        fy = 0.5;
+    }
+    return { x: freeX * fx, y: freeY * fy };
+}
+function normalizeCorners(c) {
+    if (typeof c === "number")
+        return [c, c, c, c];
+    if (c.length === 1)
+        return [c[0] ?? 0, c[0] ?? 0, c[0] ?? 0, c[0] ?? 0];
+    if (c.length === 2)
+        return [c[0] ?? 0, c[1] ?? 0, c[0] ?? 0, c[1] ?? 0];
+    return [c[0] ?? 0, c[1] ?? 0, c[2] ?? 0, c[3] ?? 0];
+}
+function roundRectPath(ctx, x, y, w, h, r) {
+    const [tl, tr, br, bl] = r;
+    ctx.beginPath();
+    ctx.moveTo(x + (tl ?? 0), y);
+    ctx.lineTo(x + w - (tr ?? 0), y);
+    ctx.quadraticCurveTo(x + w, y, x + w, y + (tr ?? 0));
+    ctx.lineTo(x + w, y + h - (br ?? 0));
+    ctx.quadraticCurveTo(x + w, y + h, x + w - (br ?? 0), y + h);
+    ctx.lineTo(x + (bl ?? 0), y + h);
+    ctx.quadraticCurveTo(x, y + h, x, y + h - (bl ?? 0));
+    ctx.lineTo(x, y + (tl ?? 0));
+    ctx.quadraticCurveTo(x, y, x + (tl ?? 0), y);
+    ctx.closePath();
+}
+//# sourceMappingURL=index.js.map

package/dist/media/video/index.js.map

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

package/dist/media/video/types.d.ts

@@ -0,0 +1,36 @@
+import type Konva from "konva";
+import type { FlexChildProps, SizeValue } from "../../layout/flex/types.js";
+import type { ObjectFit, ObjectPosition } from "../../layout/image.js";
+import type { VideoSourceFactory } from "./video-source.js";
+/**
+ * Config for {@link Video}. Mirrors {@link ImageConfig} plus Remotion's
+ * `<Video>` playback props (`trimBefore`/`trimAfter`/`loop`/`muted`/`volume`/
+ * `playbackRate`) and a `sourceFactory` dependency-injection seam.
+ */
+export type VideoConfig = Omit<Konva.GroupConfig, "width" | "height"> & FlexChildProps & {
+    width?: SizeValue;
+    height?: SizeValue;
+    src: string;
+    /** Human label for the audio mixer channel / UIs. Defaults to {@link src}. */
+    name?: string;
+    objectFit?: ObjectFit;
+    objectPosition?: ObjectPosition;
+    cornerRadius?: number | number[];
+    /** Frames trimmed from the start of the media (composition fps). Remotion v4 name. */
+    trimBefore?: number;
+    /** Exclusive frame bound — media past this offset is trimmed (composition fps). */
+    trimAfter?: number;
+    /** @deprecated alias of {@link trimBefore} (Remotion's pre-v4.0.319 name). */
+    startFrom?: number;
+    /** @deprecated alias of {@link trimAfter} (Remotion's pre-v4.0.319 name). */
+    endAt?: number;
+    /** Repeat the trimmed clip within its sequence window instead of freezing on the last frame. */
+    loop?: boolean;
+    muted?: boolean;
+    /** 0..1 */
+    volume?: number;
+    playbackRate?: number;
+    /** Inject an alternative VideoSource. Defaults to BrowserVideoSource. */
+    sourceFactory?: VideoSourceFactory;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/media/video/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/media/video/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC,GACnE,cAAc,GAAG;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC,CAAC"}

package/dist/media/video/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/media/video/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/media/video/types.ts"],"names":[],"mappings":""}

package/dist/media/video/video-for-preview.d.ts

@@ -0,0 +1,17 @@
+import { type VideoDriver, type VideoDriverContext } from "./driver.js";
+/**
+ * Realtime preview driver for a **pull-based** {@link VideoSource} (Mediabunny +
+ * WebCodecs). Unlike the old `HTMLVideoElement` model — where the element played
+ * on its own and we only corrected drift — nothing self-plays here: every tick we
+ * seek the source to the exact media time for the current frame and redraw. The
+ * frame clock is the single source of truth, so playback and scrubbing are
+ * identical code paths and both land on the exact frame.
+ */
+export declare class PreviewVideoDriver implements VideoDriver {
+    private readonly ctx;
+    constructor(ctx: VideoDriverContext);
+    tick(localFrame: number): void;
+    deactivate(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=video-for-preview.d.ts.map

package/dist/media/video/video-for-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-for-preview.d.ts","sourceRoot":"","sources":["../../../src/media/video/video-for-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,kBAAkB;IAEpD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAW9B,UAAU,IAAI,IAAI;IAIlB,OAAO,IAAI,IAAI;CAChB"}

package/dist/media/video/video-for-preview.js

@@ -0,0 +1,30 @@
+import { getMediaTime } from "./driver.js";
+/**
+ * Realtime preview driver for a **pull-based** {@link VideoSource} (Mediabunny +
+ * WebCodecs). Unlike the old `HTMLVideoElement` model — where the element played
+ * on its own and we only corrected drift — nothing self-plays here: every tick we
+ * seek the source to the exact media time for the current frame and redraw. The
+ * frame clock is the single source of truth, so playback and scrubbing are
+ * identical code paths and both land on the exact frame.
+ */
+export class PreviewVideoDriver {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    tick(localFrame) {
+        const { source } = this.ctx;
+        if (!source.isReady) {
+            this.ctx.redraw();
+            return;
+        }
+        const expected = getMediaTime(localFrame, this.ctx.timing);
+        void source.seek(expected).then(() => this.ctx.redraw());
+        this.ctx.redraw();
+    }
+    deactivate() {
+        this.ctx.source.pause();
+    }
+    dispose() { }
+}
+//# sourceMappingURL=video-for-preview.js.map

package/dist/media/video/video-for-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-for-preview.js","sourceRoot":"","sources":["../../../src/media/video/video-for-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAC;AAEtF;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAExD,IAAI,CAAC,UAAkB;QACrB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,KAAU,CAAC;CACnB"}

package/dist/media/video/video-for-rendering.d.ts

@@ -0,0 +1,17 @@
+import { type VideoDriver, type VideoDriverContext } from "./driver.js";
+/**
+ * Deterministic, gated frame production — Remotion's `VideoForRendering`. Never
+ * plays in realtime: each tick seeks the source to the exact media time and
+ * holds a `delayRender` handle so `Composition.renderFrame()` waits for the
+ * decoded frame before the canvas is captured.
+ */
+export declare class RenderingVideoDriver implements VideoDriver {
+    private readonly ctx;
+    private _lastMediaTime;
+    constructor(ctx: VideoDriverContext);
+    tick(localFrame: number): void;
+    private _waitReady;
+    deactivate(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=video-for-rendering.d.ts.map

package/dist/media/video/video-for-rendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-for-rendering.d.ts","sourceRoot":"","sources":["../../../src/media/video/video-for-rendering.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAG1C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,cAAc,CAAc;gBAEP,GAAG,EAAE,kBAAkB;IAEpD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA4B9B,OAAO,CAAC,UAAU;IAclB,UAAU,IAAI,IAAI;IAIlB,OAAO,IAAI,IAAI;CAChB"}

package/dist/media/video/video-for-rendering.js

@@ -0,0 +1,59 @@
+import { getMediaTime } from "./driver.js";
+/**
+ * Deterministic, gated frame production — Remotion's `VideoForRendering`. Never
+ * plays in realtime: each tick seeks the source to the exact media time and
+ * holds a `delayRender` handle so `Composition.renderFrame()` waits for the
+ * decoded frame before the canvas is captured.
+ */
+export class RenderingVideoDriver {
+    ctx;
+    _lastMediaTime = Number.NaN;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    tick(localFrame) {
+        const { source, comp } = this.ctx;
+        const mediaTime = getMediaTime(localFrame, this.ctx.timing);
+        // Already decoded this exact frame and the source is live — just redraw.
+        if (source.isReady && mediaTime === this._lastMediaTime) {
+            this.ctx.redraw();
+            return;
+        }
+        this._lastMediaTime = mediaTime;
+        // Gate the frame: wait for the source to become decodable (the async
+        // `load()` fired in the constructor may still be in flight), then seek to
+        // the exact media time. Holding the handle across both steps is what keeps
+        // `renderFrame()` from capturing a blank frame before the video is ready.
+        const handle = comp.delayRender(`seek video -> ${mediaTime.toFixed(4)}s`);
+        this._waitReady()
+            .then(() => source.seek(mediaTime))
+            .then(() => {
+            this.ctx.redraw();
+        })
+            .catch((err) => {
+            console.error("[smoove] video seek failed during render:", err);
+        })
+            .finally(() => {
+            comp.continueRender(handle);
+        });
+    }
+    _waitReady() {
+        const { source } = this.ctx;
+        // Short-circuit when already ready: registering `onReady` here would invoke
+        // the callback synchronously (sources fire immediately when ready), and the
+        // callback references `off` before its `const` is initialized (TDZ).
+        if (source.isReady)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const off = source.onReady(() => {
+                off();
+                resolve();
+            });
+        });
+    }
+    deactivate() {
+        this._lastMediaTime = Number.NaN;
+    }
+    dispose() { }
+}
+//# sourceMappingURL=video-for-rendering.js.map

package/dist/media/video/video-for-rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-for-rendering.js","sourceRoot":"","sources":["../../../src/media/video/video-for-rendering.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6C,MAAM,aAAa,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAGF;IAFrB,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;IAEpC,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAExD,IAAI,CAAC,UAAkB;QACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,yEAAyE;QACzE,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,qEAAqE;QACrE,0EAA0E;QAC1E,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aAClC,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,UAAU;QAChB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAC5B,4EAA4E;QAC5E,4EAA4E;QAC5E,qEAAqE;QACrE,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC9B,GAAG,EAAE,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;IACnC,CAAC;IAED,OAAO,KAAU,CAAC;CACnB"}

package/dist/media/video/video-source-browser.d.ts

@@ -0,0 +1,37 @@
+import type { SeekMode, VideoSource } from "./video-source.js";
+/**
+ * Preview-mode {@link VideoSource}: wraps an `HTMLVideoElement` and drives it in
+ * realtime. The server renderer injects a different source via
+ * `VideoConfig.sourceFactory`.
+ */
+export declare class BrowserVideoSource implements VideoSource {
+    private readonly _el;
+    private _ready;
+    private readonly _readyCbs;
+    private readonly _frameCbs;
+    private _rvfcId;
+    private _rvfcRunning;
+    private _seeking;
+    private _pending;
+    constructor();
+    load(src: string): Promise<void>;
+    private _startFrameLoop;
+    get element(): CanvasImageSource | null;
+    get naturalWidth(): number;
+    get naturalHeight(): number;
+    get duration(): number;
+    get currentTime(): number;
+    get isReady(): boolean;
+    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
+    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
+    private _drainSeek;
+    play(): Promise<void>;
+    pause(): void;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    setPlaybackRate(rate: number): void;
+    onReady(cb: () => void): () => void;
+    onFrame(cb: () => void): () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=video-source-browser.d.ts.map

package/dist/media/video/video-source-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-source-browser.d.ts","sourceRoot":"","sources":["../../../src/media/video/video-source-browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQ/D;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAAS;IAK7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+E;;IAY/F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhC,OAAO,CAAC,eAAe;IAWvB,IAAI,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAEtC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,QAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpE,kGAAkG;IAClG,OAAO,CAAC,UAAU;IA6BlB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IASnC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKnC,OAAO,IAAI,IAAI;CAYhB"}