@dojo-video-engine/player 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2026 dojo-video-engine contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,92 @@
-# Temporary Holding Version
+# @dojo-video-engine/player
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Real-time playback for dojo-video-engine scenes: a deterministic frame clock plus a canvas render loop with play/pause/seek/loop.
+
+```ts
+import { createPlayer } from "@dojo-video-engine/player";
+
+const context = canvas.getContext("2d")!;
+const player = await createPlayer({ context, scene, loop: true });
+
+player.play();
+player.on("frame", (frame) => (slider.value = String(frame)));
+player.pause();
+await player.seek(45);
+await player.disposeAsync();
+```
+
+When the Scene is already prepared by the Canvas2D runtime, borrow that exact
+revision instead of resolving a second media graph:
+
+```ts
+import { createPlayerFromRuntime } from "@dojo-video-engine/player";
+
+const player = await createPlayerFromRuntime(runtime, { context, loop: true });
+// The runtime keeps this revision's media alive until player disposal.
+await player.disposeAsync();
+```
+
+Runtime updates, runtime disposal, and the optional caller `signal` dispose the
+borrowed player before releasing its scope. A runtime-backed player therefore
+cannot outlive or retain stale decoded assets from the prepared revision.
+
+For extension scenes, pass the host registry as `extensions`; pass
+`worker: true` when the player runs in a worker and definitions must declare
+worker compatibility.
+
+## Design
+
+- **Wall-clock time exists only in the clock.** `FrameClock` maps `performance.now()` to integer frames anchored at the last play/seek; rendering stays the engine's pure `(scene, frame)` function. Playback at 30 fps shows the same pixels as export at 30 fps.
+- **Clock ticks skip stale work; explicit seeks are serialized.** The loop awaits
+  `prepareFrame()` and re-reads the clock after a slow decode. Concurrent
+  `seek()` calls each resolve only after their requested frame paints.
+- **First paint does not wait for audio.** Preview audio mixing begins alongside
+  the initial render. If it finishes after playback starts, it joins at the
+  current scene position instead of delaying the visible player.
+- **Injectable time and scheduler.** `now`, `requestFrame`, and `cancelFrame` are constructor options, so the full play/pause/seek/ended/loop behavior is unit-tested in Node with a fake driver — no timers, no flake.
+- **Asset ownership is explicit.** Pass `assets` and you own their lifetime;
+  omit them and the player resolves reachable proxy sources by default and
+  releases them transactionally. `dispose()` remains the void compatibility
+  facade; `disposeAsync()` observes completion/errors. Budgets, `AssetPolicy`,
+  caches, and cancellation are forwarded to the resolver.
+- **Extension ownership follows assets.** An internally resolved registry runs resolve/prepare/draw/dispose through the same player lifecycle; caller-provided `assets` remain caller-owned.
+
+Events: `frame`, `play`, `pause`, `ended` (non-looping playback pauses on the
+final frame). `currentFrame` is the last rendered frame. `onError()` and
+`player.error` expose asynchronous render-loop failure without an unhandled
+promise rejection.
+
+## Audio preview
+
+Scenes with audible nodes (audio nodes, or video nodes whose clips carry a soundtrack) play sound during preview automatically:
+
+- Audio is mixed through the exact pure bus/pan/ducking functions export uses. The default backend mixes bounded chunks around the current position; seeking discards stale work and starts at the requested chunk.
+- **Audio is the master clock.** Each tick compares the frame clock against the audio position; past one frame of divergence, the frame clock re-anchors to audio. A skipped video frame is invisible; skipped audio is not.
+- **Best-effort by design.** No `AudioContext` (or a custom `audio: false`) means silent preview; the `AudioContext` is created lazily inside `play()`, which is normally a user gesture, satisfying autoplay policies. The exported file remains the audio source of truth.
+- Bring your own implementation via the `audio` option (`AudioPreview` interface) — that's also how the deterministic tests drive it.
+
+`ChunkedWebAudioPreview` is the default: it mixes only the bounded chunk around
+the current play/seek position and chains future chunks. `WebAudioPreview`
+remains available when an application explicitly wants a reusable whole-scene
+buffer for short projects.
+
+## API Stability
+
+Stable for 1.x integrations:
+
+- `createPlayer()`, `Player`, `PlayerOptions`, `PlayerEvent`, `FrameClock`, and event names `frame`, `play`, `pause`, and `ended`.
+- Prepared-runtime compatibility: `createPlayerFromRuntime()` and
+  `RuntimePlayerOptions`.
+- `play()`, `pause()`, `seek(frame)`, `dispose()`, `disposeAsync()`,
+  `currentFrame`, `on(event, callback)`, and `onError(callback)`.
+- Audio extension point: `AudioPreview`, `ChunkedWebAudioPreview`, and `WebAudioPreview`.
+
+Evolving additively in 1.x:
+
+- Scheduler/time injection options are stable enough for tests, but may gain a narrower helper API as downstream host integrations converge.
+- Chunk scheduling may gain lookahead/cross-chunk overlap tuning while keeping `AudioPreview` as the integration boundary.
+
+Internal/not public:
+
+- Render-loop bookkeeping and audio drift correction internals are implementation details. Prefer the `Player` methods/events over reaching into private state.
+- Files outside the package root export are implementation details.

package/dist/audio.d.ts

@@ -0,0 +1,101 @@
+import type { ResolvedAssets } from "@dojo-video-engine/renderer-canvas2d";
+import type { Scene } from "@dojo-video-engine/schema";
+/**
+ * Best-effort audio for preview playback. The export remains the audio
+ * source of truth; implementations of this interface only need to play
+ * scene-time-aligned sound and report their clock.
+ */
+export interface AudioPreview {
+    /** Prepares the scene's audio. Resolves false when there is nothing audible. */
+    load(scene: Scene, assets: ResolvedAssets | undefined, signal?: AbortSignal): Promise<boolean>;
+    /** Starts playback at the given scene time in seconds. */
+    start(atSeconds: number): void;
+    stop(): void;
+    /**
+     * The audio clock's current scene-time position in seconds, or null when
+     * not playing. The player treats this as the steadier reference and
+     * re-anchors its frame clock to it on drift.
+     */
+    position(): number | null;
+    dispose(): void;
+}
+export declare function previewAudioChunkRange(scene: Pick<Scene, "duration" | "fps">, atSeconds: number, chunkSeconds?: number): {
+    chunkStart: number;
+    startFrame: number;
+    endFrame: number;
+};
+/**
+ * Web Audio implementation: the scene's audible nodes are mixed once with
+ * the exact pure mix functions the export uses (`mixSceneAudio`), cached as
+ * one AudioBuffer, and played through a single AudioBufferSourceNode.
+ * Seeking restarts the source at an offset — no re-mixing.
+ */
+export declare class WebAudioPreview implements AudioPreview {
+    private readonly createContext;
+    private context;
+    private buffer;
+    private adoptedBuffer;
+    private source;
+    private startedAtContextTime;
+    private startOffset;
+    constructor(createContext?: () => AudioContext);
+    /** True when this environment can play audio at all. */
+    static supported(): boolean;
+    /**
+     * Reuses a mix produced by an earlier preview (read from `mixedBuffer`),
+     * so load() skips decoding and mixing entirely. Callers own cache
+     * invalidation: adopt only when the scene's audible content is unchanged.
+     */
+    adoptMixedBuffer(buffer: AudioBuffer | null): void;
+    /**
+     * The mixed scene audio after load() (null when the scene is silent).
+     * AudioBuffers are context-independent, so callers may cache this across
+     * players and hand it to a new preview via adoptMixedBuffer().
+     */
+    get mixedBuffer(): AudioBuffer | null;
+    load(scene: Scene, assets: ResolvedAssets | undefined, signal?: AbortSignal): Promise<boolean>;
+    start(atSeconds: number): void;
+    stop(): void;
+    position(): number | null;
+    dispose(): void;
+}
+/**
+ * Bounded-memory preview backend. One playing chunk and one prefetched chunk
+ * share an AudioContext timeline, so mixing never waits for the previous
+ * source's ended event. Seeking discards both chunks and their in-flight mix.
+ */
+export declare class ChunkedWebAudioPreview implements AudioPreview {
+    private readonly chunkSeconds;
+    private readonly createContext;
+    private context;
+    private scene;
+    private assets;
+    private chunks;
+    private timer;
+    private mixController;
+    private unlinkLoadSignal;
+    private loadSignal;
+    private lastMixError;
+    private generation;
+    private fillingGeneration;
+    private playing;
+    private clockStarted;
+    private startedAtContextTime;
+    private startOffset;
+    private nextFrame;
+    constructor(chunkSeconds?: number, createContext?: () => AudioContext);
+    static supported(): boolean;
+    get error(): Error | null;
+    load(scene: Scene, assets: ResolvedAssets | undefined, signal?: AbortSignal): Promise<boolean>;
+    start(atSeconds: number): void;
+    stop(): void;
+    position(): number | null;
+    dispose(): void;
+    private sceneTime;
+    private current;
+    private retireElapsedChunks;
+    private fillLookahead;
+    private mixAhead;
+    private scheduleBoundary;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

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

package/dist/audio.js

@@ -0,0 +1,329 @@
+import { collectAudioPlacements, mixSceneAudio, } from "@dojo-video-engine/export";
+export function previewAudioChunkRange(scene, atSeconds, chunkSeconds = 30) {
+    const chunkStart = Math.floor(Math.max(0, atSeconds) / chunkSeconds) * chunkSeconds;
+    return {
+        chunkStart,
+        startFrame: Math.floor(chunkStart * scene.fps),
+        endFrame: Math.min(scene.duration - 1, Math.ceil((chunkStart + chunkSeconds) * scene.fps) - 1),
+    };
+}
+/**
+ * Web Audio implementation: the scene's audible nodes are mixed once with
+ * the exact pure mix functions the export uses (`mixSceneAudio`), cached as
+ * one AudioBuffer, and played through a single AudioBufferSourceNode.
+ * Seeking restarts the source at an offset — no re-mixing.
+ */
+export class WebAudioPreview {
+    createContext;
+    context;
+    buffer = null;
+    adoptedBuffer = false;
+    source = null;
+    startedAtContextTime = 0;
+    startOffset = 0;
+    constructor(createContext = () => new AudioContext()) {
+        this.createContext = createContext;
+    }
+    /** True when this environment can play audio at all. */
+    static supported() {
+        return typeof AudioContext !== "undefined";
+    }
+    /**
+     * Reuses a mix produced by an earlier preview (read from `mixedBuffer`),
+     * so load() skips decoding and mixing entirely. Callers own cache
+     * invalidation: adopt only when the scene's audible content is unchanged.
+     */
+    adoptMixedBuffer(buffer) {
+        this.buffer = buffer;
+        this.adoptedBuffer = true;
+    }
+    /**
+     * The mixed scene audio after load() (null when the scene is silent).
+     * AudioBuffers are context-independent, so callers may cache this across
+     * players and hand it to a new preview via adoptMixedBuffer().
+     */
+    get mixedBuffer() {
+        return this.buffer;
+    }
+    async load(scene, assets, signal) {
+        if (!this.adoptedBuffer) {
+            this.buffer = assets
+                ? await mixSceneAudio(scene, assets, 0, scene.duration - 1, signal)
+                : null;
+        }
+        return this.buffer !== null;
+    }
+    start(atSeconds) {
+        if (!this.buffer) {
+            return;
+        }
+        // Created lazily inside start(), which the player calls from play() —
+        // normally a user gesture, satisfying autoplay policies.
+        this.context ??= this.createContext();
+        void this.context.resume?.();
+        this.stop();
+        const offset = Math.max(0, Math.min(atSeconds, this.buffer.duration));
+        const source = this.context.createBufferSource();
+        source.buffer = this.buffer;
+        source.connect(this.context.destination);
+        source.start(0, offset);
+        this.source = source;
+        this.startedAtContextTime = this.context.currentTime;
+        this.startOffset = offset;
+    }
+    stop() {
+        if (this.source) {
+            try {
+                this.source.stop();
+            }
+            catch {
+                // Stopping a source that already ended throws in some engines.
+            }
+            this.source.disconnect();
+            this.source = null;
+        }
+    }
+    position() {
+        if (!this.source || !this.context) {
+            return null;
+        }
+        return (this.startOffset + (this.context.currentTime - this.startedAtContextTime));
+    }
+    dispose() {
+        this.stop();
+        void this.context?.close?.();
+        this.context = undefined;
+        this.buffer = null;
+    }
+}
+/**
+ * Bounded-memory preview backend. One playing chunk and one prefetched chunk
+ * share an AudioContext timeline, so mixing never waits for the previous
+ * source's ended event. Seeking discards both chunks and their in-flight mix.
+ */
+export class ChunkedWebAudioPreview {
+    chunkSeconds;
+    createContext;
+    context;
+    scene = null;
+    assets;
+    chunks = [];
+    timer = null;
+    mixController = null;
+    unlinkLoadSignal = null;
+    loadSignal;
+    lastMixError = null;
+    generation = 0;
+    fillingGeneration = null;
+    playing = false;
+    clockStarted = false;
+    startedAtContextTime = 0;
+    startOffset = 0;
+    nextFrame = 0;
+    constructor(chunkSeconds = 30, createContext = () => new AudioContext()) {
+        this.chunkSeconds = chunkSeconds;
+        this.createContext = createContext;
+        if (!Number.isFinite(chunkSeconds) || chunkSeconds <= 0) {
+            throw new RangeError("Audio preview chunk duration must be positive.");
+        }
+    }
+    static supported() {
+        return typeof AudioContext !== "undefined";
+    }
+    get error() {
+        return this.lastMixError;
+    }
+    async load(scene, assets, signal) {
+        if (signal?.aborted)
+            throw signal.reason;
+        this.stop();
+        this.unlinkLoadSignal?.();
+        this.loadSignal = signal;
+        const abort = () => this.stop();
+        signal?.addEventListener("abort", abort, { once: true });
+        this.unlinkLoadSignal = signal
+            ? () => signal.removeEventListener("abort", abort)
+            : null;
+        this.scene = scene;
+        this.assets = assets;
+        return Boolean(assets && collectAudioPlacements(scene).length > 0);
+    }
+    start(atSeconds) {
+        if (!this.scene || !this.assets || this.loadSignal?.aborted)
+            return;
+        this.context ??= this.createContext();
+        void this.context.resume?.();
+        this.stop();
+        this.lastMixError = null;
+        this.startOffset = Math.max(0, Math.min(atSeconds, this.scene.duration / this.scene.fps));
+        if (this.startOffset >= this.scene.duration / this.scene.fps)
+            return;
+        this.playing = true;
+        this.clockStarted = false;
+        this.nextFrame = 0;
+        this.mixController = new AbortController();
+        this.fillLookahead(this.generation, this.mixController.signal);
+    }
+    stop() {
+        this.generation += 1;
+        this.playing = false;
+        this.clockStarted = false;
+        this.mixController?.abort(typeof DOMException === "function"
+            ? new DOMException("Audio preview work was superseded.", "AbortError")
+            : new Error("Audio preview work was superseded."));
+        this.mixController = null;
+        if (this.timer !== null)
+            clearTimeout(this.timer);
+        this.timer = null;
+        for (const chunk of this.chunks) {
+            if (!chunk.source)
+                continue;
+            chunk.source.onended = null;
+            try {
+                chunk.source.stop();
+            }
+            catch {
+                // Already ended.
+            }
+            chunk.source.disconnect();
+        }
+        this.chunks = [];
+    }
+    position() {
+        if (!this.playing || !this.context || !this.scene)
+            return null;
+        // Hold the requested position while the first mix is being prepared. The
+        // player follows this clock instead of skipping the beginning of the audio.
+        const position = this.clockStarted ? this.sceneTime() : this.startOffset;
+        return position < this.scene.duration / this.scene.fps ? position : null;
+    }
+    dispose() {
+        this.stop();
+        this.unlinkLoadSignal?.();
+        this.unlinkLoadSignal = null;
+        this.loadSignal = undefined;
+        void this.context?.close?.();
+        this.context = undefined;
+        this.scene = null;
+        this.assets = undefined;
+    }
+    sceneTime() {
+        return (this.startOffset +
+            Math.max(0, this.context.currentTime - this.startedAtContextTime));
+    }
+    current(generation, signal) {
+        return this.playing && generation === this.generation && !signal.aborted;
+    }
+    retireElapsedChunks() {
+        const now = this.context.currentTime;
+        while (this.chunks.length && this.chunks[0].endContextTime <= now) {
+            const chunk = this.chunks.shift();
+            if (chunk.source) {
+                chunk.source.onended = null;
+                chunk.source.disconnect();
+            }
+        }
+    }
+    fillLookahead(generation, signal) {
+        if (!this.current(generation, signal) ||
+            this.fillingGeneration === generation)
+            return;
+        this.fillingGeneration = generation;
+        void this.mixAhead(generation, signal)
+            .catch((error) => {
+            if (!this.current(generation, signal))
+                return;
+            this.lastMixError =
+                error instanceof Error ? error : new Error(String(error));
+            this.stop();
+        })
+            .finally(() => {
+            if (this.fillingGeneration === generation)
+                this.fillingGeneration = null;
+        });
+    }
+    async mixAhead(generation, signal) {
+        const scene = this.scene;
+        const assets = this.assets;
+        const context = this.context;
+        while (this.current(generation, signal)) {
+            this.retireElapsedChunks();
+            if (this.clockStarted && this.sceneTime() >= scene.duration / scene.fps) {
+                this.stop();
+                return;
+            }
+            if (this.chunks.length >= 2 || this.nextFrame >= scene.duration)
+                return;
+            const sceneTime = this.clockStarted
+                ? Math.max(this.nextFrame / scene.fps, this.sceneTime())
+                : this.startOffset;
+            if (sceneTime >= scene.duration / scene.fps) {
+                this.stop();
+                return;
+            }
+            const range = previewAudioChunkRange(scene, sceneTime, this.chunkSeconds);
+            // Fractional frame rates can straddle a nominal chunk boundary. Do not
+            // decode or schedule an overlapping frame at the start of the next chunk.
+            const startFrame = Math.max(this.nextFrame, range.startFrame);
+            const endFrame = Math.max(startFrame, range.endFrame);
+            const buffer = await mixSceneAudio(scene, assets, startFrame, endFrame, signal);
+            if (!this.current(generation, signal))
+                return;
+            if (!this.clockStarted) {
+                this.startedAtContextTime = context.currentTime;
+                this.clockStarted = true;
+            }
+            this.nextFrame = endFrame + 1;
+            const endContextTime = this.startedAtContextTime +
+                this.nextFrame / scene.fps -
+                this.startOffset;
+            // A late mix follows the established clock. Skip an entirely expired
+            // chunk, or start at its current offset; never shift subsequent audio.
+            if (endContextTime <= context.currentTime)
+                continue;
+            let source = null;
+            if (buffer) {
+                source = context.createBufferSource();
+                source.buffer = buffer;
+                source.connect(context.destination);
+                const when = Math.max(context.currentTime, this.startedAtContextTime + startFrame / scene.fps - this.startOffset);
+                const offset = this.startOffset +
+                    when -
+                    this.startedAtContextTime -
+                    startFrame / scene.fps;
+                try {
+                    source.start(when, Math.max(0, offset), endContextTime - when);
+                }
+                catch (error) {
+                    source.disconnect();
+                    throw error;
+                }
+            }
+            this.chunks.push({ endContextTime, source });
+            this.scheduleBoundary(generation, signal);
+        }
+    }
+    scheduleBoundary(generation, signal) {
+        if (this.timer !== null)
+            clearTimeout(this.timer);
+        this.timer = null;
+        const boundary = this.chunks[0]?.endContextTime;
+        if (!this.current(generation, signal) || boundary === undefined)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            if (!this.current(generation, signal))
+                return;
+            this.retireElapsedChunks();
+            if (this.sceneTime() >= this.scene.duration / this.scene.fps) {
+                this.stop();
+                return;
+            }
+            this.fillLookahead(generation, signal);
+            // AudioContext time can pause while a wall-clock timer keeps running.
+            // Recheck it before releasing a chunk or scheduling additional work.
+            this.scheduleBoundary(generation, signal);
+        }, Math.max(1, (boundary - this.context.currentTime) * 1000));
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

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