@motion-script/core 0.1.0

package/dist/runtime/runtime.fixtures.js

@@ -0,0 +1,264 @@
+/**
+ * Shared mock/fake implementations for the runtime test suite.
+ *
+ * These stand in for the heavy CanvasKit-backed Scene graph and the platform
+ * adapters (clock, audio, storage, render context) so the runtime orchestration
+ * logic can be exercised in a plain Node environment. Each fake records the
+ * calls it receives so tests can assert on ordering and arguments.
+ *
+ * Excluded from the published build via `src/**\/*.fixtures.ts` in tsconfig.
+ */
+import { AudioDevice } from "@/platform/audio-device";
+import { MasterClock } from "@/platform/master-clock";
+import { MeasureScope } from "@/render/measure-scope";
+// ─── Scene graph fakes ──────────────────────────────────────────────────────
+/** A minimal tree node used to test getTreeState / getNodeState walking. */
+export class FakeNode {
+    id;
+    name;
+    children;
+    properties;
+    constructor(id, name, children = [], properties = {}) {
+        this.id = id;
+        this.name = name;
+        this.children = children;
+        this.properties = properties;
+    }
+    waveform() { return undefined; }
+}
+/**
+ * Stand-in for a `Scene`. Implements exactly the surface the runtime touches and
+ * records every call. The build() generator yields `yieldCount` times, which the
+ * runtime translates into that many frames.
+ */
+export class FakeScene {
+    id;
+    name;
+    properties;
+    children;
+    yieldCount;
+    onPrepare;
+    // Call recorders.
+    resetCount = 0;
+    buildCount = 0;
+    disposeCount = 0;
+    renderCount = 0;
+    setCalls = [];
+    bindAssetsCalls = [];
+    ellapseCalls = [];
+    layoutCalls = [];
+    prepareCount = 0;
+    constructor(opts = {}) {
+        this.id = opts.id ?? "scene";
+        this.name = opts.name ?? "Scene";
+        this.yieldCount = opts.yieldCount ?? 5;
+        this.children = opts.children ?? [];
+        this.properties = opts.properties ?? {};
+        this.onPrepare = opts.onPrepare;
+    }
+    set(props) {
+        this.setCalls.push(props);
+    }
+    reset() {
+        this.resetCount++;
+    }
+    bindAssets(catalog) {
+        this.bindAssetsCalls.push(catalog);
+    }
+    ellapse(time) {
+        this.ellapseCalls.push(time);
+    }
+    layout(rect) {
+        this.layoutCalls.push({ rect });
+    }
+    render() {
+        this.renderCount++;
+    }
+    prepareAssets(tracker) {
+        this.onPrepare?.(tracker, this.prepareCount);
+        this.prepareCount++;
+    }
+    dispose() {
+        this.disposeCount++;
+    }
+    waveform() { return undefined; }
+    build() {
+        this.buildCount++;
+        const n = this.yieldCount;
+        return (function* () {
+            for (let i = 0; i < n; i++)
+                yield;
+        })();
+    }
+}
+/** Cast a fake scene to the Scene type the runtime expects. */
+export function asScene(scene) {
+    return scene;
+}
+export function asScenes(scenes) {
+    return scenes;
+}
+// ─── Platform / render fakes ────────────────────────────────────────────────
+export class FakeMeasureScope extends MeasureScope {
+    measureText(text) {
+        return text.length * 10;
+    }
+}
+export class FakeAssetCatalog {
+    videoDurations;
+    constructor(videoDurations = {}) {
+        this.videoDurations = videoDurations;
+    }
+    getVideoDuration(src) {
+        return this.videoDurations[src] ?? 10;
+    }
+}
+export function asCatalog(c) {
+    return c;
+}
+export class FakeRenderContext {
+    renderCount = 0;
+    screenshotValue = "data:image/png;base64,FAKE";
+    /** Invokes the draw callback, mirroring the real render() contract. */
+    render(cb) {
+        this.renderCount++;
+        cb();
+    }
+    screenshot() {
+        return this.screenshotValue;
+    }
+}
+export function asRenderContext(c) {
+    return c;
+}
+export class FakeStorageAdapter {
+    loadAssetCalls = [];
+    fetchAudioCalls = [];
+    /** When set, loadAsset rejects with this error (to exercise prefetch's catch). */
+    loadShouldReject = false;
+    loadAsset(key, record) {
+        this.loadAssetCalls.push({ key, record });
+        return this.loadShouldReject ? Promise.reject(new Error("load failed")) : Promise.resolve();
+    }
+    fetchAudioData(src) {
+        this.fetchAudioCalls.push(src);
+        return Promise.resolve(new ArrayBuffer(8));
+    }
+}
+export function asStorage(s) {
+    return s;
+}
+export class FakeAudioDevice extends AudioDevice {
+    cache = new Set();
+    appendCalls = [];
+    scheduleCalls = [];
+    retainCalls = [];
+    syncToCalls = [];
+    playCalls = [];
+    stopCount = 0;
+    /** Seed the cache so `has()` returns true without an append round-trip. */
+    seed(src) {
+        this.cache.add(src);
+    }
+    has(src) {
+        return this.cache.has(src);
+    }
+    async append(src) {
+        this.appendCalls.push({ src });
+        this.cache.add(src);
+    }
+    retain(keep) {
+        this.retainCalls.push(keep);
+    }
+    schedule(requests) {
+        this.scheduleCalls.push([...requests]);
+    }
+    syncTo(sceneTime) {
+        this.syncToCalls.push(sceneTime);
+    }
+    play(time, speed, reverse) {
+        this.playCalls.push({ time, speed, reverse });
+    }
+    stop() {
+        this.stopCount++;
+    }
+}
+/**
+ * A MasterClock whose time is driven manually. `simulateTick` sets the time and
+ * runs the registered tick callbacks (awaiting their async work).
+ */
+export class FakeClock extends MasterClock {
+    seekCalls = [];
+    disposeCount = 0;
+    seek(t) {
+        this.seekCalls.push(t);
+        this.setCurrentTime(t);
+    }
+    /** Set the current time without firing tick callbacks. */
+    setTime(t) {
+        this.setCurrentTime(t);
+    }
+    /** Set the time then run all onTick callbacks to completion. */
+    async simulateTick(t) {
+        this.setCurrentTime(t);
+        await this.tick();
+    }
+    dispose() {
+        this.disposeCount++;
+        super.dispose();
+    }
+}
+// ─── PrecompResult builders ──────────────────────────────────────────────────
+export function makeAudioRequest(over = {}) {
+    return {
+        id: "req",
+        src: "sound.mp3",
+        startAt: 0,
+        endAt: 1,
+        trimStart: 0,
+        volume: 1,
+        loop: false,
+        ...over,
+    };
+}
+export function makeImageRecord(over = {}) {
+    return {
+        type: "image",
+        src: "img.png",
+        startFrame: 0,
+        endFrame: 0,
+        width: 100,
+        height: 100,
+        ...over,
+    };
+}
+export function makeAssetTrack(over = {}) {
+    return {
+        record: over.record ?? makeImageRecord(),
+        cacheAt: over.cacheAt ?? 0,
+        discardAt: over.discardAt ?? null,
+    };
+}
+export function makeScenePrecomp(over = {}) {
+    return {
+        frameCount: 10,
+        startFrame: 0,
+        audioRequests: [],
+        lifespans: new Map(),
+        ...over,
+    };
+}
+export function makePrecompResult(over = {}) {
+    const scenes = over.scenes ?? [makeScenePrecomp()];
+    const totalFrames = over.totalFrames ?? scenes.reduce((n, s) => n + s.frameCount, 0);
+    const fps = over.fps ?? 30;
+    return {
+        fps,
+        scenes,
+        totalFrames,
+        totalDuration: over.totalDuration ?? totalFrames / fps,
+        assets: over.assets ?? new Map(),
+        buildErrors: over.buildErrors ?? [],
+    };
+}
+//# sourceMappingURL=runtime.fixtures.js.map

package/dist/runtime/runtime.fixtures.js.map

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

package/dist/runtime/state-evaluator.d.ts

@@ -0,0 +1,76 @@
+import { RenderContext } from "../render/render-context";
+import { Scene } from "../nodes/base/scene-node";
+import { Size2D } from "../attributes/layout/size";
+import { AssetCatalog } from "../assets/catalog";
+import { MeasureScope } from "../render/measure-scope";
+/**
+ * Drives scene generators forward in time and exposes the evaluated state for
+ * layout and rendering. It is the stateful playback engine that `PlaybackController`
+ * calls on every tick (and on seek).
+ *
+ * Each scene gets a `SceneSlot` that holds its generator and the highest local
+ * frame it has reached. Forward seeks simply advance the generator; backward
+ * seeks within a scene reset that slot and replay from frame 0. Scenes that
+ * haven't been entered yet are initialised lazily when first needed.
+ *
+ * Call order per frame:
+ * 1. `stateAt(frame)` — advance generator(s) to the requested frame.
+ * 2. `layout(scope)` — lay out the current scene's node tree.
+ * 3. `render(context)` — draw the current scene into the render context.
+ */
+export declare class StateEvaluator {
+    private scenes;
+    private slots;
+    private _currentFrame;
+    private fps;
+    private viewport;
+    private assets;
+    /** Most-recently evaluated global frame (integer). */
+    get currentFrame(): number;
+    private readonly stage;
+    /**
+     * @param scenes  Scene list in timeline order.
+     * @param viewport Render viewport size; passed to each scene on init.
+     * @param fps     Frames per second — used to convert frames ↔ seconds.
+     * @param assets  Asset catalog bound to scenes before each generator step.
+     * @param tracks  Per-scene frame counts in timeline order (one entry per
+     *                scene). Used to build global frame ranges so `stateAt`
+     *                can jump directly to the owning scene without scanning.
+     */
+    constructor(scenes: Scene[], viewport: Size2D, fps: number, assets: AssetCatalog, tracks: number[]);
+    private _currentScene;
+    get currentScene(): Scene;
+    /** Index of the current scene in the scenes array, or -1 if none. */
+    get currentSceneIndex(): number;
+    private get dt();
+    private bindAssets;
+    private ellapse;
+    /** Find the slot that owns the given global frame. */
+    private slotAt;
+    /**
+     * Resets a single scene slot and primes its generator up to local frame 0.
+     * Scenes that come *after* this one in the timeline are left untouched —
+     * they will be lazily initialised when first needed.
+     */
+    private resetSlot;
+    /** Lay out the current scene's node tree against the full viewport. */
+    layout(scope: MeasureScope): void;
+    /** Render the current scene's node tree into `context`. */
+    render(context: RenderContext): void;
+    /**
+     * Advance (or rewind) state to the given global `frame`.
+     *
+     * - If `frame` matches the current frame and the generator is already
+     *   primed, this is a no-op (early return).
+     * - If the target is within the current slot but behind the generator's
+     *   position, the slot is reset and replayed from frame 0.
+     * - If the target belongs to a different scene, that slot is entered
+     *   (resetting it if necessary) and advanced to the local target frame.
+     *
+     * @param frame Global frame index (float accepted; fractional part ignored).
+     */
+    stateAt(frame: number): void;
+    /** Dispose all scenes and drop generator references. */
+    dispose(): void;
+}
+//# sourceMappingURL=state-evaluator.d.ts.map

package/dist/runtime/state-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-evaluator.d.ts","sourceRoot":"","sources":["../../src/runtime/state-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AActD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAe;IAE7B,sDAAsD;IACtD,IAAI,YAAY,WAEf;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC;;;;;;;;OAQG;gBACS,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE;IA6BlG,OAAO,CAAC,aAAa,CAAS;IAE9B,IAAW,YAAY,IAAI,KAAK,CAE/B;IAED,qEAAqE;IACrE,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,OAAO,KAAK,EAAE,GAEb;IAED,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,OAAO;IAMf,sDAAsD;IACtD,OAAO,CAAC,MAAM;IAQd;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAYjB,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,YAAY;IAK1B,2DAA2D;IAC3D,MAAM,CAAC,OAAO,EAAE,aAAa;IAI7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA+B5B,wDAAwD;IACxD,OAAO,IAAI,IAAI;CAMlB"}

package/dist/runtime/state-evaluator.js

@@ -0,0 +1,162 @@
+import { BuildStage } from "../render/build-stage";
+/**
+ * Drives scene generators forward in time and exposes the evaluated state for
+ * layout and rendering. It is the stateful playback engine that `PlaybackController`
+ * calls on every tick (and on seek).
+ *
+ * Each scene gets a `SceneSlot` that holds its generator and the highest local
+ * frame it has reached. Forward seeks simply advance the generator; backward
+ * seeks within a scene reset that slot and replay from frame 0. Scenes that
+ * haven't been entered yet are initialised lazily when first needed.
+ *
+ * Call order per frame:
+ * 1. `stateAt(frame)` — advance generator(s) to the requested frame.
+ * 2. `layout(scope)` — lay out the current scene's node tree.
+ * 3. `render(context)` — draw the current scene into the render context.
+ */
+export class StateEvaluator {
+    scenes;
+    slots = [];
+    _currentFrame = 0;
+    fps;
+    viewport;
+    assets;
+    /** Most-recently evaluated global frame (integer). */
+    get currentFrame() {
+        return this._currentFrame;
+    }
+    stage;
+    /**
+     * @param scenes  Scene list in timeline order.
+     * @param viewport Render viewport size; passed to each scene on init.
+     * @param fps     Frames per second — used to convert frames ↔ seconds.
+     * @param assets  Asset catalog bound to scenes before each generator step.
+     * @param tracks  Per-scene frame counts in timeline order (one entry per
+     *                scene). Used to build global frame ranges so `stateAt`
+     *                can jump directly to the owning scene without scanning.
+     */
+    constructor(scenes, viewport, fps, assets, tracks) {
+        this.fps = fps;
+        this.viewport = viewport;
+        this.scenes = scenes;
+        this.assets = assets;
+        this.stage = new BuildStage(viewport, fps);
+        for (const s of scenes) {
+            s.set({ width: viewport.width, height: viewport.height });
+        }
+        let offset = 0;
+        for (let i = 0; i < scenes.length; i++) {
+            const duration = tracks[i] ?? 0;
+            this.slots.push({
+                scene: scenes[i],
+                startFrame: offset,
+                endFrame: offset + duration - 1,
+                generator: null,
+                localFrame: -1,
+            });
+            offset += duration;
+        }
+        if (this.slots.length > 0) {
+            this._currentScene = this.slots[0].scene;
+        }
+    }
+    _currentScene;
+    get currentScene() {
+        return this._currentScene;
+    }
+    /** Index of the current scene in the scenes array, or -1 if none. */
+    get currentSceneIndex() {
+        return this.scenes.indexOf(this._currentScene);
+    }
+    get dt() {
+        return 1 / this.fps;
+    }
+    bindAssets() {
+        for (const s of this.scenes) {
+            s.bindAssets(this.assets);
+        }
+    }
+    ellapse(time) {
+        for (const s of this.scenes) {
+            s.ellapse(time);
+        }
+    }
+    /** Find the slot that owns the given global frame. */
+    slotAt(frame) {
+        for (const slot of this.slots) {
+            if (frame >= slot.startFrame && frame <= slot.endFrame)
+                return slot;
+        }
+        // Past the last frame — return the last slot so currentScene stays valid.
+        return this.slots[this.slots.length - 1] ?? null;
+    }
+    /**
+     * Resets a single scene slot and primes its generator up to local frame 0.
+     * Scenes that come *after* this one in the timeline are left untouched —
+     * they will be lazily initialised when first needed.
+     */
+    resetSlot(slot) {
+        slot.scene.reset();
+        slot.scene.bindAssets(this.assets);
+        slot.scene.ellapse(0);
+        this.stage.reset();
+        const gen = slot.scene.build(this.stage);
+        // Prime: advance to the first yield so frame-0 nodes are registered.
+        gen.next(this.dt);
+        slot.generator = gen;
+        slot.localFrame = 0;
+    }
+    /** Lay out the current scene's node tree against the full viewport. */
+    layout(scope) {
+        const bounds = { x: 0, y: 0, width: this.viewport.width, height: this.viewport.height };
+        this.currentScene.layout(bounds, scope);
+    }
+    /** Render the current scene's node tree into `context`. */
+    render(context) {
+        this.currentScene.render(context);
+    }
+    /**
+     * Advance (or rewind) state to the given global `frame`.
+     *
+     * - If `frame` matches the current frame and the generator is already
+     *   primed, this is a no-op (early return).
+     * - If the target is within the current slot but behind the generator's
+     *   position, the slot is reset and replayed from frame 0.
+     * - If the target belongs to a different scene, that slot is entered
+     *   (resetting it if necessary) and advanced to the local target frame.
+     *
+     * @param frame Global frame index (float accepted; fractional part ignored).
+     */
+    stateAt(frame) {
+        const clampedFrame = Math.max(0, Math.floor(frame));
+        if (clampedFrame === this._currentFrame && this.slotAt(clampedFrame)?.generator !== null)
+            return;
+        const targetSlot = this.slotAt(clampedFrame);
+        if (!targetSlot)
+            return;
+        this._currentScene = targetSlot.scene;
+        const localTarget = clampedFrame - targetSlot.startFrame;
+        // If we need to go backwards within this slot, reset only this slot.
+        if (targetSlot.generator === null || targetSlot.localFrame > localTarget) {
+            this.resetSlot(targetSlot);
+        }
+        const dt = this.dt;
+        // Advance this slot's generator from its current local frame to localTarget.
+        while (targetSlot.localFrame < localTarget) {
+            targetSlot.localFrame++;
+            const globalTime = (targetSlot.startFrame + targetSlot.localFrame) * dt;
+            this.bindAssets();
+            this.ellapse(globalTime);
+            targetSlot.generator.next(dt);
+        }
+        this._currentFrame = clampedFrame;
+    }
+    /** Dispose all scenes and drop generator references. */
+    dispose() {
+        for (const slot of this.slots) {
+            slot.scene.dispose();
+            slot.generator = null;
+        }
+    }
+}
+//# sourceMappingURL=state-evaluator.js.map

package/dist/runtime/state-evaluator.js.map

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

package/dist/runtime/state-evaluator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state-evaluator.test.d.ts.map

package/dist/runtime/state-evaluator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-evaluator.test.d.ts","sourceRoot":"","sources":["../../src/runtime/state-evaluator.test.ts"],"names":[],"mappings":""}

package/dist/runtime/state-evaluator.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect } from 'vitest';
+import { StateEvaluator } from '@/runtime/state-evaluator';
+import { FakeScene, FakeMeasureScope, FakeRenderContext, FakeAssetCatalog, asScenes, asCatalog, asRenderContext, } from './runtime.fixtures';
+const VIEWPORT = { width: 100, height: 50 };
+const FPS = 4; // dt = 0.25 → clean global-time arithmetic
+const catalog = asCatalog(new FakeAssetCatalog());
+const scope = new FakeMeasureScope();
+function single(yieldCount = 10) {
+    const scene = new FakeScene({ id: 'a', yieldCount });
+    const evaluator = new StateEvaluator(asScenes([scene]), VIEWPORT, FPS, catalog, [yieldCount]);
+    return { scene, evaluator };
+}
+describe('StateEvaluator – construction', () => {
+    it('sizes every scene to the viewport and selects the first as current', () => {
+        const a = new FakeScene({ id: 'a', yieldCount: 5 });
+        const b = new FakeScene({ id: 'b', yieldCount: 5 });
+        const evaluator = new StateEvaluator(asScenes([a, b]), VIEWPORT, FPS, catalog, [5, 5]);
+        expect(a.setCalls).toEqual([{ width: 100, height: 50 }]);
+        expect(b.setCalls).toEqual([{ width: 100, height: 50 }]);
+        expect(evaluator.currentFrame).toBe(0);
+        expect(evaluator.currentScene).toBe(a);
+    });
+});
+describe('StateEvaluator – priming & forward advance', () => {
+    it('primes the slot on the first stateAt without advancing past frame 0', () => {
+        const { scene, evaluator } = single();
+        evaluator.stateAt(0);
+        expect(scene.resetCount).toBe(1);
+        expect(scene.buildCount).toBe(1);
+        expect(scene.ellapseCalls).toEqual([0]); // only resetSlot's ellapse(0)
+        expect(evaluator.currentFrame).toBe(0);
+    });
+    it('advances the generator one step per frame with increasing global time', () => {
+        const { scene, evaluator } = single();
+        evaluator.stateAt(3);
+        // resetSlot ellapse(0) + advances at frames 1,2,3 → times 0.25, 0.5, 0.75.
+        expect(scene.ellapseCalls).toEqual([0, 0.25, 0.5, 0.75]);
+        expect(evaluator.currentFrame).toBe(3);
+    });
+    it('is a no-op when asked for the frame it is already on', () => {
+        const { scene, evaluator } = single();
+        evaluator.stateAt(3);
+        const ellapsedBefore = scene.ellapseCalls.length;
+        evaluator.stateAt(3);
+        expect(scene.ellapseCalls.length).toBe(ellapsedBefore);
+    });
+    it('floors fractional frames and clamps negatives to 0', () => {
+        const { evaluator } = single();
+        evaluator.stateAt(2.9);
+        expect(evaluator.currentFrame).toBe(2);
+        evaluator.stateAt(-5);
+        expect(evaluator.currentFrame).toBe(0);
+    });
+});
+describe('StateEvaluator – backward seek', () => {
+    it('resets and replays the slot when seeking earlier within a scene', () => {
+        const { scene, evaluator } = single();
+        evaluator.stateAt(3);
+        expect(scene.resetCount).toBe(1);
+        expect(scene.buildCount).toBe(1);
+        evaluator.stateAt(1);
+        expect(scene.resetCount).toBe(2); // re-primed
+        expect(scene.buildCount).toBe(2);
+        expect(evaluator.currentFrame).toBe(1);
+    });
+});
+describe('StateEvaluator – multi-scene timeline', () => {
+    function pair() {
+        const a = new FakeScene({ id: 'a', yieldCount: 10 });
+        const b = new FakeScene({ id: 'b', yieldCount: 5 });
+        const evaluator = new StateEvaluator(asScenes([a, b]), VIEWPORT, FPS, catalog, [10, 5]);
+        return { a, b, evaluator };
+    }
+    it('routes a frame to the scene that owns it and lazily primes only that scene', () => {
+        const { a, b, evaluator } = pair();
+        evaluator.stateAt(12); // global 12 → scene B local 2
+        expect(evaluator.currentScene).toBe(b);
+        expect(b.buildCount).toBe(1);
+        expect(a.buildCount).toBe(0); // scene A never needed
+    });
+    it('switches current scene back to an earlier scene and re-primes it', () => {
+        const { a, evaluator } = pair();
+        evaluator.stateAt(12);
+        evaluator.stateAt(3); // back into scene A
+        expect(evaluator.currentScene).toBe(a);
+        expect(a.buildCount).toBe(1);
+        expect(evaluator.currentFrame).toBe(3);
+    });
+    it('clamps to the last slot when seeking past the end of the timeline', () => {
+        const { b, evaluator } = pair();
+        evaluator.stateAt(20); // past end (last frame is 14)
+        expect(evaluator.currentScene).toBe(b);
+        expect(evaluator.currentFrame).toBe(20);
+    });
+});
+describe('StateEvaluator – layout & render delegation', () => {
+    it('lays out the current scene against the full viewport rect', () => {
+        const { scene, evaluator } = single();
+        evaluator.stateAt(1);
+        evaluator.layout(scope);
+        expect(scene.layoutCalls).toHaveLength(1);
+        expect(scene.layoutCalls[0].rect).toEqual({ x: 0, y: 0, width: 100, height: 50 });
+    });
+    it('renders the current scene through the render context', () => {
+        const { scene, evaluator } = single();
+        const ctx = new FakeRenderContext();
+        evaluator.stateAt(1);
+        evaluator.render(asRenderContext(ctx));
+        expect(scene.renderCount).toBe(1);
+    });
+});
+describe('StateEvaluator – dispose', () => {
+    it('disposes every scene', () => {
+        const a = new FakeScene({ id: 'a', yieldCount: 5 });
+        const b = new FakeScene({ id: 'b', yieldCount: 5 });
+        const evaluator = new StateEvaluator(asScenes([a, b]), VIEWPORT, FPS, catalog, [5, 5]);
+        evaluator.dispose();
+        expect(a.disposeCount).toBe(1);
+        expect(b.disposeCount).toBe(1);
+    });
+});
+//# sourceMappingURL=state-evaluator.test.js.map

package/dist/runtime/state-evaluator.test.js.map

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