@smoove/core 0.1.0

package/dist/media/audio/mixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixer.d.ts","sourceRoot":"","sources":["../../../src/media/audio/mixer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,wEAAwE;IACxE,WAAW,IAAI,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;;IASrD,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAK1B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAMhC,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAKlC,oEAAoE;IACpE,IAAI,QAAQ,IAAI,YAAY,EAAE,CAE7B;IAED,OAAO,CAAC,WAAW;CAGpB"}

package/dist/media/audio/mixer.js

@@ -0,0 +1,51 @@
+import { createSignal } from "../../engine/signal.js";
+/**
+ * Composition-level audio bus. Holds a master volume + mute that multiply into
+ * every registered {@link AudioChannel}: a channel's effective output is
+ * `master × channel.volume`, muted when `masterMuted || channel.muted`. The
+ * mixer never touches a source directly — on any change it asks each channel to
+ * re-apply its own audio.
+ */
+export class AudioMixer {
+    /** Master level, 0..1. */
+    volume;
+    muted;
+    _volume;
+    _muted;
+    _channels = new Set();
+    constructor() {
+        this._volume = createSignal(1);
+        this._muted = createSignal(false);
+        this.volume = this._volume;
+        this.muted = this._muted;
+    }
+    setVolume(v) {
+        this._volume.set(Math.max(0, Math.min(1, v)));
+        this._reapplyAll();
+    }
+    setMuted(m) {
+        this._muted.set(m);
+        this._reapplyAll();
+    }
+    /** Register a channel. Idempotent — the Set dedupes by instance. */
+    register(ch) {
+        if (this._channels.has(ch))
+            return;
+        this._channels.add(ch);
+        ch._bindMixer(this);
+    }
+    unregister(ch) {
+        if (!this._channels.delete(ch))
+            return;
+        ch._bindMixer(null);
+    }
+    /** Snapshot of registered channels — for building per-track UIs. */
+    get channels() {
+        return [...this._channels];
+    }
+    _reapplyAll() {
+        for (const c of this._channels)
+            c._applyAudio();
+    }
+}
+//# sourceMappingURL=mixer.js.map

package/dist/media/audio/mixer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixer.js","sourceRoot":"","sources":["../../../src/media/audio/mixer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoC,MAAM,wBAAwB,CAAC;AAoBxF;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACrB,0BAA0B;IACjB,MAAM,CAAyB;IAC/B,KAAK,CAA0B;IAEvB,OAAO,CAAiB;IACxB,MAAM,CAAkB;IACxB,SAAS,GAAG,IAAI,GAAG,EAAgB,CAAC;IAErD;QACE,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,CAAS;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,CAAU;QACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,EAAgB;QACvB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,EAAgB;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO;QACvC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,oEAAoE;IACpE,IAAI,QAAQ;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAEO,WAAW;QACjB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,CAAC;CACF"}

package/dist/media/audio/shared-audio-context.d.ts

@@ -0,0 +1,30 @@
+import type { Composition } from "../../engine/composition.js";
+/**
+ * Browser-only Web Audio bus, one per {@link Composition}. Owns the single
+ * {@link AudioContext} every preview audio clip schedules against, plus a master
+ * {@link GainNode} feeding the speakers. Created lazily on first use (so nothing
+ * touches `AudioContext` in Node) and cached per composition.
+ *
+ * It deliberately knows nothing about clips or timing — the per-clip
+ * {@link PreviewAudioDriver} owns the schedule-ahead pump and the timeline↔context
+ * clock anchor. This just hands out a context, a channel gain, and `resume()`.
+ */
+export declare class SharedAudioContext {
+    private _ctx;
+    private _master;
+    /** The live context, created on first access. Null only if Web Audio is absent. */
+    get context(): AudioContext | null;
+    /** Current context clock in seconds, or 0 if Web Audio is absent. */
+    now(): number;
+    /**
+     * Resume the context — `AudioContext` starts suspended until a user gesture.
+     * Safe to call repeatedly; resolves once running (or immediately if no context).
+     */
+    resume(): Promise<void>;
+    /** A fresh per-clip {@link GainNode} wired into the master bus. */
+    createChannelGain(): GainNode | null;
+    destroy(): void;
+}
+/** Lazily get (and cache) the {@link SharedAudioContext} for a composition. */
+export declare function getSharedAudioContext(comp: Composition): SharedAudioContext;
+//# sourceMappingURL=shared-audio-context.d.ts.map

package/dist/media/audio/shared-audio-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-audio-context.d.ts","sourceRoot":"","sources":["../../../src/media/audio/shared-audio-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,OAAO,CAAyB;IAExC,mFAAmF;IACnF,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAYjC;IAED,qEAAqE;IACrE,GAAG,IAAI,MAAM;IAIb;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B,mEAAmE;IACnE,iBAAiB,IAAI,QAAQ,GAAG,IAAI;IAQpC,OAAO,IAAI,IAAI;CAKhB;AAID,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAO3E"}

package/dist/media/audio/shared-audio-context.js

@@ -0,0 +1,68 @@
+/**
+ * Browser-only Web Audio bus, one per {@link Composition}. Owns the single
+ * {@link AudioContext} every preview audio clip schedules against, plus a master
+ * {@link GainNode} feeding the speakers. Created lazily on first use (so nothing
+ * touches `AudioContext` in Node) and cached per composition.
+ *
+ * It deliberately knows nothing about clips or timing — the per-clip
+ * {@link PreviewAudioDriver} owns the schedule-ahead pump and the timeline↔context
+ * clock anchor. This just hands out a context, a channel gain, and `resume()`.
+ */
+export class SharedAudioContext {
+    _ctx = null;
+    _master = null;
+    /** The live context, created on first access. Null only if Web Audio is absent. */
+    get context() {
+        if (this._ctx)
+            return this._ctx;
+        const Ctor = typeof globalThis.AudioContext === "function"
+            ? globalThis.AudioContext
+            : globalThis
+                .webkitAudioContext;
+        if (!Ctor)
+            return null;
+        this._ctx = new Ctor();
+        this._master = this._ctx.createGain();
+        this._master.connect(this._ctx.destination);
+        return this._ctx;
+    }
+    /** Current context clock in seconds, or 0 if Web Audio is absent. */
+    now() {
+        return this.context?.currentTime ?? 0;
+    }
+    /**
+     * Resume the context — `AudioContext` starts suspended until a user gesture.
+     * Safe to call repeatedly; resolves once running (or immediately if no context).
+     */
+    async resume() {
+        const ctx = this.context;
+        if (ctx && ctx.state === "suspended") {
+            await ctx.resume().catch(() => { });
+        }
+    }
+    /** A fresh per-clip {@link GainNode} wired into the master bus. */
+    createChannelGain() {
+        const ctx = this.context;
+        if (!ctx || !this._master)
+            return null;
+        const gain = ctx.createGain();
+        gain.connect(this._master);
+        return gain;
+    }
+    destroy() {
+        void this._ctx?.close().catch(() => { });
+        this._ctx = null;
+        this._master = null;
+    }
+}
+const perComposition = new WeakMap();
+/** Lazily get (and cache) the {@link SharedAudioContext} for a composition. */
+export function getSharedAudioContext(comp) {
+    let shared = perComposition.get(comp);
+    if (!shared) {
+        shared = new SharedAudioContext();
+        perComposition.set(comp, shared);
+    }
+    return shared;
+}
+//# sourceMappingURL=shared-audio-context.js.map

package/dist/media/audio/shared-audio-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-audio-context.js","sourceRoot":"","sources":["../../../src/media/audio/shared-audio-context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACrB,IAAI,GAAwB,IAAI,CAAC;IACjC,OAAO,GAAoB,IAAI,CAAC;IAExC,mFAAmF;IACnF,IAAI,OAAO;QACT,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QAChC,MAAM,IAAI,GACR,OAAO,UAAU,CAAC,YAAY,KAAK,UAAU;YAC3C,CAAC,CAAC,UAAU,CAAC,YAAY;YACzB,CAAC,CAAE,UAAsE;iBACpE,kBAAkB,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,qEAAqE;IACrE,GAAG;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,iBAAiB;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF;AAED,MAAM,cAAc,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEtE,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,IAAI,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAClC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { AudioSourceFactory } from "./audio-source.js";
+/**
+ * Config for {@link Audio}. Mirrors Remotion's `<Audio>` playback props
+ * (`trimBefore`/`trimAfter`/`loop`/`muted`/`volume`/`playbackRate`) plus a
+ * `sourceFactory` dependency-injection seam. Unlike {@link VideoConfig} there
+ * are no visual/layout props — audio produces no pixels.
+ */
+export type AudioConfig = {
+    src: string;
+    /** Stable id used for the Konva node and rendered {@link AudioAsset}s. */
+    id?: string;
+    /** Human label for the audio mixer channel / UIs. Defaults to {@link src}. */
+    name?: string;
+    /** 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 AudioSource. Defaults to BrowserAudioSource. */
+    sourceFactory?: AudioSourceFactory;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/media/audio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,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/audio/types.js

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

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * 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";
+/**
+ * Set by {@link Font} nodes. Walked by `Composition.add` so a scene-declared
+ * font is loaded (and buffered on) before playback. Kept here, like the other
+ * markers, so `composition.ts` discovers fonts by string without importing
+ * `layout/text/` (avoiding an import cycle).
+ */
+export declare const FONT_MARK = "__kmIsFont";
+//# sourceMappingURL=media-marker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-marker.d.ts","sourceRoot":"","sources":["../../src/media/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;AACtC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,eAAe,CAAC"}

package/dist/media/media-marker.js

@@ -0,0 +1,26 @@
+/**
+ * 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";
+/**
+ * Set by {@link Font} nodes. Walked by `Composition.add` so a scene-declared
+ * font is loaded (and buffered on) before playback. Kept here, like the other
+ * markers, so `composition.ts` discovers fonts by string without importing
+ * `layout/text/` (avoiding an import cycle).
+ */
+export const FONT_MARK = "__kmIsFont";
+//# sourceMappingURL=media-marker.js.map

package/dist/media/media-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-marker.js","sourceRoot":"","sources":["../../src/media/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;AACtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC"}

package/dist/media/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/media-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-time.d.ts","sourceRoot":"","sources":["../../src/media/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/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

package/dist/media/media-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-time.js","sourceRoot":"","sources":["../../src/media/media-time.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,MAAmB;IAClE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAClE,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,sEAAsE;QACtE,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAChG,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { Composition } from "../../engine/composition.js";
+import type { MediaTiming } from "../media-time.js";
+import { getMediaTime } from "../media-time.js";
+import type { VideoSource } from "./video-source.js";
+/** Resolved per-video timing — alias of the shared {@link MediaTiming}. */
+export type VideoTiming = MediaTiming;
+export { getMediaTime };
+/**
+ * What a driver needs from the host {@link Video}: the media source, the
+ * resolved timing, the owning composition (for the render gate + play state),
+ * and a redraw hook (relayout + batchDraw).
+ */
+export type VideoDriverContext = {
+    readonly source: VideoSource;
+    readonly timing: VideoTiming;
+    readonly comp: Composition;
+    redraw(): void;
+};
+/**
+ * Strategy that maps the composition's current frame onto the media. Mirrors
+ * Remotion's split between `VideoForRendering` and `VideoForPreview`.
+ */
+export interface VideoDriver {
+    /** Called by Sequence each tick while the video is on-stage (`localFrame` = frame - sequence.from). */
+    tick(localFrame: number): void;
+    /** Called by Sequence when the video leaves range. */
+    deactivate(): void;
+    /** Release any subscriptions; called on `Video.destroy()`. */
+    dispose(): void;
+}
+//# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/media/video/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uGAAuG;IACvG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sDAAsD;IACtD,UAAU,IAAI,IAAI,CAAC;IACnB,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/media/video/driver.js

@@ -0,0 +1,3 @@
+import { getMediaTime } from "../media-time.js";
+export { getMediaTime };
+//# sourceMappingURL=driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/media/video/driver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMhD,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,66 @@
+import Konva from "konva";
+import { type ReadonlySignal } from "../../engine/signal.js";
+import type { KMLayoutNode, LayoutBox } from "../../layout/contract.js";
+import { type FlexilyNode } from "../../layout/flex/engine.js";
+import type { AudioChannel, AudioMixer } from "../audio/mixer.js";
+import type { VideoConfig } from "./types.js";
+/**
+ * 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 declare class Video extends Konva.Group implements AudioChannel, KMLayoutNode {
+    readonly _kmRole: "leaf";
+    /** Human label for mixer UIs — `config.name`, falling back to `config.src`. */
+    readonly label: string;
+    /** Intrinsic audio level, 0..1 — scaled by the composition mixer's master. */
+    readonly volume: ReadonlySignal<number>;
+    readonly muted: ReadonlySignal<boolean>;
+    private readonly _img;
+    private _source;
+    private readonly _env;
+    private readonly _factory;
+    private _suspended;
+    private readonly _trimBefore;
+    private readonly _trimAfter?;
+    private readonly _loop;
+    private readonly _playbackRate;
+    private readonly _volume;
+    private readonly _muted;
+    private _mixer;
+    private _driver;
+    private _audioDriver;
+    private readonly _src;
+    constructor(config: VideoConfig);
+    /**
+     * Create the media source and start loading it. Called once at construction
+     * and again by {@link _kmResume} after {@link _kmSuspend} dropped it.
+     */
+    private _acquireSource;
+    /** @internal — {@link Composition.suspend}: drop the source to stop downloading/decoding. */
+    _kmSuspend(): void;
+    /** @internal — {@link Composition.resume}: re-acquire the dropped source. */
+    _kmResume(): void;
+    /** @internal — called by Sequence on each tick while this video is on-stage. */
+    _kmTick(localFrame: number): void;
+    /** @internal — called by Sequence when it goes out of range. */
+    _kmDeactivate(): void;
+    /** @internal — {@link KMLayoutNode}: size from explicit width/height (cover/contain handle the rest). */
+    _kmMeasure(node: FlexilyNode): void;
+    /** @internal — {@link KMLayoutNode}: write the computed box back + re-fit the frame. */
+    _kmPlace(box: LayoutBox): void;
+    private _ensureDriver;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    /** @internal — {@link AudioMixer} hands us the bus (or null on unregister). */
+    _bindMixer(mixer: AudioMixer | null): void;
+    /** @internal — push effective level (master × intrinsic) to the source. */
+    _applyAudio(): void;
+    setPlaybackRate(rate: number): void;
+    destroy(): this;
+    /** @internal */
+    _layoutImage(): void;
+}
+export declare function isVideoNode(node: Konva.Node): node is Video;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAgB,KAAK,cAAc,EAAe,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAa,KAAK,WAAW,EAAa,MAAM,6BAA6B,CAAC;AAOrF,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoC9C;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,KAAK,CAAC,KAAM,YAAW,YAAY,EAAE,YAAY;IAC1E,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAU;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IAEnC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,MAAM,EAAE,WAAW;IAiD/B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkBtB,6FAA6F;IAC7F,UAAU,IAAI,IAAI;IAYlB,6EAA6E;IAC7E,SAAS,IAAI,IAAI;IAMjB,gFAAgF;IAChF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMjC,gEAAgE;IAChE,aAAa,IAAI,IAAI;IAKrB,yGAAyG;IACzG,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAQnC,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAQ9B,OAAO,CAAC,aAAa;IAyErB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,+EAA+E;IAC/E,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAK1C,2EAA2E;IAC3E,WAAW,IAAI,IAAI;IAQnB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,IAAI,IAAI;IAWxB,gBAAgB;IAChB,YAAY,IAAI,IAAI;CAyCrB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,CAE3D"}