@smoove/core 0.1.0

package/dist/media/video/video-source-browser.js

@@ -0,0 +1,171 @@
+/**
+ * Preview-mode {@link VideoSource}: wraps an `HTMLVideoElement` and drives it in
+ * realtime. The server renderer injects a different source via
+ * `VideoConfig.sourceFactory`.
+ */
+export class BrowserVideoSource {
+    _el;
+    _ready = false;
+    _readyCbs = new Set();
+    _frameCbs = new Set();
+    _rvfcId = null;
+    _rvfcRunning = false;
+    // Seek coalescing: keep at most one seek in flight. Rapid scrubbing only ever
+    // lands the latest target — intermediate ones are dropped — so the backlog
+    // never grows (which is what makes scrubbing a large clip degrade over time).
+    _seeking = false;
+    _pending = null;
+    constructor() {
+        const el = document.createElement("video");
+        el.crossOrigin = "anonymous";
+        el.playsInline = true;
+        el.preload = "auto";
+        // Muted so the browser allows programmatic play()/seek before any user gesture.
+        el.muted = true;
+        this._el = el;
+    }
+    load(src) {
+        return new Promise((resolve, reject) => {
+            const onReady = () => {
+                cleanup();
+                this._ready = true;
+                this._startFrameLoop();
+                for (const cb of this._readyCbs)
+                    cb();
+                resolve();
+            };
+            const onErr = () => {
+                cleanup();
+                reject(new Error(`Failed to load video: ${src}`));
+            };
+            const cleanup = () => {
+                this._el.removeEventListener("loadeddata", onReady);
+                this._el.removeEventListener("error", onErr);
+            };
+            this._el.addEventListener("loadeddata", onReady);
+            this._el.addEventListener("error", onErr);
+            this._el.src = src;
+        });
+    }
+    _startFrameLoop() {
+        if (this._rvfcRunning)
+            return;
+        if (typeof this._el.requestVideoFrameCallback !== "function")
+            return;
+        this._rvfcRunning = true;
+        const tick = () => {
+            for (const cb of this._frameCbs)
+                cb();
+            this._rvfcId = this._el.requestVideoFrameCallback?.(tick) ?? null;
+        };
+        this._rvfcId = this._el.requestVideoFrameCallback(tick);
+    }
+    get element() {
+        return this._ready ? this._el : null;
+    }
+    get naturalWidth() {
+        return this._el.videoWidth;
+    }
+    get naturalHeight() {
+        return this._el.videoHeight;
+    }
+    get duration() {
+        return Number.isFinite(this._el.duration) ? this._el.duration : 0;
+    }
+    get currentTime() {
+        return this._el.currentTime;
+    }
+    get isReady() {
+        return this._ready;
+    }
+    seek(timeSeconds, mode = "precise") {
+        const clamped = Math.max(0, this.duration > 0 ? Math.min(this.duration, timeSeconds) : timeSeconds);
+        // No-op seek with nothing in flight: already there, resolve immediately.
+        if (!this._seeking && Math.abs(this._el.currentTime - clamped) <= 1e-4) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            if (this._pending) {
+                // Supersede the queued target — only the latest scrub position matters.
+                this._pending.time = clamped;
+                this._pending.mode = mode;
+                this._pending.resolvers.push(resolve);
+            }
+            else {
+                this._pending = { time: clamped, mode, resolvers: [resolve] };
+            }
+            this._drainSeek();
+        });
+    }
+    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
+    _drainSeek() {
+        if (this._seeking || !this._pending)
+            return;
+        const { time, mode, resolvers } = this._pending;
+        this._pending = null;
+        if (Math.abs(this._el.currentTime - time) <= 1e-4) {
+            for (const r of resolvers)
+                r();
+            this._drainSeek();
+            return;
+        }
+        this._seeking = true;
+        const onSeeked = () => {
+            this._el.removeEventListener("seeked", onSeeked);
+            this._seeking = false;
+            for (const r of resolvers)
+                r();
+            // A newer target may have arrived mid-seek — land it now.
+            this._drainSeek();
+        };
+        this._el.addEventListener("seeked", onSeeked);
+        // fastSeek jumps to the nearest keyframe — much snappier for scrubbing a
+        // large clip. Fall back to a precise currentTime seek when unavailable.
+        if (mode === "fast" && typeof this._el.fastSeek === "function") {
+            this._el.fastSeek(time);
+        }
+        else {
+            this._el.currentTime = time;
+        }
+    }
+    play() {
+        return this._el.play();
+    }
+    pause() {
+        this._el.pause();
+    }
+    setMuted(muted) {
+        this._el.muted = muted;
+    }
+    setVolume(volume) {
+        this._el.volume = Math.max(0, Math.min(1, volume));
+    }
+    setPlaybackRate(rate) {
+        this._el.playbackRate = rate;
+    }
+    onReady(cb) {
+        if (this._ready) {
+            cb();
+            return () => { };
+        }
+        this._readyCbs.add(cb);
+        return () => this._readyCbs.delete(cb);
+    }
+    onFrame(cb) {
+        this._frameCbs.add(cb);
+        return () => this._frameCbs.delete(cb);
+    }
+    destroy() {
+        if (this._rvfcId !== null && typeof this._el.cancelVideoFrameCallback === "function") {
+            this._el.cancelVideoFrameCallback(this._rvfcId);
+        }
+        this._el.pause();
+        this._el.removeAttribute("src");
+        this._el.load();
+        this._readyCbs.clear();
+        this._frameCbs.clear();
+        this._pending = null;
+        this._seeking = false;
+    }
+}
+//# sourceMappingURL=video-source-browser.js.map

package/dist/media/video/video-source-browser.js.map

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

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

@@ -0,0 +1,69 @@
+import { AudioBufferSink } from "mediabunny";
+import type { SchedulableAudioSource } from "../audio/audio-source-mediabunny.js";
+import type { SeekMode, VideoSource } from "./video-source.js";
+/**
+ * Preview-mode {@link VideoSource} backed by Mediabunny + WebCodecs. Replaces the
+ * `HTMLVideoElement`-based {@link BrowserVideoSource}: instead of a self-playing
+ * element corrected for drift, frames are **pulled** for the exact timestamp the
+ * frame clock asks for, so scrubbing and playback are frame-accurate.
+ *
+ * Decoding uses a forward-only {@link CanvasSink} iterator (the cheap path for
+ * playback); the iterator is torn down and reseeded only on a backward seek or a
+ * large forward jump. Each decoded frame is blitted onto a single owned canvas so
+ * {@link element} keeps a stable reference for `Konva.Image`.
+ *
+ * The same {@link Input} also exposes the file's audio track as an
+ * {@link AudioBufferSink} (so a `Video` with sound is decoded once, not twice),
+ * which is why this also satisfies {@link SchedulableAudioSource} — the Video's
+ * {@link PreviewAudioDriver} schedules it on the shared Web Audio context.
+ */
+export declare class MediabunnyVideoSource implements VideoSource, SchedulableAudioSource {
+    private readonly _canvas;
+    private readonly _ctx;
+    private _input;
+    private _sink;
+    private _audioSink;
+    private _audioFirstTs;
+    private _ready;
+    private _disposed;
+    private readonly _readyCbs;
+    private readonly _frameCbs;
+    private _w;
+    private _h;
+    private _duration;
+    private _firstTs;
+    private _iter;
+    private _next;
+    private _curTs;
+    private _seeking;
+    private _pending;
+    constructor();
+    load(src: string): Promise<void>;
+    get element(): CanvasImageSource | null;
+    get naturalWidth(): number;
+    get naturalHeight(): number;
+    get duration(): number;
+    get currentTime(): number;
+    get isReady(): boolean;
+    /** @see SchedulableAudioSource — decoded-buffer sink for the file's audio track. */
+    get sink(): AudioBufferSink | null;
+    /** @see SchedulableAudioSource — audio track start time in seconds. */
+    get firstTimestamp(): number;
+    seek(timeSeconds: number, _mode?: SeekMode): Promise<void>;
+    private _drainSeek;
+    /** Land the owned canvas on the last frame whose start timestamp is <= `t`. */
+    private _satisfy;
+    private _restartIterator;
+    private _pull;
+    /** Blit a decoded frame onto the owned canvas and notify listeners. */
+    private _draw;
+    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-mediabunny.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-source-mediabunny.d.ts","sourceRoot":"","sources":["../../../src/media/video/video-source-mediabunny.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAKhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAS/D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAsB,YAAW,WAAW,EAAE,sBAAsB;IAC/E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA2B;IAGxC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IAIrB,OAAO,CAAC,KAAK,CAA6D;IAC1E,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAA4B;IAI1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+D;;IAWzE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCtC,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,oFAAoF;IACpF,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IAED,uEAAuE;IACvE,IAAI,cAAc,IAAI,MAAM,CAE3B;IAID,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,QAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAmBvD,UAAU;IAgBxB,+EAA+E;YACjE,QAAQ;YAuBR,gBAAgB;YAShB,KAAK;IAMnB,uEAAuE;IACvE,OAAO,CAAC,KAAK;IAQb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAGrB,KAAK,IAAI,IAAI;IACb,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAChC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAEpC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IASnC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKnC,OAAO,IAAI,IAAI;CAahB"}

package/dist/media/video/video-source-mediabunny.js

@@ -0,0 +1,236 @@
+import { ALL_FORMATS, AudioBufferSink, CanvasSink, Input, UrlSource, } from "mediabunny";
+/** Reuse decoded frames within this window before issuing a seek (1/4 of a 60fps frame). */
+const SAME_FRAME_EPS = 1 / 240;
+/** Forward jumps larger than this restart the decode iterator instead of decoding through. */
+const BIGGEST_FORWARD_JUMP = 3;
+/** Canvas pool size — holds the current lookahead frame plus one in flight. */
+const POOL_SIZE = 2;
+/**
+ * Preview-mode {@link VideoSource} backed by Mediabunny + WebCodecs. Replaces the
+ * `HTMLVideoElement`-based {@link BrowserVideoSource}: instead of a self-playing
+ * element corrected for drift, frames are **pulled** for the exact timestamp the
+ * frame clock asks for, so scrubbing and playback are frame-accurate.
+ *
+ * Decoding uses a forward-only {@link CanvasSink} iterator (the cheap path for
+ * playback); the iterator is torn down and reseeded only on a backward seek or a
+ * large forward jump. Each decoded frame is blitted onto a single owned canvas so
+ * {@link element} keeps a stable reference for `Konva.Image`.
+ *
+ * The same {@link Input} also exposes the file's audio track as an
+ * {@link AudioBufferSink} (so a `Video` with sound is decoded once, not twice),
+ * which is why this also satisfies {@link SchedulableAudioSource} — the Video's
+ * {@link PreviewAudioDriver} schedules it on the shared Web Audio context.
+ */
+export class MediabunnyVideoSource {
+    _canvas;
+    _ctx;
+    _input = null;
+    _sink = null;
+    // Audio sink off the same Input — null when the file has no decodable audio.
+    _audioSink = null;
+    _audioFirstTs = 0;
+    _ready = false;
+    _disposed = false;
+    _readyCbs = new Set();
+    _frameCbs = new Set();
+    _w = 0;
+    _h = 0;
+    _duration = 0;
+    _firstTs = 0;
+    // Forward iterator + a one-frame lookahead so we can land on the last frame
+    // whose start timestamp is <= the target without trusting reported durations.
+    _iter = null;
+    _next = null;
+    _curTs = Number.NEGATIVE_INFINITY;
+    // Seek coalescing: keep at most one decode in flight; rapid scrubbing only ever
+    // lands the latest target, so the backlog never grows.
+    _seeking = false;
+    _pending = null;
+    constructor() {
+        this._canvas = document.createElement("canvas");
+        this._canvas.width = 1;
+        this._canvas.height = 1;
+        const ctx = this._canvas.getContext("2d");
+        if (!ctx)
+            throw new Error("[smoove] 2D canvas context unavailable");
+        this._ctx = ctx;
+    }
+    async load(src) {
+        const input = new Input({ formats: ALL_FORMATS, source: new UrlSource(src) });
+        this._input = input;
+        const track = await input.getPrimaryVideoTrack();
+        if (!track)
+            throw new Error(`[smoove] no video track in: ${src}`);
+        if (!(await track.canDecode())) {
+            throw new Error(`[smoove] cannot decode video track in: ${src}`);
+        }
+        if (this._disposed)
+            return;
+        this._w = await track.getDisplayWidth();
+        this._h = await track.getDisplayHeight();
+        this._duration = await track.computeDuration();
+        this._firstTs = await track.getFirstTimestamp();
+        this._canvas.width = this._w;
+        this._canvas.height = this._h;
+        this._sink = new CanvasSink(track, { poolSize: POOL_SIZE, fit: "fill" });
+        // Wire the file's audio track (if any) for the Video's audio driver. A clip
+        // with no decodable audio just stays silent — `sink` reports null.
+        const audioTrack = await input.getPrimaryAudioTrack();
+        if (audioTrack && (await audioTrack.canDecode())) {
+            this._audioFirstTs = await audioTrack.getFirstTimestamp();
+            this._audioSink = new AudioBufferSink(audioTrack);
+        }
+        // Decode the first frame so `element` has content the moment we're ready.
+        await this._satisfy(this._firstTs);
+        if (this._disposed)
+            return;
+        this._ready = true;
+        for (const cb of this._readyCbs)
+            cb();
+    }
+    get element() {
+        return this._ready ? this._canvas : null;
+    }
+    get naturalWidth() {
+        return this._w;
+    }
+    get naturalHeight() {
+        return this._h;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get currentTime() {
+        return this._curTs === Number.NEGATIVE_INFINITY ? 0 : this._curTs;
+    }
+    get isReady() {
+        return this._ready;
+    }
+    /** @see SchedulableAudioSource — decoded-buffer sink for the file's audio track. */
+    get sink() {
+        return this._audioSink;
+    }
+    /** @see SchedulableAudioSource — audio track start time in seconds. */
+    get firstTimestamp() {
+        return this._audioFirstTs;
+    }
+    // mode is ignored: Mediabunny seeks are always frame-accurate and fast enough
+    // that scrubbing doesn't need an approximate keyframe-only path.
+    seek(timeSeconds, _mode = "precise") {
+        const clamped = Math.max(this._firstTs, this._duration > 0 ? Math.min(this._duration, timeSeconds) : timeSeconds);
+        if (!this._seeking && Math.abs(this._curTs - clamped) <= SAME_FRAME_EPS) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            if (this._pending) {
+                this._pending.time = clamped; // supersede — only the latest target matters
+                this._pending.resolvers.push(resolve);
+            }
+            else {
+                this._pending = { time: clamped, resolvers: [resolve] };
+            }
+            void this._drainSeek();
+        });
+    }
+    async _drainSeek() {
+        if (this._seeking || !this._pending)
+            return;
+        this._seeking = true;
+        while (this._pending) {
+            const { time, resolvers } = this._pending;
+            this._pending = null;
+            try {
+                await this._satisfy(time);
+            }
+            catch (err) {
+                if (!this._disposed)
+                    console.error("[smoove] video seek failed:", err);
+            }
+            for (const r of resolvers)
+                r();
+        }
+        this._seeking = false;
+    }
+    /** Land the owned canvas on the last frame whose start timestamp is <= `t`. */
+    async _satisfy(t) {
+        if (!this._sink)
+            return;
+        // Backward seek or a large forward jump: the forward iterator can't help —
+        // start a fresh one seeded at the target.
+        if (t < this._curTs - SAME_FRAME_EPS || t > this._curTs + BIGGEST_FORWARD_JUMP) {
+            await this._restartIterator(t);
+        }
+        else if (!this._iter) {
+            await this._restartIterator(t);
+        }
+        // Advance while the lookahead frame still starts at or before the target.
+        while (true) {
+            if (!this._next)
+                this._next = await this._pull();
+            if (this._next && this._next.timestamp <= t + SAME_FRAME_EPS) {
+                this._draw(this._next);
+                this._next = null;
+            }
+            else {
+                break;
+            }
+        }
+    }
+    async _restartIterator(t) {
+        await this._iter?.return();
+        this._iter = this._sink?.canvases(Math.max(0, t)) ?? null;
+        this._next = null;
+        this._curTs = Number.NEGATIVE_INFINITY;
+        const first = await this._pull();
+        if (first)
+            this._draw(first);
+    }
+    async _pull() {
+        if (!this._iter)
+            return null;
+        const r = await this._iter.next();
+        return r.done ? null : r.value;
+    }
+    /** Blit a decoded frame onto the owned canvas and notify listeners. */
+    _draw(frame) {
+        this._curTs = frame.timestamp;
+        this._ctx.clearRect(0, 0, this._w, this._h);
+        this._ctx.drawImage(frame.canvas, 0, 0, this._w, this._h);
+        for (const cb of this._frameCbs)
+            cb();
+    }
+    // Pull-based: nothing self-plays. The frame clock drives `seek()` each tick.
+    play() {
+        return Promise.resolve();
+    }
+    pause() { }
+    setMuted(_muted) { }
+    setVolume(_volume) { }
+    setPlaybackRate(_rate) { }
+    onReady(cb) {
+        if (this._ready) {
+            cb();
+            return () => { };
+        }
+        this._readyCbs.add(cb);
+        return () => this._readyCbs.delete(cb);
+    }
+    onFrame(cb) {
+        this._frameCbs.add(cb);
+        return () => this._frameCbs.delete(cb);
+    }
+    destroy() {
+        this._disposed = true;
+        void this._iter?.return();
+        this._iter = null;
+        this._next = null;
+        this._input?.dispose();
+        this._input = null;
+        this._sink = null;
+        this._audioSink = null;
+        this._readyCbs.clear();
+        this._frameCbs.clear();
+        this._pending = null;
+    }
+}
+//# sourceMappingURL=video-source-mediabunny.js.map

package/dist/media/video/video-source-mediabunny.js.map

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

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

@@ -0,0 +1,48 @@
+import type { Environment } from "../../engine/environment.js";
+/** Seek precision: exact frame ("precise", default) vs. snappy nearest-keyframe ("fast", for scrubbing). */
+export type SeekMode = "precise" | "fast";
+/**
+ * Runtime-agnostic video source — the dependency-injection seam between the
+ * engine and the actual media decoder. The browser implementation
+ * ({@link BrowserVideoSource}) wraps an `HTMLVideoElement`; a server renderer
+ * (e.g. Bun + Skia Canvas) injects its own decoder-backed source that produces
+ * drawable frames on demand.
+ */
+export interface VideoSource {
+    load(src: string): Promise<void>;
+    /** Drawable surface for `Konva.Image`, or null until ready. */
+    readonly element: CanvasImageSource | null;
+    readonly naturalWidth: number;
+    readonly naturalHeight: number;
+    /** Duration in seconds, or 0 if unknown. */
+    readonly duration: number;
+    /** Current media playback position in seconds. */
+    readonly currentTime: number;
+    readonly isReady: boolean;
+    /**
+     * Seek to a time in seconds. Resolves once the frame at that time has been
+     * decoded and is ready to draw — rendering `await`s this to gate frame
+     * capture; preview fires it and forgets.
+     *
+     * `mode: "fast"` requests an approximate, snappy seek (nearest keyframe) for
+     * scrubbing; the default `"precise"` lands on the exact frame.
+     */
+    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
+    play(): Promise<void>;
+    pause(): void;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    setPlaybackRate(rate: number): void;
+    /** Fires once when metadata + first frame are available. */
+    onReady(cb: () => void): () => void;
+    /** Fires whenever a new frame has been decoded and is ready to draw. */
+    onFrame(cb: () => void): () => void;
+    destroy(): void;
+}
+/**
+ * Factory for a {@link VideoSource}. Receives the resolved {@link Environment}
+ * so a single factory can pick an implementation (e.g. browser vs. decoder)
+ * based on whether we are rendering or previewing.
+ */
+export type VideoSourceFactory = (env: Environment) => VideoSource;
+//# sourceMappingURL=video-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-source.d.ts","sourceRoot":"","sources":["../../../src/media/video/video-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,4GAA4G;AAC5G,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,CAAC"}

package/dist/media/video/video-source.js

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

package/dist/media/video/video-source.js.map

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

package/dist/media-marker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Marker attrs stamped on media nodes ({@link Video}, {@link Audio}) and
+ * inspected by `Sequence`/`Composition`. Kept in a dependency-free leaf so
+ * `composition.ts` can discover media by string without importing `video/` or
+ * `audio/` (which would create an import cycle).
+ */
+/** Set by every tickable media node — drives Sequence discovery + mixer registration. */
+export declare const MEDIA_MARK = "__kmIsMedia";
+/** Additionally set by {@link Video} — backs `isVideoNode`. */
+export declare const VIDEO_MARK = "__kmIsVideo";
+/** Additionally set by {@link Audio} — backs `isAudioNode`. */
+export declare const AUDIO_MARK = "__kmIsAudio";
+/**
+ * Set by non-media nodes that still want a per-frame `_kmTick` callback (e.g.
+ * {@link Text}'s typewriter). Discovered by `Sequence` alongside media, but
+ * NOT registered with the audio mixer.
+ */
+export declare const TICK_MARK = "__kmIsTick";
+//# sourceMappingURL=media-marker.d.ts.map

package/dist/media-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-marker.d.ts","sourceRoot":"","sources":["../src/media-marker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yFAAyF;AACzF,eAAO,MAAM,UAAU,gBAAgB,CAAC;AACxC,+DAA+D;AAC/D,eAAO,MAAM,UAAU,gBAAgB,CAAC;AACxC,+DAA+D;AAC/D,eAAO,MAAM,UAAU,gBAAgB,CAAC;AACxC;;;;GAIG;AACH,eAAO,MAAM,SAAS,eAAe,CAAC"}

package/dist/media-marker.js

@@ -0,0 +1,19 @@
+/**
+ * Marker attrs stamped on media nodes ({@link Video}, {@link Audio}) and
+ * inspected by `Sequence`/`Composition`. Kept in a dependency-free leaf so
+ * `composition.ts` can discover media by string without importing `video/` or
+ * `audio/` (which would create an import cycle).
+ */
+/** Set by every tickable media node — drives Sequence discovery + mixer registration. */
+export const MEDIA_MARK = "__kmIsMedia";
+/** Additionally set by {@link Video} — backs `isVideoNode`. */
+export const VIDEO_MARK = "__kmIsVideo";
+/** Additionally set by {@link Audio} — backs `isAudioNode`. */
+export const AUDIO_MARK = "__kmIsAudio";
+/**
+ * Set by non-media nodes that still want a per-frame `_kmTick` callback (e.g.
+ * {@link Text}'s typewriter). Discovered by `Sequence` alongside media, but
+ * NOT registered with the audio mixer.
+ */
+export const TICK_MARK = "__kmIsTick";
+//# sourceMappingURL=media-marker.js.map

package/dist/media-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-marker.js","sourceRoot":"","sources":["../src/media-marker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AACxC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AACxC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AACxC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC"}

package/dist/media-time.d.ts

@@ -0,0 +1,17 @@
+/** Resolved per-clip timing, derived from a media config + composition fps. */
+export type MediaTiming = {
+    fps: number;
+    /** Frames trimmed from the start of the media. */
+    trimBefore: number;
+    /** Exclusive frame bound, or undefined to play to the media's natural end. */
+    trimAfter?: number;
+    loop: boolean;
+    playbackRate: number;
+};
+/**
+ * Convert a local frame to a media time in seconds — Remotion's `getMediaTime`,
+ * extended with `loop` wrap-around. Without `loop`, the media freezes on its
+ * last in-range frame (Remotion's default behavior). Shared by video and audio.
+ */
+export declare function getMediaTime(localFrame: number, timing: MediaTiming): number;
+//# sourceMappingURL=media-time.d.ts.map

package/dist/media-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-time.d.ts","sourceRoot":"","sources":["../src/media-time.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAU5E"}

package/dist/media-time.js

@@ -0,0 +1,17 @@
+/**
+ * Convert a local frame to a media time in seconds — Remotion's `getMediaTime`,
+ * extended with `loop` wrap-around. Without `loop`, the media freezes on its
+ * last in-range frame (Remotion's default behavior). Shared by video and audio.
+ */
+export function getMediaTime(localFrame, timing) {
+    const { fps, trimBefore, trimAfter, loop, playbackRate } = timing;
+    const advanced = localFrame * playbackRate;
+    if (trimAfter === undefined) {
+        // No explicit end bound: play forward; loop has no length to wrap to.
+        return (trimBefore + advanced) / fps;
+    }
+    const loopLen = Math.max(1, trimAfter - trimBefore);
+    const eff = loop ? ((advanced % loopLen) + loopLen) % loopLen : Math.min(advanced, loopLen - 1);
+    return (trimBefore + eff) / fps;
+}
+//# sourceMappingURL=media-time.js.map