@motion-script/core 0.1.0

package/dist/runtime/precompisition.js

@@ -0,0 +1,202 @@
+import { BuildStage } from "../render/build-stage";
+import { nodePath } from "../project/tree";
+import { AssetTracker } from "../assets/tracker";
+// ─── Precomp runner ───────────────────────────────────────────────────────────
+/**
+ * Runs a full offline build pass over every scene before playback starts.
+ *
+ * The pass drives each scene's generator frame-by-frame (without rendering)
+ * to collect three things:
+ *
+ * - **Frame counts** — how long each scene lasts, from which the global
+ *   timeline is assembled.
+ * - **Asset timeline** — every image / video / font each scene needs, with
+ *   the global frame range it is visible, so the asset manager knows exactly
+ *   when to load and evict each one.
+ * - **Node lifespans** — which structural path was alive during which frames,
+ *   used by the timeline UI to draw per-node bars.
+ *
+ * Construct and then call `run()` once; the result is a `PrecompResult` that
+ * `PlaybackController` holds onto for the lifetime of the playback session.
+ */
+export class Precomp {
+    scenes;
+    viewport;
+    fps;
+    assets;
+    measureScope;
+    constructor(scenes, viewport, fps, assets, measureScope) {
+        this.scenes = scenes;
+        this.viewport = viewport;
+        this.fps = fps;
+        this.assets = assets;
+        this.measureScope = measureScope;
+    }
+    /**
+     * Execute the build pass and return the complete precomp result.
+     *
+     * Each scene is driven through its full generator loop: `build()` yields
+     * once per frame, and each tick calls `layout`, `prepareAssets`, and
+     * `recordLifespans` before advancing the clock. Errors thrown by a scene
+     * generator are caught and recorded in `buildErrors` rather than aborting
+     * the entire pass, so other scenes can still precomp successfully.
+     */
+    run() {
+        const dt = 1 / this.fps;
+        const layoutBounds = { x: 0, y: 0, width: this.viewport.width, height: this.viewport.height };
+        // Single shared registry accumulates across all scenes so frame ranges
+        // span the global timeline and cross-scene shared assets merge correctly.
+        const registry = new AssetTracker(this.assets);
+        const stage = new BuildStage(this.viewport, this.fps);
+        const sceneResults = [];
+        const buildErrors = [];
+        let globalFrameOffset = 0;
+        for (let sceneIndex = 0; sceneIndex < this.scenes.length; sceneIndex++) {
+            const scene = this.scenes[sceneIndex];
+            scene.reset();
+            scene.set({ width: this.viewport.width, height: this.viewport.height });
+            scene.bindAssets(this.assets);
+            stage.reset();
+            let localFrame = 0;
+            const lifespans = new Map();
+            try {
+                const generator = scene.build(stage);
+                // Prime: advance to first yield so frame-0 nodes are registered.
+                generator.next(dt);
+                while (true) {
+                    const globalFrame = globalFrameOffset + localFrame;
+                    // layout before prepare — layout gives nodes their layoutRect,
+                    // which prepare uses to determine decode resolution.
+                    scene.layout(layoutBounds, this.measureScope);
+                    registry.start(globalFrame);
+                    scene.prepareAssets(registry);
+                    registry.end();
+                    // Record which nodes are alive this frame so the timeline can
+                    // draw each node's bar over only its true lifespan.
+                    recordLifespans(scene, "", localFrame, lifespans);
+                    localFrame++;
+                    scene.bindAssets(this.assets);
+                    scene.ellapse(localFrame * dt);
+                    const result = generator.next(dt);
+                    if (result.done)
+                        break;
+                }
+            }
+            catch (err) {
+                const e = err instanceof Error ? err : new Error(String(err));
+                buildErrors.push({
+                    sceneName: scene.name ?? `Scene ${sceneIndex}`,
+                    sceneIndex,
+                    message: e.message,
+                    stack: e.stack,
+                });
+            }
+            const audioRequests = registry.audioRequests.slice();
+            registry.clearAudio();
+            sceneResults.push({
+                frameCount: localFrame,
+                startFrame: globalFrameOffset,
+                audioRequests,
+                lifespans,
+            });
+            globalFrameOffset += localFrame;
+            scene.reset();
+        }
+        return {
+            fps: this.fps,
+            scenes: sceneResults,
+            totalFrames: globalFrameOffset,
+            totalDuration: globalFrameOffset / this.fps,
+            assets: buildAssetMap(registry, this.fps),
+            buildErrors,
+        };
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Walk the scene's live node tree and extend each node's lifespan to include
+ * `frame`, keyed by structural path (see {@link nodePath}). A node's lifespan
+ * starts the first frame its slot appears and ends the last frame it is still
+ * present, so nodes added or removed mid-scene get a range narrower than the
+ * scene itself. The scene root (path "") is included so its own bar spans the
+ * whole scene.
+ */
+function recordLifespans(node, path, frame, out) {
+    const existing = out.get(path);
+    if (existing) {
+        existing.endFrame = frame;
+    }
+    else {
+        out.set(path, { startFrame: frame, endFrame: frame });
+    }
+    const children = node.children;
+    for (let i = 0; i < children.length; i++) {
+        recordLifespans(children[i], nodePath(path, i), frame, out);
+    }
+}
+/**
+ * Lead-time tuning constants.
+ *
+ * LEADS_PER_MB: frames of lead time granted per decoded megabyte.
+ * A 4K image (~32 MB) gets ~64 frames; a 256×256 thumbnail (~0.25 MB) gets
+ * MIN_LEAD. These are intentionally conservative starting values.
+ */
+const LEADS_PER_MB = 2;
+const MIN_LEAD = 2;
+const MAX_LEAD = 120;
+/** Frames to keep an asset alive after its last use (backward-scrub headroom). */
+const TAIL_FRAMES = 30;
+/** Decoded RGBA memory footprint of a frame with the given pixel dimensions. */
+function decodedMB(width, height) {
+    return (width * height * 4) / (1024 * 1024);
+}
+/** Clamp-scaled lead time in frames for an asset of `mb` decoded megabytes. */
+function leadFrames(mb) {
+    return Math.min(MAX_LEAD, Math.max(MIN_LEAD, Math.round(mb * LEADS_PER_MB)));
+}
+/**
+ * Convert the raw asset registry into the typed `AssetTrack` map consumed by
+ * `AssetManager`. Each asset type gets a `cacheAt` / `discardAt` window based
+ * on its decoded size and usage range. Fonts are pinned at frame 0 and never
+ * evicted; images and video get size-proportional lead time.
+ */
+function buildAssetMap(registry, fps) {
+    const out = new Map();
+    for (const [key, entry] of registry.assets) {
+        switch (entry.type) {
+            case "image": {
+                const mb = decodedMB(entry.width, entry.height);
+                const lead = leadFrames(mb);
+                out.set(key, {
+                    record: entry,
+                    cacheAt: Math.max(0, entry.startFrame - lead),
+                    discardAt: entry.endFrame + TAIL_FRAMES,
+                });
+                break;
+            }
+            case "video": {
+                const mb = decodedMB(entry.width, entry.height);
+                // Video decode is heavier than image: double the lead, then
+                // also add a fixed buffer so short clips still get real headroom.
+                const lead = Math.min(MAX_LEAD, leadFrames(mb) * 2 + Math.round(fps));
+                out.set(key, {
+                    record: entry,
+                    cacheAt: Math.max(0, entry.startFrame - lead),
+                    discardAt: entry.endFrame + TAIL_FRAMES,
+                });
+                break;
+            }
+            case "font":
+                // Fonts are tiny and referenced throughout; always load at frame 0
+                // and never evict.
+                out.set(key, {
+                    record: entry,
+                    cacheAt: 0,
+                    discardAt: null,
+                });
+                break;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=precompisition.js.map

package/dist/runtime/precompisition.js.map

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

package/dist/runtime/precompisition.test.d.ts

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

package/dist/runtime/precompisition.test.d.ts.map

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

package/dist/runtime/precompisition.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect } from 'vitest';
+import { Precomp } from '@/runtime/precompisition';
+import { FakeScene, FakeMeasureScope, FakeAssetCatalog, asScenes, asCatalog, makeAudioRequest, } from './runtime.fixtures';
+const VIEWPORT = { width: 200, height: 100 };
+const scope = new FakeMeasureScope();
+function run(scenes, fps = 10, catalog = new FakeAssetCatalog()) {
+    return new Precomp(asScenes(scenes), VIEWPORT, fps, asCatalog(catalog), scope).run();
+}
+describe('Precomp – timeline accounting', () => {
+    it('derives per-scene frame counts from the build generator', () => {
+        const a = new FakeScene({ yieldCount: 3 });
+        const b = new FakeScene({ yieldCount: 7 });
+        const result = run([a, b], 10);
+        expect(result.scenes.map((s) => s.frameCount)).toEqual([3, 7]);
+    });
+    it('assigns increasing global start frames', () => {
+        const a = new FakeScene({ yieldCount: 3 });
+        const b = new FakeScene({ yieldCount: 7 });
+        const result = run([a, b], 10);
+        expect(result.scenes.map((s) => s.startFrame)).toEqual([0, 3]);
+    });
+    it('totals frames and duration across scenes', () => {
+        const result = run([new FakeScene({ yieldCount: 3 }), new FakeScene({ yieldCount: 7 })], 10);
+        expect(result.totalFrames).toBe(10);
+        expect(result.totalDuration).toBeCloseTo(1.0, 6);
+        expect(result.fps).toBe(10);
+    });
+    it('resets each scene before and after its pass', () => {
+        const a = new FakeScene({ yieldCount: 4 });
+        run([a]);
+        expect(a.resetCount).toBe(2);
+        expect(a.buildCount).toBe(1);
+    });
+    it('lays out and prepares assets once per frame', () => {
+        const a = new FakeScene({ yieldCount: 4 });
+        run([a]);
+        expect(a.layoutCalls).toHaveLength(4);
+        expect(a.prepareCount).toBe(4);
+    });
+});
+describe('Precomp – audio capture', () => {
+    it('collects audio requests emitted during a scene', () => {
+        const a = new FakeScene({
+            yieldCount: 3,
+            onPrepare: (tracker, frame) => {
+                if (frame === 0)
+                    tracker.addAudioRequest(makeAudioRequest({ id: 'a-sound', src: 'a.mp3' }));
+            },
+        });
+        const result = run([a]);
+        expect(result.scenes[0].audioRequests.map((r) => r.id)).toEqual(['a-sound']);
+    });
+    it('keeps each scene’s audio separate (registry cleared between scenes)', () => {
+        const a = new FakeScene({
+            yieldCount: 2,
+            onPrepare: (t, f) => { if (f === 0)
+                t.addAudioRequest(makeAudioRequest({ id: 'a1', src: 'a.mp3' })); },
+        });
+        const b = new FakeScene({
+            yieldCount: 2,
+            onPrepare: (t, f) => { if (f === 0)
+                t.addAudioRequest(makeAudioRequest({ id: 'b1', src: 'b.mp3' })); },
+        });
+        const result = run([a, b]);
+        expect(result.scenes[0].audioRequests.map((r) => r.id)).toEqual(['a1']);
+        expect(result.scenes[1].audioRequests.map((r) => r.id)).toEqual(['b1']);
+    });
+});
+describe('Precomp – asset map (image)', () => {
+    it('computes lead time and a backward-scrub tail for an image', () => {
+        // Register a 512×512 image only from frame 5 onward (single 10-frame scene).
+        const scene = new FakeScene({
+            yieldCount: 10,
+            onPrepare: (tracker, frame) => {
+                if (frame >= 5)
+                    tracker.requestImage('img.png', 512, 512);
+            },
+        });
+        const result = run([scene], 10);
+        const track = result.assets.get('img.png');
+        expect(track.record.type).toBe('image');
+        expect(track.record.startFrame).toBe(5);
+        expect(track.record.endFrame).toBe(9);
+        // 512×512×4 = 1 MB → 2 frames of lead; cacheAt = startFrame − lead.
+        expect(track.cacheAt).toBe(3);
+        // Tail = endFrame + 30.
+        expect(track.discardAt).toBe(39);
+    });
+    it('clamps cacheAt to 0 when the lead reaches before frame 0', () => {
+        const scene = new FakeScene({
+            yieldCount: 4,
+            onPrepare: (tracker) => tracker.requestImage('hero.png', 512, 512),
+        });
+        const track = run([scene]).assets.get('hero.png');
+        expect(track.cacheAt).toBe(0);
+        expect(track.record.startFrame).toBe(0);
+    });
+    it('tracks the maximum requested resolution across frames', () => {
+        const scene = new FakeScene({
+            yieldCount: 3,
+            onPrepare: (tracker, frame) => {
+                tracker.requestImage('img.png', frame === 1 ? 800 : 100, frame === 1 ? 600 : 100);
+            },
+        });
+        const record = run([scene]).assets.get('img.png').record;
+        expect(record.type).toBe('image');
+        if (record.type === 'image') {
+            expect(record.width).toBe(800);
+            expect(record.height).toBe(600);
+        }
+    });
+});
+describe('Precomp – asset map (font & video)', () => {
+    it('always caches fonts at frame 0 and never discards them', () => {
+        const scene = new FakeScene({
+            yieldCount: 5,
+            onPrepare: (tracker, frame) => { if (frame >= 2)
+                tracker.requestFont('Inter', '700'); },
+        });
+        const track = run([scene]).assets.get('Inter');
+        expect(track.record.type).toBe('font');
+        expect(track.cacheAt).toBe(0);
+        expect(track.discardAt).toBeNull();
+    });
+    it('gives video a heavier lead than the equivalent image and a discard tail', () => {
+        const catalog = new FakeAssetCatalog({ 'clip.mp4': 5 });
+        const scene = new FakeScene({
+            yieldCount: 6,
+            onPrepare: (tracker) => tracker.requestVideo('clip.mp4', 512, 512),
+        });
+        const track = run([scene], 30, catalog).assets.get('clip.mp4');
+        expect(track.record.type).toBe('video');
+        // Video lead clamps cacheAt to 0 here; the tail is endFrame + 30.
+        expect(track.cacheAt).toBe(0);
+        expect(track.discardAt).toBe(5 + 30);
+    });
+});
+//# sourceMappingURL=precompisition.test.js.map

package/dist/runtime/precompisition.test.js.map

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

package/dist/runtime/runtime.fixtures.d.ts

@@ -0,0 +1,158 @@
+/**
+ * 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";
+import { AssetTracker } from "@/assets/tracker";
+import { AssetCatalog } from "@/assets/catalog";
+import { Scene } from "@/nodes/base/scene-node";
+import { StorageAdapter } from "@/platform/storage-adapter";
+import { RenderContext } from "@/render/render-context";
+import { AudioRequest } from "@/attributes/audio/request";
+import { AssetRecord } from "@/assets/record";
+import { PrecompResult, AssetTrack, ScenePrecomp } from "@/runtime/precompisition";
+/** A minimal tree node used to test getTreeState / getNodeState walking. */
+export declare class FakeNode {
+    id: string;
+    name: string;
+    children: FakeNode[];
+    properties: Record<string, unknown>;
+    constructor(id: string, name: string, children?: FakeNode[], properties?: Record<string, unknown>);
+    waveform(): undefined;
+}
+export interface FakeSceneOptions {
+    id?: string;
+    name?: string;
+    /** Number of times the build generator yields ≈ this scene's frame count. */
+    yieldCount?: number;
+    children?: FakeNode[];
+    properties?: Record<string, unknown>;
+    /**
+     * Hook invoked on each prepareAssets() call so a test can register assets or
+     * audio with the tracker. `frame` is the prepareAssets call index (0-based).
+     */
+    onPrepare?: (tracker: AssetTracker, frame: number) => void;
+}
+/**
+ * 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 declare class FakeScene {
+    id: string;
+    name: string;
+    properties: Record<string, unknown>;
+    children: FakeNode[];
+    yieldCount: number;
+    private onPrepare?;
+    resetCount: number;
+    buildCount: number;
+    disposeCount: number;
+    renderCount: number;
+    setCalls: unknown[];
+    bindAssetsCalls: unknown[];
+    ellapseCalls: number[];
+    layoutCalls: {
+        rect: unknown;
+    }[];
+    prepareCount: number;
+    constructor(opts?: FakeSceneOptions);
+    set(props: unknown): void;
+    reset(): void;
+    bindAssets(catalog: unknown): void;
+    ellapse(time: number): void;
+    layout(rect: unknown): void;
+    render(): void;
+    prepareAssets(tracker: AssetTracker): void;
+    dispose(): void;
+    waveform(): undefined;
+    build(): Generator<void, void, number>;
+}
+/** Cast a fake scene to the Scene type the runtime expects. */
+export declare function asScene(scene: FakeScene): Scene;
+export declare function asScenes(scenes: FakeScene[]): Scene[];
+export declare class FakeMeasureScope extends MeasureScope {
+    measureText(text: string): number;
+}
+export declare class FakeAssetCatalog {
+    private videoDurations;
+    constructor(videoDurations?: Record<string, number>);
+    getVideoDuration(src: string): number;
+}
+export declare function asCatalog(c: FakeAssetCatalog): AssetCatalog;
+export declare class FakeRenderContext {
+    renderCount: number;
+    screenshotValue: string | undefined;
+    /** Invokes the draw callback, mirroring the real render() contract. */
+    render(cb: () => void): void;
+    screenshot(): string | undefined;
+}
+export declare function asRenderContext(c: FakeRenderContext): RenderContext;
+export declare class FakeStorageAdapter {
+    loadAssetCalls: {
+        key: string;
+        record: AssetRecord;
+    }[];
+    fetchAudioCalls: string[];
+    /** When set, loadAsset rejects with this error (to exercise prefetch's catch). */
+    loadShouldReject: boolean;
+    loadAsset(key: string, record: AssetRecord): Promise<void>;
+    fetchAudioData(src: string): Promise<ArrayBuffer>;
+}
+export declare function asStorage(s: FakeStorageAdapter): StorageAdapter;
+export declare class FakeAudioDevice extends AudioDevice {
+    private cache;
+    appendCalls: {
+        src: string;
+    }[];
+    scheduleCalls: AudioRequest[][];
+    retainCalls: ReadonlySet<string>[];
+    syncToCalls: number[];
+    playCalls: {
+        time: number;
+        speed: number;
+        reverse: boolean;
+    }[];
+    stopCount: number;
+    /** Seed the cache so `has()` returns true without an append round-trip. */
+    seed(src: string): void;
+    has(src: string): boolean;
+    append(src: string): Promise<void>;
+    retain(keep: ReadonlySet<string>): void;
+    schedule(requests: readonly AudioRequest[]): void;
+    syncTo(sceneTime: number): void;
+    play(time: number, speed: number, reverse: boolean): void;
+    stop(): void;
+}
+/**
+ * A MasterClock whose time is driven manually. `simulateTick` sets the time and
+ * runs the registered tick callbacks (awaiting their async work).
+ */
+export declare class FakeClock extends MasterClock {
+    seekCalls: number[];
+    disposeCount: number;
+    seek(t: number): void;
+    /** Set the current time without firing tick callbacks. */
+    setTime(t: number): void;
+    /** Set the time then run all onTick callbacks to completion. */
+    simulateTick(t: number): Promise<void>;
+    dispose(): void;
+}
+export declare function makeAudioRequest(over?: Partial<AudioRequest>): AudioRequest;
+export declare function makeImageRecord(over?: Partial<Extract<AssetRecord, {
+    type: "image";
+}>>): AssetRecord;
+export declare function makeAssetTrack(over?: Partial<AssetTrack> & {
+    record?: AssetRecord;
+}): AssetTrack;
+export declare function makeScenePrecomp(over?: Partial<ScenePrecomp>): ScenePrecomp;
+export declare function makePrecompResult(over?: Partial<PrecompResult>): PrecompResult;
+//# sourceMappingURL=runtime.fixtures.d.ts.map

package/dist/runtime/runtime.fixtures.d.ts.map

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